Microsoft MVP성태의 닷넷 이야기
글쓴 사람
홈페이지
첨부 파일
[Web.zip]    
IIS Express - localhost 이외의 호스트 이름으로 접근하는 방법

설마, 아직도 Windows 7 + Visual Studio 2010 환경에서 웹 개발을 하면서 IIS Express를 설치하지 않으신 분은 없겠지요? ^^

WebDev도 좋긴 하지만, 몇몇 특정 기능 때문에 IIS 를 사용할 수 밖에 없는 상황이 발생하지요. 그런 경우, IIS에서 디버깅을 하려면 '관리자 권한'으로 Visual Studio를 실행해야 하는 문제가 걸리는데, 이런 부분이 "IIS Express"를 사용하면 자연스럽게 해결됩니다. (물론, IIS Express 도 net.tcp 프로토콜의 WCF 서비스는 감당 못하지만.)

그리 시간이 걸리지 않으니 지금이라도 아래의 사이트에서 다운로드 하십시오. ^^

Internet Information Services (IIS) 7.5 Express 
; http://www.microsoft.com/downloads/en/details.aspx?FamilyID=abc59783-89de-4adc-b770-0a720bb21deb




IIS Express가 이제 설치되었으면, 간단한 테스트 환경을 구성해 보겠습니다.

다음과 같은 내용의 3가지 파일을 c:\temp\web 에 넣어두고,

(* 첨부 파일에 아래의 소스가 포함되어 있습니다.)
=========== Default.aspx ===========
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
        <asp:HyperLink ID="HyperLink1" runat="server">HyperLink</asp:HyperLink>
    
    </div>
    </form>
</body>
</html>

=========== Default.aspx.cs ===========
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

public partial class _Default : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        HyperLink1.Text = "TEST";
    }
}

=========== web.config ===========
<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true" targetFramework="4.0"/>
  </system.web>
</configuration>

IIS Express 가 설치된 폴더에 가서 (관리자 권한 없이) 다음과 같이 명령을 내려주면 웹 사이트 호스팅이 시작됩니다.

C:\Program Files (x86)\IIS Express>iisexpress /path:c:\temp\web /port:8500
Copied template config file 'C:\Program Files (x86)\IIS Express\AppServer\applicationhost.config' to '%LOCALAPPDATA%\Temp\iisexpress\applicationhost201142971710826.config'
Updated configuration file '%LOCALAPPDATA%\Temp\iisexpress\applicationhost201142971710826.config' with given cmd line info.
Starting IIS Express ...
Successfully registered URL "http://localhost:8500/" for site "Development Web Site" application "/"
Registration completed
IIS Express is running.
Enter 'Q' to stop IIS Express

Internet Explorer로 확인을 해보면, 다음과 같이 ^^ default.aspx/cs 파일이 잘 컴파일되어 출력이 되는 것을 확인할 수 있습니다.

how_to_use_hostname_in_iisexpress_1.png

그런데, "http://127.0.0.1:8500"으로 한번 접근해 볼까요? 그러면 다음과 같이 오류가 발생하는 것을 볼 수 있습니다.

how_to_use_hostname_in_iisexpress_2.png

Bad Request - Invalid Hostname
 
HTTP Error 400. The request hostname is invalid.

말 그대로, IIS Express는 기본적으로 'localhost'이외의 호스트 이름으로 전달되는 모든 HTTP 요청을 거부합니다. "127.0.0.1" 주소도 거부될 정도이니, 다른 IP 나 DNS 는 굳이 확인할 필요도 없습니다.

개발자 컴퓨터에서 Visual Studio로 웹 사이트 개발/디버깅하는 용도로는 이런 제약이 크게 문제가 안 되지만, IIS Express 자체가 Tomcat 과 같은 무료 웹 서버로 사용되기 위한 용도로는 적합하지 않은 제약입니다.

물론, 이러한 제약을 벗어나도록 하는 방법이 있고 바로 여기서부터 '관리자 권한'이 필요하게 됩니다. 우선, 여러분이 호스트하려는 (포트 포함)URL 형식에 대해 시스템에 등록해 주어야 합니다. 이를 위해 netsh 이 필요합니다. 예전에도 몇몇 글에서 한번 알아본 적이 있지요. ^^

WCF 인증서 설정 관련 오류 정리
; https://www.sysnet.pe.kr/2/0/869

VS.NET 2008 - WCF 를 위한 디버깅 환경 개선
; https://www.sysnet.pe.kr/2/0/522

그렇습니다. 보안이라는 맥락으로 모두 다 같이 영향을 받는 것으로, 로컬에서 함부로 http.sys와 연동되는 서비스 포트를 열 수 없도록 이러한 제약이 생긴 것입니다. 따라서, 이를 허용하도록 '관리자 권한'에서 설정을 해주어야 하는데, 이 글에서 원하는 것은 8500 번 포트를 여는 것이므로 다음과 같이 명령행 창에서 실행해 주면 됩니다.

