Skip to main content

Compose 작성법 (네트워크)

network template

 

  # 참고: Docker 기본 설정은 bridge 네트워크 약 30개가 한도.
  # "could not find an available, non-overlapping IPv4 address pool" 에러가 나면 이 문제.

networks:
  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에 붙일지는 여전히 정해야 합니다. 대신 동작 원리를 따질 필요 없이 **"일단 막고, 안 되면 연다"**는 규칙으로 바꾸면 됩니다.

  1. host 모드가 필요한 서비스(HA, matter, Plex)는 예외로 둡니다. 이건 지금처럼 이미 정해져 있어요.
  2. 나머지 모든 서비스는 일단 in에만 붙입니다.
  3. 배포해 보고 포트 접속이 안 되거나 인터넷이 필요해서 에러가 나면 out를 추가합니다.
  4. Caddy에 DDNS를 걸어둔 서비스면 proxy를 추가합니다.

이 방식이 잘 동작하는 이유는 실수했을 때 항상 시끄럽게 실패하기 때문입니다. 필요한 걸 막았으면 바로 에러가 나고, 고치면 끝나요. 반대로 불필요하게 열어두는 조용한 실수는 3번 규칙 덕분에 생기지 않습니다.

앞에서 말한 핵심이 그대로 남습니다. ports:로 연 포트는 어떤 네트워크 구성이든 LAN 전체에 열립니다. C 구성을 해도 mosquitto의 1883과 zigbee2mqtt의 9080은 지금과 똑같이 노출돼요. 그러니 C는 "포트를 열지 않은 서비스의 격리"를 자동화해주는 것이고, 포트를 연 서비스는 앱 자체 인증(mosquitto 비밀번호, z2m auth_token)이 따로 필요합니다. 이건 네트워크 구성과 별개로 꼭 챙기세요.