DigitalOcean에서 n8n 호스팅
이 호스팅 가이드는 DigitalOcean Droplet에서 n8n을 셀프 호스팅하는 방법을 안내합니다. n8n 셀프 호스팅에는 다음을 포함한 기술적 지식이 필요합니다: n8n은 전문 사용자에게 셀프 호스팅을 권장합니다.
이 호스팅 가이드는 DigitalOcean Droplet에서 n8n을 셀프 호스팅하는 방법을 안내합니다. 다음을 사용합니다:
- Caddy(리버스 프록시)를 사용하여 인터넷에서 Droplet에 접근할 수 있도록 합니다. Caddy는 또한 n8n 인스턴스에 대한 SSL/TLS 인증서를 자동으로 생성하고 관리합니다.
- Docker Compose를 사용하여 애플리케이션 구성 요소와 그 상호 작용 방식을 생성하고 정의합니다.
n8n 셀프 호스팅에는 다음을 포함한 기술적 지식이 필요합니다:
- 서버 및 컨테이너 설정 및 구성
- 애플리케이션 리소스 관리 및 확장
- 서버 및 애플리케이션 보안
- n8n 구성
n8n은 전문 사용자에게 셀프 호스팅을 권장합니다. 실수하면 데이터 손실, 보안 문제, 다운타임이 발생할 수 있습니다. 서버 관리 경험이 없다면 n8n Cloud를 권장합니다.
n8n은 매주 새로운 마이너 버전을 릴리스합니다. stable 버전은 프로덕션 사용을 위한 것입니다. beta는 가장 최근 릴리스입니다. beta 버전은 불안정할 수 있습니다. 문제를 보고하려면 포럼을 이용하세요.
현재 stable: 2.14.2
현재 beta: 2.15.0
Droplet 생성#
- DigitalOcean에 로그인합니다.
- Droplet을 호스팅할 프로젝트를 선택하거나 새 프로젝트를 생성합니다.
- 프로젝트에서 Manage 메뉴의 Droplets를 선택합니다.
- Marketplace 탭에서 제공하는 Docker 이미지를 사용하여 새 Droplet을 생성합니다.
Droplet 생성 시 DigitalOcean에서 플랜을 선택하라는 메시지가 표시됩니다. 대부분의 사용량 수준에서는 기본 공유 CPU 플랜으로 충분합니다.
DigitalOcean에서는 SSH 키 기반 인증과 비밀번호 기반 인증 중 선택할 수 있습니다. SSH 키가 더 안전한 것으로 간주됩니다.
Droplet에 로그인하고 새 사용자 생성#
이 가이드의 나머지 부분은 SSH를 사용하여 터미널로 Droplet에 로그인해야 합니다. 자세한 내용은 SSH로 Droplet에 연결하는 방법을 참조하세요.
루트 사용자로 작업하지 않도록 새 사용자를 생성해야 합니다:
- 루트로 로그인합니다.
- 새 사용자를 생성합니다:
adduser <username> - CLI의 프롬프트에 따라 사용자 생성을 완료합니다.
- 새 사용자에게 관리 권한을 부여합니다:
이제 명령 앞에usermod -aG sudo <username>sudo를 사용하여 슈퍼유저 권한으로 명령을 실행할 수 있습니다. - 새 사용자에 대한 SSH 설정 단계를 따르세요: 공개 키 인증 추가.
- Droplet에서 로그아웃합니다.
- 새 사용자로 SSH를 사용하여 로그인합니다.
설정 리포지터리 클론#
Docker Compose, n8n, Caddy에는 일련의 폴더와 설정 파일이 필요합니다. Droplet에 로그인한 사용자의 홈 폴더에 이 리포지터리에서 이 파일들을 클론할 수 있습니다. 다음 단계에서는 변경할 파일과 변경 내용을 알려줍니다.
다음 명령으로 리포지터리를 클론합니다:
git clone https://github.com/n8n-io/n8n-docker-caddy.git
클론한 리포지터리의 루트 디렉터리로 변경합니다:
cd n8n-docker-caddy
기본 폴더 및 파일#
호스트 운영 체제(DigitalOcean Droplet)는 생성한 두 폴더를 Docker 컨테이너에 복사하여 Docker에서 사용할 수 있도록 합니다. 두 폴더는 다음과 같습니다:
caddy_config: Caddy 설정 파일을 보관합니다.local_files: n8n을 사용하여 업로드하거나 추가하는 파일을 위한 폴더입니다.
Docker 볼륨 생성#
재시작 간에 Caddy 캐시를 유지하고 시작 시간을 단축하려면 Docker가 재시작 간에 재사용하는 Docker 볼륨을 생성합니다:
sudo docker volume create caddy_data
n8n 데이터를 위한 Docker 볼륨을 생성합니다:
sudo docker volume create n8n_data
DNS 설정#
n8n은 일반적으로 서브도메인에서 작동합니다. DNS 제공업체에서 서브도메인에 대한 DNS 레코드를 생성하고 Droplet의 IP 주소를 가리키도록 합니다. 정확한 단계는 DNS 제공업체에 따라 다르지만, 일반적으로 n8n 서브도메인에 대한 새 "A" 레코드를 생성해야 합니다. DigitalOcean은 DNS 용어, 구성 요소 및 개념 소개를 제공합니다.
포트 열기#
n8n은 웹 애플리케이션으로 실행되므로 Droplet은 비보안 트래픽을 위해 포트 80, 보안 트래픽을 위해 포트 443에서 들어오는 트래픽에 접근할 수 있어야 합니다.
다음 두 명령을 실행하여 Droplet의 방화벽에서 다음 포트를 엽니다:
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은 Caddy에게 docker-compose.yml 파일에 정의된 서비스 정의를 사용하라고 알려줍니다:
n8n.<domain>.<suffix> {
reverse_proxy n8n:5678 {
flush_interval -1
}
}
automate.example.com을 사용한다면 Caddyfile은 다음과 같을 수 있습니다:
automate.example.com {
reverse_proxy n8n:5678 {
flush_interval -1
}
}
Docker Compose 시작#
다음 명령으로 n8n과 Caddy를 시작합니다:
sudo docker compose up -d
몇 분이 걸릴 수 있습니다.
설정 테스트#
브라우저에서 앞서 정의한 서브도메인과 도메인 이름으로 구성된 URL을 엽니다. 앞서 정의한 사용자 이름과 비밀번호를 입력하면 n8n에 접근할 수 있습니다.
n8n 및 Caddy 중지#
다음 명령으로 n8n과 Caddy를 중지할 수 있습니다:
sudo docker compose stop
업데이트#
Docker Compose 파일을 사용하여 n8n을 실행하는 경우 다음 단계에 따라 n8n을 업데이트하세요:
# docker compose 파일이 있는 디렉토리로 이동
cd </path/to/your/compose/file/directory>
# 최신 버전 pull
docker compose pull
# 이전 버전 중지 및 제거
docker compose down
# 컨테이너 시작
docker compose up -d
