n8n 로컬 설치: Docker 또는 npm으로 첫 Webhook까지

Docker 또는 npx로 n8n을 켜고 5678 편집기에서 Webhook을 둔 뒤 Test URL로 첫 요청을 받는다.

HTTP를 자동화에 잇기 위해 클라우드 좌석이 필요하진 않다. n8n은 이 기기에서 돈다. 편집기는 브라우저, 데이터는 기본으로 로컬에 남는다.

공식을 따라 Docker 또는 npm으로 n8n을 로컬 실행하고 localhost:5678을 연 뒤 첫 Webhook을 만든다. 개발자 도구 사용법이며 브레인스토밍 제품 설명서가 아니다.

설치 경로를 하나 고른다

docs.n8n.io/hosting/installation을 본다. 노트북 시험은 Docker 또는 Node. Postgres와 큐는 나중에.

첫 Webhook까지 다섯 단계

1. 1

   Docker 또는 npm으로 시작

   Docker: docker volume create n8n_data 후 docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n. Node: 빈 폴더에서 npx n8n, 또는 전역 설치 후 n8n start. 태그는 바뀌니 docs.n8n.io를 다시 본다.

2. 2

   편집기를 열고 owner를 만든다

   http://localhost:5678. 첫 로드는 email과 비밀번호. 이 사용자는 이 인스턴스 소유자이지 클라우드 플랜이 아니다. 마법사는 건너뛰고 빈 캔버스로 가도 된다.

3. 3

   새 워크플로에 Webhook

   New workflow. Webhook 노드. HTTP Method는 POST. Path는 임의이거나 hello. 아직 운영 비밀을 붙이지 않는다.

4. 4

   Listen 후 Test URL에 curl

   Listen for test event를 누르고 Test URL을 복사. 다른 터미널에서 curl -X POST 테스트URL -H 'Content-Type: application/json' -d '{"ping":true}'. Listen이 멈추고 JSON이 보여야 한다.

5. 5

   응답을 달고 Activate를 결정

   Set 또는 Respond to Webhook으로 {"ok":true}. 노트북에서는 Test URL만 쓴다. 안정 URL이 필요하면 저장 후 Activate하고 Production URL. 5678은 기본으로 공용망이 아니다.

docker volume create n8n_data
docker run -it --rm --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

# 또는: npx n8n
# 그다음 http://localhost:5678

먼저 익힐 세 조각

흔한 함정

포트 충돌이면 -p 5679:5678이거나 옛 컨테이너를 끈다. Docker는 볼륨이 필요하다. --rm만 쓰면 워크플로가 사라진다. 오래된 Node는 npx n8n이 실패한다. 공식 LTS를 쓴다.

동작한 뒤 짧은 스케치가 필요하면 wbstorm 방 번호. 방 만들기와 참가와 화이트보드 기초. Cursor Rules 작성법도 보라.