왕초보도 ok n8n 설치 사용 가이드Even Total Beginners OK: n8n Installation and Usage Guide

n8n은 다른 미니pc나 다른 하드 에 설치할것 자동화용 24시간 돌리려면 그래야합니다 다른 방법도 있으니 찾아보시고여

2025 최신판 · 초보자 완벽 가이드

n8n
초보자 완벽 가이드

설치부터 자동화 워크플로우까지 — 코딩 없이 1시간 완성 ✨
보안 설정까지 빠짐없이 알려드려요! 🔐

⏱ 1시간 완성

🐳 Docker 추천

🔐 보안 중점

🌐 노코드 자동화

⭐ 오픈소스 무료

📚 목차 — 클릭하면 바로 이동!

1n8n이란 무엇인가? 2설치하기 (Docker) 3인터페이스 살펴보기 4첫 워크플로우 만들기 5🔐 보안 완벽 설정 6FAQ & 문제해결

1

n8n이란 무엇인가요?

n8n은 노코드(No-Code) 워크플로우 자동화 도구입니다. 마치 레고 블록처럼 앱과 서비스를 연결해 반복 작업을 자동화해요. Gmail → Slack → Notion 같은 복잡한 흐름도 클릭 몇 번으로 완성됩니다!

오픈소스라 완전 무료이고, 내 서버에 설치해 데이터를 100% 내가 관리해요. Zapier·Make의 오픈소스 대안입니다.

🆚 다른 툴과 비교

항목	n8n	Zapier	Make
가격	무료(셀프호스팅)	유료 $19.99~	일부 무료
데이터 소유	✅ 내 서버	❌ 클라우드	❌ 클라우드
코드 커스텀	JS/Python 가능	제한적	일부 가능
노드/앱 수	400+ 노드	6,000+ 앱	1,500+ 앱

💡 n8n으로 할 수 있는 것들

📧

이메일 자동화

Gmail / Outlook

💬

슬랙 알림

Slack / Discord

📝

노션 DB

Notion API

📊

구글 시트

Google Sheets

🤖

AI 연동

OpenAI / Claude

🐙

깃헙 이벤트

GitHub Actions

🛒

쇼핑몰 주문

Shopify / WooCommerce

📱

SNS 게시

Twitter / Instagram

⚙️ 설치 시작

2

설치하기 — Docker 추천!

💡

왜 Docker인가요? 설치가 가장 쉽고, 환경 오염이 없으며, 업데이트·삭제가 간편합니다. 초보자에게 최고의 선택!

🐳

Docker 추천

설치 쉬움 · 격리 환경 · 관리 편리

📦

npm 설치

Node.js 필요 · 개발자 선호

🐳 Docker 설치 (5분 완성)

1️⃣

준비

Docker Desktop 설치

docker.com에서 내 OS에 맞는 Docker Desktop을 설치하세요. Windows·macOS·Linux 모두 지원!

2️⃣

실행

터미널에 명령어 입력

아래 코드를 복사 → 터미널에 붙여넣기!

bash · 기본 실행

# 기본 실행 (테스트용)
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

3️⃣

접속

브라우저에서 확인

초록 로그가 뜨면 성공! 브라우저에서 http://localhost:5678 접속!

✅

성공! "Welcome to n8n" 화면이 보이면 완료. 계정을 만들면 바로 시작!

🔄 운영용 실행 (자동 재시작)

bash · 운영용

docker run -d --restart unless-stopped \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=강한비밀번호! \
  n8nio/n8n

⚠️

비밀번호 꼭 변경! 대문자+숫자+특수문자 12자 이상 조합으로 설정하세요!

📦 npm 설치 (개발자용)

bash · npm

# Node.js 18+ 필요
npm install -g n8n
n8n start
# 또는 npx로 바로 실행
npx n8n

🖥 인터페이스

3

인터페이스 살펴보기

n8n 화면을 처음 보면 막막할 수 있어요. 차근차근 살펴봅시다!

📋 Workflows 메뉴

만들어둔 워크플로우 목록. "New Workflow"로 새로 만들기!

➕ 노드 추가 (+버튼)

캔버스의 + 버튼 클릭 → 수백 개 노드 목록. 검색으로 원하는 앱 찾기!

🔗 노드 연결

오른쪽 점 → 다음 노드 왼쪽 점으로 드래그! 이게 워크플로우 흐름.

▶️ 테스트 실행

"Execute Workflow" 버튼으로 테스트! 각 노드에 결과가 바로 표시.

💾 저장 & 활성화

저장 후 오른쪽 상단 토글 ON → 자동 실행 시작!

⚙️ Settings 메뉴

계정·보안·커뮤니티 노드 설치 관리. API 키는 Credentials 메뉴에서!

🚀 워크플로우

4

첫 워크플로우 만들기!

🎯 예제: 웹훅 메시지 받으면 → Slack 알림 보내기

가장 기본이자 실용적인 워크플로우! 이것만 이해하면 응용은 무한대예요.

🔄 워크플로우 흐름

🌐

TRIGGER

Webhook

→

⚙️

PROCESS

Set Node

→

💬

ACTION

Slack

→

✅

DONE

완료!

①

STEP 1

Webhook 노드 추가

+ 버튼 → "Webhook" 검색 → 추가. HTTP Method: POST. "Test URL" 복사!

②

STEP 2

Slack 노드 추가 & 연결

Webhook 오른쪽 점 드래그 → Slack 노드 연결. Slack API Credential 추가 후 Channel·Message 설정!

③

STEP 3

테스트 실행

"Execute Workflow" 클릭 후 아래 curl로 테스트!

bash · 테스트

