n8n 도커 설치했는데 5678 포트 접속 안됨 해결

도커(Docker)로 n8n을 설치했는데 5678 포트로 접속되지 않는 문제는 주로 포트 포워딩 누락, 방화벽 차단, 컨테이너 실행 실패, 또는 바인딩 주소 문제로 인해 발생합니다.

하나씩 체크하면서 해결해 보세요.

1. 도커 실행 명령어(포트 포워딩) 확인

도커 컨테이너를 실행할 때 외부 포트와 내부 포트를 연결하는 -p 5678:5678 옵션이 누락되었거나 잘못되었을 수 있습니다.

원인: 만약 실행 명령어에 -p 5678:5678이 없었다면 컨테이너 내부에서는 n8n이 돌고 있지만, PC나 서버 외부에서는 접근할 수 없습니다.

해결 방법: 기존 컨테이너를 삭제하고 포트 옵션을 명확히 주어 다시 실행합니다.

Bash

# 기존 컨테이너 중지 및 삭제
docker stop n8n
docker rm n8n

# 포트 포워딩을 포함하여 재실행
docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

명령어는 정상 입력했으나 n8n 컨테이너가 어떤 이유(권한 오류, 디렉토리 문제 등)로 실행 직후 종료되었을 수 있습니다.

터미널에 아래 명령어를 입력해 상태를 확인합니다:
Bash
docker ps -a
체크 포인트: STATUS 열을 확인하세요.
- Up ... hours 라고 되어 있으면 정상 실행 중입니다.
- Exited (1) ... 처럼 종료되어 있다면 컨테이너가 죽은 것입니다.
에러 로그 확인: 컨테이너가 죽어있다면 아래 명령어로 원인을 파악해야 합니다.
Bash
docker logs n8n
(로그에 권한 오류(Permission denied)가 있다면 볼륨 매핑한 폴더(~/.n8n)의 소유권이나 권한을 수정해야 합니다.)

오라클 클라우드, AWS, 네이버 클라우드 같은 클라우드 환경이거나 우분투/리눅스 서버 자체 방화벽이 켜져 있는 경우입니다.

클라우드 인스턴스인 경우: 해당 클라우드 콘솔(웹사이트)로 이동하여 보안 그룹(Security Group) 또는 서브넷 ACL에서 TCP 5678 포트 인바운드(Inbound)를 열어주어야 합니다.
리눅스 자체 방화벽(UFW)인 경우: 서버 터미널에서 5678 포트를 허용해 줍니다.
Bash
sudo ufw allow 5678/tcp sudo ufw reload

접속하려는 환경에 따라 웹 브라우저 주소창에 입력하는 주소가 달라야 합니다.

내 PC(로컬)에 설치한 경우: http://localhost:5678 또는 http://127.0.0.1:5678
가상머신(Docker Desktop, WSL2 등)인 경우: 간혹 로컬호스트 바인딩이 꼬이는 경우가 있습니다. 이 때는 가상머신의 실제 내부 IP나 http://192.168.x.x:5678 형태의 사설 IP로 접근해야 할 수 있습니다.
원격 서버(AWS 등)인 경우: http://서버의공인IP:5678

윈도우나 맥에서 Docker Desktop을 사용하는 경우, 간혹 포트 매핑 엔진이 먹통이 될 때가 있습니다.

해결 방법: Docker Desktop 프로그램을 완전히 종료(Quit)한 뒤 관리자 권한으로 다시 실행해 보세요. 혹은 대시보드(Dashboard)에서 n8n 컨테이너의 Port 항목이 5678:5678로 정상 활성화(파란색 링크 형태)되어 있는지 확인하고 클릭하여 접속해 보세요.