n8n 자동화 가이드 - 2편: Docker로 n8n 설치하기

n8n 자동화 가이드 - 2편: Docker로 n8n 설치하기

이전 글에서 n8n이 무엇인지와 왜 주목받고 있는지에 대해 살펴봤습니다. 이번 글에서는 본격적으로 n8n을 서버에 설치하는 방법을 알아보겠습니다. 가장 많이 사용되는 방식인 Docker + Docker Compose 환경을 기준으로 설명합니다.

---

1. 설치 준비물

다음은 n8n 설치를 위해 필요한 사전 조건입니다:

• Linux 기반 서버 (예: Ubuntu 20.04 이상)
• Docker & Docker Compose 설치
• 도메인 (선택, HTTPS 적용 시 필요)

로컬에서 테스트하려면 Mac 또는 Windows 환경에서도 Docker만 설치되어 있으면 진행 가능합니다.

---

2. Docker 및 Docker Compose 설치

우분투 기준으로 Docker 설치는 아래 명령어를 차례대로 실행하면 됩니다:

sudo apt update
sudo apt install -y docker.io docker-compose
sudo systemctl enable docker
sudo systemctl start docker

설치 후 아래 명령어로 정상 작동 여부를 확인합니다:

docker --version
docker-compose --version

---

3. n8n을 위한 디렉토리 구성

n8n을 설치할 디렉토리를 만들고, 설정 파일을 구성합니다.

mkdir ~/n8n
cd ~/n8n
touch docker-compose.yml
touch .env

.env 파일은 다음과 같이 작성합니다:

# .env
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=securepassword
N8N_HOST=localhost
N8N_PORT=5678
N8N_PROTOCOL=http

주의: 비밀번호는 보안을 위해 반드시 복잡하게 설정하세요.

---

4. docker-compose.yml 작성

docker-compose.yml 파일은 다음과 같이 구성합니다:

version: "3"

services:
  n8n:
    image: n8nio/n8n
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=${N8N_BASIC_AUTH_ACTIVE}
      - N8N_BASIC_AUTH_USER=${N8N_BASIC_AUTH_USER}
      - N8N_BASIC_AUTH_PASSWORD=${N8N_BASIC_AUTH_PASSWORD}
      - N8N_HOST=${N8N_HOST}
      - N8N_PORT=${N8N_PORT}
      - N8N_PROTOCOL=${N8N_PROTOCOL}
    volumes:
      - ./n8n_data:/home/node/.n8n
    restart: always

이 구성은 n8n을 http://localhost:5678에서 실행하며, 기본 인증을 활성화해 외부 접근을 제한합니다.

---

5. n8n 실행

이제 아래 명령어로 n8n을 실행합니다:

docker-compose up -d

정상적으로 실행되면, 브라우저에서 다음 주소로 접속해 확인할 수 있습니다:

http://localhost:5678

설정한 아이디/비밀번호로 로그인하면 n8n의 시각적 워크플로우 편집 화면을 확인할 수 있습니다.

---

6. HTTPS 적용 (선택)

도메인이 있다면, Nginx + Let's Encrypt를 활용해 HTTPS를 적용할 수 있습니다. 이 부분은 별도의 글로 따로 다룰 예정입니다.

---

7. 자주 발생하는 오류 및 해결 방법

• 포트 충돌: 다른 프로세스가 5678 포트를 이미 사용 중인 경우 N8N_PORT를 변경하거나 해당 프로세스를 종료하세요.
• 접속 불가: 서버 방화벽에서 5678 포트를 허용했는지 확인하세요.
• 데이터 초기화: ./n8n_data 폴더에 저장된 데이터가 n8n의 모든 설정과 워크플로우를 포함하므로, 삭제 시 주의하세요.

---

8. 마무리

여기까지 n8n을 Docker 환경에 설치하고 실행하는 기본적인 과정을 살펴봤습니다. 이제 n8n의 UI에서 직접 워크플로우를 구성할 준비가 끝났습니다.

다음 편에서는 n8n의 기본 인터페이스 구성과 노드(Node)의 개념, 워크플로우 설계 흐름을 이해하는 데 필요한 기초 지식을 다룰 예정입니다.

---

■ n8n 자동화 가이드 시리즈 전체 보기