curl -X POST \
  "http://localhost:5678/webhook-test/your-path" \
  -H "Content-Type: application/json" \
  -d '{"message":"테스트 메시지 🎉"}'

🎉

슬랙에 메시지가 왔나요? 성공! Gmail·Notion·Google Sheets도 똑같이 연결 가능!

⭐ 초보자 추천 워크플로우 5가지

📧

Gmail → Slack 알림

새 이메일 오면 Slack에 즉시 알림!

📝

폼 제출 → Notion DB

Google Forms 응답을 자동으로 Notion에 저장

🐙

GitHub PR → Slack 알림

새 Pull Request가 열리면 팀 채널에 자동 공지

⏰

매일 아침 날씨 리포트

스케줄 트리거 + 날씨 API → 이메일/슬랙 일일 리포트

🤖

AI 자동 응답봇

Webhook → OpenAI GPT → Slack AI 챗봇!

🔐 보안 설정

5

🔐 보안 완벽 설정

🚨

보안은 선택이 아닌 필수! n8n은 API 키·비밀번호 등 민감 정보를 다룹니다. 아래 체크리스트를 반드시 완료하세요!

🛡

보안 체크리스트

항목 클릭 → 완료 표시!

✓

✅ Basic Auth 인증 활성화

N8N_BASIC_AUTH_ACTIVE=true 설정 필수!

✓

✅ 강력한 비밀번호 설정

대문자+숫자+특수문자 12자 이상 조합

✓

✅ API 키를 환경변수로 관리

Credentials 메뉴 사용. 코드에 직접 입력 금지!

✓

✅ N8N_ENCRYPTION_KEY 설정

Credentials 암호화 키. 안전하게 보관 필수!

✓

✅ HTTPS 설정 (외부 접근 시)

Nginx/Caddy로 SSL/TLS 적용. HTTP 외부 노출 금지!

✓

✅ 방화벽으로 5678 포트 제한

신뢰할 수 있는 IP만 허용!

✓

✅ 커뮤니티 노드 신중하게 설치

다운로드 수·별점·업데이트 날짜 확인!

✓

✅ 정기 백업 설정

~/.n8n 폴더 백업 + JSON 내보내기!

✓

✅ 정기 업데이트

docker pull n8nio/n8n 으로 최신 보안 패치!

✓

✅ 공용 PC 접근 금지

개인 기기에서만. 사용 후 반드시 로그아웃!

보안 완료도 0 / 10

🔑 암호화 키 생성 & 적용

bash · 암호화 키

# 랜덤 암호화 키 생성 (Linux/Mac)
openssl rand -hex 32

docker run -d --restart unless-stopped \
  -e N8N_ENCRYPTION_KEY=생성된_키_입력 \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=SuperSecure#2025! \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  --name n8n n8nio/n8n

🌐 HTTPS Nginx 설정

nginx

# /etc/nginx/sites-available/n8n
server {
    listen 443 ssl;
    server_name n8n.yourdomain.com;
    ssl_certificate     /etc/letsencrypt/live/도메인/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/도메인/privkey.pem;
    location / {
        proxy_pass http://localhost:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

🚨 절대 하면 안 되는 것들

❌

API 키를 워크플로우 JSON에 직접 입력

JSON 내보내면 API 키 그대로 노출! 반드시 Credentials 메뉴 사용

❌

HTTP로 인터넷에 n8n 노출

비밀번호·API 키 도청 위험! 반드시 HTTPS 사용

❌

검증 안 된 커뮤니티 노드 설치

악성 노드로 시스템 접근 가능. 공식 노드 우선 사용!

❌

.n8n 폴더를 GitHub에 공개 업로드

Credentials·암호화 키 전부 노출! .gitignore에 추가 필수

❓ FAQ

6

FAQ & 문제해결

Docker 없이도 n8n을 쓸 수 있나요? +

네! npm install -g n8n으로 설치 가능합니다. Node.js 18 이상 필요. 또는 n8n.cloud에서 설치 없이 바로 사용 가능(유료).

포트 5678이 이미 사용 중이에요! +

Docker 실행 시 -p 5679:5678처럼 왼쪽 숫자를 바꾸세요. 그 후 localhost:5679로 접속!

워크플로우 백업하는 방법은? +

① 개별: 우상단 메뉴 → Download → JSON 파일 저장. ② 전체: ~/.n8n 폴더 압축 보관.

최신 버전으로 업데이트 방법은? +

Docker: docker pull n8nio/n8n 후 재시작. npm: npm update -g n8n. 업데이트 전 반드시 백업!

API 키(Credential)를 잃어버렸어요! +

N8N_ENCRYPTION_KEY가 있으면 복호화 가능. 키를 잃어버렸다면 Credential을 다시 입력해야 해요. 이 키는 반드시 안전하게 보관!

워크플로우 오류 디버깅 방법은? +

오류 난 노드가 빨간색으로 표시됩니다. 클릭하면 에러 메시지 확인 가능. "Execution Log"에서 실행 히스토리도 볼 수 있어요!

외부에서 접근하려면 어떻게 하나요? +

클라우드 VPS에 설치 후 Nginx + Let's Encrypt HTTPS 적용. 또는 Cloudflare Tunnel 사용 시 포트 개방 없이 안전하게 접근 가능!

셀프호스팅 n8n은 완전 무료인가요? +

직접 설치는 완전 무료! 워크플로우 수·실행 횟수 제한 없음. Oracle Free Tier 등 무료 VPS로도 운영 가능!

🚀

이제 n8n 여정을 시작해보세요!

궁금한 점은 n8n 커뮤니티 포럼에서!

📚 공식 문서 · 🐙 GitHub · 💬 커뮤니티 · 🌐 공식 사이트

n8n 초보자 완벽 가이드 · 2025