2025년 최신 NAS n8n 설치 가이드와 완벽한 자동화 구축법

목차

• 도입: 자동화의 새로운 시작, NAS에서 n8n 셀프 호스팅하기
• n8n 셀프 호스팅, 왜 NAS가 최적의 선택인가?
• 설치 전 필수 확인! 시스템 요구사항 및 사전 준비물
• 핵심 단계: n8n Docker 구성 및 실행 (docker-compose.yml 활용)
• Synology NAS 맞춤형 설치: Container Manager GUI 활용법
• 초기 접속 및 보안 강화 설정
• (고급) PostgreSQL 연동으로 성능 극대화하기
• 유지보수 및 문제 해결
• 마무리: 성공적인 나만의 자동화 허브 구축 완료
• 자주 묻는 질문 (FAQ)

도입: 자동화의 새로운 시작, NAS에서 n8n 셀프 호스팅하기

이 NAS n8n 설치 가이드는 2025년을 기준으로, 개인 서버에서 데이터 주권을 지키며 강력한 자동화 워크플로우를 구축하려는 모든 분들을 위한 완벽한 지침서입니다. n8n은 코딩 지식 없이도 수많은 애플리케이션의 API를 서로 연결하고 반복적인 작업을 자동으로 처리하게 해주는 노드 기반의 오픈소스 자동화 도구입니다. Zapier나 Make와 같은 유명 서비스와 기능은 유사하지만, 내 서버에 직접 설치할 수 있다는 강력한 장점을 가집니다.

그렇다면 왜 클라우드 서비스가 아닌 NAS(Network Attached Storage)에 직접 설치하는 것이 유리할까요? 여기에는 세 가지 핵심 가치가 있습니다. 첫째, 완벽한 데이터 소유권입니다. 여러분의 모든 자동화 기록과 민감한 인증 정보가 외부 서버가 아닌 내 손안의 NAS에만 저장됩니다. 둘째, 월 구독료 없는 비용 효율성입니다. 한번 구축하면 추가 비용 없이 마음껏 사용할 수 있습니다. 마지막으로, 무한한 커스터마이징이 가능해 필요에 따라 성능을 확장하고 원하는 기능을 자유롭게 추가할 수 있습니다.

이 글을 끝까지 따라오시면 Synology, QNAP 등 주요 NAS 장비에서 Docker를 이용해 안정적인 n8n 환경을 구축하고, 기본적인 보안 설정과 고성능 데이터베이스 연동까지 막힘없이 완료할 수 있을 것입니다. 이제 여러분만의 자동화 허브를 만들 준비를 시작해 봅시다.

n8n 셀프 호스팅, 왜 NAS가 최적의 선택인가?

n8n 셀프 호스팅 설치 방법으로 NAS를 선택하는 것은 단순히 비용을 아끼는 것을 넘어, 자동화 인프라의 통제권을 완전히 가져오는 전략적인 결정입니다. 클라우드 서비스가 제공하는 편리함 이면에는 데이터 통제권의 상실과 지속적인 비용이라는 문제가 존재하기 때문입니다. NAS는 이러한 문제에 대한 명쾌한 해답을 제시합니다.

가장 중요한 장점은 데이터 주권과 프라이버시입니다. 모든 워크플로우의 로그, API 키와 같은 인증 정보, 실행 데이터가 외부 서버가 아닌 오직 여러분의 NAS에만 저장됩니다. 이는 고객 정보나 금융 데이터 등 민감한 정보를 다루는 자동화를 구현할 때, 정보 유출에 대한 걱정 없이 안심하고 시스템을 운영할 수 있게 해줍니다. 데이터의 흐름을 완벽하게 통제할 수 있다는 것은 셀프 호스팅의 가장 큰 가치입니다.

