성태의 닷넷 이야기
홈 주인
모아 놓은 자료
프로그래밍
질문/답변
사용자 관리
사용자
메뉴
아티클
외부 아티클
유용한 코드
온라인 기능
MathJax 입력기
최근 덧글
[정성태] 제가 큰 실수를 했군요. ^^; Delegate를 통한 Bein...
[정성태] Working with Rust Libraries from C#...
[정성태] Detecting blocking calls using asyn...
[정성태] 아쉽게도, 커뮤니티는 아니고 개인 블로그입니다. ^^
[정성태] 질문이 잘 이해가 안 됩니다. 우선, 해당 소스코드에서 ILis...
[양승조
] var대신 dinamic으로 선언해서 해결은 했습니다. 맞는 해...
[양승조
] 또 막혔습니다. ㅠㅠ var list = props[i].Ge...
[양승조
] 아. 감사합니다. 어제는 안됐던것 같은데....정신을 차려야겠네...
[정성태] "props[i].GetValue(props[i])" 코드에서 ...
[정성태] 저렇게 조각 코드 말고, 실제로 재현이 되는 예제 프로젝트를 압...
글쓰기
제목
이름
암호
전자우편
HTML
홈페이지
유형
제니퍼 .NET
닷넷
COM 개체 관련
스크립트
VC++
VS.NET IDE
Windows
Team Foundation Server
디버깅 기술
오류 유형
개발 환경 구성
웹
기타
Linux
Java
DDK
Math
Phone
Graphics
사물인터넷
부모글 보이기/감추기
내용
<div style='display: inline'> <h1 style='font-family: Malgun Gothic, Consolas; font-size: 20pt; color: #006699; text-align: center; font-weight: bold'>"Docker Desktop for Windows" - ASP.NET Core 응용 프로그램의 소켓 주소 바인딩(IPv4/IPv6 loopback, Any)</h1> <p> 예를 들기 위해, 비주얼 스튜디오에서 ASP.NET Core 웹 프로젝트를 "Enable Docker" 옵션을 체크하고 만듭니다. (또는, 해당 옵션 없이 만든 후 "Add" / "Docker Support..." 메뉴를 선택해도 됩니다.)<br /> <br /> 이제 F5 키를 눌러 실행하면, 비주얼 스튜디오의 "Containers" 뷰(단축키: Ctrl+K, Ctrl+O)에서 다음과 같은 출력 내용을 볼 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > warn: Microsoft.AspNetCore.DataProtection.Repositories.FileSystemXmlRepository[60] Storing keys in a directory '/home/app/.aspnet/DataProtection-Keys' that may not be persisted outside of the container. Protected data will be unavailable when container is destroyed. For more information go to https://aka.ms/aspnet/dataprotectionwarning warn: Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager[35] No XML encryptor configured. Key {85a48ab0-5ffe-4904-ab57-f396acf433fd} may be persisted to storage in unencrypted form. info: Microsoft.Hosting.Lifetime[14] Now listening on: <span style='color: blue; font-weight: bold'>http://[::]:8080</span> info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl+C to shut down. info: Microsoft.Hosting.Lifetime[0] Hosting environment: Development info: Microsoft.Hosting.Lifetime[0] Content root path: /app </pre> <br /> "[::]"은 <a target='tab' href='https://learn.microsoft.com/en-us/dotnet/api/system.net.ipaddress.ipv6any'>IPAddress.IPv6Any</a> 주소를 의미하는데요, IPv4도 같이 매핑이 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > $ <span style='color: blue; font-weight: bold'>netstat -ant | grep LISTEN</span> tcp6 0 0 :::8080 :::* LISTEN $ <span style='color: blue; font-weight: bold'>cat /proc/sys/net/ipv6/bindv6only</span> 0 </pre> <br /> 하지만 (기본적으로는) 정작 컨테이너 환경 내에서 IPv4 형식만 지원하기 때문에,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > $ <span style='color: blue; font-weight: bold'>ifconfig</span> eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet <span style='color: blue; font-weight: bold'>172.17.0.2</span> netmask 255.255.0.0 broadcast 172.17.255.255 ether 02:42:ac:11:00:02 txqueuelen 0 (Ethernet) RX packets 143 bytes 15531 (15.1 KiB) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 122 bytes 338731 (330.7 KiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536 inet <span style='color: blue; font-weight: bold'>127.0.0.1</span> netmask 255.0.0.0 loop txqueuelen 1000 (Local Loopback) RX packets 60 bytes 17200 (16.7 KiB) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 60 bytes 17200 (16.7 KiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 </pre> <br /> 127.0.0.1, 172.17.0.2와 같은 IPv4 주소를 지정한 요청만 받아들일 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > $ <span style='color: blue; font-weight: bold'>curl http://172.17.0.2:8080</span> ...[OK]... $ <span style='color: blue; font-weight: bold'>curl http://127.0.0.1:8080</span> ...[OK]... $ <span style='color: blue; font-weight: bold'>curl http://[::1]:8080</span> curl: (7) Failed to connect to ::1 port 8080 after 0 ms: Couldn't connect to server </pre> <br /> 물론, 컨테이너 환경 내에서 저런 제약이 있는 것이고, 해당 포트를 외부로 매핑한 경우에는, 예를 들어 "-p 16000:8080"으로 매핑시켜 노출했다면 외부에서는 IPv6, IPv4에 상관 없이 접근할 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > // Docker Desktop을 호스팅하는 윈도우 환경으로 가정 c:\temp> <span style='color: blue; font-weight: bold'>curl [::1]:16000</span> ...[OK]... // 윈도우 측의 IPv6 주소가 "fe80::cef1:2a62:aee0:1ca9"인 경우, c:\temp> <span style='color: blue; font-weight: bold'>curl [fe80::cef1:2a62:aee0:1ca9]:16000</span> ...[OK]... c:\temp> <span style='color: blue; font-weight: bold'>curl localhost:8080</span> ...[OK]... </pre> <br /> 하지만, 외부에서 IPv6로 접속했다고 해서 내부의 IPv6 [::] 주소로 Accept가 된 것은 아닙니다. 예를 들어, telnet으로 간단하게 TCP 커넥션을 열어두도록 접속하는 경우,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > c:\temp> <span style='color: blue; font-weight: bold'>telnet [::1] 16000</span> </pre> <br /> 컨테이너 내부에서 보면, IPv4 0.0.0.0 소켓에서 Accept 처리했음을 확인할 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > $ <span style='color: blue; font-weight: bold'>netstat -ano</span> Active Internet connections (servers and established) Proto Recv-Q Send-Q Local Address Foreign Address State Timer tcp6 0 0 :::8080 :::* LISTEN off (0.00/0/0) tcp6 0 0 <span style='color: blue; font-weight: bold'>172.17.0.2:8080</span> <span style='color: blue; font-weight: bold'>172.17.0.1:37966</span> ESTABLISHED off (0.00/0/0) ...[생략]... </pre> <br /> <hr style='width: 50%' /><br /> <a name='publish_ports'></a> <br /> ASP.NET Core 프로젝트를 .NET 8 런타임으로 생성하면 (기본값이 5000이 아닌) 8080 포트로 서비스하는 이유는 launchSettings.json에 ASPNETCORE_HTTP_PORTS 옵션이 8080으로 설정돼 있기 때문입니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > "Docker": { "commandName": "Docker", "launchBrowser": true, "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}", "environmentVariables": { <span style='color: blue; font-weight: bold'>"ASPNETCORE_HTTP_PORTS": "8080"</span> }, <span style='color: blue; font-weight: bold'>"publishAllPorts": true</span> } </pre> <br /> 또한, 그 8080으로 컨테이너 외부에서 접근할 수 있도록 자동으로 랜덤 포트를 하나 매핑해 주는데요, 그것은 위의 옵션에서 설정한 "publishAllPorts" 옵션 때문입니다. 이 옵션이 true면, dockerfile에 "EXPOSE" 설정이 된 모든 포트를 매핑시켜줍니다.<br /> <br /> 가령, 기본으로는 8080만 있을 텐데요, 여기에 임의로 다른 포트를 하나 더하면,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base USER app WORKDIR /app EXPOSE 8080 <span style='color: blue; font-weight: bold'>EXPOSE 5000</span> ...[생략]... </pre> <br /> 이것 역시 랜덤 포트로 매핑이 됩니다. 엄밀히 말해서 "publishAllPorts" 옵션이 그렇게 해주는 것은 아니고, 그 옵션을 읽어낸 비주얼 스튜디오가 "docker run" 시에 <a target='tab' href='https://docs.docker.com/engine/reference/commandline/container_run/#options'>"-P" 설정</a>을 추가하기 때문입니다.<br /> <br /> 만약, "랜덤 포트"를 사용하고 싶지 않다면 <a target='tab' href='https://learn.microsoft.com/en-us/visualstudio/containers/container-msbuild-properties#properties-for-dockerfile-projects'>csproj에 DockerfileRunArguments 옵션</a>을 줘 고정할 수 있는데요, 가령 아래와 같은 설정을 하게 되면,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > <span style='color: blue; font-weight: bold'><DockerfileRunArguments>-p 16000:8080</DockerfileRunArguments></span> </pre> <br /> 이제 비주얼 스튜디오는 ("publishAllPorts"이 있는 경우 "-P" 옵션도 주겠지만) 명시적으로 "-p 16000:8080" 설정을 "docker run" 시에 추가함으로써 우리가 원하는 포트를 사용할 수 있게 해줍니다.<br /> <br /> <hr style='width: 50%' /><br /> <br /> 대개의 경우 기본 설정된 "ASPNETCORE_HTTP_PORTS": "8080" 옵션으로 인해 [::] Any 바인딩을 그대로 사용하겠지만, 때로는 Reverse Proxy 등을 사용한다면 보안상 localhost로만 매핑하고 싶은 상황도 발생할 것입니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > Host ASP.NET Core on Linux with Nginx ; <a target='tab' href='https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/linux-nginx'>https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/linux-nginx</a> </pre> <br /> 이를 위해서는 ASPNETCORE_URLS 옵션 등을 통해 바인딩 정보를 바꿀 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > "Docker": { "commandName": "Docker", "launchBrowser": true, "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}", "environmentVariables": { // "ASPNETCORE_HTTP_PORTS": "8080" "<a target='tab' href='https://www.sysnet.pe.kr/2/0/13545#aspnetcore_urls'>ASPNETCORE_URLS</a>": "http://localhost:8080" }, "publishAllPorts": true } </pre> <br /> 그럼, F5 실행 시 컨테이너 로그에는 이렇게 바인딩 정보가 바뀌어 출력됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > warn: Microsoft.AspNetCore.Hosting.Diagnostics[15] Overriding HTTP_PORTS '8080' and HTTPS_PORTS ''. Binding to values defined by URLS instead 'http://localhost:8080'. info: Microsoft.Hosting.Lifetime[14] Now listening on: <span style='color: blue; font-weight: bold'>http://localhost:8080</span> </pre> <br /> 그리고 이제부터는, 설령 외부에 "-p 16000:8080" 설정으로 포트 매핑을 시켰다고 해도 윈도우 호스트 측에서 컨테이너 내부의 웹 서비스로 접근하는 것이 불가능합니다. 그렇기 때문에 비주얼 스튜디오에서 자동으로 실행한 웹 브라우저 화면에는 "http://localhost:16000/"로 방문은 하지만 다음과 같은 오류 화면만 보게 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > This page isn't working right now localhost didn't send any data. ERR_EMPTY_RESPONSE </pre> <br /> 또는, curl을 이용해 컨테이너 내부와 외부에서 간단하게 테스트할 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > // Container 내부에서 실행 $ <span style='color: blue; font-weight: bold'>netstat -ant | grep LISTEN</span> Active Internet connections (servers and established) Proto Recv-Q Send-Q Local Address Foreign Address State tcp 0 0 <span style='color: blue; font-weight: bold'>127.0.0.1:8080</span> 0.0.0.0:* LISTEN $ <span style='color: blue; font-weight: bold'>curl http://127.0.0.1:8080</span> ...[OK] </pre> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > // Container 외부에서 실행 c:\temp> <span style='color: blue; font-weight: bold'>curl http://127.0.0.1:16000</span> curl: (52) Empty reply from server c:\temp> <span style='color: blue; font-weight: bold'>curl http://[::1]:8080</span> curl: (7) Failed to connect to ::1 port 8080 after 0 ms: Couldn't connect to server </pre> <br /> 위와 같은 동작의 이유는 간단합니다. "localhost" 바인딩은 "0.0.0.0"이 아닌 "127.0.0.1"에 대한 요청만 허용하기 때문에 컨테이너 외부에서 들어오는 요청에는 반응할 수 없습니다.<br /> <br /> 그나저나, 위의 출력에서 "Container 외부에서 실행"하는 경우 curl의 출력이 "Empty reply from server"인 것이 좀 이상하지 않나요? ^^ 원래는 "Couldn't connect to server"라고 나와야 하는데요, 분량상 <a target='tab' href='https://www.sysnet.pe.kr/2/0/13549#docker_backend'>이에 대해서는 다른 글</a>에서 자세하게 더 다뤄보겠습니다.<br /> <br /> <hr style='width: 50%' /><br /> <a name='ipv6_loopback_bind'></a> <br /> 중요한 것은 아니지만, 여기서 하나 더 테스트를 해보겠습니다. ^^ 이를 위해 "appsettings.json", 만약 디버깅 중이라면 "appsettings.Development.json" 파일의 내용 중 "Microsoft.AspNetCore" 설정을 "Warning"에서 "Information"으로 바꿔 보겠습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > { "DetailedErrors": true, "Logging": { "LogLevel": { "Default": "Information", // "Microsoft.AspNetCore": "Warning" <span style='color: blue; font-weight: bold'>"Microsoft.AspNetCore": "Information"</span> } } } </pre> <br /> 이 상태에서 다시 F5 디버깅을 시도하면 이제 컨테이너 출력에는 다음과 같은 내용이 포함됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > // ...[생략]... info: Microsoft.AspNetCore.Server.Kestrel[0] <span style='color: blue; font-weight: bold'>Unable to bind to http://localhost:8080 on the IPv6 loopback interface: 'Cannot assign requested address'.</span> info: Microsoft.Hosting.Lifetime[14] Now listening on: <span style='color: blue; font-weight: bold'>http://localhost:8080</span> // ...[생략]... </pre> <br /> 지난 글에서 다룬 바로 그 내용이,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > 리눅스 - "Docker Desktop for Windows" Container 환경에서 IPv6 Loopback Address 바인딩 오류 ; <a target='tab' href='https://www.sysnet.pe.kr/2/0/13540'>https://www.sysnet.pe.kr/2/0/13540</a> </pre> <br /> ASP.NET Core 웹 프로젝트의 경우에도 그대로 발생하는 것입니다.<br /> </p><br /> <br /><hr /><span style='color: Maroon'>[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]</span> </div>
첨부파일
스팸 방지용 인증 번호
6437
(왼쪽의 숫자를 입력해야 합니다.)