이 호스팅 가이드는 Hetzner 클라우드 서버에서 n8n을 셀프 호스팅하는 방법을 보여줍니다. 다음을 사용합니다.

• Caddy (리버스 프록시)를 사용하여 인터넷에서 서버에 접근할 수 있도록 합니다.
• Docker Compose를 사용하여 애플리케이션 구성 요소와 이들이 함께 작동하는 방식을 생성하고 정의합니다.

n8n이 실행되고 나면, 선택 사항인 마지막 섹션에서 n8n Assistant를 추가하는 방법을 다룹니다.

서버 생성#

1. Hetzner Cloud Console에 로그인합니다.
2. 서버를 호스팅할 프로젝트를 선택하거나, + NEW PROJECT를 선택하여 새 프로젝트를 생성합니다.
3. 추가할 프로젝트 타일에서 + CREATE SERVER를 선택합니다.

필요에 맞게 대부분의 설정을 변경할 수 있지만, 이 가이드에서는 Docker를 사용하여 애플리케이션을 실행하므로 Image 섹션에서 APPS 탭의 "Docker CE"를 선택하세요.

서버에 로그인#

이 가이드의 나머지 부분은 SSH를 사용하는 터미널로 서버에 로그인해야 합니다. 자세한 내용은 SSH/rsync/BorgBackup으로 접근을 참고하세요. 프로젝트 내 서버 목록에서 공개 IP를 찾을 수 있습니다.

Docker Compose 설치#

Hetzner의 Docker 앱 이미지에는 Docker compose가 설치되어 있지 않습니다. 다음 명령으로 설치하세요.

apt update && apt -y upgrade
apt install docker-compose-plugin

구성 리포지터리 클론#

Docker Compose, n8n, Caddy에는 일련의 폴더와 구성 파일이 필요합니다. 이 리포지터리에서 이를 서버의 root 사용자 폴더로 클론할 수 있습니다. 다음 단계에서는 어떤 파일을 변경해야 하는지, 어떤 변경을 해야 하는지 안내합니다.

다음 명령으로 리포지터리를 클론합니다.

git clone https://github.com/n8n-io/n8n-docker-caddy.git

그리고 클론한 리포지터리의 루트로 디렉터리를 변경합니다.

cd n8n-docker-caddy

기본 폴더와 파일#

호스트 운영 체제(서버)는 생성한 두 폴더를 Docker 컨테이너에서 사용할 수 있도록 Docker 컨테이너로 복사합니다. 두 폴더는 다음과 같습니다.

• caddy_config: Caddy 구성 파일을 보관합니다.
• local_files: n8n을 사용하여 업로드하거나 추가하는 파일을 위한 폴더입니다.

Docker 볼륨 생성#

재시작 사이에 Caddy 캐시를 유지하고 시작 시간을 단축하려면, 재시작 사이에 Docker가 재사용하는 Docker 볼륨을 생성합니다.

docker volume create caddy_data

n8n 데이터를 위한 Docker 볼륨을 생성합니다.

sudo docker volume create n8n_data

DNS 설정#

n8n은 일반적으로 서브도메인에서 작동합니다. 서브도메인에 대한 DNS 레코드를 제공업체에서 생성하고 서버의 IP 주소를 가리키도록 지정합니다. 정확한 단계는 사용하는 DNS 제공업체에 따라 다르지만, 일반적으로 n8n 서브도메인에 대한 새로운 "A" 레코드를 생성해야 합니다. DigitalOcean은 DNS 용어, 구성 요소, 개념 소개를 제공합니다.

포트 열기#

n8n은 웹 애플리케이션으로 실행되므로 서버는 비보안 트래픽을 위한 포트 80과 보안 트래픽을 위한 포트 443에 대한 수신 접근을 허용해야 합니다.

다음 두 명령을 실행하여 서버 방화벽에서 해당 포트를 엽니다.

sudo ufw allow 80
sudo ufw allow 443

n8n 구성#

n8n은 Docker 컨테이너에서 실행되는 애플리케이션에 전달할 몇 가지 환경 변수를 설정해야 합니다. 예시 .env 파일에는 사용자 고유의 값으로 교체해야 하는 자리표시자가 포함되어 있습니다.

다음 명령으로 파일을 엽니다.

nano .env

이 파일에는 무엇을 변경해야 하는지 알려주는 인라인 주석이 포함되어 있습니다.

n8n 환경 변수에 대한 자세한 내용은 환경 변수를 참고하세요.

Docker Compose 파일#

Docker Compose 파일(docker-compose.yml)은 이 경우 Caddy와 n8n인, 애플리케이션에 필요한 서비스를 정의합니다. 별도의 데이터베이스 서비스는 없습니다. n8n은 기본적으로 내장 SQLite 데이터베이스를 사용합니다.

• Caddy 서비스 정의는 사용하는 포트와 컨테이너에 복사할 로컬 볼륨을 정의합니다.
• n8n 서비스 정의는 사용하는 포트, n8n을 실행하는 데 필요한 환경 변수(일부는 .env 파일에 정의됨), 컨테이너에 복사해야 하는 볼륨을 정의합니다.

