n8n CLI 시작하기

n8n CLI는 공개 API를 통해 n8n 인스턴스와 프로그래밍 방식으로 상호작용하는 경량 명령줄 클라이언트입니다. 설치, 연결 설정, 주요 명령어 및 출력 형식을 설명합니다.

n8n CLI 는 실행 중인 n8n 인스턴스와 n8n API 를 통해 통신하는 경량 명령줄 클라이언트입니다. 네트워크 접근이 가능한 모든 장치에서 실행할 수 있으며, API 키를 사용하여 인증합니다. n8n CLI는 베타 버전입니다 실험적 사용, 로컬 개발, 개인 프로젝트에만 사용하고 프로덕션 워크플로에는 사용하지 마세요. API CLI를 다음 용도로 사용할 수 있습니다: 워크플로 목록 조회 및 검사 JSON으로 워크플로 생성 최근 실행 내역 확인 자격 증명 생성 프로젝트 관리 모든 작업은 사용자의 권한과 API 키 범위를 준수합니다. n8n CLI vs 서버 CLI # n8n 인스턴스를 관리해야 하는 경우(백업, 라이선스 관리, 긴급 초기화 등), n8n과 동일한 장치에서 실행되는 내장 도구인 서버 CLI 를 참조하세요. 항목 n8n CLI 서버 CLI 실행 위치 네트워크 접근이 가능한 모든 장치 n8n과 동일한 장치 인증 API 키 직접 데이터베이스(DB) 접근 n8n 실행 필요 여부 예 아니오 (대부분의 작업에서 불필요) 최적 사용 대상 개발자, 연동, AI 에이전트 인스턴스 운영자, 백업, 긴급 상황 권한 사용자 역할 및 API 키 범위 준수 접근 제어 우회 n8n-cli 설치 # # npx로 바로 사용 (설치 불필요) npx @n8n/cli workflow list # 또는 전역 설치 npm install -g @n8n/cli 인스턴스에 연결하기 # n8n-cli config set-url https://your-instance.n8n.cloud n8n-cli config set-api-key YOUR_API_KEY n8n-cli config show 구성 정보는 제한된 파일 권한( 0600 )으로 ~/.n8n-cli/config.json 에 저장됩니다. n8n > Settings > n8n API 에서 API 키를 발급받으세요. 또는 구성 파일 대신 환경 변수를 사용할 수 있습니다: export N8N_URL=https://your-instance.n8n.cloud export N8N_API_KEY=your_api_key 인라인 플래그 # n8n-cli --url=https://my-n8n.app.n8n.cloud --api-key=n8n_api_xxxxx workflow list 적용 우선순위 # 명령줄 플래그 ( --url , --api-key ) 환경 변수 ( N8N_URL , N8N_API_KEY ) 구성 파일 ( ~/.n8n-cli/config.json ) 명령어 # 모든 명령어는 자세한 사용법을 위해 --help 를 지원합니다. 주제 명령어 workflow list , get , create , update , delete , activate , deactivate , tags , transfer execution list , get , retry , stop , delete credential list , get , schema , create , delete , transfer project list , get