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

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

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 설치하기 가이드를 따르세요.