n8n을 NAS에 설치해보면 예상보다 막히는 부분이 많다. 공식 문서를 따라 해도 컨테이너가 제대로 안 뜨거나 포트가 충돌하고, 외부에서 접속할 때는 아예 하얀 화면만 나올 때도 있다.
클라우드 SaaS를 쓰자니 워크플로우가 많아질수록 비용이 부담스럽고, 라즈베리파이로 돌리기엔 성능이 아슬아슬하다. 그래서 이미 집이나 사무실에 NAS가 있다면, 그 위에 n8n을 올리는 게 현실적인 대안이다. 시놀로지든 QNAP이든 Docker만 지원된다면 시작할 수 있다.
단순히 설치만 하는 게 아니라, 안정적으로 잘 돌아가게 만드는 게 진짜 어렵다. 포트 매핑, 볼륨 마운트, 리버스 프록시, SSL 인증서, 자동 업데이트까지 한 번에 제대로 세팅하지 않으면 나중에 꼭 삽질하게 된다.
실제로 NAS에 n8n을 올릴 때 가장 신경써야 할 부분은 Docker 명령어 자체보다, NAS만의 특이한 권한 구조와 네트워크 세팅을 꼼꼼히 맞추는 과정이다. 컨테이너는 무리 없이 작동하는 듯 보이지만, 정작 저장이 안 되거나 내부에서는 접속이 되는데 외부 웹훅이 실패하고, 재부팅 후에는 컨테이너가 제대로 올라오지 않는 등 문제는 대부분 설치 직후가 아닌 며칠 운영한 뒤에 발생한다. 이런 이유에서 설치 가이드 역시 단순히 “실행됐다”에서 끝내서는 부족하다. 데이터 보존과 외부 접속까지 두루 챙겨야 훨씬 안전하게 운영할 수 있다.
실패 사례에도 반복되는 패턴이 있다. 첫 번째는 볼륨 마운트를 빼먹어서 업데이트 후 워크플로우가 몽땅 사라지는 경우다. 두 번째는 WEBHOOK_URL을 NAS 내부 주소나 localhost로 설정해 외부 서비스 연동이 꼬이는 사례, 세 번째는 리버스 프록시와 HTTPS 적용을 뒤로 미루다 나중에 인증서, 포트 포워딩, DNS까지 한꺼번에 손보느라 진땀을 빼는 경우다. 결국 NAS 셀프호스팅에서는 설치 자체보다, 운영 구조를 처음부터 제대로 정리하는 게 훨씬 중요하다.
💡 3줄 요약
- 시놀로지나 QNAP NAS에서 Docker를 이용해 n8n을 직접 설치하면 별도의 월 구독료 없이 자동화 서버를 구축할 수 있다.
- 포트 5678 매핑, 영구 볼륨 설정, 환경변수 세팅이 핵심이고, 외부 접속을 위해 리버스 프록시와 HTTPS 설정도 필요하다.
- NAS 모델에 따라 CPU·RAM 제약이 있으니, 워크플로우가 무거워지면 리소스 부족 문제를 겪을 수 있다는 점을 꼭 염두에 둬야 한다.
n8n NAS 설치 전 체크리스트
모든 NAS가 똑같지 않다. Docker를 사용하려면 최소한 인텔이나 AMD 기반의 x86 CPU가 필요하다. ARM 계열 보급형 NAS는 n8n 이미지가 아예 실행되지 않거나, 겨우 돌아가더라도 성능 저하가 심할 수 있다.
RAM도 빼놓을 수 없다. n8n 컨테이너 자체는 보통 200~400MB 정도지만, 워크플로우가 복잡해지고 동시에 여러 작업이 돌아가면 금방 1GB를 넘긴다. 최소 4GB RAM을 권장하고, Plex나 Surveillance Station처럼 다른 패키지까지 함께 사용한다면 8GB 이상이 안전하다.
| 확인 항목 | 최소 사양 | 권장 사양 |
|---|---|---|
| CPU 아키텍처 | x86_64 (Intel Celeron 이상) | Intel Core / AMD Ryzen 임베디드 |
| RAM | 2GB (n8n 단독) | 4GB~8GB |
| Docker 지원 | 시놀로지: Container Manager / QNAP: Container Station | 동일 |
| 여유 저장 공간 | 1GB 이상 | 5GB 이상 (이미지 + 데이터) |
1. NAS 모델별 Docker 지원 여부 확인
시놀로지의 경우 DSM 7.x 이상이 설치된 모델이어야 ‘Container Manager’ 패키지를 사용할 수 있다. DS220j처럼 J 시리즈(ARM 기반)는 Docker를 지원하지 않으니, DS220+, DS720+, DS923+처럼 ‘플러스(+) 시리즈’ 이상을 선택해야 한다.
QNAP NAS도 Docker 지원 범위가 넓은 편이지만, TS-x28A 같은 ARM 기반 모델은 일부 제약이 있다. 먼저 QTS의 App Center에서 ‘Container Station’ 설치 가능 여부를 확인하자.
2. SSH 접속 및 Docker Compose 사용 가능 여부
그래픽 인터페이스(GUI)만으로도 n8n을 NAS에 설치할 수 있기는 하다. 그래도 직접 SSH로 접속해서 Docker Compose 파일을 작성하는 쪽이 훨씬 깔끔하고 관리가 쉽다. 환경변수, 볼륨 경로, 네트워크 설정까지 모두 YAML 파일 하나로 관리할 수 있기 때문이다.
시놀로지에서 SSH 기능을 켜려면 ‘제어판 → 터미널 및 SNMP → 터미널’ 탭에서 SSH 활성화를 선택하면 된다. QNAP은 ‘제어판 → 네트워크 및 파일 서비스 → 텔넷/SSH’ 메뉴에서 SSH를 켤 수 있다.
Docker 기반 설치 방식 전체를 먼저 비교하고 싶다면 [관련 글: n8n 설치 방식 로컬부터 클라우드까지 총정리 더 알아보기], 외부 서버에 올리는 대안이 궁금하다면 [관련 글: n8n oracle cloud 무료 서버 설치 가이드 더 알아보기]를 같이 보면 NAS 설치의 장단점이 더 분명해진다.

