Compose 작성법
network template
networks:
out:
name: system-net
external: true
net:
internal: true # 스택이름_net 으로 자동 생성, 내부 전용
services:
app: # 외부 접속 필요: 양쪽
networks:
- out
- net
db: # 내부 전용: net만
networks:
- net
서비스마다 위에서부터 차례로 묻기
| 순서 | 질문 | 예 → |
|---|---|---|
| 1 | 기기 탐색(mDNS, Matter 등)이나 실제 클라이언트 IP가 필요한가? | network_mode: host |
| 2 | ports:로 포트를 여는가? |
out (격리 의미 없음. 앱 자체 인증으로 보호) |
| 3 | 다른 스택이 이름으로 찾아오는가? (Caddy 등) | out |
| 4 | 위에 다 해당 없음 (자기 스택만 접근) | net (internal) |
network_mode: host
서비스마다 ext에 붙일지 net에 붙일지는 여전히 정해야 합니다. 대신 동작 원리를 따질 필요 없이 **"일단 막고, 안 되면 연다"**는 규칙으로 바꾸면 됩니다.
- host 모드가 필요한 서비스(HA, matter, Plex)는 예외로 둡니다. 이건 지금처럼 이미 정해져 있어요.
- 나머지 모든 서비스는 일단
net에만 붙입니다. - 배포해 보고 포트 접속이 안 되거나 인터넷이 필요해서 에러가 나면
ext를 추가합니다. - Caddy에 DDNS를 걸어둔 서비스면
proxy를 추가합니다.
이 방식이 잘 동작하는 이유는 실수했을 때 항상 시끄럽게 실패하기 때문입니다. 필요한 걸 막았으면 바로 에러가 나고, 고치면 끝나요. 반대로 불필요하게 열어두는 조용한 실수는 3번 규칙 덕분에 생기지 않습니다.