Docker Compose 파일은 .env 파일에 설정된 환경 변수를 사용하므로 내용을 변경할 필요는 없지만, 확인해 보려면 다음 명령을 실행하세요.

nano docker-compose.yml

Caddy 구성#

Caddy는 서비스할 도메인과 외부 세계에 노출할 포트를 알아야 합니다. caddy_config 폴더의 Caddyfile 파일을 편집하세요.

nano caddy_config/Caddyfile

자리표시자 서브도메인을 사용자의 것으로 변경합니다. 서브도메인 이름을 n8n으로 지정하는 단계를 따랐다면, 전체 도메인은 n8n.example.com과 유사합니다. reverse_proxy 설정의 n8n은 docker-compose.yml 파일에 정의된 서비스 정의를 사용하도록 Caddy에 지시합니다.

n8n.<domain>.<suffix> {
    reverse_proxy n8n:5678 {
      flush_interval -1
    }
}

Docker Compose 시작#

다음 명령으로 n8n과 Caddy를 시작합니다.

docker compose up -d

몇 분 정도 걸릴 수 있습니다.

설정 테스트#

브라우저에서 이전에 정의한 서브도메인과 도메인 이름으로 구성된 URL을 엽니다. 이전에 정의한 사용자 이름과 비밀번호를 입력하면 n8n에 접근할 수 있습니다.

n8n과 Caddy 중지#

다음 명령으로 n8n과 Caddy를 중지할 수 있습니다.

sudo docker compose stop

선택 사항: n8n Assistant 추가#

n8n Assistant는 코드를 실행할 샌드박스가 필요합니다. Docker Compose 가이드에서 사용한 것과 같은 샌드박스 스택을 이 설정에 추가할 수 있습니다. 시작하기 전에 알아 두면 좋은 사항이 있습니다.

• 이 샌드박스는 로컬 개발과 테스트에 적합합니다. 아래 스택은 n8n에 내장된 자체 샌드박스(n8n-sandbox)를 사용합니다. 공개 도메인이 있는 DigitalOcean 드롭릿은 실제 운영 환경인 경우가 많으므로, 프로덕션에 사용할 예정이라면 대신 Daytona를 고려하세요.
• 필요하면 크기를 조정하세요. 샌드박스 러너는 Docker-in-Docker를 사용하므로 n8n 단독보다 더 많은 여유 자원이 필요합니다. 최소 4 GB RAM / 2 vCPU를 프로비저닝하세요.
• 네트워크 변경이 필요하지 않습니다. Caddy는 n8n 자체만 프록시하며, 샌드박스 서비스는 Compose 네트워크 내부에 머무르므로 DNS, 방화벽, Caddyfile을 변경할 필요가 없습니다.

1. 이미 있는 변수와 함께 샌드박스 시크릿을 .env에 추가합니다.

   # Sandbox service secrets — pick your own values
   SANDBOX_API_KEYS=change-me-api-key
   SANDBOX_API_RUNNER_REGISTRATION_TOKEN=change-me-registration-token
   SANDBOX_API_RUNNER_API_KEY=change-me-runner-key
   
   # Web search: secret for the bundled SearXNG instance — pick your own value
   SEARXNG_SECRET=change-me-searxng-secret
   

2. 다른 구성 파일과 같은 위치에 searxng-settings.yml 파일을 생성합니다(기본 SearXNG 이미지는 HTML만 제공하므로, 이 파일은 n8n 웹 검색에 필요한 JSON API를 활성화합니다).

   use_default_settings: true
   search:
     formats:
       - html
       - json
   

