Compose 작성법 (네트워크)
network template
networks:
# 참고: Docker 기본 설정은 bridge 네트워크 약 30개가 한도.
# "could not find an available, non-overlapping IPv4 address pool" 에러가 나면 이 문제.
proxy:
name: proxy-net
external: true
out:
name: name-net
in:
name: name-internal-net
internal: true
services:
networks:
# - proxy # Caddy가 프록시하면 주석 해제
# - out # 포트/인터넷 필요하면 주석 해제
- in
network_mode: host
서비스마다 ext에 붙일지 net에 붙일지는 여전히 정해야 합니다. 대신 동작 원리를 따질 필요 없이 **"일단 막고, 안 되면 연다"**는 규칙으로 바꾸면 됩니다.
- host 모드가 필요한 서비스(HA, matter, Plex)는 예외로 둡니다. 이건 지금처럼 이미 정해져 있어요.
- 나머지 모든 서비스는 일단
in에만 붙입니다. - 배포해 보고 포트 접속이 안 되거나 인터넷이 필요해서 에러가 나면
out를 추가합니다. - Caddy에 DDNS를 걸어둔 서비스면
proxy를 추가합니다.
이 방식이 잘 동작하는 이유는 실수했을 때 항상 시끄럽게 실패하기 때문입니다. 필요한 걸 막았으면 바로 에러가 나고, 고치면 끝나요. 반대로 불필요하게 열어두는 조용한 실수는 3번 규칙 덕분에 생기지 않습니다.
앞에서 말한 핵심이 그대로 남습니다. ports:로 연 포트는 어떤 네트워크 구성이든 LAN 전체에 열립니다. C 구성을 해도 mosquitto의 1883과 zigbee2mqtt의 9080은 지금과 똑같이 노출돼요. 그러니 C는 "포트를 열지 않은 서비스의 격리"를 자동화해주는 것이고, 포트를 연 서비스는 앱 자체 인증(mosquitto 비밀번호, z2m auth_token)이 따로 필요합니다. 이건 네트워크 구성과 별개로 꼭 챙기세요.