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

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

서버 생성#

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인, 애플리케이션에 필요한 서비스를 정의합니다.

• 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

업데이트#

다음 단계#