Hetzner 클라우드에서 n8n 호스팅#

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

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

Self-hosting knowledge prerequisites

Self-hosting n8n requires technical knowledge, including:

Setting up and configuring servers and containers
Managing application resources and scaling
Securing servers and applications
Configuring n8n

n8n recommends self-hosting for expert users. Mistakes can lead to data loss, security issues, and downtime. If you aren't experienced at managing servers, n8n recommends n8n Cloud.

Latest and Next versions

n8n releases a new minor version most weeks. The latest version is for production use. next is the most recent release. You should treat next as a beta: it may be unstable. To report issues, use the forum.

Current latest: 1.99.1
Current next: 1.100.1

서버 생성#

Hetzner 클라우드 콘솔에 로그인합니다.
서버를 호스팅할 프로젝트를 선택하거나 + 새 프로젝트를 선택하여 새 프로젝트를 만듭니다.
추가하려는 프로젝트 타일에서 + 서버 생성을 선택합니다.

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

유형

서버를 생성할 때 Hetzner는 플랜을 선택하도록 요청합니다. 대부분의 사용 수준에서는 CPX11 유형으로 충분합니다.

SSH 키

Hetzner는 SSH와 암호 기반 인증 중에서 선택할 수 있습니다. SSH가 더 안전합니다. 이 가이드의 나머지 부분에서는 SSH를 사용한다고 가정합니다.

서버에 로그인#

이 가이드의 나머지 부분에서는 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에는 일련의 폴더와 구성 파일이 필요합니다. 이 리포지토리에서 서버의 루트 사용자 폴더로 복제할 수 있습니다. 다음 단계에서는 변경할 파일과 변경할 내용을 알려줍니다.

다음 명령으로 리포지토리를 복제합니다.

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

그리고 복제한 리포지토리의 루트로 디렉토리를 변경합니다.

1	`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 파일에는 자체 값으로 바꿔야 하는 자리 표시자가 포함되어 있습니다.

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

1	`nano .env`

파일에는 변경할 내용을 알 수 있도록 인라인 주석이 포함되어 있습니다.

자세한 내용은 환경 변수를 참조하십시오.

Docker Compose 파일#

Docker Compose 파일(docker-compose.yml)은 이 경우 Caddy와 n8n과 같이 애플리케이션에 필요한 서비스를 정의합니다.

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

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

1	`nano docker-compose.yml`

Caddy 구성#

Caddy는 어떤 도메인을 제공해야 하는지, 외부 세계에 어떤 포트를 노출해야 하는지 알아야 합니다. caddy_config 폴더의 Caddyfile 파일을 편집합니다.

1	`nano caddy_config/Caddyfile`

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

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

업데이트#

If you run n8n using a Docker Compose file, follow these steps to update n8n:

# Navigate to the directory containing your docker compose file
cd </path/to/your/compose/file/directory>

# Pull latest version
docker compose pull

# Stop and remove older version
docker compose down

# Start the container
docker compose up -d

다음 단계#

Learn more about configuring and scaling n8n.
Or explore using n8n: try the Quickstarts.