구글 클라우드(GCP) 맞춤형 n8n 마법의 설치 스크립트 | 가나투데이
구글 클라우드(GCP) 맞춤형 n8n 마법의 설치 스크립트 | 가나투데이
구글 클라우드(GCP) 맞춤형 n8n 마법의 설치 스크립트를 준비했습니다. 이 스크립트는 단순히 설치만 하는 게 아니라, 서버의 기초 공사(Docker 설치)부터 n8n의 집(컨테이너)을 짓는 것까지 한 방에 끝내줍니다.
GCP 우분투 터미널에 접속해서 아래 내용을 순서대로 진행해 보세요.
[Step 1] 도커 및 기본 인프라 원클릭 설치 스크립트
GCP 터미널(SSH)에 접속하자마자 아래 명령어를 복사해서 붙여넣으세요. 서버를 n8n이 살 수 있는 최적의 상태로 만듭니다.
# 1. 시스템 업데이트 및 필수 도구 설치
sudo apt-get update && sudo apt-get install -y docker.io docker-compose git
# 2. 도커 서비스 활성화 및 현재 사용자 권한 부여
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER
# 3. 설치 확인 (버전이 나오면 성공!)
docker --version && docker-compose --version
[Step 2] n8n 실행을 위한 마법의 Docker-Compose 코드
이제 n8n을 24시간 돌릴 설정 도면을 만듭니다. 터미널에서 nano docker-compose.yml을 입력하고 아래 내용을 복사해서 붙여넣은 뒤 Ctrl+O, Enter, Ctrl+X로 저장하세요.
version: '3.8'
services:
n8n:
image: n8nio/n8n:latest
container_name: n8n_agent
restart: always
ports:
- "5678:5678"
environment:
- N8N_HOST=0.0.0.0
- N8N_PORT=5678
- N8N_PROTOCOL=http
- NODE_ENV=production
- WEBHOOK_URL=http://[너의-GCP-외부-IP]:5678/
- GENERIC_TIMEZONE=Asia/Seoul
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:
주의:
[너의-GCP-외부-IP]부분은 GCP 콘솔에서 확인한 본인의 정적 IP로 꼭 바꿔주세요!
[Step 3] 에이전트 깨우기 (마지막 단계)
도면 작성이 끝났다면, 아래 명령어로 에이전트를 세상 밖으로 불러냅니다.
docker-compose up -d
내부 로직 스캔:
-d옵션은 '백그라운드 실행'을 의미합니다. 터미널 창을 꺼도 에이전트는 GCP 서버 안에서 24시간 계속 일하게 됩니다.
설치 후 에이전트 아키텍트의 꼼꼼한 체크리스트
스크립트를 돌렸는데도 접속이 안 된다면, GCP만의 방화벽 로직을 점검해야 합니다.
GCP 방화벽 개방: GCP 콘솔 -> VPC 네트워크 -> 방화벽에서 tcp:5678 포트를 허용하는 규칙을 만드세요. (이게 안 되어 있으면 에이전트가 밖으로 신호를 못 보냅니다.)
데이터 보존: 위 스크립트의
volumes설정 덕분에, 서버가 꺼지거나 도커를 재시작해도 친구가 짠 소중한 워크플로우와 API 키는 사라지지 않고 안전하게 보관됩니다.상시 감시:
docker ps명령어를 입력했을 때n8n_agent가Up상태라면 에이전트가 건강하게 숨 쉬고 있다는 증거입니다.
#가나 투데이 #ganatoday
그린아프로




