découvrez notre guide pratique et complet pour déployer n8n avec docker sur un système linux. suivez les étapes simples et efficaces pour automatiser vos flux de travail et optimisez votre productivité en quelques minutes.

Linux 시스템에서 Docker를 사용하여 n8n을 배포하는 방법 가이드

작성자:

작업 자동화는 그 어느 때보다 생산성 향상에 필수적인 요소가 되었으며, 특히 워크플로 관리가 빠르게 복잡해질 수 있는 Linux 환경에서 더욱 그렇습니다. n8n은 API 연결, 웹훅 오케스트레이션, 복잡한 통합 관리를 위한 이상적인 유연한 오픈소스 솔루션으로 자리매김했습니다. Docker는 런타임 환경을 격리하여 배포를 간소화하고, 기반 Linux 시스템에 관계없이 안정적이고 이식 가능한 운영을 보장합니다. 이 상세 가이드는 전용 머신이든 클라우드 환경이든 Linux 서버에 Docker를 사용하여 n8n을 배포하는 단계별 가이드를 제공하며, PostgreSQL 데이터베이스 및 Nginx와 같은 강력한 도구를 보안 역방향 프록시로 활용합니다. 이 튜토리얼은 자동화 솔루션을 산업화하려는 시스템 관리자와 컨테이너 환경에서 Node.js의 잠재력을 탐구하고자 하는 Linux 사용자 모두를 대상으로 합니다. Linux 시스템에 Docker를 사용하여 n8n을 설치하기 위한 필수 전제 조건

배포를 시작하기 전에 각 구성 요소가 원활하게 작동할 수 있는 적절한 환경을 준비하는 것이 중요합니다. Linux 서버는 안정적이어야 하며, 일반적으로 Debian 또는 Ubuntu를 사용해야 합니다. 이 서버는 Docker 및 관련 도구와의 견고성과 폭넓은 호환성으로 유명합니다. Docker와 Docker Compose는 n8n 및 관련 종속성을 호스팅할 컨테이너의 실행을 조정하므로 반드시 설치해야 합니다.

n8n 인스턴스 보안을 위해 Nginx 또는 Traefik과 같은 역방향 프록시를 사용하는 것이 좋습니다. 이를 통해 Let’s Encrypt를 통해 무료로 관리되는 SSL/TLS 인증서를 추가할 수 있습니다. 이러한 수준의 보안은 웹훅이나 API를 인터넷에 노출할 때 필수적이며, 교환의 기밀성과 무결성을 보장합니다. 운영 환경에서는 네이티브 SQLite 옵션보다 PostgreSQL 데이터베이스를 사용하는 것이 더 나은 확장성과 수많은 쿼리 처리 효율성을 보장하므로 더 바람직합니다. 필수 전제 조건은 다음과 같습니다.

최신 Linux 서버

(Debian 11 이상, Ubuntu 22.04 이상 권장)

  • Docker 및 Docker Compose 설치 호환 버전(Docker 20.10 이상, Compose 2.x)
  • 역방향 프록시 설치 (Nginx 또는 Traefik 권장)
  • 서버를 가리키는 도메인 이름 접근 및 SSL 구성 용이
  • Docker를 통해 구성된 PostgreSQL n8n 데이터베이스 관리
  • 적합한 네트워크 구성 : 필요한 경우 포트 80, 443(HTTP/S), 5678(n8n)을 열고 리디렉션
  • Linux 초보자라면 이러한 요소들이 무엇을 의미하는지 이해하는 것이 좋습니다. Docker는 호스트 시스템과 분리된 경량 컨테이너에 애플리케이션을 캡슐화하는 반면, Nginx와 같은 역방향 프록시는 n8n으로 들어오는 액세스를 리디렉션하고 보호합니다. PostgreSQL은 n8n의 기반이 되는 Node.js 프레임워크와의 견고성과 호환성 덕분에 프로덕션 인스턴스에 적합한 강력한 관계형 데이터베이스입니다. Linux에서 Docker Compose를 사용하여 Docker 환경 구성 및 n8n 사용자 정의

Linux에 n8n을 배포하는 가장 큰 매력은 Docker Compose의 사용 편의성에 있습니다. 이 YAML 파일은 모든 컨테이너와 그 상호 작용을 읽고 편집할 수 있는 형식으로 설명합니다. 초기 구성은 전용 n8n 트리를 생성한 다음 두 개의 필수 파일을 정의하는 것으로 구성됩니다.

.env

환경 변수 및 docker-compose.yml 을 사용하여 서비스를 오케스트레이션합니다. 자주 간과되는 측면 중 하나는 영구 데이터의 분리입니다. 세 개의 로컬 폴더를 생성해야 합니다. 하나는 PostgreSQL 데이터용, 다른 하나는 n8n에서 생성된 파일용, 그리고 마지막 하나는 임시 파일 또는 스왑 파일용입니다. 이 디렉터리들은 각 컨테이너에 마운트되어 재부팅이나 업데이트 시 데이터 손실을 방지합니다. 디렉터리 생성 예: mkdir -p /opt/docker-compose/n8n/{postgresql,n8n_data,n8n_files}

