Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
[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



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

[연관 글]


donaricano-btn



[최초 등록일: ]
[최종 수정일: 6/27/2021

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

비밀번호

댓글 쓴 사람
 



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

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

감사합니다.
[손님]
2011-04-30 09시51분
아... ^^ 넵. 글을 수정했습니다.
정성태
2019-03-25 11시29분
혹시 저렇게 설정했는데도 다음과 같은 오류가 발생한다면?

Service Unavailable
HTTP Error 503. The service is unavailable.

명령행에서 직접 IISExpress.exe를 해당 인자들과 함께 실행해 보세요. 그 이후로는 비주얼 스튜디오에서 잘 되는 경우가 있습니다.
정성태
2021-07-31 05시58분
[gwise] .net core로 rest api서버 만들어서 Xamarin 으로 개발중인데 ip 접근이 안되서 정리해 봤습니다.
위에 처럼 하다가 안되서 아래 처럼 하면 로컬 pc ip로 접근해서 디버깅 할 수 있습니다.

1.Visual Studio 를 관리자 권한으로 실행. (포트번호 8500 번으로 변경)



2. 프로젝트를 한번 실행 한다.

Enable SSL 체크 해제 하고 (http로 실행)



3. 프로젝트 폴더의 ".vs" 폴더로 들어 간다.

C:\Users\DELL\source\repos\WebApplication4\.vs



4. config 폴더에서

C:\Users\DELL\source\repos\WebApplication4\.vs\WebApplication4\config



5. config폴더에서 applicationhost.config 파일을 열람 후 빨간줄 처럼 해준다.



      <site name="WebApplication4" id="2">

        <application path="/" applicationPool="WebApplication4 AppPool">

          <virtualDirectory path="/" physicalPath="C:\Users\DELL\source\repos\WebApplication4\WebApplication4" />

        </application>

        <bindings>

          <binding protocol="http" bindingInformation=":8500:" />

        </bindings>

      </site>



이렇게 하면 ip로 접근이 가능하다.
[손님]

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12839정성태9/15/2021335.NET Framework: 1118. C# 10 - (17) 제네릭 타입의 특성 적용파일 다운로드1
12838정성태9/13/2021319.NET Framework: 1117. C# - Task에 전달한 Action, Func 유형에 따라 달라지는 async/await 비동기 처리 [2]파일 다운로드1
12837정성태9/11/2021161VC++: 151. Golang - fmt.Errorf, errors.Is, errors.As 설명
12836정성태9/10/2021119Linux: 45. 리눅스 - 실행 중인 다른 프로그램의 출력을 확인하는 방법
12835정성태9/7/2021173.NET Framework: 1116. C# 10 - (16) CallerArgumentExpression 특성 추가파일 다운로드1
12834정성태9/7/202198오류 유형: 762. Visual Studio 2019 Build Tools - 'C:\Program' is not recognized as an internal or external command, operable program or batch file.
12833정성태9/6/2021197VC++: 150. Golang - TCP client/server echo 예제 코드파일 다운로드1
12832정성태9/6/202196VC++: 149. Golang - 인터페이스 포인터가 의미 있을까요?
12831정성태9/6/2021129VC++: 148. Golang - 채널에 따른 다중 작업 처리파일 다운로드1
12830정성태9/6/2021124오류 유형: 761. Internet Explorer에서 파일 다운로드 시 "Your current security settings do not allow this file to be downloaded." 오류
12829정성태9/5/2021218.NET Framework: 1115. C# 10 - (15) 구조체 타입에 기본 생성자 정의 가능파일 다운로드1
12828정성태9/4/2021252.NET Framework: 1114. C# 10 - (14) 단일 파일 내에 적용되는 namespace 선언파일 다운로드1
12827정성태9/4/2021122스크립트: 27. 파이썬 - 웹 페이지 데이터 수집을 위한 scrapy Crawler 사용법 요약
12826정성태9/3/2021184.NET Framework: 1113. C# 10 - (13) 문자열 보간 성능 개선파일 다운로드1
12825정성태9/3/202175개발 환경 구성: 603. GoLand - WSL 환경과 연동
12824정성태9/2/2021203오류 유형: 760. 파이썬 tensorflow - Dst tensor is not initialized. 오류 메시지
12823정성태9/2/2021174스크립트: 26. 파이썬 - PyCharm을 이용한 fork 디버그 방법
12822정성태9/1/2021112오류 유형: 759. 파이썬 tensorflow - ValueError: Shapes (...) and (...) are incompatible
12821정성태9/1/2021157.NET Framework: 1112. C# - .NET 6부터 공개된 ISpanFormattable 사용법
12820정성태9/1/202190VC++: 147. Golang - try/catch에 대응하는 panic/recover파일 다운로드1
12819정성태8/31/2021192.NET Framework: 1111. C# - FormattableString 타입
12818정성태8/31/2021135Windows: 198. 윈도우 - 작업 관리자에서 (tensorflow 등으로 인한) GPU 연산 부하 보는 방법
12817정성태8/31/202185스크립트: 25. 파이썬 - 윈도우 환경에서 directml을 이용한 tensorflow의 AMD GPU 사용 방법
12816정성태8/30/2021436스크립트: 24. 파이썬 - tensorflow 2.6 NVidia GPU 사용 방법 [2]
12815정성태8/30/2021216개발 환경 구성: 602. WSL 2 - docker-desktop-data, docker-desktop (%LOCALAPPDATA%\Docker\wsl\data\ext4.vhdx) 파일을 다른 디렉터리로 옮기는 방법
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...