네트워크·보안
공개 문서 변환기를 internal 네트워크로 분리한 구성
로그인 없이 공개한 문서 변환기에서 gateway와 LibreOffice 변환기를 Docker internal 네트워크로 분리하고, 재생성 뒤 DNS 재해결까지 적용한 과정입니다.
업로드 문서를 여는 converter를 외부 경로에서 떼어냈습니다
로그인 없이 공개하는 웹 문서 변환기를 운영하면서, 파일을 실제로 여는 위치를 gateway와 분리했습니다. 이미지와 PDF는 브라우저 안에서 처리하지만 DOCX·DOC·XLSX·XLS·CSV·PPTX·PPT와 HWP·HWPX는 NAS의 변환 서버로 보냅니다.
변환 서버에서는 Go로 만든 job API가 LibreOffice를 실행합니다. 사용자가 올린 문서를 LibreOffice가 여는 구조이므로, 이 컨테이너가 인터넷에 직접 나갈 이유는 없다고 판단했습니다.
문서 안의 외부 참조나 변환 엔진의 취약점이 문제가 되더라도 converter에서 바깥으로 나가는 경로를 두지 않는 것이 분리의 목표였습니다. 변환 API를 호스트에 직접 게시하지 않고 gateway만 경계에 두는 방향으로 구성했습니다.
DSM 역방향 프록시와 nginx gateway로 요청 경로를 나눴습니다
요청은 브라우저에서 HTTPS로 들어와 DSM 역방향 프록시에서 TLS를 처리합니다. 역방향 프록시는 loopback에만 게시한 nginx gateway로 HTTP 요청을 넘기고, gateway는 정적 파일과 API 전달을 맡습니다.
이전에는 Web Station의 Apache로 정적 파일을 제공했습니다. 하지만 이 NAS의 Apache에는 프록시 모듈이 없어 /api/ 요청을 converter로 전달할 수 없었습니다.
그래서 DSM 역방향 프록시가 Apache 대신 gateway를 가리키도록 바꿨습니다. gateway에서는 /api/ location만 converter로 넘기며, Authorization 헤더는 전달하지 않습니다.
변환 요청 응답은 성공 여부와 관계없이 Cache-Control: no-store를 붙였습니다. 업로드 본문 크기는 50MiB와 multipart 처리 여유분을 고려하는 값으로 두었습니다.
gateway에는 두 네트워크를, converter에는 internal만 붙였습니다
Docker 네트워크는 gateway 게시 포트용 기본 네트워크와 converter 통신 전용 internal 네트워크로 나눴습니다. gateway는 두 네트워크에 모두 연결하고, converter는 internal 네트워크에만 연결했습니다.
internal 네트워크에는 internal: true를 지정했습니다. 이 네트워크는 바깥으로 나가는 경로가 없으므로 converter는 gateway를 통한 내부 요청만 받도록 배치됩니다.
converter에는 호스트 게시 포트를 두지 않았습니다. 호스트가 직접 받는 대상은 gateway뿐이며, converter의 API는 internal 네트워크에 연결된 gateway에서만 접근합니다.
services:
web:
image: nginx:1.30.6-alpine
security_opt:
- no-new-privileges:true
networks:
- default
- internal
converter:
user: "10001:10001"
read_only: true
cap_drop:
- ALL
security_opt:
- no-new-privileges:true
mem_limit: 4g
networks:
- internal
healthcheck:
test: ["CMD", "/usr/local/bin/converter", "healthcheck"]
networks:
default: {}
internal:
internal: true
네트워크 분리와 별도로 converter의 실행 조건도 제한했습니다. 실행 사용자, 읽기 전용 루트 파일시스템, capability 전체 제거, 신규 권한 획득 방지, 메모리 제한을 함께 적용했습니다.
converter 재생성 뒤의 오래된 IP는 nginx DNS 재해결로 피했습니다
internal 네트워크에 분리하는 것만으로는 컨테이너 재생성 문제를 해결할 수 없었습니다. nginx에서 upstream 이름을 그대로 쓰면 기동 시점에 한 번만 이름을 해석하고, 이후에는 그 IP를 계속 사용합니다.
converter 컨테이너를 다시 만들어 IP가 바뀌면 gateway가 이전 IP로 요청을 보낼 수 있습니다. 이를 피하려고 converter 주소를 변수에 넣고, nginx resolver가 이름을 다시 찾도록 바꿨습니다.
resolver 127.0.0.11 valid=10s ipv6=off; resolver_timeout 5s; set $bakkwo_converter converter:8080; proxy_pass http://$bakkwo_converter;
127.0.0.11은 사용자 정의 Docker 네트워크에서 컨테이너에 제공되는 내장 DNS입니다. 따라서 web을 기본 bridge 네트워크에 띄우는 구성에서는 이 resolver를 그대로 사용할 수 없습니다.
proxy_pass에 변수를 사용했기 때문에 nginx는 resolver로 converter 이름을 다시 찾습니다. 유효 시간 동안에는 같은 결과를 쓰고, 기간이 지나면 새 주소를 반영합니다.
이 구성으로 바꾼 뒤 converter가 없어도 web은 기동합니다. converter가 없는 동안에는 변환 요청을 처리할 수 없으므로 /api/만 502가 되고, 정적 파일을 제공하는 gateway 자체는 시작 상태를 유지합니다.
네트워크 경계와 양쪽 통신을 컨테이너 안에서 확인했습니다
적용 뒤에는 네트워크 속성, converter 실행 조건, 외부 이름 조회, gateway에서의 상태 요청을 차례로 확인했습니다. 설정 파일만 보는 대신 실제 컨테이너에서 내부와 외부 방향을 각각 점검했습니다.
| 점검 항목 | 실측 결과 |
|---|---|
| internal 네트워크 | internal=true, driver는 bridge |
| converter 실행 조건 | user=10001:10001, ro=true, caps=[ALL] |
| converter의 호스트 게시 포트 | ports=map[] |
| converter 안의 외부 이름 조회 | DNS_FAIL |
| gateway에서 converter 상태 요청 | {"status":"ok"} |
| gateway 안의 converter 이름 조회 | 사설 주소로 converter 이름 해석 |
converter 안에서는 외부 이름을 조회하지 못했고, gateway에서는 internal 네트워크의 converter 이름을 해석한 뒤 상태 API까지 호출했습니다. 외부 통신을 요구하지 않는 변환 프로세스와 내부 프록시 경로가 분리된 상태를 함께 확인한 결과입니다.
inspect 결과에서는 converter에 호스트 게시 포트가 없고, 읽기 전용 루트 파일시스템 및 capability 제거 설정도 적용된 상태였습니다. gateway를 거치지 않는 직접 접근 경로가 없는지 확인할 때 이 출력이 기준이 됐습니다.
converter 부재 때 API 502를 감수하고 gateway 기동을 지켰습니다
converter가 없으면 변환 요청은 성공할 수 없으므로 API 오류는 남습니다. 다만 converter 부재 때문에 정적 파일 제공까지 멈추는 동작은 피했습니다.
대안으로 converter를 다시 만들 때마다 web도 함께 재생성하는 절차를 둘 수 있었습니다. 저는 사람이 그 순서를 빠뜨렸을 때의 장애를 줄이기 위해, gateway가 converter 이름을 다시 해석하는 구조를 선택했습니다.
이후 점검에서는 internal 네트워크 속성, converter의 게시 포트 부재, converter 내부의 외부 이름 조회, gateway의 상태 요청, nginx resolver 설정을 순서대로 확인하면 됩니다. 이 다섯 항목이 맞으면 gateway와 변환 프로세스 사이의 경계와 통신 상태를 함께 판단할 수 있습니다.