chmod 777 /opt/docker-compose/n8n/n8n_data (권한 오류 방지를 위해 필요)

.env

  • 파일에는 다음과 같은 주요 변수가 포함되어 있습니다.
  • N8N_HOST

: 인터페이스가 표시하고 URL을 생성하는 데 사용할 호스트 이름 N8N_WEBHOOK_URL : 웹훅이 제대로 작동하도록 공개적으로 액세스 가능한 URL

  • POSTGRES_DB ,
  • POSTGRES_USER ,
  • POSTGRES_PASSWORD: PostgreSQL 데이터베이스 연결 정보 N8N_GENERIC_TIMEZONE: 워크플로 실행에 영향을 미치는 시간대 docker-compose.yml
  • 에는 두 가지 주요 서비스가 포함되어 있습니다. postgres

: 환경 변수 설정, 지속성 볼륨 및 상태 확인을 포함하는 공식 PostgreSQL 이미지 기반 n8n : 공식 n8n Docker 이미지, 애플리케이션을 데이터베이스에 연결하는 환경 변수 구성, 포트 관리, 데이터 및 파일을 유지하는 볼륨, 그리고 PostgreSQL 상태 종속성

  • 이 두 파일을 사용하여 구성하면 자동화되고 재현 가능하며 쉽게 수정할 수 있는 환경을 만들 수 있습니다. 이는 오픈 소스 소프트웨어, Docker, 그리고 Linux의 장점을 모두 갖춘 것입니다. 또한 이 방법은 종속성 오류나 버전 간 비호환성으로부터 사용자를 보호합니다. https://www.youtube.com/watch?v=NAzpMf50auI
  • Linux 시스템에서 n8n용 Docker 컨테이너 시작 및 관리 환경이 준비되면 n8n 컨테이너가 파일을 쓰는 데 문제가 발생하지 않도록 마운트된 폴더의 권한이 올바른지 확인해야 합니다. 대부분의 경우 n8n 데이터가 포함된 폴더에 chmod 777 설정을 적용해야 하지만, 이 방법은 허용적이며 관련 위험을 철저히 이해해야 합니다.

다음 명령으로 컨테이너를 시작하면 백그라운드 서비스를 시작하고 배포할 수 있습니다. sudo docker compose up -d다음 명령을 사용하여 컨테이너 상태를 모니터링합니다.

sudo docker compose ps

활성 컨테이너 목록과 상태를 확인합니다.

sudo docker compose log -f

실시간으로 출력 로그를 확인합니다. 문제 발생 시 필수적입니다.

  • n8n이 제대로 연결하고 오류 없이 시작할 수 있도록 PostgreSQL 컨테이너는 “정상” 상태여야 합니다. 로그에 다음과 같은 메시지가 표시됩니다.

“편집기는 이제 https://n8n.it-connect.local을 통해 액세스할 수 있습니다.”

  • 이 메시지는 서비스가 작동 중이며 구성된 도메인 이름을 통해 브라우저에서 액세스할 수 있는 포트 5678을 통해 사용할 준비가 되었음을 확인합니다. 로그 관리자를 사용하면 Node.js, PostgreSQL 데이터베이스 및 미들웨어 기반의 복잡한 솔루션을 배포할 때 진단이 크게 간소화됩니다. Nginx 역방향 프록시를 구성하여 Linux에서 HTTPS를 통해 n8n을 보호하고 노출합니다.
  • 역방향 프록시는 특히 웹훅을 사용하거나 인터넷을 통해 자동화를 노출하는 경우 n8n에 대한 액세스를 보호하는 데 필수적인 구성 요소입니다. Nginx는 가볍고 안정성이 뛰어나며 구성이 간편하기 때문에 Linux에서 최적의 선택입니다. Docker 포트 5678을 직접 노출하는 대신 Nginx는 중개자 역할을 하여 SSL/TLS 인증서를 적용하고 필수 리디렉션 및 HTTP 헤더를 관리할 수 있도록 합니다. 주요 단계는 다음과 같습니다. 패키지 관리자를 통해 Nginx를 설치합니다(예: Debian/Ubuntu에 sudo apt install nginx).

자체 서명 또는 Let’s Encrypt에서 생성된 SSL 인증서를 저장할 디렉터리를 생성합니다.

OpenSSL(또는 Let’s Encrypt의 경우 Certbot 사용)을 사용하여 인증서를 생성합니다.

sudo openssl req -x509 -nodes -days 365 -newkey rsa:4096 -keyout /etc/nginx/ssl/n8n.key -out /etc/nginx/ssl/n8n.crt

Nginx 설정에는 두 개의 서버 블록이 포함되어야 합니다.

