npm으로 n8n 설치
npm으로 n8n 설치 (Install with npm)
npm은 로컬 머신에서 n8n을 빠르게 시작하는 방법이에요. Node.js가 설치되어 있어야 하며, n8n은 Node.js 버전 20.19 이상 24.x 이하(포함)가 필요합니다.
⚠️ 기능 가용성: npm 기반 설치는 n8n 3.0부터 더 이상 지원되지 않습니다(Deprecated).
💡 참고: npm 설치 방법을 쓸 때는 n8n Assistant를 사용할 수 없습니다.
npx로 n8n 시도하기
설치 없이 npx로 바로 n8n을 시도할 수 있어요. 터미널에서 실행하세요.
npx n8n
이 명령은 n8n을 시작하는 데 필요한 모든 것을 다운로드합니다. 그다음 http://localhost:5678 을 열면 n8n에 접속해 워크플로를 만들기 시작할 수 있습니다.
npm으로 전역 설치
n8n을 전역으로 설치하려면 npm을 사용하세요.
npm install n8n -g
특정 버전으로 설치하거나 업데이트하려면 @ 문법으로 버전을 지정하세요.
npm install -g [email protected]
next를 설치하려면:
npm install -g n8n@next
설치 후 다음으로 n8n을 시작합니다.
n8n
# 또는
n8n start
다음 단계
Quickstarts로 n8n을 시도해 보세요.
업데이트하기
n8n 인스턴스를 latest 버전으로 업데이트하려면:
npm update -g n8n
next 버전을 설치하려면:
npm install -g n8n@next
⚠️ 주의: 이 방법은 로컬 개발·테스트용입니다. 프로덕션에서 사용하기에는 안전하지 않습니다.
웹훅용 터널 사용하기
⚠️ 개발 도구 참고: 터널 기능은 로컬 개발을 위한 편의 도구로, 내부 구현이 n8n 버전에 따라 바뀔 수 있습니다.
GitHub 같은 외부 서비스의 트리거 노드에 웹훅을 사용하려면 n8n이 웹에서 접근 가능해야 해요. n8n은 cloudflared를 사용해 웹의 요청을 로컬 n8n 인스턴스로 리다이렉트하는 터널 서비스를 제공합니다.
💡 Docker 필요: 터널은 Docker 컨테이너로 실행되는 cloudflared를 사용합니다. npm으로 n8n을 실행하더라도 Docker가 설치되어 있어야 해요.
npm 설치는 services only 방식을 사용합니다. cloudflared를 독립 서비스로 시작한 뒤 n8n을 로컬에서 실행하세요.
# 터미널 1: cloudflared 터널 서비스 시작
pnpm --filter n8n-containers services --services cloudflared
# 터미널 2: n8n 로컬 실행
pnpm dev
services 명령은 cloudflared를 시작하고 공개 터널 URL을 가져와 WEBHOOK_URL과 N8N_PROXY_HOPS=1이 담긴 .env 파일을 packages/cli/bin/.env에 씁니다. n8n은 시작 시 이 .env를 자동으로 읽습니다.
작업이 끝나면 정리하세요.
pnpm --filter n8n-containers services:clean
전체 스택 방식(n8n과 cloudflared를 모두 컨테이너에서)은 Docker 터널 설정을 참고하세요.
업그레이드 되돌리기
돌아가고 싶은 이전 버전을 설치하세요.
업그레이드에 데이터베이스 마이그레이션이 포함된 경우:
- 수동으로 해야 할 변경이 있는지 기능 문서와 릴리스 노트를 확인하세요.
- 현재 버전에서
n8n db:revert를 실행해 데이터베이스를 롤백하세요. 데이터베이스 마이그레이션을 한 번 이상 되돌리려면 이 과정을 반복해야 합니다.
Windows 문제 해결
Windows에서 n8n 실행에 문제가 있다면 Node.js 환경 설정을 확인하세요. Microsoft 가이드 Windows에 NodeJS 설치를 따라 해 보세요.