n8n 셀프호스팅

n8n 셀프호스팅 (Host n8n)

직접 서버를 준비해서 n8n을 운영하고 싶을 때, 어디부터 시작해야 할지가 막막할 수 있어요. 이 문서는 n8n을 당신의 인프라, 온프레미스, 또는 프라이빗 클라우드에 직접 설치하고 관리하는 방법을 안내합니다. Docker Compose, 원라인 설치, 또는 다른 배포 방식을 골라서 시작하면 됩니다. 셀프호스팅이 지금 상황에 맞는지 아직 고민 중이라면 Choose how to use n8n 문서를 먼저 읽어보세요.

출처: 공식문서 - Host n8n

설치 방법 고르기

기술 요구사항과 인프라에 가장 잘 맞는 설치 방법을 선택하세요.

  • 원라인 설치 (One-line setup)

    적합한 경우: 최소 설정으로 빠르게 시작할 때.

    요구사항: curl이 설치된 Linux 또는 macOS 시스템.

    모든 의존성과 설정을 알아서 처리해 주는 자동 설치 스크립트입니다.

    원라인 설치 가이드

  • Docker Compose

    적합한 경우: 데이터베이스와 추가 서비스가 필요한 프로덕션 배포.

    요구사항: 시스템에 Docker와 Docker Compose가 설치되어 있어야 합니다.

    영속적인 데이터와 확장성을 갖춘 견고한 배포에 이상적인 멀티 컨테이너 구성입니다.

    Docker Compose 가이드

  • AWS

    EC2, ECS 또는 기타 AWS 서비스를 사용해 Amazon Web Services에 배포합니다.

    AWS 설치 가이드

  • Azure

    컨테이너 인스턴스 또는 가상 머신으로 Microsoft Azure에 n8n을 호스팅합니다.

    Azure 설치 가이드

  • Google Cloud

    Cloud Run 또는 Kubernetes Engine을 사용해 Google Cloud에서 n8n을 실행합니다.

    Google Cloud Run | Kubernetes Engine

  • DigitalOcean

    중소 규모 배포에 이상적인 간단한 droplet 기반 호스팅입니다.

    DigitalOcean 설치 가이드

  • Hetzner

    뛰어난 성능을 제공하는 비용 효율적인 유럽 호스팅 옵션입니다.

    Hetzner 설치 가이드

  • Heroku

    최소 설정으로 빠르게 배포할 수 있는 Platform-as-a-Service 옵션입니다.

    Heroku 설치 가이드

  • OpenShift

    컨테이너화된 앱을 위한 엔터프라이즈 Kubernetes 플랫폼입니다.

    OpenShift 설치 가이드

  • npm

    적합한 경우: 로컬 개발 또는 테스트.

    요구사항: 시스템에 Node.js가 설치되어 있어야 합니다.

    npm 설치는 n8n 3.0부터 더 이상 지원되지 않습니다(Deprecated). Docker Compose나 원라인 설치를 대신 고려해 보세요.

    Node Package Manager를 사용해 n8n을 직접 설치합니다. 빠르게 설정할 수 있지만 Node.js 버전과 의존성은 직접 관리해야 합니다.

    npm 설치 가이드

한 번에 시작하기

문서를 읽는 대신 바로 실행하고 싶다면, 아래 명령 하나로 로컬에 n8n을 띄울 수 있습니다. Docker가 Linux나 macOS(Windows는 WSL)에 필요합니다.

curl -fsSL https://get.n8n.io | sh

이 스크립트가 하는 일이 궁금하다면 원라인 설치 가이드를, 각 설치 방법을 비교해 보고 싶다면 계속 읽어보세요.

에디션 이해하기

모든 셀프호스팅 설치는 동일한 코어 제품을 사용합니다. 라이선스 키가 없으면 n8n은 무료 Community 에디션으로 실행됩니다. Business나 Enterprise 라이선스 키를 추가하면 해당 에디션이 활성화됩니다. 셀프호스팅 에디션 간 차이는 Compare editions 문서에서 확인할 수 있습니다.

더 알아보기 (Learn more)