이 글은 n8n NAS 설치 Docker로 자동화 서버 구축하기를 처음 적용하는 사람보다도, 이미 한두 번 시도해봤지만 설정 기준이 매번 헷갈렸던 사람에게 더 도움이 되도록 정리했다. 단순 기능 소개보다 실제로 어디서 막히는지, 무엇을 먼저 확인해야 덜 돌아가게 되는지에 초점을 맞췄다.
특히 이 주제는 비슷한 설명이 반복되는 경우가 많아 보이지만, 실제 작업에서는 환경과 목적에 따라 판단 기준이 달라진다. 그래서 아래 내용도 정답 하나를 밀어붙이기보다, 선택이 갈리는 지점을 중심으로 읽는 편이 훨씬 도움이 된다.
시놀로지 NAS에 n8n Docker 설치하는 방법
시놀로지 사용자는 보통 두 가지 방법 중 하나를 선택한다. Container Manager GUI를 이용하거나, 또는 SSH로 접속해 Docker Compose를 실행하는 것이다. 어떤 방법을 선택해도 결과는 같다.
3. GUI 방식: Container Manager로 설치
DSM에 로그인해서 Container Manager를 연다. ‘레지스트리’ 탭에서 n8nio/n8n을 검색한 뒤, latest 태그를 골라 이미지를 다운로드한다. 이미지 용량은 약 400~600MB 정도다.
다운로드가 끝나면 ‘이미지’ 탭에서 다운받은 이미지를 선택하고 ‘실행’을 누른다. 컨테이너 이름을 n8n으로 하면 추후 관리가 편하다. 포트 매핑은 로컬 5678 포트를 컨테이너 5678 포트에 연결하면 된다. 만약 5678 포트가 이미 다른 서비스에 사용 중이라면, 5679 같은 다른 포트를 로컬 포트로 지정해도 상관없다.
이때 가장 중요한 게 바로 볼륨 마운트 설정이다. 이걸 하지 않으면 컨테이너를 재시작하거나 이미지를 업데이트할 때, 워크플로우 데이터가 모두 사라진다. 미리 NAS 내에 /docker/n8n 폴더를 만들고, 컨테이너 내부 경로인 /home/node/.n8n에 바인딩해주면 안전하다.
4. CLI 방식: Docker Compose로 설치
SSH로 NAS에 접속한 뒤, 원하는 디렉터리(예: /volume1/docker/n8n)에 docker-compose.yml 파일을 만든다. 아래는 실무에서 추천하는 안정적인 예시다.
version: "3.8"
services:
n8n:
image: n8nio/n8n:latest
container_name: n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_HOST=your-domain.com
- N8N_PORT=5678
- N8N_PROTOCOL=https
- WEBHOOK_URL=https://your-domain.com/
- GENERIC_TIMEZONE=Asia/Seoul
- TZ=Asia/Seoul
volumes:
- ./n8n_data:/home/node/.n8ndocker-compose up -d 명령어를 실행하면 백그라운드에서 n8n이 바로 시작된다. 이후 브라우저에서 http://NAS_IP:5678로 접속해서 계정 생성 화면이 잘 나온다면 성공이다.
특히 환경변수 중 WEBHOOK_URL은 외부 서비스와 연동할 때 반드시 제대로 된 도메인으로 지정해야 한다. 여기서 실수가 있으면 웹훅 트리거가 엉뚱한 주소로 값을 돌려주는 문제가 생길 수 있으니 주의하자.
웹훅 URL과 외부 접근 주소를 함께 맞추는 방법은 [관련 글: n8n 웹훅 설정 가이드 오류 없이 연결하는 법 더 알아보기]를 같이 보면 훨씬 이해가 빠르다.