3. docker-compose.yml을 열고 기존 caddy 및 n8n 서비스와 함께 샌드박스 및 검색 서비스를 추가합니다.

   volumes:
     sandbox-tls:
   
   services:
     sandbox-certs:
       image: ghcr.io/n8n-io/n8n-sandbox-service-api:latest
       user: '0:0'
       entrypoint: ['sh', '-c']
       command:
         - >
           bootstrap-mtls.sh --out-dir /tls --api-san sandbox-api
           --control-san-prefix sandbox-runner &&
           chown -R sandbox-api:sandbox-api /tls/api
       environment:
         NUM_RUNNERS: '1'
       volumes:
         - sandbox-tls:/tls
   
     sandbox-api:
       image: ghcr.io/n8n-io/n8n-sandbox-service-api:latest
       depends_on:
         sandbox-certs:
           condition: service_completed_successfully
       environment:
         SANDBOX_API_KEYS: ${SANDBOX_API_KEYS}
         SANDBOX_API_RUNNER_REGISTRATION_TOKEN: ${SANDBOX_API_RUNNER_REGISTRATION_TOKEN}
         SANDBOX_API_RUNNER_API_KEY: ${SANDBOX_API_RUNNER_API_KEY}
         SANDBOX_API_GRPC_TLS_CERT_FILE: /tls/api/grpc-server.crt
         SANDBOX_API_GRPC_TLS_KEY_FILE: /tls/api/grpc-server.key
         SANDBOX_API_GRPC_TLS_CLIENT_CA_FILE: /tls/api/ca.crt
         SANDBOX_API_RUNNER_CONTROL_GRPC_TLS_CA_FILE: /tls/api/ca.crt
         SANDBOX_API_RUNNER_CONTROL_GRPC_TLS_CERT_FILE: /tls/api/control-grpc-api-client.crt
         SANDBOX_API_RUNNER_CONTROL_GRPC_TLS_KEY_FILE: /tls/api/control-grpc-api-client.key
         SANDBOX_API_RUNNER_CONTROL_GRPC_TLS_SERVER_NAME: sandbox-runner-1
       volumes:
         - sandbox-tls:/tls:ro
       healthcheck:
         test: ["CMD", "wget", "-qO-", "http://localhost:8080/healthz"]
         interval: 5s
         timeout: 3s
         retries: 5
         start_period: 10s
       # Never publish 8080/9090 — Caddy never routes to this service, and it shouldn't.
   
     sandbox-runner-1:
       image: ghcr.io/n8n-io/n8n-sandbox-service-runner-dind:latest
       privileged: true
       depends_on:
         sandbox-api:
           condition: service_healthy
       environment:
         SANDBOX_RUNNER_API_KEYS: ${SANDBOX_API_RUNNER_API_KEY}
         SANDBOX_RUNNER_REGISTRATION_TOKEN: ${SANDBOX_API_RUNNER_REGISTRATION_TOKEN}
         SANDBOX_RUNNER_API_GRPC_ADDR: sandbox-api:9090
         SANDBOX_RUNNER_HTTP_BASE_URL: http://sandbox-runner-1:8080
         SANDBOX_RUNNER_CONTROL_GRPC_LISTEN_ADDR: ':9091'
         SANDBOX_RUNNER_CONTROL_GRPC_ADVERTISE_ADDR: sandbox-runner-1:9091
         SANDBOX_RUNNER_ID: runner-1
         SANDBOX_RUNNER_DOCKER_SANDBOX_IMAGE: ghcr.io/n8n-io/n8n-sandbox-service-sandbox:latest
         SANDBOX_RUNNER_REGISTRATION_GRPC_CA_FILE: /tls/runner/ca.crt
         SANDBOX_RUNNER_REGISTRATION_GRPC_CERT_FILE: /tls/runner/grpc-client.crt
         SANDBOX_RUNNER_REGISTRATION_GRPC_KEY_FILE: /tls/runner/grpc-client.key
         SANDBOX_RUNNER_REGISTRATION_GRPC_SERVER_NAME: sandbox-api
         SANDBOX_RUNNER_CONTROL_GRPC_TLS_CERT_FILE: /tls/runner/control-grpc-server.crt
         SANDBOX_RUNNER_CONTROL_GRPC_TLS_KEY_FILE: /tls/runner/control-grpc-server.key
         SANDBOX_RUNNER_CONTROL_GRPC_TLS_CLIENT_CA_FILE: /tls/runner/ca.crt
       volumes:
         - sandbox-tls:/tls:ro
       # Never expose this container's ports publicly — it runs privileged Docker-in-Docker.
   
     searxng:
       image: ghcr.io/searxng/searxng:latest
       environment:
         SEARXNG_SECRET: ${SEARXNG_SECRET}
       volumes:
         - ./searxng-settings.yml:/etc/searxng/settings.yml:ro
       # Internal-only: n8n reaches it by service name. Never publish its port, and don't route Caddy to it.
   

4. 기존 n8n 서비스의 environment 블록에 대응하는 샌드박스 변수를 추가합니다.

   environment:
    # ...your existing N8N_HOST, N8N_PORT, etc. stay as they are
    - N8N_ENABLED_MODULES=instance-ai
    - N8N_INSTANCE_AI_SANDBOX_ENABLED=true
    - N8N_INSTANCE_AI_SANDBOX_PROVIDER=n8n-sandbox
    - N8N_SANDBOX_SERVICE_URL=http://sandbox-api:8080
    - N8N_SANDBOX_SERVICE_API_KEY=${SANDBOX_API_KEYS}
    - N8N_INSTANCE_AI_SEARXNG_URL=http://searxng:8080
   depends_on:
    sandbox-api:
      condition: service_healthy
   

5. 새 서비스가 변경 사항을 반영하도록 모든 서비스를 재시작합니다.

   sudo docker compose up -d
   

6. 모델 API 키를 추가합니다. 모델 제공업체를 선택하는 방법을 포함한 전체 참조는 n8n Assistant 설정을 참고하세요. 웹 검색은 위의 내장 SearXNG 서비스를 통해 별도 설정 없이 작동합니다. Brave Search를 사용하려면 대신 Brave Search 키를 추가하세요.

업데이트#

다음 단계#

관련 리소스#

• 클라우드 제공업체 사용
• DigitalOcean
• Heroku
• AWS
• Azure
• Google Cloud Run
• Google Kubernetes Engine
• OpenShift Local (CRC)
• Docker Compose 사용