호스트의 DNS는 작동하면서 컨테이너의 DNS는 실패할 수 있습니다. 컨테이너가 다른 리졸버 경로, 네임스페이스, 방화벽 경로 또는 Docker 전달 상태를 사용하기 때문입니다.
홈 서버에서는 호스트가 라우터, Pi-hole 또는 VPN 리졸버를 직접 조회하는 반면, 브리지 네트워크의 컨테이너는 Docker의 내장 리졸버나 복사된 resolv.conf를 통해 요청을 보낼 수 있습니다. 가장 빠른 진단 방법은 먼저 IP 주소를 테스트한 다음 장애가 발생한 컨테이너에서 각 리졸버를 명시적으로 조회해 DNS 장애와 일반적인 외부 연결 장애를 구분하는 것입니다.
DNS 장애와 일반 네트워크 장애 구분
장애가 발생한 컨테이너에서 호스트 이름을 테스트하기 전에 알려진 외부 IP와 사용할 DNS 서버의 IP 주소에 연결되는지 확인하세요. 경로, 패킷 손실, TCP 및 UDP 포트 53에 연결할 수 있는지 기록하세요.
Manjaro 컨테이너 사례는 반대 상황을 보여줍니다. 직접 IP 트래픽도 실패해 문제가 DNS에만 국한되지 않았음을 확인했습니다. 이 직접 IP 연결 테스트를 통해 리졸버 설정 변경으로 브리지, NAT 또는 방화벽 경로의 장애를 가리지 않도록 하세요.
IP 연결이 실패하면 먼저 컨테이너 네트워킹을 복구하세요. IP 연결은 되지만 이름 조회가 실패하면 리졸버 설정과 조회 경로를 계속 확인하세요.
컨테이너 내부의 리졸버 설정 검사
컨테이너 내부의 /etc/resolv.conf를 읽고 호스트의 파일과 비교하세요. 네임서버 주소, 검색 도메인, 옵션, 네트워크 모드, 컨테이너를 다시 만든 뒤 파일이 바뀌는지 확인하세요.
OpenMediaVault 사례에서는 런타임 업데이트 후 Docker의 내장 127.0.0.11 리졸버를 통한 컨테이너 조회가 실패했다고 보고했습니다. 이 내장 리졸버 경로는 호스트의 정상적인 조회 경로와 다를 수 있습니다.
실행 중인 컨테이너 내부에서 자동 생성된 파일을 영구적으로 수정하지 마세요. 컨테이너를 다시 만들어도 설정이 유지되도록 의도한 DNS 서버와 검색 도메인을 compose 또는 플랫폼 설정에 지정하세요.
Docker DNS와 업스트림 리졸버를 각각 조회하세요
Docker의 내장 리졸버, 라우터 또는 로컬 DNS 서버, 그리고 정책이 허용하는 경우 알려진 외부 리졸버를 대상으로 같은 조회를 실행하세요. 시간 초과, 거부, NXDOMAIN, 반환된 주소를 비교하세요.
TrueNAS 커뮤니티 사례에서는 다른 호스트 트래픽은 정상인데 라우터 액세스 프로필이 요청을 차단해 컨테이너에서만 DNS 장애가 발생한 것으로 밝혀졌습니다. 결정적인 관찰 결과는 잘못된 호스트 이름이 아니라 컨테이너 경로의 DNS 차단이었습니다.
직접 업스트림 쿼리는 성공하지만 내장 리졸버가 실패하면 Docker의 리졸버와 네트워크 상태를 다시 시작하거나 복구하세요. 모든 DNS 서버가 시간 초과되면 53번 포트 라우팅, 방화벽, VPN, 응답 트래픽을 점검하세요.
로컬 DNS 루프와 잘못된 내부 응답 확인하기
컨테이너가 같은 호스트의 DNS 서비스, 다른 컨테이너 또는 리버스 프록시를 통해 되돌아오는 호스트 이름 중 무엇을 조회하려는지 확인하세요. 모든 조회가 성공했다고 해서 응답이 올바르다고 단정하지 말고, 실제 응답을 캡처하세요.
Traefik 커뮤니티 사례에서는 한 컨테이너가 사용자 지정 도메인을 의도한 피어가 아닌 자기 자신으로 확인했습니다. 이 잘못된 컨테이너 측 DNS 응답은 기본적인 이름 확인 테스트는 통과했지만 API 연결은 계속 실패하게 했습니다.
같은 네트워크의 컨테이너 간 트래픽에는 서비스 이름을 사용하고, 반환 경로가 확실할 때만 공개 호스트 이름에 분할 DNS를 사용하세요. 로컬 종속성에 도달하기 위해 컨테이너가 공개 프록시를 통과하는 헤어핀 경로는 명시적으로 테스트한 경우가 아니라면 피하세요.
UDP 응답, NAT, 네트워크 격리 확인하기
컨테이너 인터페이스와 호스트 브리지에서 53번 포트 트래픽을 캡처하세요. 쿼리가 전송되고 리졸버가 이를 수신하며, 클라이언트가 예상하는 주소에서 응답이 돌아오는지 확인하세요.
Pi-hole 사용자들은 응답이 예상치 못한 변환 소스에서 돌아와 같은 호스트의 컨테이너 쿼리가 시간 초과되는 사례를 보고했습니다. 이러한 예상치 못한 DNS 응답 소스를 확인하면 응답 경로 문제와 응답이 없는 리졸버를 구분할 수 있습니다.
요청과 응답이 서로 다른 Docker 네트워크를 오간다면 모든 서비스를 호스트 네트워킹으로 옮기지 말고 올바른 공유 네트워크나 경로를 추가하세요. 브리지 서브넷을 호스트 주소와 다르게 처리할 수 있는 방화벽 영역과 VPN 정책도 확인하세요.
네트워크 상태를 재생성하고 수정 사항 검증하기
리졸버, 방화벽 또는 네트워크 정의를 수정한 후, 의도한 네트워크에서 테스트 컨테이너 하나를 재생성하고 IP, 직접 리졸버, 내장 리졸버, 서비스 이름, 공개 이름 테스트를 다시 수행하세요.
IP 주소 문제와 이름 확인 문제를 구분하는 방법에 대한 ZimaSpace 가이드에서 호스트 측 진단의 다음 단계를 확인할 수 있습니다.
DNS 구성 설정이 컨테이너 재생성과 재부팅 후에도 유지되고, 내부 서비스 이름과 승인된 공개 이름이 의도한 주소를 반환하며, 애플리케이션 트래픽이 동일한 네트워크 경로를 통해 성공할 때만 문제가 해결된 것입니다. Docker 업데이트 후에만 문제가 다시 발생한다면, 런타임 회귀가 시작된 경계를 확인할 수 있도록 버전과 데몬 로그를 보존하세요.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



