npm

npm을 사용하여 n8n을 로컬 머신에 설치하고 실행하는 방법을 설명합니다.

npm은 로컬 머신에서 n8n을 빠르게 시작하는 방법입니다. Node.js 가 설치되어 있어야 합니다. n8n은 20.19 ~ 24.x(포함) 사이의 Node.js 버전을 요구합니다. 참고 이 섹션의 상세 내용은 n8n 공식 문서 를 참조하세요. 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 공식 문서 를 참조하세요. Note Docker 필요 터널은 Docker 컨테이너로 실행되는 cloudflared를 사용합니다. npm으로 n8n을 실행하는 경우에도 머신에 Docker 가 설치되어 있는지 확인하세요. 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 터널 설정 을 참고하세요. 업그레이드 되돌리기 # 되돌리려는 이전 버전을 설치하세요. 업그레이드에 데이터베이스 마이그레이션이 포함된 경우: 기능 문서와 릴리즈 노트를 확인하여 수동으로 변경해야 할 사항이 있는지 확인하세요. 현재 버전에서 n8n db:revert 를 실행하여 데이터베이스를 롤백하세요. 데이터베이스 마이그레이션을 여러 번 되돌리려면 이 과정을 반복해야