Docker에서 n8n 설치하는 방법

작성일자 글쓴이
Docker에서 n8n 설치하는 방법

n8n은 워크플로 자동화 도구로, 코딩 없이도 다양한 서비스와 애플리케이션을 연결해 자동화할 수 있는 오픈소스 도구입니다. 특히 데이터 파이프라인 구축이나 반복적인 작업 자동화에 매우 유용합니다. 이번 포스팅에서는 Docker를 활용해 n8n을 설치하는 방법을 단계별로 안내드리겠습니다.

📌 준비사항

  • Docker가 설치된 환경 (Windows, macOS, Linux 모두 가능)
  • Docker Compose가 설치된 상태 (선택 사항)

Docker와 Docker Compose가 설치되지 않았다면, Docker 공식 사이트에서 설치 방법을 참고해 주세요.

1. Docker Compose 파일 생성

Docker Compose를 이용하면 환경 설정 파일 한 개로 n8n 설치 및 실행이 가능합니다. docker-compose.yml 파일을 생성하고, 아래와 같이 작성해 주세요.

version: "3"

services:
  n8n:
    image: n8nio/n8n
    ports:
      - "5678:5678"  # n8n은 기본적으로 5678 포트를 사용합니다.
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true  # 인증 활성화 여부
      - N8N_BASIC_AUTH_USER=<사용자명>  # 사용자명 설정
      - N8N_BASIC_AUTH_PASSWORD=<비밀번호>  # 비밀번호 설정
    volumes:
      - ./n8n_data:/home/node/.n8n  # 데이터가 저장될 로컬 경로를 지정합니다.

위 설정에서는 5678 포트로 n8n에 접근할 수 있게 하고, 기본 인증 기능을 활성화했습니다. N8N_BASIC_AUTH_USER와 N8N_BASIC_AUTH_PASSWORD에 원하는 사용자명과 비밀번호를 입력해 주세요.

🔍 Tip: ./n8n_data:/home/node/.n8n 부분은 데이터 저장소 경로로, 워크플로 데이터를 로컬에 영구 저장합니다. 원하는 경로로 변경할 수 있습니다.

2. Docker Compose 실행

설정 파일을 저장한 후, 해당 디렉터리에서 다음 명령어를 입력해 Docker Compose를 실행합니다.

docker-compose up -d

-d 옵션은 백그라운드에서 실행하는 옵션입니다. 명령어를 실행하면 필요한 이미지가 다운로드되고, n8n 컨테이너가 자동으로 실행됩니다.

3. n8n에 접속하기

컨테이너가 정상적으로 실행되었다면, 웹 브라우저에서 http://localhost:5678로 접속해 n8n 인터페이스에 접근할 수 있습니다.

앞서 설정한 인증 정보(사용자명과 비밀번호)를 입력하여 로그인합니다.

🔑 Note: Docker가 설치된 서버나 원격 환경에서 실행했다면, localhost 대신 해당 서버의 IP 주소나 도메인을 입력해야 합니다.

4. 환경 설정 추가 (선택 사항)

n8n은 다양한 환경 변수를 통해 설정을 커스터마이징할 수 있습니다. 예를 들어, 데이터베이스 연결 설정, 실행 메모리 제한, 보안 설정 등을 환경 변수로 지정할 수 있습니다. 아래는 자주 사용되는 몇 가지 환경 변수입니다.

  • N8N_HOST: n8n이 실행될 호스트 주소 설정 (기본값: localhost)
  • N8N_PORT: 포트 번호 설정 (기본값: 5678)
  • DB_TYPE: 데이터베이스 유형 설정 (sqlite, postgres, mariadb 등 지원)
  • N8N_ENCRYPTION_KEY: 워크플로 데이터를 암호화하는 데 사용되는 키

예시:

environment:
  - N8N_HOST=example.com
  - N8N_PORT=8080
  - N8N_ENCRYPTION_KEY=<암호화 키>

위와 같이 환경 변수를 추가하여, n8n의 기능을 더 확장하거나 보안을 강화할 수 있습니다.

5. n8n 업데이트 및 관리

n8n을 새로운 버전으로 업데이트하고 싶다면, 다음과 같이 실행 중인 컨테이너를 중지하고 이미지를 업데이트할 수 있습니다.

  1. 현재 컨테이너 중지
   docker-compose down
  1. 최신 이미지 다운로드 및 컨테이너 재실행
   docker-compose pull
   docker-compose up -d

이 과정을 통해 n8n을 최신 버전으로 손쉽게 업데이트할 수 있습니다.

마무리하며

이렇게 해서 Docker를 통해 n8n 설치 및 실행하는 방법을 알아보았습니다. n8n을 활용해 데이터 연동과 자동화를 쉽게 시작할 수 있을 것입니다. 처음 사용하시는 경우, 간단한 워크플로부터 시작해보세요! 🎉

혹시 설치 과정에서 궁금한 점이나, n8n 활용 팁이 있으시면 댓글로 공유해 주세요!