NAS에 N8N 설치 (ARM CPU 기반 Ubuntu, Odroid)

최근 다양한 시스템간 연계된 Flow로 처리되는 복잡한 구조를 자동화 도구로 처리하도록 하는 자신만의 시스템을 N8N 통해 많이들 활용하고 있습니다. 여기에 AI와 함께 연계하게 되면 나만의 AI Agent가 될 수 있는 거고요.

저도 이번에 집에 있는 ARM 칩 기반의 Ubuntu NAS 서버에 N8N을 설치하기로 마음먹고 설치하는 과정을 정리했어요. 아래 과정을 공유 드립니다~!

주의하실 점은, 대부분 가지고 계신 NAS는 Arm칩(보통 휴대폰에 들어가는 칩이에요) 기반의 NAS가 아닐거에요~ 본인의 NAS 서버 CPU 타입에 따라 아래 과정중 설치파일을 골라야 하는 점은 주의하세요!

 

---

🔧 Odroid NAS에 n8n 설치해보기 (ARM칩 기반의 서버 기준)

집에 있는 Odroid에 Ubuntu 올려서 NAS로 쓰고 계신다면, 여기에 자동화 툴인 n8n을 한 번 설치해보시는 것도 좋을 것 같아요. Docker로 간단하게 구성할 수 있어서 어렵지 않게 따라하실 수 있어요.

---

1. 먼저 준비물부터 확인해볼게요!

• Odroid 같은 ARM 계열 보드 (예: HC4, N2 등)
• Ubuntu 20.04 이상 설치되어 있어야 해요
• 외부에서 접속하려면 5678 포트 개방도 필요해요 (공유기 등에서)

---

2. Docker랑 Docker Compose 설치하기

터미널에서 아래 명령어를 차례대로 입력해주시면 돼요.

sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
sudo apt install docker-compose -y

(docker 명령어 쓸 때마다 sudo 치기 귀찮다면, sudo usermod -aG docker $USER 입력한 뒤 로그아웃했다가 다시 로그인하시면 돼요.)

---

3. n8n 폴더 만들어주기

mkdir ~/n8n-docker
cd ~/n8n-docker

---

4. docker-compose.yml 파일 작성하기

아래 내용을 복사해서 docker-compose.yml 파일로 저장해주세요.

version: "3"

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - TZ=Asia/Seoul
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=your_password
    volumes:
      - ./n8n_data:/home/node/.n8n

your_password 부분은 꼭 본인이 원하는 안전한 비밀번호로 바꿔주세요!

---

5. 이제 실행해볼게요

docker-compose up -d

그리고 웹 브라우저에서 http://NAS_IP:5678로 접속하면 n8n 화면이 뜰 거예요. 로그인하면 바로 사용하실 수 있어요.

---

6. 추가로 알아두시면 좋은 점

• n8n의 설정이나 워크플로우는 ./n8n_data 폴더에 저장되니까, NAS 백업과 같이 관리하시면 좋아요.
• 외부에서 Webhook을 사용하려면 N8N_HOST나 WEBHOOK_TUNNEL_URL 환경변수를 설정해주셔야 해요.
• ARM 기기에서도 n8nio/n8n 공식 이미지는 잘 돌아가니까 따로 신경쓸 부분은 많지 않아요.

---

n8n을 설치하고 나면 생각보다 다양한 자동화 작업들을 손쉽게 만들 수 있어서 꽤 유용해요. 집에서도 NAS 자동화, 알림, 파일 처리 같은 걸 자동으로 돌릴 수 있어서 아주 만족스럽더라고요. 나중에 간단한 워크플로우 예제도 소개해드릴게요. 😊

---

⚠️ 주의사항 한 가지!

만약 공식 이미지가 ARM 아키텍처 오류로 설치 안 된다면, 아래 중 하나를 선택하셔야 해요:

1. 임시 방법:
   비공식 이미지(harrygog/n8n-arm32v7) 사용하면 대부분 문제없이 돌아가요. 단, 신뢰성은 공식보다 떨어질 수 있어요.
2. 추천 방법:
   Odroid가 64비트 CPU라면, Ubuntu 64비트 OS로 재설치하면 공식 이미지(n8nio/n8n)도 바로 사용 가능해요.

그리고 docker-compose up 하다가 Continue with the new image? 라고 물어보면, y 눌러서 진행하셔도 돼요.
데이터는 n8n_data 폴더에 따로 저장되니까 안전해요. 혹시 모르니 백업은 한번 해두면 더 좋고요!