n8n을 셀프호스팅하기 위한 가장 효율적인 방법 중 하나는 Docker를 사용하는 것입니다. Docker는 일관된 환경을 제공하며, 설치 및 실행이 간편해 초보자부터 전문가까지 폭넓게 활용할 수 있습니다. 이 글에서는 Docker로 n8n을 설치하고 실행하는 방법을 단계별로 안내합니다.
Docker란 무엇인가?
Docker는 애플리케이션을 컨테이너라는 독립적인 환경에서 실행할 수 있게 해주는 플랫폼입니다. 컨테이너를 사용하면 다양한 서버 환경에서도 동일한 실행 환경을 유지할 수 있어 n8n을 안정적으로 배포하는 데 매우 유리합니다.
1. Ubuntu에서 Docker 설치 방법
sudo apt update
sudo apt install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce
설치 후 Docker 서비스를 시작하고 부팅 시 자동 실행되도록 설정합니다:
sudo systemctl start docker
sudo systemctl enable docker정상 설치 확인:
docker --version2. n8n Docker 이미지 다운로드
Docker 설치가 완료되면, 아래 명령어로 n8n의 공식 Docker 이미지를 다운로드합니다:
docker pull n8nio/n8n이 명령어는 Docker Hub에서 최신 버전의 n8n 이미지를 가져옵니다.
3. n8n Docker 컨테이너 실행하기
다운로드한 이미지로 n8n 컨테이너를 실행하려면 다음 명령어를 입력합니다:
docker run -d --name n8n -p 5678:5678 n8nio/n8n-d: 백그라운드 실행--name n8n: 컨테이너 이름 지정-p 5678:5678: 로컬 포트와 컨테이너 포트를 매핑
웹 브라우저에서 http://localhost:5678로 접속하면 n8n 인터페이스에 접근할 수 있습니다.
4. 환경 변수로 커스터마이징
Docker 컨테이너 실행 시 환경 변수를 설정하여 데이터베이스 연결 등 다양한 기능을 설정할 수 있습니다.
PostgreSQL 연동 예시:
docker run -d --name n8n -p 5678:5678 \
-e DB_TYPE=postgresdb \
-e DB_POSTGRESDB_HOST=localhost \
-e DB_POSTGRESDB_PORT=5432 \
-e DB_POSTGRESDB_USER=n8n_user \
-e DB_POSTGRESDB_PASSWORD=your_password \
n8nio/n8n5. n8n 컨테이너 상태 확인 및 관리
실행 중인 컨테이너 확인:
docker ps컨테이너 중지:
docker stop n8n컨테이너 삭제:
docker rm n8n결론
Docker를 활용한 n8n 설치는 빠르고 효율적인 방법입니다. 이 과정을 통해 n8n을 빠르게 실행하고, 다양한 설정을 환경 변수로 적용할 수 있어 유지보수도 간편합니다. 이제 여러분은 Docker 기반의 n8n 셀프호스팅을 성공적으로 시작할 준비가 되셨습니다.
다음 강의에서는 Docker Compose를 활용한 n8n 구성을 소개합니다.