n8n 호스팅(Self-hosted) 버전 설치 방법

---

Zapier나 Make 같은 업무 자동화 툴을 사용하다 보면, 늘어나는 구독료와 내부 데이터 유출에 대한 보안 우려 때문에 고민하게 됩니다. 특히 기업 환경이나 개인의 민감한 데이터를 다룰 때는 외부 서버에 의존하기가 꺼려지죠.

이럴 때 최고의 대안이 바로 n8n입니다. n8n은 강력한 노드 기반의 오픈소스 자동화 플랫폼으로, 내 서버에 직접 설치(Self-hosting)하면 데이터 통제권을 완벽하게 유지하면서 비용 없이 무제한으로 사용할 수 있습니다.

오늘은 개발자나 IT 인프라 관리자들에게 가장 표준적이고 안정적인 방식인 Docker를 활용하여 n8n 호스팅 버전을 설치하는 방법을 단계별로 알아보겠습니다.

---

🛠️ 1. 설치 전 준비 사항

본 튜토리얼은 가장 널리 쓰이는 리눅스 환경(Ubuntu 등)을 기준으로 설명합니다. AWS EC2, Oracle Cloud 무료 티어, 또는 개인용 NAS 서버 등 어디든 적용할 수 있습니다.

• 운영체제: Linux (Ubuntu 20.04 또는 22.04 권장)
• 필수 프로그램: Docker 및 Docker Compose 가 미리 설치되어 있어야 합니다.

---

💻 2. n8n 설치 단계 (Docker Compose 활용)

Docker Compose를 사용하면 n8n 실행에 필요한 환경 변수와 볼륨(데이터 저장소)을 손쉽게 관리할 수 있습니다.

Step 1. n8n 디렉토리 생성 및 이동

터미널에 접속한 후, n8n의 설정 파일과 데이터를 보관할 폴더를 만듭니다.

mkdir n8n-docker
cd n8n-docker

Step 2. docker-compose.yml 파일 작성

해당 폴더 안에 docker-compose.yml 파일을 생성하고 아래의 코드를 입력합니다.

nano docker-compose.yml

[docker-compose.yml 설정 코드]

version: '3.8'

volumes:
  n8n_data:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=당신의_서버_IP_또는_도메인
      - N8N_PORT=5678
      - N8N_PROTOCOL=http # HTTPS를 적용했다면 https로 변경
      - NODE_ENV=production
      - WEBHOOK_URL=http://당신의_서버_IP_또는_도메인:5678/
      - GENERIC_TIMEZONE=Asia/Seoul
    volumes:
      - n8n_data:/home/node/.n8n

• 주의: 당신의_서버_IP_또는_도메인 부분에 실제 서버의 퍼블릭 IP나 연결해 둔 도메인 주소를 입력해 주세요. (예: 123.45.67.89 또는 n8n.mydomain.com)

Step 3. 컨테이너 실행하기

파일을 저장하고 빠져나온 뒤(nano의 경우 Ctrl+O, Enter, Ctrl+X), 아래 명령어를 실행하여 n8n 컨테이너를 백그라운드에서 구동합니다.

docker-compose up -d

명령어를 입력하면 n8n 이미지를 다운로드하고 서버가 실행됩니다. Done 메시지가 뜨면 설치가 완료된 것입니다!

---

🌐 3. n8n 접속 및 초기 설정

1. 웹 브라우저를 열고 http://서버IP주소:5678 (또는 설정한 도메인)로 접속합니다.
2. 최초 접속 시 관리자 계정 생성(Owner Setup) 화면이 나타납니다.
3. 사용할 이메일, 이름, 비밀번호를 입력하여 계정을 생성합니다.
4. 이제 캔버스 화면이 열리며, 자유롭게 워크플로우를 생성하여 업무 자동화를 시작할 수 있습니다!

---

💡 마무리 및 보안 팁

Docker를 통해 n8n을 직접 호스팅하면 워크플로우 실행 횟수에 제한이 없고, 업무망 내부에서 발생하는 로그나 파일 등 민감한 데이터가 외부로 빠져나가지 않아 정보 보안 및 내부 통제 측면에서 매우 훌륭한 선택입니다.

다만, 위 설정은 기본 HTTP 연결 상태이므로 실제 운영 환경(Production)에서 사용할 때는 Nginx Proxy Manager(NPM)나 Cloudflare Tunnels 등을 활용하여 리버스 프록시를 구성하고 무료 SSL 인증서(HTTPS)를 적용하는 것을 강력히 권장합니다.

다음 포스팅에서는 호스팅된 n8n에 HTTPS를 적용하고 보안을 한층 강화하는 방법에 대해 다루어 보겠습니다. 궁금한 점이 있으시다면 언제든 댓글로 남겨주세요!