지식 공유/인공지능,자동화 지식

Synology NAS에 n8n 설치 및 Redis 연동 방법

대대소소 2025. 4. 22. 07:43
728x90

n8n은 노드 기반의 워크플로우 자동화 도구입니다. Redis는 데이터 캐시 및 메시지 큐로 사용할 수 있는 데이터베이스입니다. 이번 포스팅에서는 Synology NAS에 n8n을 설치하고 Redis와 연동하는 방법에 대해 설명합니다.

1. Docker 설치

n8n과 Redis는 Docker 컨테이너를 통해 설치할 수 있습니다. 따라서, 먼저 Synology NAS에 Docker를 설치해야 합니다.

  1. Synology 패키지 센터에서 Docker를 검색하고 설치합니다.
  2. 설치가 완료되면 Docker를 실행합니다.

2. Redis 설치

  1. Docker 앱에서 "이미지" 탭으로 이동합니다.
  2. 검색창에 "redis"를 입력하고 Enter 키를 누릅니다.
  3. "redis" 공식 이미지를 선택하고 "다운로드" 버튼을 클릭합니다.
  4. 이미지가 다운로드되면 "이미지" 탭에서 다운로드한 "redis" 이미지를 선택하고 "실행" 버튼을 클릭합니다.
  5. 컨테이너 이름을 원하는 대로 설정합니다.
  6. "고급 설정"을 클릭하고 "포트 설정" 탭으로 이동합니다. 로컬 포트와 컨테이너 포트 모두 6379로 설정합니다.
  7. "볼륨" 탭으로 이동하여 로컬 폴더를 Redis 컨테이너의 데이터 저장 경로 (/data)에 마운트합니다.
  8. "환경 변수" 탭에서 REQUIREPASS 변수를 추가하고 원하는 비밀번호를 입력합니다.
  9. "적용" 또는 "생성" 버튼을 클릭하여 Redis 컨테이너를 실행합니다.

3. n8n 설치

  1. Docker 앱에서 "이미지" 탭으로 이동합니다.
  2. 검색창에 "n8n"을 입력하고 Enter 키를 누릅니다.
  3. "n8nio/n8n" 공식 이미지를 선택하고 "다운로드" 버튼을 클릭합니다.
  4. 이미지가 다운로드되면 "이미지" 탭에서 다운로드한 "n8nio/n8n" 이미지를 선택하고 "실행" 버튼을 클릭합니다.
  5. 컨테이너 이름을 원하는 대로 설정합니다.
  6. "고급 설정"을 클릭하고 "포트 설정" 탭으로 이동합니다. 로컬 포트와 컨테이너 포트를 원하는 포트로 설정합니다.
  7. "볼륨" 탭으로 이동하여 로컬 폴더를 n8n 데이터 저장 경로 (/home/node/.n8n)에 마운트합니다.
  8. "환경 변수" 탭에서 다음 변수를 추가합니다.
    • N8N_HOST: NAS의 IP 주소 또는 도메인 이름을 입력합니다.
    • N8N_PORT: n8n 컨테이너에 설정한 로컬 포트를 입력합니다.
    • N8N_PROTOCOL: http 또는 https를 입력합니다.
    • N8N_ENCRYPTION_KEY: n8n의 암호화를 위한 임의의 강력한 문자열을 입력합니다.
    • EXECUTIONS_PROCESS: main으로 설정합니다.
    • QUEUE_BULL_REDIS_HOST: redis-n8n (2단계에서 설정한 Redis 컨테이너 이름) 또는 Redis 컨테이너가 실행 중인 NAS의 IP 주소를 입력합니다.
    • QUEUE_BULL_REDIS_PORT: 6379를 입력합니다.
    • QUEUE_BULL_REDIS_PASSWORD (선택 사항): Redis에 비밀번호를 설정했다면 해당 비밀번호를 입력합니다.
  9. "적용" 또는 "생성" 버튼을 클릭하여 n8n 컨테이너를 실행합니다.

4. n8n 접속 및 확인

  1. 웹 브라우저를 열고 http://[NAS_IP_주소]:[n8n_포트] 또는 https://[NAS_도메인]:[n8n_포트]로 접속합니다.
  2. n8n 초기 설정 화면이 나타나면 사용자 이름과 비밀번호를 설정합니다.
  3. n8n이 정상적으로 실행되면 Redis와의 연동도 자동으로 이루어집니다. 워크플로우 실행 시 데이터 처리 속도가 향상된 것을 확인할 수 있습니다.

추가 설정 및 고려 사항

  • n8n을 HTTPS로 안전하게 사용하려면 Reverse Proxy (예: Synology Application Portal 또는 Nginx Proxy Manager) 설정을 추가해야 합니다.
  • 여러 컨테이너를 관리하는 경우 Docker Compose를 사용하여 n8n과 Redis 컨테이너를 함께 정의하고 실행하는 것이 더 효율적일 수 있습니다.
  • NAS 방화벽에서 n8n과 Redis에 사용되는 포트가 열려 있는지 확인합니다.
  • 시놀로지 Resource Monitor를 통해 CPU, 메모리, 디스크 사용량 등을 확인하여 n8n과 Redis의 성능을 모니터링하는 것이 좋습니다.

이 포스팅이 Synology NAS에 n8n을 설치하고 Redis와 연동하는 데 도움이 되었기를 바랍니다.

728x90