[형식]: netsh http add urlacl url=http://*:[포트번호]/ user="[사용자 계정]"

C:\Program Files (x86)\IIS Express>netsh http add urlacl url=http://*:8500/ user="testusr32"

URL reservation successfully added

아래와 같은 명령어로 확인을 할 수 있고,

C:\Program Files (x86)\IIS Express>netsh http show urlacl

URL Reservations:
-----------------
    ...[생략]...

    Reserved URL            : http://*:8500/
        User: TESTPC\TESTUSR32
            Listen: Yes
            Delegate: No
            SDDL: D:(A;;GX;;;S-1-5-21-15120209-1487767885-450303533-1000)

지우는 방법은 다음과 같습니다. (실습을 위해 지우지는 마세요. ^^)

netsh http delete urlacl ur=http://*:8500/

이렇게 해서 8500번 포트를 등록했으면 다시 iisexpress를 실행시켜 봅니다. 하지만, 이번에는 정상적으로 실행이 안됩니다.

C:\Program Files (x86)\IIS Express>iisexpress /path:c:\temp\web /port:8500
Copied template config file 'C:\Program Files (x86)\IIS Express\AppServer\applicationhost.config' to '%LOCALAPPDATA%\Temp\iisexpress\applicationhost201142974455237.config'
Updated configuration file '%LOCALAPPDATA%\Temp\iisexpress\applicationhost201142974455237.config' with given cmd line info.
Starting IIS Express ...
Failed to call HttpAddUrl with http://localhost:8500/
Failed to register URL "http://localhost:8500/" for site "Development Web Site" application "/". Error description: Access is denied. (0x80070005)
Registration completed
Failed to process sites
Report ListenerChannel stopped due to failure; ProtocolId:http, ListenerChannelId:0
HostableWebCore activation failed.
Unable to start iisexpress.

Access is denied.
For more information about the error, run iisexpress.exe with the tracing switch enabled (/trace:error).

일단 netsh로 등록이 되면, 이제 더 이상 localhost 만으로 접근이 되는 낮은 권한의 웹 사이트 호스팅이 안됩니다.

이 단계에서, 한가지 더 수정을 해주어야 합니다. 즉, "localhost" 이외의 주소로 바인딩하려 한다는 정보를 iisexpress.exe에게 알려야 합니다.

그런데, 아쉽게도 바인딩 관련 옵션을 직접적으로 iisexpress.exe의 명령행 인자로 줄 수 있는 방법이 없습니다. 대신에, 해당 웹 사이트에 대한 호스팅 정보를 제공하는 applicationHost.config 파일을 만들어서 iisexpress.exe에 지정해 주어야 합니다.

다행히 어려운 방법은 아닙니다. applicationHost.config 파일을 바닥부터 만들 필요없이, 이미 iisexpress.exe가 대략적인 호스팅 정보를 담고 있는 config 파일을 만들어주므로 이를 재사용하면 되기 때문입니다. 위의 iisexpress.exe 실행 결과를 자세히 보시면 다음과 같은 경로에 config 파일을 만들어 주고 있음을 눈치챌 수 있습니다.

Updated configuration file '%LOCALAPPDATA%\Temp\iisexpress\applicationhost201142974455237.config' with given cmd line info.


위의 경로에 있는 applicationhost201142974455237.config 파일을 c:\temp\web 폴더에 "applicationhost.config" 라는 이름으로 복사하고, bindings 절에서 다음의 내용을 수정해 줍니다.

<sites>
    <site name="Development Web Site" id="1" serverAutoStart="true">
        <application path="/">
            <virtualDirectory path="/" physicalPath="c:\temp\web" />
        </application>
        <bindings>
            <binding protocol="http" bindingInformation=":8500:" /> <== 원래는 ":8500:localhost"
        </bindings>
    </site>
    ...[생략]...
</sites>

자, 이제 다시 명령행에서 다음과 같이 입력해 주면 정상적으로 호스팅이 되는 것을 확인할 수 있습니다.

C:\Program Files (x86)\IIS Express>iisexpress /config:c:\temp\web\applicationHost.config
Starting IIS Express ...
Failed to add localhost binding to binding ':8500:'
Successfully registered URL "http://*:8500/" for site "Development Web Site" application "/"
Registration completed for site "Development Web Site"
IIS Express is running.
Enter 'Q' to stop IIS Express

이유는 알 수 없지만 중간에 failed... 되었다는 메시지가 나오는데 영향은 없습니다. 이제 IP 든 도메인 주소든 다음과 같이 정상적으로 접근하는 것이 가능합니다.

how_to_use_hostname_in_iisexpress_3.png




그 외, 위의 사항에 대한 공식적인 문서는 다음의 경로에서 제공됩니다.

Handling URL Binding Failures in IIS Express 
- Serving External Traffic
; http://learn.iis.net/page.aspx/1005/handling-url-binding-failures-in-iis-express/

참고로, 예전에 Microsoft MVP로 활동하셨던 (그리고, 조만간 다시 되실 ^^) '송원석'님이 위의 문서를 번역해서 공개해 주고 있습니다. ^^

