n8n CLI 시작하기

n8n CLI 는 실행 중인 n8n 인스턴스와 n8n API 를 통해 통신하는 경량 명령줄 클라이언트입니다. 네트워크에 접근할 수 있는 모든 머신에서 실행할 수 있으며 API 키로 인증합니다. Note n8n CLI는 베타 버전입니다 프로덕션 워크플로가 아닌 실험, 로컬 개발, 개인 프로젝트 용도로만 사용하세요. API CLI를 사용해 다음을 수행할 수 있습니다. 워크플로 목록 조회 및 확인 JSON에서 워크플로 생성 최근 실행 확인 자격 증명 생성 프로젝트 관리 모든 작업은 사용자의 권한과 API 키의 범위를 따릅니다. n8n CLI와 서버 CLI 비교 # n8n 인스턴스를 관리(백업, 라이선스 관리, 긴급 초기화)해야 하는 경우, n8n과 동일한 머신에서 실행되는 내장 도구인 서버 CLI 를 참고하세요. 항목 n8n CLI 서버 CLI 실행 위치 네트워크에 접근할 수 있는 모든 머신 n8n과 동일한 머신 인증 API 키 직접 데이터베이스 접근 n8n 실행 필요 여부 예 아니요(대부분의 작업에서 필요하지 않음) 적합한 대상 개발자, 통합, AI 에이전트 인스턴스 운영자, 백업, 긴급 상황 권한 사용자 역할 및 API 키 범위를 따름 접근 제어를 우회함 n8n-cli 설치 # # Use directly with npx (zero install) npx @n8n/cli workflow list # Or install globally 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