콘텐츠로 이동
📣 인포그랩에서 OpenAI 기술 기반으로 자체 개발한 자동화 번역 프로그램을 통해 n8n 공식 문서의 한글판을 국내 최초로 제공합니다.

n8n 공식 기술 문서 한글판 by 인포그랩

Docker-Compose#

Docker와 Docker-Compose를 이미 설치했다면, 4단계부터 시작할 수 있습니다.

다양한 아키텍처에 대한 Docker Compose 구성은 n8n-hosting repository에서 찾을 수 있습니다.

자체 호스팅 사전 요구 사항

n8n을 자체 호스팅하려면 다음과 같은 기술적 지식이 필요합니다:

  • 서버 및 컨테이너 설정 및 구성
  • 애플리케이션 리소스 관리 및 확장
  • 서버 및 애플리케이션 보안 강화
  • n8n 구성

n8n은 전문가 수준의 사용자에게 자체 호스팅을 권장합니다. 실수로 인해 데이터 손실, 보안 문제, 서비스 중단이 발생할 수 있습니다. 서버 관리 경험이 부족한 경우, n8n은 n8n Cloud 사용을 추천합니다.

최신 및 차기 버전

n8n은 대부분의 주에 새로운 마이너 버전을 출시합니다. latest 버전은 프로덕션 환경에서 사용하도록 설계된 안정적인 버전입니다. next 버전은 가장 최근에 출시된 버전으로, 베타 버전으로 간주해야 하며 불안정할 수 있습니다. 문제를 발견하면 포럼에서 보고해 주세요.

현재 latest: 1.77.3
현재 next: 1.78.0

1. Docker 설치#

사용하는 Linux 배포판에 따라 다를 수 있습니다. 자세한 지침은 Docker 문서에서 확인할 수 있습니다. 아래 예는 Ubuntu에 대한 것입니다:

1
2
3
4
5
6
7
8
9
sudo apt-get remove docker docker-engine docker.io containerd runc
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

2. 선택사항: 비루트 사용자 접근#

docker를 실행할 수 있도록 허용된 사용자로 로그인한 상태에서 실행하세요:

1
2
sudo usermod -aG docker ${USER}
su - ${USER}

3. Docker-Compose 설치#

사용하는 Linux 배포판에 따라 다를 수 있습니다. 자세한 지침은 Docker 문서에서 확인할 수 있습니다.

아래 예는 Ubuntu에 대한 것입니다:

1
sudo apt-get install docker-compose-plugin

4. DNS 설정#

서브도메인을 적절하게 라우팅하기 위해 A 레코드를 추가하세요:

1
2
3
Type: A
Name: n8n (또는 원하는 서브도메인)
IP address: <IP_OF_YOUR_SERVER>

5. Docker Compose 파일 만들기#

docker-compose.yml 파일을 생성하세요. 파일에 다음 내용을 붙여넣으세요:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
version: "3.7"

services:
  traefik:
    image: "traefik"
    restart: always
    command:
      - "--api=true"
      - "--api.insecure=true"
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.web.http.redirections.entryPoint.to=websecure"
      - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
      - "--entrypoints.websecure.address=:443"
      - "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
      - "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
      - "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - traefik_data:/letsencrypt
      - /var/run/docker.sock:/var/run/docker.sock:ro

  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    labels:
      - traefik.enable=true
      - traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
      - traefik.http.routers.n8n.tls=true
      - traefik.http.routers.n8n.entrypoints=web,websecure
      - traefik.http.routers.n8n.tls.certresolver=mytlschallenge
      - traefik.http.middlewares.n8n.headers.SSLRedirect=true
      - traefik.http.middlewares.n8n.headers.STSSeconds=315360000
      - traefik.http.middlewares.n8n.headers.browserXSSFilter=true
      - traefik.http.middlewares.n8n.headers.contentTypeNosniff=true
      - traefik.http.middlewares.n8n.headers.forceSTSHeader=true
      - traefik.http.middlewares.n8n.headers.SSLHost=${DOMAIN_NAME}
      - traefik.http.middlewares.n8n.headers.STSIncludeSubdomains=true
      - traefik.http.middlewares.n8n.headers.STSPreload=true
      - traefik.http.routers.n8n.middlewares=n8n@docker
    environment:
      - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  traefik_data:
    external: true
  n8n_data:
    external: true

n8n로 로컬 파일을 읽거나 쓸 계획이라면 (예: Read/Write Files from Disk node을 사용하여) 여기서 해당 파일을 위한 데이터 디렉토리를 구성해야 합니다. n8n을 루트 사용자로 실행하는 경우, n8n 서비스의 volumes 아래에 다음을 추가하세요:

1
- /local-files:/files

n8n을 비루트 사용자로 실행하는 경우, n8n 서비스의 volumes 아래에 다음을 추가하세요:

1
- /home/<YOUR USERNAME>/n8n-local-files:/files

이제 n8n의 /files 디렉토리에 파일을 쓸 수 있으며, 해당 파일은 서버의 /local-files 또는 /home/<YOUR USERNAME>/n8n-local-files에 각각 나타날 것입니다.

6. .env 파일 만들기#

.env 파일을 만들고 그에 맞게 변경하세요.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
# 서비스할 최상위 도메인
DOMAIN_NAME=example.com

# 서비스할 서브도메인
SUBDOMAIN=n8n

# DOMAIN_NAME과 SUBDOMAIN을 결합하여 n8n이 접근 가능한 위치를 결정합니다
# 위의 예시에서 결과는: https://n8n.example.com

# Cron-Node에 의해 기본적으로 사용되는 선택적 타임존 설정
# 설정하지 않으면 뉴욕 시간이 사용됩니다
GENERIC_TIMEZONE=Europe/Berlin

# SSL 인증서 생성을 위해 사용할 이메일 주소
SSL_EMAIL=user@example.com

7. 데이터 폴더 만들기#

n8n_data로 정의된 도커 볼륨을 생성하세요. n8n은 이 볼륨에 SQLite의 데이터베이스 파일과 암호화 키를 저장합니다.

1
sudo docker volume create n8n_data

Traefik 데이터에 대한 볼륨을 생성하세요. 이는 traefik_data로 정의됩니다.

1
sudo docker volume create traefik_data

8. Docker Compose 시작#

n8n은 이제 다음을 통해 시작할 수 있습니다:

1
sudo docker compose up -d

컨테이너를 중지하려면:

1
sudo docker compose stop

9. 완료#

n8n은 이제 위에서 정의한 서브도메인 + 도메인 조합을 사용하여 접근할 수 있습니다. 위의 예시에서 결과는: https://n8n.example.com

n8n은 https를 사용하여서만 접근할 수 있으며 http를 사용하여서는 안 됩니다.

n8n 인스턴스 보호

n8n 인스턴스에 대해 인증 설정 을 설정했는지 확인하세요.

다음 단계#

인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!