명령줄 사용

n8n에 내장된 명령줄 인터페이스인 Server CLI에서 사용할 수 있는 명령입니다.

Server CLI 는 n8n 설치와 동일한 머신에서 실행되는 내장 명령줄 인터페이스입니다. 관리 작업을 위한 직접적인 데이터베이스 액세스를 제공하며, n8n이 실행되고 있지 않을 때도 대부분의 명령을 실행할 수 있습니다. Note 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: Docker 컨테이너 내에서 n8n 명령을 사용할 수 있습니다: docker exec -u node -it <n8n-container-name> <n8n-cli-command> 워크플로 시작하기 # CLI를 사용하여 워크플로를 직접 시작할 수 있습니다. 저장된 워크플로를 ID로 실행합니다: n8n execute -- id 워크플로 게시 또는 게시 취소 # CLI를 사용하여 워크플로를 게시하거나 게시를 취소할 수 있습니다. n8n 2.0에서는 이전의 활성/비활성 토글 이 게시/게시 취소 모델로 대체되었습니다. CLI에서 워크플로의 게시 상태를 변경하려면 publish:workflow 와 unpublish:workflow 를 사용하세요. Note 재시작 필요 이 명령들은 n8n 데이터베이스에서 작동합니다. n8n이 실행 중일 때 이 명령을 실행하면, n8n을 재시작할 때까지 변경 사항이 적용되지 않습니다. 워크플로 게시하기 # publish:workflow 를 사용하여 ID로 워크플로를 게시합니다. 선택적으로 versionId 를 전달하여 특정 이력 버전을 게시할 수도 있습니다. 명령 플래그: 플래그 설명 --help 도움말 프롬프트. --id 게시할 워크플로의 ID입니다. 필수. --versionId 게시할 선택적 버전 ID입니다. 생략하면 현재 초안이 게시됩니다. Note --all 플래그 없음 더 이상 사용되지 않는 update:workflow 명령과 달리, publish:workflow 는 --all 을 지원하지 않습니다. 이는 의도된 것으로, 프로덕션 환경에서 워크플로가 실수로 대량 게시되는 것을 방지합니다. 워크플로는 개별적으로 ID를 지정하여 게시하세요. ID로