npm은 로컬 머신에서 n8n을 빠르게 시작하는 방법입니다. Node.js가 설치되어 있어야 합니다. n8n은 Node.js 버전 20.19 이상 24.x 이하(포함)를 요구합니다.

npx로 n8n 체험하기#

npx를 사용하면 n8n을 설치하지 않고도 체험할 수 있습니다.

터미널에서 다음 명령을 실행합니다:

npx n8n

이 명령은 n8n 시작에 필요한 모든 것을 다운로드합니다. 그 후 http://localhost:5678을 열어 n8n에 접근하고 워크플로 빌드를 시작할 수 있습니다.

npm으로 전역 설치#

n8n을 전역으로 설치하려면 npm을 사용합니다:

npm install n8n -g

특정 버전의 n8n을 설치하거나 업데이트하려면 @ 구문을 사용하여 버전을 지정합니다. 예를 들어:

npm install -g n8n@0.126.1

next 버전을 설치하려면:

npm install -g n8n@next

설치 후 다음 명령으로 n8n을 시작합니다:

n8n
# 또는
n8n start

다음 단계#

빠른 시작을 사용하여 n8n을 체험해 보세요.

업데이트#

n8n 인스턴스를 latest 버전으로 업데이트하려면 다음 명령을 실행합니다:

npm update -g n8n

next 버전을 설치하려면:

npm install -g n8n@next

터널을 사용한 n8n#

GitHub 같은 외부 서비스의 트리거 노드에 웹훅을 사용하려면, n8n이 웹에서 접근 가능해야 합니다. n8n은 cloudflared를 이용한 터널 서비스를 제공하여 웹의 요청을 로컬 n8n 인스턴스로 리다이렉트합니다. 터널이 작동하려면 Docker가 설치되어 있어야 합니다.

n8n 실행 방법에 따라 터널을 사용하는 두 가지 방법이 있습니다:

npm 설치의 경우 서비스만 방식을 사용합니다. 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 터널 설정을 참조하세요.

업그레이드 되돌리기#

되돌아가고자 하는 이전 버전을 설치합니다.

업그레이드에 데이터베이스 마이그레이션이 포함된 경우:

1. 기능 문서 및 릴리스 노트를 확인하여 수동으로 변경해야 할 사항이 있는지 확인합니다.
2. 현재 버전에서 n8n db:revert를 실행하여 데이터베이스를 롤백합니다. 둘 이상의 데이터베이스 마이그레이션을 되돌리려면 이 과정을 반복해야 합니다.

Windows 문제 해결#

Windows에서 n8n을 실행하는 데 문제가 있다면 Node.js 환경이 올바르게 설정되어 있는지 확인합니다. Microsoft의 Windows에 NodeJS 설치 가이드를 따르세요.