Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

(시리즈 글이 5개 있습니다.)
Linux: 69. 리눅스 - "Docker Desktop for Windows" Container 환경에서 IPv6 Loopback Address 바인딩 오류
; https://www.sysnet.pe.kr/2/0/13540

개발 환경 구성: 705. "Docker Desktop for Windows" - ASP.NET Core 응용 프로그램의 소켓 주소 바인딩(IPv4/IPv6 loopback, Any)
; https://www.sysnet.pe.kr/2/0/13548

개발 환경 구성: 706. C# - 컨테이너에서 실행하기 위한 (소켓) 콘솔 프로젝트 구성
; https://www.sysnet.pe.kr/2/0/13549

닷넷: 2226. C# - "Docker Desktop for Windows" Container 환경에서의 IPv6 DualMode 소켓
; https://www.sysnet.pe.kr/2/0/13574

닷넷: 2256. ASP.NET Core 웹 사이트의 HTTP/HTTPS + Dual mode Socket (IPv4/IPv6) 지원 방법
; https://www.sysnet.pe.kr/2/0/13616




리눅스 - "Docker Desktop for Windows" Container 환경에서 IPv6 Loopback Address 바인딩 오류

예를 들어, 다음과 같이 예제 코드를 작성한 다음,

using System.Net;
using System.Net.Sockets;

namespace ConsoleApp1;

internal class Program
{
    static void Main(string[] args)
    {
        Socket socket = new Socket(AddressFamily.InterNetworkV6, SocketType.Stream, ProtocolType.Tcp);

        IPEndPoint ep = new IPEndPoint(IPAddress.IPv6Loopback, 15000);
        socket.Bind(ep);

        Thread.Sleep(5000);

        socket.Close();
    }
}

윈도우 또는 리눅스 데스크톱에서 실행하면 잘 동작할 것입니다. 하지만, Visual Studio에서 "Add" / "Docker Support..." 메뉴를 선택해 Docker 환경에서 실행하도록 바꾸면 이제 Bind에서는 다음과 같은 오류가 발생합니다.

System.Net.Sockets.SocketException
  HResult=0x80004005
  Message=Cannot assign requested address
  Source=System.Net.Sockets
  StackTrace:
   at System.Net.Sockets.Socket.DoBind(EndPoint endPointSnapshot, SocketAddress socketAddress)
   at System.Net.Sockets.Socket.Bind(EndPoint localEP)
   at ConsoleApp1.Program.Main(String[] args)

말 그대로 IPv6의 경우 Localhost Loopback 주소에 대해서는 컨테이너 환경에서 바인딩할 수가 없는 것입니다. 이에 대해서는 Any 주소를 직접 바인딩하는 식으로 우회해야 합니다.

// 아래의 코드는 Container 환경에서도 동작
IPEndPoint ep = new IPEndPoint(IPAddress.IPv6Any, 15000);

socket.Bind(ep); // IPv6Any == "::"

그런데, 저게 별 의미가 없습니다. 왜냐하면, 애당초 컨테이너 환경을 구성하는 네트워크 자체가 (IPv6가 아닌) IPv4 환경이기 때문입니다. (잘 동작합니다. ^^)




문서에 따르면,

Enable IPv6 support
; https://docs.docker.com/config/daemon/ipv6/

IPv6를 사용하기 위해 ("Docker Desktop for Windows"의 경우 %USERPROFILE%\.docker 디렉터리에 위치한) daemon.json 파일에 다음의 내용을 추가하면 된다고 합니다.

{
	"builder": { "gc": { "defaultKeepStorage": "20GB", "enabled": true } },
	"experimental": true,
        "ip6tables":  true,
	"features": { "buildkit": true }
}

하지만, 제가 해보니까 저건 그때 당시에만 "experimental"일 뿐이었고, 현재는 통합이 된 듯합니다. 그래서 그냥 ipv6 네트워크를 곧장 생성할 수 있습니다.

c:\temp> docker network create --ipv6 --subnet 2001:0DB8::/112 ip6net

c:\temp> docker network ls
NETWORK ID     NAME      DRIVER    SCOPE
1745376123f7   bridge    bridge    local
802205405723   host      host      local
10c5265fee2d   ip6net    bridge    local
4ad2d57a8bca   none      null      local

그다음, 컨테이너를 위에서 생성한 네트워크를 사용하도록 설정한 다음,

c:\temp> docker run --rm --network ip6net -p 15000:15000 --name ConsoleApp1 -it 2dee319b7378 /bin/bash

다시 AddressFamily.InterNetworkV6 + IPAddress.IPv6Loopback 바인딩을 시도하면 정상적으로 동작하는 것을 확인할 수 있습니다.




혹시나, 실수로라도 아래와 같이 바인딩을 시도하면,

