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)
12057정성태11/18/20193오류 유형: 579. Visual Studio - Memory 창에서 유효한 주소 영역임에도 "Unable to evaluate the expression." 오류 출력
12056정성태11/18/201911개발 환경 구성: 464. "Microsoft Visual Studio Installer Projects" 프로젝트로 EXE 서명 및 MSI 파일 서명 방법파일 다운로드1
12055정성태11/17/201940개발 환경 구성: 463. Visual Studio의 Ctrl + Alt + M, 1 (Memory 1) 등의 단축키가 동작하지 않는 경우
12054정성태11/15/201957.NET Framework: 869. C# - 일부러 GC Heap을 깨뜨려 GC 수행 시 비정상 종료시키는 예제
12053정성태11/15/201930Windows: 164. 윈도우 10 - 명령행 창(cmd.exe) 속성에 (DotumChe, GulimChe, GungsuhChe 등의) 한글 폰트가 없는 경우
12052정성태11/15/201915오류 유형: 578. Azure - 일정(schedule)에 등록한 runbook이 1년 후 실행이 안 되는 문제(Reason - The key used is expired.)
12051정성태11/14/201959개발 환경 구성: 462. 시작하자마자 비정상 종료하는 프로세스의 메모리 덤프 - procdump
12050정성태11/14/201938Windows: 163. AcLayers의 API 후킹과 FaultTolerantHeap
12049정성태11/13/201941.NET Framework: 868. (닷넷 프로세스를 대상으로) 디버거 방식이 아닌 CLR Profiler를 이용해 procdump.exe 기능 구현
12048정성태11/12/201956Windows: 163. GUID 이름의 볼륨에 해당하는 파티션을 찾는 방법
12047정성태11/12/2019124Windows: 163. 안전하게 eject시킨 USB 장치를 물리적인 재연결 없이 다시 인식시키는 방법
12046정성태11/9/2019105오류 유형: 577. windbg - The call to LoadLibrary(...\sos.dll) failed, Win32 error 0n193
12045정성태10/27/201998오류 유형: 576. mstest.exe 실행 시 "Visual Studio Enterprise is required to execute the test." 오류 - 두 번째 이야기
12044정성태10/27/2019102오류 유형: 575. mstest.exe - System.Resources.MissingSatelliteAssemblyException: The satellite assembly named "Microsoft.VisualStudio.ProductKeyDialog.resources.dll, ..."
12043정성태10/27/201992오류 유형: 574. Windows 10 설치 시 오류 - 0xC1900101 - 0x4001E
12042정성태10/26/201985오류 유형: 573. OneDrive 하위에 위치한 Documents, Desktop 폴더에 대한 권한 변경 시 "Unable to display current owner"
12041정성태10/23/201975오류 유형: 572. mstest.exe - The load test results database could not be opened.
12040정성태10/23/2019181오류 유형: 571. Unhandled Exception: System.Net.Mail.SmtpException: Transaction failed. The server response was: 5.2.0 STOREDRV.Submission.Exception:SendAsDeniedException.MapiExceptionSendAsDenied
12039정성태10/22/201992스크립트: 16. cmd.exe의 for 문에서는 ERRORLEVEL이 설정되지 않는 문제
12038정성태10/17/201991오류 유형: 570. SQL Server 2019 RC1 - SQL Client Connectivity SDK 설치 오류
12037정성태10/15/2019242.NET Framework: 867. C# - Encoding.Default 값을 바꿀 수 있을까요?파일 다운로드1
12036정성태10/21/2019303.NET Framework: 866. C# - 고성능이 필요한 환경에서 GC가 발생하지 않는 네이티브 힙 사용파일 다운로드1
12035정성태10/13/2019182개발 환경 구성: 461. C# 8.0의 #nulable 관련 특성을 .NET Framework 프로젝트에서 사용하는 방법파일 다운로드1
12034정성태10/12/2019273개발 환경 구성: 460. .NET Core 환경에서 (프로젝트가 아닌) C# 코드 파일을 입력으로 컴파일하는 방법 [1]
12033정성태10/11/2019224개발 환경 구성: 459. .NET Framework 프로젝트에서 C# 8.0 컴파일러를 사용하는 방법
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...