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)
14001정성태8/19/2025404닷넷: 2356. .NET SDK 10 - 단일 소스 코드 파일을 빌드/실행하는 기능을 "dotnet" 명령어에 추가
14000정성태8/18/2025686오류 유형: 979. ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory
13999정성태8/15/20251135닷넷: 2355. C# 14 - (8) null 조건부 연산자 개선 - 대입문에도 사용 가능파일 다운로드1
13998정성태8/14/20251079닷넷: 2354. C# 14 - (7) 확장 메서드에 정적 메서드와 속성 지원을 위한 전용 구문 추가파일 다운로드1
13997정성태8/14/20251179Linux: 120. docker 컨테이너로 매핑된 볼륨에 컨테이너 측의 사용자 ID를 유지하면서 복사하는 방법
13996정성태8/13/2025734오류 유형: 978. Unable to find the requested .Net Framework Data Provider.
13995정성태8/13/2025747개발 환경 구성: 754. Visual C++ - 리눅스 빌드를 위한 Ubuntu 18 docker 컨테이너 설정
13994정성태8/12/2025728오류 유형: 977. SQL Server - User, group, or role '...' already exists in the current database. (Microsoft SQL Server, Error: 15023)
13993정성태8/11/20251119오류 유형: 976. Microsoft.ML.OnnxRuntimeGenAI 패키지 사용 시 "cublasLt64_12.dll" which is missing. (Error 126: "The specified module could not be found.") 오류
13992정성태8/11/20251349닷넷: 2353. C# - Foundry Local을 이용한 gpt-oss-20b 모델 사용파일 다운로드1
13991정성태8/9/20251254오류 유형: 975. winget - Foundry Local 패키지 업데이트가 안 되는 문제
13990정성태8/8/2025919Windows: 283. Time zone 설정이 없는 Windows Server 2025
13989정성태8/8/20251353닷넷: 2352. C# - Windows S-mode 환경인지 체크하는 방법파일 다운로드1
13988정성태8/8/20251496오류 유형: 974. 비주얼 스튜디오 업데이트 시 잠김 파일 경고 - Visual Studio Standard Collector Service 150 (VSStandardCollectorService150)
13987정성태8/7/20251125닷넷: 2351. C# 14 - (6) event와 생성자에도 partial 메서드 적용파일 다운로드1
13986정성태8/6/20251216닷넷: 2350. C# 14 - (5) 람다 매개 변수에 접근자가 있는 경우에도 타입 생략 가능파일 다운로드1
13985정성태8/6/20251660오류 유형: 973. "wsl --install" 명령어 수행 시 "The server name or address could not be resolved"
13984정성태8/6/20251364Windows: 282. 윈도우 운영체제에 추가된 ssh 서버(Win32-OpenSSH)
13983정성태8/4/20251513오류 유형: 972. Microsoft.Data.SqlClient 6.1.0 버전부터 .NET 8 이상만 지원
13982정성태8/2/20251887개발 환경 구성: 753. CentOS 7 컨테이너 내에서 openssh 서버 호스팅
13981정성태8/1/20251528오류 유형: 971. CentOS 7에서 yum 사용 시 "Could not resolve host: mirrorlist.centos.org; Unknown error"
13980정성태7/31/20251700Linux: 119. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ (2)
13979정성태7/30/20252023Linux: 118. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ
13978정성태7/29/20251746오류 유형: 970. 파일 복사 시 "Data error (cyclic redundancy check). (0x80070017)" 에러
13977정성태7/28/20252099닷넷: 2349. C# 14 - (4) 문자열 리터럴을 utf-8 인코딩으로 저장파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...