QNAP NAS에서 n8n 설치 실전 가이드
QNAP을 사용한다면 자연스럽게 Container Station을 쓰게 된다. 시놀로지와 전체적인 흐름은 비슷하지만, 인터페이스가 다르기 때문에 처음엔 헷갈릴 수 있다.
5. Container Station에서 n8n 이미지 배포하기
먼저 QTS의 App Center에서 Container Station을 설치한다. 그 다음, ‘생성’ 메뉴에서 Docker Hub 이미지를 검색해 n8nio/n8n을 찾고 latest 버전을 받아오면 된다.
컨테이너를 만들 때는 ‘고급 설정’을 꼭 눌러야 한다. 여기에서 포트 매핑(호스트 5678 → 컨테이너 5678), 공유 폴더와 볼륨 매핑, 환경변수 등을 모두 지정할 수 있다. QNAP의 경우 공유 폴더 경로가 주로 /share/Container/n8n_data처럼 되기 때문에, 자신의 NAS 폴더 구조를 미리 확인해서 올바르게 매핑해주면 된다.
6. QNAP만의 네트워크 이슈 해결법
QNAP에서는 브릿지 네트워크 모드가 기본으로 설정되어 있어서, 간혹 NAS 내부의 다른 서비스와 포트가 충돌할 때가 있다. 이런 경우엔 네트워크 모드를 호스트로 바꾸거나, 사용하지 않는 포트 번호로 변경하면 보통 문제없이 해결된다.
또 하나 알아둘 점이 있다. QNAP의 방화벽인 QuFirewall이 활성화되어 있으면 5678 포트를 따로 허용해줘야 한다. 이 설정을 빼먹고 한참 접속이 안 돼서 고생하는 일이 생각보다 많으니, 꼭 확인해두자.

