n8n Docker 설치 방법 및 실행 가이드
워크플로우 자동화 도구인 n8n은 다양한 API를 연결하고 자동화할 수 있는 강력한 오픈소스 솔루션입니다. Docker를 이용하면 복잡한 설치 과정 없이 빠르게 구성할 수 있으며, 설정과 배포도 간단합니다. 이번 글에서는 n8n을 Docker로 설치하는 방법과 실행 절차를 단계별로 안내해드립니다.
n8n이란?
n8n(Node for workflow automation)은 코드와 비코드 방식을 모두 지원하는 자동화 툴입니다. 슬랙, 구글시트, 트렐로, 깃허브 등 수백 가지 서비스를 연결할 수 있으며, 워크플로우 기반으로 자동화 로직을 시각적으로 구성할 수 있습니다.
공식 웹사이트는 n8n.io이며, 오픈소스 버전은 무료로 사용할 수 있습니다.
설치 준비 사항
1. 필요 환경
- Docker 및 Docker Compose 설치
- 리눅스, macOS 또는 WSL2 기반 Windows 환경
2. 권장 사항
- Node.js 설치는 필요 없음 (Docker 이미지에 포함)
- 포트 5678번 외부 개방 필요 (원격 접속 시)
👉 Docker가 설치되지 않았다면 공식 설치 가이드를 참고하세요.
Docker Compose 설정
아래 내용을 기준으로 docker-compose.yml 파일을 생성하세요.
```yaml version: '3' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=your_password - TZ=Asia/Seoul volumes: - ./n8n_data:/home/node/.n8n