다음으로 비용 절감 효과를 무시할 수 없습니다. 대부분의 클라우드 자동화 서비스는 워크플로우 실행 횟수나 작업량, 사용하는 앱의 종류에 따라 요금 구간이 나뉩니다. 사용량이 늘어날수록 구독료 부담은 기하급수적으로 커질 수 있습니다. 하지만 NAS 셀프 호스팅은 초기 하드웨어 비용 외에 n8n 운영 자체에 대한 추가 비용이 발생하지 않아, 장기적으로 매우 경제적입니다.

마지막으로 성능과 유연성 측면에서 뛰어납니다. NAS에서 n8n 셀프 호스팅 설치 방법을 택하면, 필요에 따라 RAM이나 저장 공간 같은 하드웨어 리소스를 직접 증설할 수 있습니다. 또한, 기본 데이터베이스인 SQLite를 넘어 PostgreSQL과 같은 고성능 데이터베이스를 연동하여 수만 건의 대규모 워크플로우 기록도 안정적으로 처리할 수 있습니다. 이러한 기술적 유연성은 비즈니스 성장에 맞춰 자동화 시스템을 함께 확장할 수 있는 기반이 됩니다.

설치 전 필수 확인! 시스템 요구사항 및 사전 준비물

본격적인 설치에 앞서, 여러분의 NAS 환경이 n8n을 원활하게 구동할 준비가 되었는지 확인하는 단계가 필요합니다. 아래 체크리스트를 통해 하드웨어 사양부터 필수 소프트웨어, 네트워크 설정까지 꼼꼼히 점검하세요. 이 과정을 거치면 설치 중 발생할 수 있는 대부분의 문제를 예방할 수 있습니다.

NAS 하드웨어 최소 사양

안정적인 n8n 운영을 위해 아래의 최소 사양을 권장합니다. 단순한 워크플로우 몇 개는 이보다 낮은 사양에서도 동작할 수 있지만, 여러 작업을 동시에 처리하거나 대량의 데이터를 다룰 경우 성능 저하를 겪을 수 있습니다.

필수 소프트웨어 설치

n8n은 Docker 컨테이너 기술을 기반으로 설치됩니다. 따라서 NAS에 Docker 실행 환경을 미리 준비해야 합니다.

• Synology NAS: DSM의 패키지 센터에 접속하여 ‘Container Manager’를 검색하고 설치합니다. (구 버전 DSM에서는 ‘Docker’라는 이름의 패키지입니다.)
• QNAP NAS: QTS의 App Center에 접속하여 ‘Container Station’을 검색하고 설치합니다.

네트워크 환경 구성

원활한 접속과 서비스 운영을 위해 기본적인 네트워크 설정을 확인해야 합니다.

• 내부 고정 IP 주소 설정: NAS가 재부팅될 때마다 IP 주소가 바뀌는 것을 방지하기 위해, 공유기 설정이나 NAS 제어판에서 NAS의 내부 IP를 고정으로 할당하세요. (예: 192.168.1.100)
• 포트 충돌 확인: n8n은 기본적으로 5678번 포트를 사용합니다. NAS에서 실행 중인 다른 서비스가 이 포트를 이미 사용하고 있는지 확인하세요. 만약 사용 중이라면, 설치 과정에서 다른 포트 번호로 변경해야 합니다.

핵심 단계: n8n Docker 구성 및 실행 (docker-compose.yml 활용)

이제 n8n Docker 구성의 핵심 단계입니다. 여러 개의 명령어를 터미널에 입력하는 방식 대신, docker-compose.yml이라는 하나의 설정 파일을 사용하는 방법을 안내합니다. 이 방식을 사용하면 n8n 구동에 필요한 모든 설정(네트워크, 저장 공간, 환경변수 등)을 코드로 명확하게 관리할 수 있어, 나중에 설정을 변경하거나 백업, 이전할 때 매우 편리합니다. 이것이 바로 현대적인 n8n 셀프 호스팅 설치 방법의 표준입니다.

docker-compose.yml 최종 코드

