Node-RED 는 스마트홈 자동화나 IoT 데이터를 시각적으로 처리하는 가장 직관적이고 강력한 도구 중 하나다.
Synology NAS와 함께 사용하면 24시간 안정적인 자동화 서버를 운영할 수 있다.
이 글에서는 **Container Manager(Docker)**를 이용해 설치하는 방법을 소개하며, GUI 설치와 Compose 방식 두 가지를 모두 다룬다.
🔗 더 자세한 정보는 공식 사이트에서 확인할 수 있다.
1. 설치 전 준비 사항
설치를 시작하기 전에 아래 조건이 충족되어야 한다.
- Synology NAS에 Container Manager(Docker) 패키지가 설치되어 있어야 한다.
(DSM > 패키지 센터 > “Container Manager” 검색 후 설치) - DSM 관리자 계정으로 로그인해야 한다.
- DSM 버전은 7.2 이상을 사용하는 것이 좋다.
2. Node-RED Docker Compose로 설치하는 방법 (추천)
GUI 설정 대신 구성 파일로 컨테이너를 설정하면 관리와 재설치가 훨씬 편리하다.
2-1. 공유 폴더 생성
DSM에서 /docker/node-red 같은 폴더를 만들어 데이터를 저장할 공간을 마련한다.
2-2. docker-compose.yml 작성
다음 내용을 포함한 docker-compose.yml 파일을 준비하거나 프로젝트 생성에서 직접 작성한다.
version: "3.9"
services:
node-red:
image: nodered/node-red:latest
container_name: Node-RED
hostname: node-red
mem_limit: 1g
mem_reservation: 128m
cpu_shares: 1024
security_opt:
- no-new-privileges:true
read_only: true
user: 1026:100
ports:
- 6336:1880
volumes:
- /volume1/docker/node-red:/data:rw
environment:
TZ: Asia/Seoul
restart: on-failure:5
/volume1/docker/node-red는 NAS 실제 경로에 맞게 수정한다.
도메인에 연결하여 사용하려면 Web Station을 통해 웹 포털 생성을 체크한다.
설정을 확인하고 완료 버튼을 클리갛여 프로젝트 생성을 완료한다.
2-3. 컨테이너 실행
프로젝트가 생성되면 프로젝트 시작에 체크하고 완료 버튼을 클릭하면 프로젝트 빌드가 시작된다.
컨테이너가 정상적으로 실행되면 웹 브라우저로 접속할 수 있다.
3. Container Manager(Docker)로 이미지 다운로드 및 설치
GUI 기반 설치가 익숙하다면 Container Manager(Docker) 앱을 통해 설치할 수 있다.
3-1. 이미지 다운로드
- DSM에서 Container Manager(Docker) 앱을 실행한다.
- 상단 메뉴에서 레지스트리 탭을 선택한다.
- 검색창에 “nodered” 를 입력하고, 공식 이미지를 선택해 다운로드한다.
3-2. 컨테이너 생성
- 이미지 탭에서 다운로드한 node-red 이미지를 선택하고 실행을 클릭한다.
- 컨테이너 이름은 예: node-red
- 고급 설정 메뉴에서 아래 항목을 설정한다:
- 자동 재시작 활성화
- 볼륨 마운트: /volume1/docker/node-red :/data
- 포트 설정: 로컬 포트 6336 → 컨테이너 포트 1880
- 환경변수: TZ → Asia/Seoul
설정 후 컨테이너를 시작하면 설치가 완료된다.
4. Node-RED 접속 확인
웹 브라우저에서 다음 주소로 접속해 대시보드를 확인한다.
http://Synology-ip-address:6336
정상 접속된다면 설치가 성공적으로 완료된 것이다.
5. 활용 예시
다양한 자동화 작업을 손쉽게 구성할 수 있는 도구다.
- MQTT 브로커 연결
- HTTP 요청 처리
- 스마트홈 디바이스 제어
- 대시보드 시각화 구성
블록을 연결하는 방식으로 플로우를 구성할 수 있어, 프로그래밍 지식 없이도 IoT 시스템을 구현할 수 있다.
6. Node-RED 보안 설정 권장사항
외부 네트워크에서 접근할 경우 보안을 강화해야 한다.
- 사용자 인증 설정 (settings.js 파일 수정)
- HTTPS 구성: DSM의 리버스 프록시 기능을 이용해 HTTPS 경로로 연결
- DSM 방화벽에서 1880 포트 접근을 제한
마무리
Synology NAS에 Node-RED를 설치하면, 손쉽게 구축 가능한 자동화 환경이 완성된다. **Container Manager(Docker)**를 이용하면 설치와 유지관리가 간단하며, Docker Compose 방식을 활용하면 재현성과 관리 효율이 더욱 향상된다. 스마트홈부터 공장 자동화까지 다양한 분야에서 강력한 도구로 활용될 수 있다.
