[초보] 맥북 Docker로 n8n 셀프호스팅 완전 가이드
MCP·AI Agent를 내 맥북에서 무료로 무제한 운영하는 방법
클라우드 n8n 월 2만 원 대신, 맥북 전기세로 MCP(Model Context Protocol)와 AI Agent를 자유롭게 돌려보세요. Docker 컨테이너로 5분 만에 완성되는 초보자 친화적 셀프호스팅 가이드입니다.
🚀 왜 맥북 셀프호스팅인가?
Docker는 프로그램을 '격리된 상자(컨테이너)'에 담아 설치하는 기술입니다. n8n을 컨테이너로 실행하면 맥북 OS를 망가뜨릴 걱정 없이 안전하게 운영할 수 있습니다.
| 항목 | 클라우드 n8n | 맥북 Docker |
|---|---|---|
| 비용 | 월 2만~10만 원 | 무료 (전기세만) |
| AI Agent 제한 | API 호출당 과금 | Ollama 무료 무제한 |
| MCP 활용 | 플랜 제한 | 커뮤니티 노드 무제한 |
📱 1. Goodle Cloud준비
google cloud 가입
- google cloud console에 접속합니다.
- "프로젝트 만들기"버튼을 클릭합니다.
- 프로젝트이름을 입력하고, "만들기"를 누릅니다.
google cloud console에 접속하기
가입시, 계좌 번호를 입력해야 하며 90동안 사용할 300달러 크래딧을 주고 이용할수있게합니다. 이후 과금됩니다.
📱 5분 설치: Docker Desktop 활용법
Step 1: Docker Desktop 설치
- docker.com 접속 → Docker Desktop 다운로드
- 맥북(M1/M2/M4)에 맞는 .dmg 파일 설치 (3분 소요)
- Docker 실행 → 처음 실행 시 Apple Silicon 최적화 허용
Step 2: n8n 컨테이너 Pull & Run
Docker Desktop GUI 방식 (초보 추천)
- Docker Desktop 실행 → 검색창에 "n8n" 입력
n8nio/n8n:latest(★ 최상위 다운로드 순) 선택 → PULL- RUN 클릭 → 컨테이너 설정 화면 등장
Step 3: 컨테이너 설정 (핵심!)
| 설정항목 | 입력값 | 설명 |
|---|---|---|
| 컨테이너 이름 | n8n-server | 자신만의 이름 자유 설정 |
| Host Path | /Users/사용자명/n8n-data | 맥북 로컬 폴더 (자동생성) |
| Container Path | /home/node/.n8n | n8n 공식 경로 (고정) |
| 포트 | 5678:5678 | 외부:내부 포트 매핑 |
💡 Host Path는 필수! 이 경로에 워크플로우 데이터가 영구 저장됩니다.
✅ 실행 & 첫 접속
설정 완료 후 RUN 클릭 → 30초 대기 → http://localhost:5678 접속!
- n8n 로그인 화면 등장 → 계정 생성
- Queue Mode 활성화 (M4 칩 권장)
- 첫 워크플로우 "Hello World" 생성 테스트
🎉 성공! 이제 MCP, AI Agent 무제한 활용 가능
⚠️ 시행착오 극복: 초보자 함정 3가지
1️⃣ Safari 접속 불가 → Chrome 필수
맥북 Safari에서는 localhost:5678이 로딩되지 않습니다. Chrome 또는 Firefox로 변경하세요.
2️⃣ Host Path 누락 → 데이터 영구 삭제
컨테이너 재시작 시 모든 워크플로우 사라짐. 반드시 /Users/사용자명/n8n-data 매핑 필수!
3️⃣ Docker 메모리 부족 → M4 Pro 24GB 권장
Docker Desktop → Preferences → Resources에서 메모리 8GB 이상 할당
📈 배운 점 & 자신감 UP
- 유튜브 셀프호스팅 영상 중 Docker Desktop GUI 방식이 가장 쉽습니다
- 컨테이너 개념 이해 → 다른 오픈소스도 쉽게 설치 가능
- 시행착오 경험 → MCP/AI Agent 프로젝트 자신감 폭발!
- 전기세 3천 원으로 클라우드 10만 원 가치 창출
