제2부: 도커(Docker)로 n8n 5분 만에 올리기 (실행 중심 따라하기)| 가나투데이

제2부: 도커(Docker)로 n8n 5분 만에 올리기 (실행 중심 따라하기)

1. [준비물] 딱 두 가지만 챙기세요

  • 제1부에서 만든 GCP 서버

  • 복사(Ctrl+C)와 붙여넣기(Ctrl+V)를 할 수 있는 자신감


2. [따라하기] 실패 없는 3단계 실행 가이드

1단계: 서버의 문 열기 (SSH 접속)

먼저 내 서버 안으로 들어가야 명령을 내릴 수 있습니다.

  1. [GCP 콘솔]에 접속하여 내 인스턴스 오른쪽의 'SSH' 버튼을 누릅니다.

  2. 잠시 후 나타나는 검은색 창이 뜨면 준비 끝입니다.

2단계: 도커 엔진 설치 (복사해서 붙여넣기)

아래 코드를 하나씩 복사해서 SSH 창에 넣고 엔터를 치세요. (오른쪽 마우스 클릭 시 붙여넣기가 됩니다.)

  • 도커 원클릭 설치 스크립트:

Bash
curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh

진행 상황 확인: 화면에 흰색 글자들이 빠르게 지나가며 설치가 진행됩니다. 마지막에 Docker version 2x.x.x 문구가 보이면 성공입니다.

  • 사용자 권한 설정 (명령어 입력 후 재접속 필수!):

Bash
sudo usermod -aG docker $USER

중요: 이 명령어를 치고 나서 SSH 창을 완전히 닫았다가 다시 'SSH' 버튼을 눌러 새로 접속하세요. 이 과정을 생략하면 도커 실행 시 '권한 거부(Permission Denied)' 오류가 발생합니다.

3단계: n8n 엔진 가동하기 (최종 단계)

다시 열린 SSH 창에 아래의 '마법의 한 줄'을 복사해서 넣으세요.

Bash
docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n
  • 무슨 일이 일어나나요? 서버가 n8n 프로그램을 인터넷에서 자동으로 다운로드(Pull)하고 실행합니다. 약 1분 정도 소요됩니다.


3. [최종 확인] 내 자동화 주소로 접속하기

이제 모든 구축이 끝났습니다. 실제로 내 자동화 비서가 살아있는지 확인해 봅시다.

  1. 내 외부 IP 확인: GCP 화면의 '외부 IP' 숫자를 복사하세요. (예: 34.123.45.67)

  2. 주소창에 입력: 브라우저 새 탭을 열고 http://내외부IP:5678을 입력합니다.

  3. 결과: n8n 로고와 함께 계정 생성 화면이 나오면 완벽하게 성공입니다!


4. 자주 묻는 질문 (FAQ)

  • Q: 주소를 입력했는데 접속이 안 돼요!

    • A: 제1부의 4단계(방화벽 설정)에서 5678 포트를 열었는지 다시 한번 확인해 주세요.

  • Q: SSH 창을 꺼도 자동화가 계속 돌아가나요?

    • A: 네! 도커의 -d(백그라운드) 옵션 덕분에 여러분이 잠을 자거나 컴퓨터를 꺼도 서버는 24시간 가동됩니다.

#가나 투데이 #ganatoday

그린아프로