기본 컨테이너 실행

n8n을 Docker로 실행할 때 가장 많이 사용하는 설정입니다. 호스트 네트워크 모드와 볼륨 마운트를 적용합니다.

docker run -d \
  --name workflow-engine \
  --network=host \
  -v /data/n8n:/home/node/.n8n \
  -p 5678:5678 \
  -e N8N_HOST=www.lmzon.com \
  -e N8N_EDITOR_BASE_URL=https://www.lmzon.com/n8n/ \
  -e WEBHOOK_TUNNEL_URL=https://www.lmzon.com/n8n/ \
  -e N8N_PROTOCOL=https \
  -e N8N_PORT=5678 \
  -e N8N_PATH=/n8n \
  -e N8N_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  ghcr.io/n8n-io/n8n:1.18.4

프로덕션 환경 권장 설정

자동 재시작, 타임존 설정, 텔레메트리 비활성화 등 프로덕션에 적합한 구성입니다.

docker run -d \
  --name automation-server \
  --restart=unless-stopped \
  -p 5678:5678 \
  -v /data/n8n:/home/node/.n8n \
  -e TZ=Asia/Seoul \
  -e N8N_HOST=www.lmzon.com \
  -e N8N_EDITOR_BASE_URL=https://www.lmzon.com/n8n/ \
  -e WEBHOOK_TUNNEL_URL=https://www.lmzon.com/n8n/ \
  -e N8N_PROTOCOL=https \
  -e N8N_PORT=5678 \
  -e N8N_PATH=/n8n/ \
  -e N8N_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -e N8N_DIAGNOSTICS_ENABLED=false \
  ghcr.io/n8n-io/n8n:1.18.4

로컬 이미지 기반 실행

사전에 다운로드한 이미지 ID를 직접 지정하여 실행합니다.

docker run -d \
  --name n8nsw \
  --restart=unless-stopped \
  -p 5678:5678 \
  -v /data/n8n:/home/node/.n8n \
  -e TZ=Asia/Seoul \
  -e N8N_HOST=www.lmzon.com \
  -e N8N_EDITOR_BASE_URL=https://www.lmzon.com/n8n/ \
  -e WEBHOOK_TUNNEL_URL=https://www.lmzon.com/n8n/ \
  -e N8N_PROTOCOL=https \
  -e N8N_PORT=5678 \
  -e N8N_PATH=/n8n/ \
  -e N8N_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -e N8N_DIAGNOSTICS_ENABLED=false \
  45acd849e256

디버그 모드 실행

문제 해결을 위해 대화형 터미널로 실행하고 종료 시 자동 삭제됩니다.

docker run -it --rm \
  --name n8n-debug \
  -p 5678:5678 \
  -v /data/n8n:/home/node/.n8n \
  -e N8N_HOST=www.lmzon.com \
  -e N8N_EDITOR_BASE_URL=https://www.lmzon.com/n8n/ \
  -e WEBHOOK_TUNNEL_URL=https://www.lmzon.com/n8n/ \
  -e N8N_PROTOCOL=https \
  -e N8N_PORT=5678 \
  -e N8N_PATH=/n8n/ \
  -e N8N_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  ghcr.io/n8n-io/n8n:1.18.4

레지스트리 연결 오류 해결

Docker Hub 접속 시 타임아이 발생하는 경우 미러 서버를 구성합니다.

오류 메시지:

Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection

설정 파일 경로: /etc/docker/daemon.json

{
  "registry-mirrors": [
    "https://docker.registry.cyou",
    "https://docker-cf.registry.cyou",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://mirror.aliyuncs.com",
    "https://dockerproxy.com",
    "https://mirror.baidubce.com",
    "https://docker.m.daocloud.io",
    "https://docker.nju.edu.cn",
    "https://docker.mirrors.sjtug.sjtu.edu.cn",
    "https://docker.mirrors.ustc.edu.cn",
    "https://mirror.iscas.ac.cn",
    "https://docker.rainbond.cc",
    "https://do.nark.eu.org",
    "https://dc.j8.work",
    "https://gst6rzl9.mirror.aliyuncs.com",
    "https://registry.docker-cn.com",
    "http://hub-mirror.c.163.com",
    "https://mirrors.tuna.tsinghua.edu.cn",
    "https://docker.211678.top",
    "https://docker.1panel.live",
    "https://hub.rat.dev",
    "https://dockerpull.com",
    "https://dockerproxy.cn",
    "https://docker.awsl9527.cn"
  ],
  "insecure-registries": [
    "registry.docker-cn.com",
    "docker.mirrors.ustc.edu.cn"
  ],
  "debug": true,
  "experimental": false
}

설정 적용 후 Docker 데몬을 재시작합니다.

systemctl daemon-reload
systemctl restart docker

화웨이 클라우드 미러 활용

공식 이미지를 화웨이 클라우드 미러에서 가져옵니다. 텐센트 미러에는 n8n이 없습니다.

docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/n8nio/n8n

볼륨 권한 설정

컨테이너 내부 node 사용자(UID 1000)가 데이터 디렉토리에 쓰기 권한을 갖도록 설정합니다.

sudo mkdir -p /data/n8n
sudo chown -R 1000:1000 /data/n8n

호스트에 UID 1000 사용자가 없어도 숫자 ID로 소유권 변경이 가능합니다.

최소 설정 빠른 시작

테스트 환경에서 사용하는 간소화된 실행 명령입니다.

docker run -d \
  --name workflow-engine \
  -p 5678:5678 \
  -v /home/n8n:/root/.n8n \
  ghcr.io/n8n-io/n8n:1.18.4

커뮤니티 플러그인 설치

커스텀 노드 설치 방법은 공식 문서와 커뮤니티 가이드를 참조합니다.

이미지 업데이트

docker pull n8nio/n8n:latest

워크플로우 템플릿 리소스

AI 비디오 생성 및 다중 플랫폼 배포 자동화 예시:

Fully Automated AI Video Generation

중국어 지원 이미지

로컬라이즈된 버전을 사용할 경우 다음 이미지를 참고합니다.

docker pull docker.io/deluxebear/n8n:2.0.0-chs

화웨이 미러 경로:

docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/deluxebear/n8n:2.0.0-chs

템플릿 커뮤니티 목록