외부 접속과 HTTPS, 리버스 프록시 설정
NAS 내부에서는 보통 http://192.168.x.x:5678처럼 로컬 IP로 쉽게 접속할 수 있다. 문제는 밖에 나와서, 예를 들어 카페처럼 외부 네트워크에서 노트북으로, 혹은 외부 서비스의 웹훅 콜백 등 외부에서 n8n에 접속해야 할 때다.
7. 리버스 프록시로 도메인 연결하기
시놀로지 DSM에는 리버스 프록시 기능이 기본 내장되어 있다. 제어판 → 로그인 포털 → 고급 → 리버스 프록시에서 새 규칙을 추가하면 된다. 소스는 https://n8n.your-domain.com(443), 대상은 http://localhost:5678로 지정해 주면 된다.
QNAP의 경우, 시놀로지처럼 내장 기능이 바로 제공되는 게 아니라 주로 Nginx나 Traefik을 별도의 컨테이너 형태로 띄워서 프록시 역할을 맡긴다. 직접 설정하는 작업이 조금 더 필요하다.
HTTPS를 적용하지 않으면, 웹훅을 연동할 때 보안 경고가 뜨거나, 일부 외부 서비스는 연결 자체를 거부하기도 한다. 이런 경우 무료인 Let’s Encrypt 인증서를 발급받아 적용하는 것이 현실적인 선택이다. 시놀로지 DSM에서는 제어판 → 보안 → 인증서 메뉴에서 쉽게 인증서를 받을 수 있고, QNAP도 QTS 시스템 내에서 비슷하게 지원된다.
8. DDNS와 포트 포워딩 설정
고정 IP가 없다면 DDNS(동적 도메인 서비스)를 써야 외부 접속이 편하다. 시놀로지는 자체적으로 synology.me와 같은 DDNS를 제공하고, QNAP 역시 myQNAPcloud에서 도메인을 할당받을 수 있다. 그리고 공유기에서 외부 포트 443을 NAS의 내부 IP의 443 포트로 포워딩해두면 외부에서도 HTTPS로 접속이 가능하다.
만약 공유기 설정이 복잡하게 느껴진다면, Cloudflare Tunnel 같은 방법도 있다. NAS에 cloudflared 컨테이너를 하나 더 올리면, 포트 포워딩 없이 외부 접속 통로가 열린다. 실제로 보안 면에서도 더 안전하다고 평가받는 방법이다.
웹훅을 외부에서 안정적으로 받으려면 단순 접속보다 보안 설정이 더 중요하다. 이 부분은 [관련 글: n8n Credential과 웹훅 완벽 방어 전략 더 알아보기]까지 같이 보면 세팅을 더 안전하게 가져갈 수 있다.
n8n NAS 설치 후 트러블슈팅
설치는 마쳤는데 뭔가 잘 안 된다면, 아래 대표적인 상황을 점검해보자.
9. 컨테이너가 시작 직후 종료되는 경우
대부분은 볼륨 권한 문제다. n8n 컨테이너에서는 node 유저(UID 1000)로 프로세스가 동작하는데, NAS에서 해당 폴더의 소유자가 root나 다른 UID라면 쓸 권한이 부족해서 바로 종료된다. SSH로 접속한 뒤 sudo chown -R 1000:1000 /volume1/docker/n8n/n8n_data 명령을 실행하면 해결된다. QNAP도 경로만 다를 뿐 같은 방식이다.
10. 웹훅 URL이 localhost로 표시되는 문제
Docker Compose나 환경변수 설정에서 WEBHOOK_URL 값을 빼먹었거나 잘못 입력한 경우다. n8n이 웹훅 주소를 생성할 때 이 값을 참고하기 때문에, 반드시 실제 외부 도메인 주소를 프로토콜(https://)까지 포함해서 정확히 입력해야 한다.
11. 업데이트 시 데이터 유실 방지
n8n은 새로운 버전이 자주 나오기 때문에, 컨테이너 이미지를 갱신할 때 볼륨이 제대로 마운트되어 있으면 데이터는 그대로 유지된다. 그래도 만에 하나를 대비해 업데이트 전에는 .n8n 폴더 전체를 백업하는 습관을 들여두자.
Docker Compose를 사용한다면 docker-compose pull로 최신 이미지를 받고, docker-compose up -d로 컨테이너를 재시작하면 된다. 기존 볼륨 데이터를 그대로 쓰므로 워크플로우, 크레덴셜 등도 그대로 살아 있다.
업데이트와 롤백 루틴은 설치 직후 같이 잡아두는 편이 훨씬 낫다. [관련 글: n8n 업데이트 방법, 백업과 롤백까지 완벽 정리 더 알아보기]를 같이 보면 나중에 버전 올릴 때 훨씬 덜 헤맨다.
📌 핵심 포인트 & 주의사항
NAS의 CPU와 RAM 자원은 한계가 있다. 워크플로우를 10~20개 정도 돌릴 때는 무리가 없지만, HTTP Request 노드를 수백 개씩 동시에 실행하거나 대용량 파일을 처리하면 NAS 전체 속도가 크게 저하될 수 있다. 이런 상황에서는 n8n 컨테이너에 CPU와 메모리 사용량 제한을 설정해 두는 게 다른 서비스에 영향을 주지 않는 데 도움이 된다.
또한, n8n을 직접 설치해서 운영할 때는 보안 업데이트도 직접 관리해야 한다. 클라우드 서비스처럼 자동으로 패치해 주지 않으니, 이미지를 주기적으로 최신 버전으로 업데이트하고 NAS 자체 보안 설정도 꼼꼼히 확인하는 것이 좋다.
n8n NAS 설치 vs 클라우드 호스팅 비교
어떤 방식이 더 좋은지는 각자의 상황에 따라 달라진다. 어느 한쪽이 무조건 낫다고 말하긴 어렵다.
| 비교 항목 | NAS 셀프호스팅 | n8n Cloud |
|---|---|---|
| 월 비용 | 전기료만 부담 (NAS를 이미 쓰고 있다면) | 월 20~50달러대 (플랜에 따라 다름) |
| 설치 난이도 | 중~상 (Docker와 네트워크 기본 지식 필요) | 하 (회원가입만 하면 바로 사용) |
| 데이터 통제권 | 직접 100% 관리 | n8n 서버에 데이터 저장 |
| 가동 안정성 | 정전·NAS 장애 시 중단 가능 | 99.9% 이상 SLA 제공 |
| 보안 업데이트 | 직접 수동으로 관리 | 자동 적용 |
만약 민감한 사내 데이터를 다루거나, 외부 클라우드에 중요 정보(크레덴셜 등)를 맡기는 게 불안하다면 NAS 셀프호스팅이 확실한 장점이 있다. 반대로, 설치나 유지관리 시간 투자 자체가 부담이거나 24시간 무중단이 꼭 필요한 비즈니스라면 클라우드 호스팅이 더 현실적이다.
처음엔 n8n NAS 설치가 살짝 어렵게 느껴질 수 있지만, 한 번만 제대로 세팅해두면 매달 구독료를 신경 쓸 필요 없이 내 맘대로 자동화 환경을 꾸릴 수 있다. 볼륨 매핑, 권한 설정, 리버스 프록시 이 세 가지만 제대로 세팅하면 운영도 그리 어렵지 않다. 막히는 부분이 있으면 n8n 커뮤니티 포럼에 검색해 보자. 직접 만든 자동화 서버가 반복 작업을 하나씩 처리해주는 순간, 노력한 보람을 분명히 느낄 수 있을 것이다.
다음 단계
여기까지 따라왔다면, 이제 남은 다음 단계는 세 가지다. 먼저, 단순 설치에서 멈추지 않고 백업과 업데이트 루틴까지 미리 엮어 두는 것. 두 번째는 외부 웹훅과 HTTPS 구조를 안정적으로 연결해 실제 서비스 환경에 올리는 것. 마지막으로 NAS 자원의 한계를 고려해, 무거운 워크플로우와 가벼운 워크플로우를 구분해 운영 전략을 세우는 일이다. NAS에 n8n을 올리는 과정은 다소 복잡할 수 있지만, 초반에 구조를 잘 잡아두면 이후 운영이 훨씬 편안해진다.
다음 단계 학습용으로는 [관련 글: n8n 업데이트 방법, 백업과 롤백까지 완벽 정리 더 알아보기], [관련 글: n8n 웹훅 설정 가이드 오류 없이 연결하는 법 더 알아보기], [관련 글: n8n Credential과 웹훅 완벽 방어 전략 더 알아보기] 순서로 이어 보면 NAS 셀프호스팅을 더 안정적으로 운영하기 좋다.
참고 자료:
n8n 공식 셀프호스팅 문서 |
Docker Hub – n8nio/n8n |
Docker Compose 공식 문서 |
Let’s Encrypt 공식 사이트