NAS의 Docker 관련 폴더(예: /volume1/docker/) 안에 n8n이라는 새 폴더를 만드세요. 그리고 그 안에 docker-compose.yml이라는 이름으로 파일을 생성한 뒤, 아래 코드를 그대로 복사하여 붙여넣으세요. 여기에_로 시작하는 부분은 반드시 여러분의 정보로 수정해야 합니다.

# 2025년 기준, Docker Compose V2+ 에서는 'version' 최상위 키가 더 이상 필요하지 않지만, 호환성을 위해 포함할 수 있습니다.
services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - TZ=Asia/Seoul
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=여기에_관리자_ID_입력
      - N8N_BASIC_AUTH_PASSWORD=여기에_강력한_비밀번호_입력
      # 외부 접속 URL이 확정되면 아래 주석을 해제하고 입력하세요.
      # - WEBHOOK_URL=https://your-domain.com/
      # - N8N_EDITOR_BASE_URL=https://your-domain.com/
    volumes:
      - /volume1/docker/n8n:/home/node/.n8n

설정값 상세 해설

• image: n8nio/n8n:latest: Docker Hub에 있는 n8n의 최신 공식 이미지를 가져와 사용하라는 의미입니다. n8n 공식 Docker Hub 페이지(https://hub.docker.com/r/n8nio/n8n)에서 다양한 버전 태그를 확인할 수 있습니다.
• restart: unless-stopped: NAS가 예기치 않게 재부팅되더라도, 사용자가 직접 중지하지 않는 한 n8n 컨테이너를 자동으로 다시 시작시켜 서비스의 연속성을 보장하는 중요한 설정입니다.
• ports: - "5678:5678": NAS의 IP 주소로 들어오는 5678번 포트 요청을 n8n 컨테이너 내부의 5678번 포트로 연결(매핑)합니다. 만약 5678번 포트를 다른 서비스가 사용 중이라면 "외부포트:5678" 형식으로 변경할 수 있습니다.
• environment: 컨테이너의 동작을 제어하는 환경 변수들입니다. TZ는 시간대를 서울로 설정하여 로그 시간이 정확히 기록되게 합니다. N8N_BASIC_AUTH_로 시작하는 변수들은 n8n 웹 인터페이스에 접속하기 위한 초기 로그인 보안을 설정하는 것으로, 무단 접근을 막는 첫 번째 방어선 역할을 합니다.
• volumes: - /volume1/docker/n8n:/home/node/.n8n: 가장 중요한 설정입니다. 이 부분은 컨테이너 내부의 데이터 폴더(/home/node/.n8n)를 NAS의 실제 폴더(/volume1/docker/n8n)와 연결합니다. 여러분이 만드는 모든 워크플로우, 인증 정보, 설정이 이 NAS 폴더에 영구적으로 저장됩니다. 따라서 나중에 n8n 버전을 업데이트하거나 컨테이너를 삭제 후 재생성해도 모든 데이터가 안전하게 보존됩니다.

컨테이너 실행 방법

NAS의 SSH 터미널에 접속하여 위에서 생성한 docker-compose.yml 파일이 있는 디렉토리로 이동하세요. 그 다음, 아래 명령어를 입력하면 n8n이 백그라운드에서 조용히 실행을 시작합니다.

docker-compose up -d

Synology NAS 맞춤형 설치: Container Manager GUI 활용법

명령줄 인터페이스(CLI)가 낯선 Synology NAS 사용자분들을 위해, 웹 브라우저의 그래픽 인터페이스(GUI)만으로 NAS n8n 설치 가이드를 따라 설치하는 방법을 단계별로 안내합니다. 이 방법을 사용하면 터미널 접속 없이도 섹션 4와 동일한 n8n Docker 구성을 완료할 수 있습니다.

1단계: 프로젝트 생성

Synology DSM에 로그인한 후, Container Manager를 실행합니다. 왼쪽 메뉴에서 ‘프로젝트’를 선택하고 ‘생성’ 버튼을 클릭하세요. 프로젝트 이름에는 n8n이라고 입력하고, ‘경로’는 docker-compose.yml 파일을 저장할 위치를 지정합니다. (예: /volume1/docker/n8n)

2단계: docker-compose.yml 붙여넣기

‘소스’ 항목에서 ‘docker-compose.yml 생성’을 선택하세요. 그러면 큰 텍스트 입력창이 나타납니다. 여기에 섹션 4에서 제공한 docker-compose.yml 코드를 그대로 복사해서 붙여넣습니다. 이때, N8N_BASIC_AUTH_USER와 N8N_BASIC_AUTH_PASSWORD의 값은 반드시 여러분이 사용할 실제 아이디와 강력한 비밀번호로 수정해야 합니다.

3단계: 프로젝트 빌드 및 실행

코드 붙여넣기를 마쳤다면 ‘다음’ 버튼을 누릅니다. 웹훅 설정과 관련된 추가 옵션이 나올 수 있지만, 지금은 그냥 ‘다음’을 눌러 넘어가도 괜찮습니다. 마지막으로 설정 요약을 확인한 뒤 ‘완료’ 버튼을 클릭하세요. Container Manager가 자동으로 n8n 이미지를 Docker Hub에서 다운로드하고, 설정에 맞춰 컨테이너를 생성한 후 실행까지 완료합니다. 이 과정은 인터넷 속도에 따라 몇 분 정도 소요될 수 있습니다.

4단계: 실행 확인

프로젝트 생성이 완료되면, ‘프로젝트’ 목록에 방금 만든 ‘n8n’이 ‘실행 중’ 상태로 표시되는지 확인하세요. 프로젝트 이름을 클릭하면 세부 정보로 들어갈 수 있는데, 여기서 ‘컨테이너’ 탭을 눌러 n8n 컨테이너가 정상적으로 동작하는지 볼 수 있습니다. ‘로그’ 탭을 확인하여 오류 메시지 없이 n8n ready와 같은 문구가 보인다면 성공적으로 설치된 것입니다.

초기 접속 및 보안 강화 설정

n8n 컨테이너가 성공적으로 실행되었다면, 이제 웹 인터페이스에 접속하여 초기 설정을 하고 외부에서도 안전하게 사용할 수 있도록 보안을 강화할 차례입니다. 이 단계는 여러분의 소중한 자동화 워크플로우와 데이터를 보호하기 위해 매우 중요합니다.

첫 웹 인터페이스 접속

웹 브라우저를 열고 주소창에 http://<NAS_IP_주소>:5678을 입력하여 접속합니다. (예: http://192.168.1.100:5678) docker-compose.yml 파일에 설정했던 N8N_BASIC_AUTH 아이디와 비밀번호를 묻는 로그인 창이 나타날 것입니다. 입력 후 로그인하면 n8n의 초기 설정 화면으로 이동합니다.

Owner 계정 설정

최초 접속 시, n8n 인스턴스의 모든 권한을 가지는 ‘Owner(소유자)’ 계정을 생성해야 합니다. 이름, 이메일, 그리고 매우 강력한 비밀번호를 설정하세요. 여기서 N8N_BASIC_AUTH와 Owner 계정의 차이를 이해하는 것이 중요합니다. N8N_BASIC_AUTH는 n8n 애플리케이션에 접근하는 첫 번째 관문을 지키는 ‘문지기’와 같습니다. 반면, Owner 계정은 그 문을 통과한 뒤 n8n 내부의 모든 워크플로우와 설정을 관리하는 ‘최고 관리자’입니다. 두 가지 보안 장치를 모두 사용하는 것이 안전합니다.

HTTPS 활성화: 리버스 프록시 설정

“외부에서 n8n을 안전하게 사용하려면 모든 통신을 암호화하는 HTTPS 설정이 필수입니다.”

HTTP로 통신하면 아이디, 비밀번호, API 키 등 모든 정보가 암호화되지 않은 채로 전송되어 탈취 위험이 있습니다. Synology NAS의 ‘리버스 프록시’ 기능을 사용하면 Let’s Encrypt의 무료 SSL 인증서를 발급받아 손쉽게 HTTPS 접속 환경을 구축할 수 있습니다.

리버스 프록시 설정 방법 (Synology 기준):

1. 제어판 실행: DSM의 제어판 > 로그인 포털 > 고급 탭으로 이동합니다.
2. 역방향 프록시 클릭: ‘역방향 프록시’ 버튼을 누르고 ‘생성’을 클릭합니다.
3. 규칙 설정:
   • 소스:
     • 프로토콜: HTTPS
     • 호스트 이름: n8n.your-domain.com (사용할 도메인 주소)
     • 포트: 443
   • 대상:
     • 프로토콜: HTTP
     • 호스트 이름: localhost
     • 포트: 5678
4. 인증서 발급: 제어판 > 보안 > 인증서 탭으로 이동하여 ‘추가’를 누릅니다. ‘Let’s Encrypt에서 인증서 받기’를 선택하고, 방금 설정한 도메인(n8n.your-domain.com)을 입력하여 인증서를 발급받습니다.
5. 인증서 적용: 인증서 발급이 완료되면, ‘설정’ 버튼을 눌러 방금 생성한 리버스 프록시 서비스의 인증서를 새로 발급받은 Let’s Encrypt 인증서로 지정합니다.

이제 https://n8n.your-domain.com으로 접속하면 자물쇠 아이콘과 함께 안전하게 n8n을 사용할 수 있습니다.

(고급) PostgreSQL 연동으로 성능 극대화하기

n8n을 처음 설치하면 기본적으로 내장된 SQLite라는 가벼운 데이터베이스를 사용합니다. 개인적인 용도로 간단한 워크플로우 몇 개를 운영하는 환경에서는 SQLite로도 충분합니다. 하지만,

“워크플로우 실행 기록(Execution Logs)이 수만 건 이상 쌓이면 성능이 저하될 수 있습니다.”

SQLite는 여러 작업이 동시에 데이터베이스에 정보를 쓰려고 할 때 전체 파일을 잠그는 방식으로 동작하여 병목 현상이 발생하기 쉽습니다.

이러한 한계를 극복하고 대규모 데이터도 안정적으로 처리할 수 있는 n8n Docker 구성을 위해, 전문 데이터베이스인 PostgreSQL을 연동하는 것이 좋습니다. PostgreSQL은 여러 워크플로우가 동시에 실행되어도 효율적으로 데이터를 처리하며, 데이터의 안정성과 확장성 면에서 훨씬 뛰어납니다.

PostgreSQL 연동 docker-compose.yml 코드

기존의 docker-compose.yml 파일을 아래와 같이 수정하세요. postgres라는 새로운 서비스가 추가되고, n8n 서비스의 environment 설정이 변경됩니다.

services:
  postgres:
    image: postgres:15
    container_name: n8n-postgres
    restart: always
    environment:
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=여기에_DB_비밀번호_입력
      - POSTGRES_DB=n8n
    volumes:
      - /volume1/docker/n8n-postgres:/var/lib/postgresql/data

  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - TZ=Asia/Seoul
      # --- DB 연결 정보 추가 ---
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=여기에_DB_비밀번호_입력
      # --- 기존 BASIC_AUTH 등 다른 환경변수는 그대로 유지 ---
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=여기에_관리자_ID_입력
      - N8N_BASIC_AUTH_PASSWORD=여기에_강력한_비밀번호_입력
    volumes:
      - /volume1/docker/n8n:/home/node/.n8n
    depends_on:
      - postgres

코드 해설

• postgres:: PostgreSQL 15 버전의 공식 이미지를 사용하여 n8n-postgres라는 이름의 데이터베이스 컨테이너를 생성합니다. 데이터베이스 사용자, 비밀번호, 이름을 환경 변수로 설정합니다.
• volumes: - /volume1/docker/n8n-postgres...: PostgreSQL의 모든 데이터를 NAS의 실제 폴더에 영구적으로 저장하여 데이터베이스의 안정성을 보장합니다.
• depends_on: - postgres: n8n 컨테이너가 시작되기 전에 postgres 컨테이너가 반드시 먼저 실행되도록 순서를 지정합니다. 데이터베이스가 준비되지 않은 상태에서 n8n이 실행되는 것을 방지합니다.
• DB_TYPE=postgresdb: n8n에게 기본 SQLite 대신 PostgreSQL을 사용하도록 알리는 가장 중요한 설정입니다.
• DB_POSTGRESDB_...: n8n이 postgres 서비스에 접속하는 데 필요한 호스트 이름, 사용자, 비밀번호 등 연결 정보를 전달합니다. DB_POSTGRESDB_HOST에 postgres라고 서비스 이름을 적으면 Docker의 내부 네트워크 기능이 알아서 IP를 찾아 연결해줍니다. 더 자세한 설정은 n8n 공식 문서의 Docker Compose 가이드(https://docs.n8n.io/hosting/installation/server-setups/docker-compose/)에서 확인할 수 있습니다.

유지보수 및 문제 해결

n8n을 설치하고 운영하다 보면 예상치 못한 문제들을 마주칠 수 있습니다. 이 섹션에서는 정기적으로 버전을 업데이트하는 방법과 사용자들이 자주 겪는 문제들에 대한 해결책을 FAQ 형식으로 정리했습니다. 문제가 발생했을 때 당황하지 않고 대처할 수 있도록 도와드립니다.

n8n 버전 업데이트 방법

n8n은 새로운 기능 추가와 버그 수정이 활발하게 이루어지므로 최신 버전을 유지하는 것이 좋습니다. docker-compose를 사용하면 데이터 손실 없이 매우 간단하고 안전하게 업데이트할 수 있습니다. docker-compose.yml 파일이 있는 폴더로 이동하여 아래 명령어들을 순서대로 실행하세요.

1. docker-compose pull: docker-compose.yml 파일에 명시된 n8nio/n8n:latest 이미지의 최신 버전을 Docker Hub에서 다운로드합니다.
2. docker-compose up -d: 다운로드한 새 이미지를 기반으로 기존 n8n 컨테이너를 중지하고, 새로운 버전의 컨테이너를 생성하여 실행합니다. 볼륨(volumes) 설정으로 데이터 폴더가 NAS에 연결되어 있기 때문에, 기존의 모든 워크플로우와 설정은 그대로 유지됩니다. 이 업데이트 방식은 n8n 공식 Docker Hub 업데이트 가이드(https://hub.docker.com/r/n8nio/n8n)에서도 권장하는 표준 절차입니다.

마무리: 성공적인 나만의 자동화 허브 구축 완료

지금까지의 NAS n8n 설치 가이드를 충실히 따라오셨다면, 여러분은 이제 Docker를 활용한 안정적인 n8n 셀프 호스팅 설치 방법을 완벽히 익히고, 나아가 데이터베이스 연동과 HTTPS 보안 설정까지 마친 자신만의 강력한 자동화 허브를 갖게 되었습니다. 클라우드 서비스에 의존하지 않고 데이터 주권을 지키며, 비용 걱정 없이 무한한 자동화의 가능성을 탐색할 수 있는 기반이 마련된 것입니다.

마지막으로, 모든 과정이 성공적으로 완료되었는지 아래의 최종 체크리스트를 통해 확인해 보세요.

최종 체크리스트

• [x] Container Manager(Docker) 설치 및 실행 완료
• [x] docker-compose.yml 파일 작성 및 환경변수 설정 완료
• [x] 데이터 저장을 위한 볼륨 마운트 설정 완료
• [x] n8n 컨테이너 정상 실행 및 웹 접속 확인 완료
• [x] n8n Owner 계정 생성 완료
• [x] (선택) 리버스 프록시 및 HTTPS 설정 완료
• [x] (선택) PostgreSQL 데이터베이스 연동 완료

이 모든 항목을 확인했다면 진심으로 축하드립니다! 이제 여러분은 n8n의 무궁무진한 기능을 활용할 준비가 되었습니다.

다음 단계 제안

• 첫 워크플로우 만들어보기: 가장 간단한 워크플로우부터 시작해 보세요. 예를 들어, ‘매일 아침 9시에 오늘의 날씨 정보를 내가 쓰는 슬랙(Slack)이나 텔레그램으로 보내기’ 같은 워크플로우는 n8n의 작동 방식을 이해하는 데 큰 도움이 됩니다.
• 커뮤니티와 라이브러리 탐색: n8n은 전 세계 수많은 사용자가 참여하는 활발한 커뮤니티를 가지고 있습니다. 공식 커뮤니티 포럼과 다른 사용자들이 만들어 공유한 수백 개의 워크플로우 라이브러리를 탐색하며 새로운 자동화 아이디어를 얻어보세요.

이제 여러분의 시간과 노력을 아껴줄 자동화의 세계로 뛰어들 시간입니다. 반복적인 업무는 n8n에게 맡기고, 여러분은 더 창의적이고 중요한 일에 집중하세요.

자주 묻는 질문 (FAQ)

Q: 5678 포트로 접속이 안 돼요.

A: 가장 먼저 컨테이너가 정상적으로 실행 중인지 확인해야 합니다. SSH 터미널에서 docker ps 명령어를 입력했을 때 n8n 컨테이너가 목록에 나타나야 합니다. 만약 컨테이너가 없다면 docker-compose up -d로 다시 실행하세요. 컨테이너가 실행 중인데도 접속이 안 된다면, NAS의 방화벽 설정에서 5678번 포트가 차단되어 있는지 확인하고, docker-compose.yml 파일의 ports 설정에 오타가 없는지 다시 한번 점검해 보세요.

Q: 워크플로우 실행 중 ‘Out of Memory’ 오류가 발생해요.

A: 이는 n8n 컨테이너에 할당된 메모리보다 더 많은 메모리를 사용하는 워크플로우를 실행할 때 발생합니다. 먼저 NAS의 리소스 모니터를 통해 전체 RAM 사용량을 확인하고, 사용하지 않는 다른 패키지나 컨테이너를 중지하여 메모리를 확보하세요. 근본적인 해결책으로, 한 번에 수천 개의 데이터를 처리하는 워크플로우의 경우 n8n의 ‘Split in Batches’ 노드를 활용하는 것이 매우 효과적입니다. 이 노드는 대량의 데이터를 작은 묶음(배치)으로 나누어 순차적으로 처리하게 함으로써, 한 번에 필요한 메모리 양을 크게 줄여줍니다.

Q: 비밀번호를 잊어버렸어요.

A: 두 가지 경우에 따라 해결 방법이 다릅니다.

• N8N_BASIC_AUTH_PASSWORD (초기 접속 비밀번호): docker-compose.yml 파일을 열어 N8N_BASIC_AUTH_PASSWORD 값을 새로운 비밀번호로 수정한 뒤, 저장하고 docker-compose up -d 명령어로 컨테이너를 다시 생성하면 즉시 적용됩니다.
• n8n Owner 계정 비밀번호: 이 경우 n8n의 내장 명령어 도구(CLI)를 사용해야 합니다. SSH 터미널에서 아래 명령어를 실행하면 n8n의 사용자 데이터가 초기화되고, 다시 웹으로 접속했을 때 새로운 Owner 계정을 생성할 수 있습니다.
  docker exec -it -u node n8n n8n user-management:reset

이 글이 마음에 드세요?

RSS 피드를 구독하세요!