포트 80에서 수신하는 블록은 HTTPS로 301 리디렉션을 수행합니다. 인증서, TLS 1.2 및 1.3 프로토콜 지원, proxy_pass 구성을 포함하는 HTTPS 블록은

http://127.0.0.1:5678(n8n이 실행됨)에 있습니다.

  • 필수 구성 파일은 다음과 같습니다(도메인 이름은 수정해야 함). Nginx 구성 스니펫: server {
  • listen 80;
  • server_name n8n.example.com;

return 301 https://$server_name$request_uri;

}

  • server {
  • listen 443 ssl http2; server_name n8n.example.com; ssl_certificate /etc/nginx/ssl/n8n.crt;

ssl_certificate_key /etc/nginx/ssl/n8n.key;

ssl_protocols TLSv1.2 TLSv1.3;

<!– wp:code {"content":"
nserver {n    listen 80;n    server_name n8n.example.com;n    return 301 https://$server_name$request_uri;n}nnserver {n    listen 443 ssl http2;n    server_name n8n.example.com;nn    ssl_certificate /etc/nginx/ssl/n8n.crt;n    ssl_certificate_key /etc/nginx/ssl/n8n.key;n    ssl_protocols TLSv1.2 TLSv1.3;n    ssl_prefer_server_ciphers off;n    ssl_session_cache shared:SSL:10m;n    ssl_session_timeout 10m;nn    location / {n        proxy_pass http://127.0.0.1:5678;n        proxy_http_version 1.1;n        proxy_set_header Upgrade $http_upgrade;n        proxy_set_header Connection 'upgrade';n        proxy_set_header Host $host;n        proxy_set_header X-Real-IP $remote_addr;n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;n        proxy_set_header X-Forwarded-Proto $scheme;nn        proxy_buffering off;n        proxy_read_timeout 300s;n    }n}n
“} –>
ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    대여 / {
proxy_pass http://127.0.0.1:5678;

proxy_http_version 1.1;
    proxy_set_header 업그레이드 $http_upgrade;
    proxy_set_header 연결 '업그레이드';

    proxy_set_header 호스트 $host;
    proxy_set_header X-실제 IP $remote_addr;
    proxy_set_header X-포워드 대상 $proxy_add_x_forwarded_for;
    proxy_set_header X-포워드 프로토타입 $scheme;
    proxy_bufferingoff;
    proxy_read_timeout 300초;

    }
        }
        /etc/nginx/sites-enabled/의 심볼릭 링크를 통해 이 사이트를 활성화한 후
        Nginx를 다시 로드하는 것이 필수입니다.
        sudo ln -s /etc/nginx/sites-available/n8n.example.com /etc/nginx/sites-enabled/
        sudo systemctl reload nginx
        https://n8n.example.com에 접속하면 HTTPS로 보호되는 n8n 관리 인터페이스가 나타납니다. 인증서가 자체 서명된 경우 SSL 인증서 경고가 발생할 수 있지만, 공인된 CA를 통해 해결할 수 있습니다.
        
        n8n 시작하기: Linux에서 워크플로, 웹훅 및 API 통합 관리

        n8n을 설치하고 액세스할 수 있게 되면 워크플로를 구성하여 자동화를 최대한 활용할 수 있습니다. n8n은 Node.js 기반으로 구축되었으며, API를 통해 수백 개의 서비스를 기본적으로 지원하여 복잡한 자동화 체인을 간소화합니다. 주요 개념은 다음과 같습니다.
        워크플로
    : 스크립트, API 호출 및 다양한 트리거를 포함할 수 있는 자동화된 작업 시퀀스입니다.
웹훅

: 외부에서 워크플로를 트리거하는 HTTP 진입점으로, 외부 이벤트에 대응하는 데 필수적입니다. 통합 : MySQL, PostgreSQL, Redis 등을 위한 네이티브 커넥터로 데이터 상호 연결을 용이하게 합니다.

  • 실제 사례: 고객 양식에서 트리거된 웹훅을 수신하면 CRM 데이터를 MySQL 데이터베이스와 자동으로 동기화합니다. 이러한 오케스트레이션을 통해 수동 오류를 방지하고 처리 시간을 단축하며 인력을 효율적으로 활용할 수 있습니다.
  • n8n은 직관적인 그래픽 인터페이스와 GitHub 또는 공식 웹사이트를 통해 바로 사용할 수 있는 템플릿을 제공하여 초보자도 프로세스를 빠르게 진행할 수 있도록 지원합니다. 대규모 프로덕션 워크플로에서 대기열 관리를 개선하기 위해 Redis를 중간 캐시로 사용하는 것이 좋습니다.

Docker, Linux, 그리고 n8n의 시너지 효과는 기존의 복잡한 배포 과정을 간소화합니다. 이 모듈형 아키텍처는 업데이트와 디버깅을 용이하게 하고, 자동화 애플리케이션의 성장을 지원하는 제어된 확장성을 제공합니다.