No. 61 :: IIS 7.0 인스퍼레이션 - 41, (Handling URL Binding Failures in IIS Express 번역 및 주해) 
; http://www.egocube.pe.kr/asp_0061.asp



[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]





[최초 등록일: ]
[최종 수정일: 3/25/2019 ]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer@outlook.com

비밀번호

댓글 쓴 사람
 



2011-04-30 09시48분
[송원석] 안녕하세요? 송원석입니다.
항상 좋은 글들, 잘 읽고 있습니다.

그런데, 죄송하게도... 제가 더 이상 MVP가 아니랍니다. ^_^;;;
혹시라도 오해하시는 분들이 계실까봐서 말씀드립니다.

감사합니다.
[손님]
2011-04-30 09시51분
아... ^^ 넵. 글을 수정했습니다. (요즘은 MVP모임을 가도 거의 아는 분이 없어서 외롭답니다. ^^;)
정성태
2019-03-25 11시29분
혹시 저렇게 설정했는데도 다음과 같은 오류가 발생한다면?

Service Unavailable
HTTP Error 503. The service is unavailable.

명령행에서 직접 IISExpress.exe를 해당 인자들과 함께 실행해 보세요. 그 이후로는 비주얼 스튜디오에서 잘 되는 경우가 있습니다.
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12207정성태4/2/202025스크립트: 19. Windows PowerShell의 NonInteractive 모드
12206정성태4/2/202014오류 유형: 613. 파일 잠금이 바로 안 풀린다면? - The process cannot access the file '...' because it is being used by another process.
12205정성태4/2/202011스크립트: 18. Powershell에서는 cmd.exe의 명령어를 지원하진 않습니다.
12204정성태4/1/202016스크립트: 17. Powershell 명령어에 ';' (semi-colon) 문자가 포함된 경우
12203정성태3/18/202072오류 유형: 612. warning: 'C:\ProgramData/Git/config' has a dubious owner: '...'.
12202정성태3/18/202090개발 환경 구성: 486. .NET Framework 프로젝트를 위한 GitLab CI/CD Runner 구성
12201정성태3/18/202035오류 유형: 611. git-credential-manager.exe: Using credentials for username "Personal Access Token".
12200정성태3/18/2020130VS.NET IDE: 145. NuGet + Github 라이브러리 디버깅 관련 옵션 3가지 - "Enable Just My Code" / "Enable Source Link support" / "Suppress JIT optimization on module load (Managed only)"
12199정성태3/17/202039오류 유형: 610. C# - CodeDomProvider 사용 시 Unhandled Exception: System.IO.DirectoryNotFoundException: Could not find a part of the path '...\f2_6uod0.tmp'.
12198정성태3/17/202035오류 유형: 609. SQL 서버 접속 시 "Cannot open user default database. Login failed."
12197정성태3/17/2020125VS.NET IDE: 144. .NET Core 콘솔 응용 프로그램을 배포(publish) 시 docker image 자동 생성 - 두 번째 이야기
12196정성태3/17/202064오류 유형: 608. The ServicedComponent being invoked is not correctly configured (Use regsvcs to re-register).
12195정성태3/17/2020173.NET Framework: 902. C# - 프로세스의 모든 핸들을 열람 - 세 번째 이야기
12194정성태3/16/202045오류 유형: 607. PostgreSQL - Npgsql.NpgsqlException: sorry, too many clients already
12193정성태3/16/202081개발 환경 구성: 485. docker - SAP Adaptive Server Enterprise 컨테이너 실행
12192정성태3/14/202090개발 환경 구성: 484. docker - Sybase Anywhere 16 컨테이너 실행
12191정성태3/14/2020131개발 환경 구성: 483. docker - OracleXE 컨테이너 실행
12190정성태3/14/202046오류 유형: 606. Docker Desktop 업그레이드 시 "The process cannot access the file 'C:\Program Files\Docker\Docker\resources\dockerd.exe' because it is being used by another process."
12189정성태3/13/202087개발 환경 구성: 482. Facebook OAuth 처리 시 상태 정보 전달 방법과 "유효한 OAuth 리디렉션 URI" 설정 규칙
12188정성태3/14/202050Windows: 167. 부팅 시점에 실행되는 chkdsk 결과를 확인하는 방법
12187정성태3/12/202038오류 유형: 605. NtpClient was unable to set a manual peer to use as a time source because of duplicate error on '...'.
12186정성태3/12/202054오류 유형: 604. The SysVol Permissions for one or more GPOs on this domain controller and not in sync with the permissions for the GPOs on the Baseline domain controller.
12185정성태3/11/202053오류 유형: 603. The browser service was unable to retrieve a list of servers from the browser master...
12184정성태3/11/202058오류 유형: 602. Automatic certificate enrollment for local system failed (0x800706ba) The RPC server is unavailable.
12183정성태3/12/202057오류 유형: 601. Warning: DsGetDcName returned information for \\[...], when we were trying to reach [...].
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...