n8n CLI 명령어

n8n의 워크플로 실행, 엔티티 가져오기/내보내기, 라이선스 관리, 사용자 관리 등을 위한 CLI 명령어 레퍼런스 문서입니다.

Server CLI 는 n8n 설치와 같은 머신에서 실행되는 내장 명령줄 인터페이스입니다. 관리 작업을 위해 데이터베이스에 직접 접근할 수 있으며 n8n이 실행 중이지 않아도 대부분의 명령어를 실행할 수 있습니다. n8n CLI 원격 머신에서 프로그래밍 방식으로 n8n과 상호작용하거나 AI 에이전트와 통합하고 싶으신가요? n8n CLI 를 확인하세요. Server CLI와 n8n CLI 비교 # 기능 Server CLI n8n CLI 실행 위치 n8n과 같은 머신 네트워크 접근이 있는 모든 머신 인증 데이터베이스 직접 접근 API 키 n8n 실행 필요 여부 아니요(대부분의 명령어) 예 적합한 용도 인스턴스 운영자, 백업, 마이그레이션 프로그래머, AI 에이전트, 원격 관리 보안 모델 접근 제어 우회 사용자 권한 및 API 키 범위 준수 사용 예시 백업/복원, 라이선스 관리, 비상 비밀번호 재설정 워크플로 자동화, 코드를 통한 자격 증명 관리 CLI 명령어 실행하기 # 셀프 호스팅 n8n에서 CLI 명령어를 사용할 수 있습니다. n8n 설치 방법에 따라 명령어 실행 방식에 차이가 있습니다: npm: n8n 명령어를 직접 사용할 수 있습니다. 아래 예시에서는 이 방법을 사용합니다. Docker: n8n 명령어는 Docker 컨테이너 내에서 사용할 수 있습니다: docker exec -u node -it <n8n-container-name> <n8n-cli-command> 워크플로 시작하기 # CLI를 사용하여 워크플로를 직접 시작할 수 있습니다. ID로 저장된 워크플로 실행하기: n8n execute -- id 워크플로 게시 또는 게시 취소 # CLI를 사용하여 워크플로를 게시하거나 게시 취소할 수 있습니다. n8n 2.0에서 이전의 활성/비활성 토글 이 게시/게시 취소 모델로 교체되었습니다. publish:workflow 와 unpublish:workflow 를 사용하여 CLI에서 워크플로의 게시 상태를 변경합니다. 재시작 필요 이 명령어들은 n8n 데이터베이스에 작동합니다. n8n이 실행 중일 때 명령어를 실행하면, n8n을 재시작하기 전까지 변경 사항이 적용되지 않습니다. 워크플로 게시 # publish:workflow 를 사용하여 ID로 워크플로를 게시합니다. 선택적으로 versionId 를 전달하여 특정 이전 버전을 게시할 수 있습니다. 명령어 플래그: 플래그 설명 --help 도움말 프롬프트. --id 게시할 워크플로의 ID. 필수. --versionId 게시할 선택적 버전 ID. 생략하면 현재 초안이 게시됩니다. `--all` 플래그 없음 더 이상 사용되지 않는 update:workflow 명령어와 달리 publish:workflow 는 --all 을 지원하지 않습니다. 이는 프로덕션 환경에서 워크플로를 대량으로 실수로 게시하는 것을 방지하기 위한 의도적인 설계입니다. ID로 워크플로를 개별적으로 게시하세요. ID로 워크플로의 현재 초안 게시: n8n publish:workflow -- id = 워크플로의 특정