Docker 환경에서 외부 도메인 연결 시 발생하는 404 에러 해결법

 Docker 환경에서 외부 도메인 연결 시 발생하는 404 에러 해결법

🔎 1. 404가 어디서 나는지 먼저 구분

👉 이게 핵심이다 (무조건 먼저 체크)

👉 케이스 A: 브라우저 404 화면이 “깔끔한 기본 페이지”

nginx / Caddy 느낌

👉 리버스 프록시 문제

👉 케이스 B: 사이트 디자인인데 “페이지 없음”

👉 앱(WordPress, Node 등) 문제

🌐 2. DNS 문제 (도메인이 서버를 못 찾음)

👉 도메인이 서버 IP로 안 붙으면 이상한 서버로 감

확인

ping example.com

👉 IP가 네 서버랑 다르면 문제

해결

DNS에서 A레코드 설정

예:

example.com → 서버IP

👉 Cloudflare 쓰면:

Proxy ON/OFF 확인

🔁 3. 포트포워딩 / 방화벽 문제

👉 외부 → 서버로 못 들어옴

확인

curl http://localhost

👉 서버 내부에서 되면 → 외부 문제

해결

sudo ufw allow 80

sudo ufw allow 443

👉 공유기:

80 → 서버IP

443 → 서버IP

🔀 4. Caddy / Nginx 설정 문제 (가장 많다)

5

👉 Caddy 기준 설명

❌ 문제 상황

example.com 접속 → 404

👉 이유

도메인 매칭 안됨

잘못된 포트

✅ 해결

Caddyfile 확인

example.com {

    reverse_proxy localhost:3000

}

🔥 핵심 체크

도메인 철자 맞냐?

www 포함했냐?

example.com, www.example.com {

    reverse_proxy localhost:3000

}

🐳 5. Docker 포트 매핑 문제

👉 이거 초보 90% 실수

❌ 문제

docker run -p 3000:3000 app

근데 Caddy는:

reverse_proxy localhost:80 ❌

👉 안 맞음 → 404

✅ 해결

👉 포트 맞춰라

reverse_proxy localhost:3000

📦 6. 컨테이너 내부 문제

👉 컨테이너가 아예 안 돌고 있음

확인

docker ps

👉 없으면 죽은 상태

로그 확인

docker logs 컨테이너이름

🧠 7. 도메인 vs localhost 차이

👉 이거 중요

테스트

curl localhost:3000

👉 되면 앱 정상

👉 그럼 문제는:

Caddy

DNS

포트포워딩

🚨 8. 워드프레스/앱 URL 설정 문제

👉 WordPress 자주 터짐

❌ 문제

내부 URL = localhost

외부 도메인 = example.com

👉 충돌 → 404

✅ 해결

WP_HOME

WP_SITEURL

👉 도메인으로 변경

🔥 최종 해결 체크리스트

👉 이 순서대로 보면 100% 잡힌다

1️⃣ 도메인 → 서버IP 맞냐

2️⃣ 포트포워딩 열렸냐

3️⃣ 방화벽 열렸냐

4️⃣ Docker 컨테이너 살아있냐

5️⃣ 포트 매핑 맞냐💥 한줄 핵심

6️⃣ Caddy 도메인 설정 맞냐

7️⃣ 앱 내부 URL 맞냐

💥 한줄 핵심

👉 404 = “연결은 됐는데 목적지 못 찾음”