Socket socket = new Socket(AddressFamily.InterNetworkV6,
    SocketType.Stream, ProtocolType.Tcp);

IPEndPoint ep = new IPEndPoint(IPAddress.Loopback, 15000);
socket.Bind(ep);

이런 오류를 보게 될 것입니다. ^^

Unhandled exception. System.Net.Sockets.SocketException (10014): The system detected an invalid pointer address in attempting to use a pointer argument in a call.
   at System.Net.Sockets.Socket.UpdateStatusAfterSocketErrorAndThrowException(SocketError error, Boolean disconnectOnFailure, String callerName)
   at System.Net.Sockets.Socket.DoBind(EndPoint endPointSnapshot, SocketAddress socketAddress)
   at System.Net.Sockets.Socket.Bind(EndPoint localEP)
   at ConsoleApp1.Program.Main(String[] args)




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







[최초 등록일: ]
[최종 수정일: 1/30/2024]

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

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13945정성태6/7/2025365오류 유형: 960. 파이썬 + conda - mysqlclient 사용 시 "NameError: name '_mysql' is not defined" 에러
13944정성태6/7/2025368오류 유형: 959. The trust relationship between this workstation and the primary domain failed. - 네 번째 이야기
13943정성태6/6/2025510개발 환경 구성: 748. Windows + Foundry Local - 로컬에서 AI 모델 활용
13942정성태6/5/2025706오류 유형: 958. winget 설치 시 "0x80d02002 : unknown error"
13941정성태6/2/2025941닷넷: 2334. C# - cpuid 명령어를 이용한 CPU 제조사 문자열 가져오기파일 다운로드1
13940정성태6/1/20251354C/C++: 188. C++의 32비트 + Release 어셈블리 코드를 .NET으로 포팅할 때 주의할 점파일 다운로드1
13939정성태5/29/20251635오류 유형: 957. NVIDIA Triton Inference Server - version `GLIBCXX_3.4.32' not found (required by /opt/tritonserver/backends/python/triton_python_backend_stub)
13938정성태5/29/20251371개발 환경 구성: 747. 파이썬 - WSL/docker에 구성한 Triton 예제 개발 환경
13937정성태5/24/20251348개발 환경 구성: 746. Windows + WSL2 환경에서 (tensorflow 등의) NVIDIA GPU 인식
13936정성태5/23/20251176개발 환경 구성: 745. Linux / WSL 환경에 Miniconda 설치하기
13935정성태5/20/20251197파이썬 - pip 사용 시 "ImportError: cannot import name 'html5lib' from 'pip._vendor'" 오류
13934정성태5/20/20251705스크립트: 77. 파이썬 - 'urllib.request' 모듈의 명시적/암시적 로딩 차이
13933정성태5/19/20251274오류 유형: 956. Visual Studio 2022가 17.12 버전부터 업데이트 되지 않는다면?
13932정성태5/18/20251481스크립트: 76. 파이썬 - Version 문자열 다루기(semver 패키지)
13931정성태5/17/20251770스크립트: 75. 파이썬 - Cython 기본 예제 및 컴파일
13930정성태5/17/20251457개발 환경 구성: 744. 파이썬 - Windows embeddable package 환경에서 외부 패키지 사용하는 방법(ex: UFO² 환경 구성)
13929정성태5/16/20251480오류 유형: 955. 파이썬 - "Windows embeddable package" REPL 환경에서 "NameError: name 'exit' is not defined"
13928정성태5/15/20251531오류 유형: 954. UFO² - "'Invalid URL (POST /v1/chat/completions/chat/completions)'"
13927정성태5/15/20251525오류 유형: 953. OpenAI - The API request of HOST_AGENT failed: OpenAI API request exceeded rate limit: Error code: 429
13926정성태5/14/20251900개발 환경 구성: 743. LLM과 윈도우의 만남 - Desktop AgentOS UFO² 기본 환경 구성
13925정성태5/12/20252000닷넷: 2333. C# - (Console 유형의 프로젝트에서) Clipboard 연동파일 다운로드1
13924정성태5/8/20251736닷넷: 2332. C# - (JetBrains Omea Reader 대상으로) 런타임 시에 메서드 가로채기 [2]파일 다운로드1
13923정성태5/5/20251490스크립트: 74. 파이썬 - C# - Python.NET의 RunSimpleScript, Exec, Eval 차이점파일 다운로드1
13922정성태5/3/20251732스크립트: 73. 파이썬 - Windows embeddable package 버전에서 tkinter 환경 구성
13921정성태5/3/20252230오류 유형: 952. 듀얼 채널 메모리 정렬을 지키지 않은 컴퓨터의 Windows 비정상 종료 현상(Blue Screen) [2]
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...