n8n Docker 설치 중 포트 오류 & Not Found (HTTP 404) 해결기 (Windows)

n8n Docker 설치 중 포트 오류 & Not Found (HTTP 404) 해결기 (Windows)

n8n을 로컬에 셀프 호스팅해보고 싶어서 공식 GitHub에 올라온 self-hosted-ai-starter-kit 레포지토리를 참고해 Docker 환경을 구성했습니다.

👉 self-hosted-ai-starter-kit GitHub 링크

문서대로 따라 했을 뿐인데... Docker까지 실행했지만 페이지 접속은 실패.
Not Found, ERR_UNSAFE_PORT, 포트 충돌 등 복합적인 이슈를 겪게 됐습니다.

이 포스팅은 그 전체 디버깅과 해결 과정을 기록한 실전형 후기입니다.

---

📦 시도 1: GitHub 레포지토리 클론 → Docker 실행

git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git
cd self-hosted-ai-starter-kit
docker compose up -d

컨테이너는 정상적으로 실행됐고 로그도 깨끗하게 출력되었지만,
브라우저에서 http://localhost:5678 접속 시 이런 메시지가 떴습니다:

HTTP Error 404. The requested resource is not found.

Not Found
HTTP Error 404. The requested resource is not found.

---

🔍 원인 1: 포트는 열려 있어도 Windows가 "예약 중"

명령어로 시스템이 예약한 포트 목록을 확인해보았습니다:

netsh int ipv4 show excludedportrange protocol=tcp

결과:

5678       5678
5679       5679

n8n의 기본 포트인 5678번이 Windows 시스템 예약 포트였던 겁니다.
컨테이너는 실행됐지만, 실제로는 포트 바인딩이 실패해 브라우저에서는 404가 발생한 것이었습니다.

---

✅ 해결 1: 예약되지 않은 포트로 재구성

n8n 컨테이너를 지우고 안전한 포트(예: 8080)로 재실행합니다.

docker rm -f n8n
docker run -d --name n8n -p 8080:5678 n8nio/n8n

➡ 브라우저 주소는: http://localhost:8080
이번에는 정상적으로 n8n UI가 뜨는 것을 확인했습니다 🎉

---

🚧 문제 2: 또 다른 오류 - ERR_UNSAFE_PORT

사실 그 전에 포트를 6000으로 시도했었는데, 이런 메시지를 만났습니다:

This site can’t be reached

This site can’t be reached
ERR_UNSAFE_PORT

이건 Chrome의 보안 정책 때문입니다.
일부 포트(예: 6000, 6667 등)는 보안상 자동 차단됩니다.
→ 해결책은 다른 포트 사용 혹은 다른 브라우저(Firefox, Edge 등) 사용입니다.

---

✅ 최종 해결 방법 정리

정상 동작을 위해 사용한 최종 명령어는 아래와 같습니다:

docker rm -f n8n
docker run -d --name n8n -p 8080:5678 n8nio/n8n

브라우저에서 http://localhost:8080 으로 접속 → n8n 정상 작동 확인.

---

🧠 전체 요약

1. self-hosted-ai-starter-kit 그대로 따라 했지만 포트 문제로 접속 실패
2. netsh int ipv4 show excludedportrange protocol=tcp 명령어로 예약 포트 확인
3. 예약된 포트가 Docker 바인딩을 막고 있었음 → Not Found 발생
4. Chrome은 일부 포트를 자동 차단 → ERR_UNSAFE_PORT 발생
5. 컨테이너 이름 충돌 시 docker rm -f [이름]으로 정리 후 재실행

---

📌 참고 명령어 모음

# 시스템 예약 포트 확인
netsh int ipv4 show excludedportrange protocol=tcp

# 실행 중인 컨테이너 확인
docker ps -a

# 컨테이너 삭제
docker rm -f n8n

# n8n 실행 (포트 8080 사용)
docker run -d --name n8n -p 8080:5678 n8nio/n8n

n8n 샘플

---

✨ 후기

처음엔 공식 레포지토리를 그대로 따라 했고, Docker도 정상 실행돼서 "이제 끝났다!" 싶었는데,
의외로 포트 충돌과 브라우저 정책에 막혀 버린 접속이 가장 큰 장애물이었습니다.

n8n은 단순한 명령어 몇 줄로 실행할 수 있지만,
Windows에서는 포트 충돌 문제를 먼저 고려해야 한다는 교훈을 얻었습니다.
비슷한 문제 겪는 분들께 이 글이 실질적인 도움이 되면 좋겠습니다.