n8n을 위한 CLI 명령어

n8n은 CLI(명령 줄 인터페이스)를 포함하고 있어, n8n 편집기 대신 CLI를 사용하여 작업을 수행할 수 있습니다. 여기에는 워크플로 시작, 워크플로 및 자격 증명 내보내기 및 가져오기가 포함됩니다.

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 <ID>

워크플로의 활성 상태 변경하기

CLI를 사용하여 워크플로의 활성 상태를 변경할 수 있습니다.

Restart required

이 명령어는 n8n 데이터베이스에서 작동합니다. n8n이 실행 중일 때 이 명령어를 실행하면 변경 사항은 n8n을 다시 시작할 때까지 적용되지 않습니다.

ID를 사용하여 워크플로의 활성 상태를 false로 설정합니다:

n8n update:workflow --id=<ID> --active=false

ID를 사용하여 워크플로의 활성 상태를 true로 설정합니다:

n8n update:workflow --id=<ID> --active=true

모든 워크플로의 활성 상태를 false로 설정합니다:

n8n update:workflow --all --active=false

모든 워크플로의 활성 상태를 true로 설정합니다:

n8n update:workflow --all --active=true

워크플로 및 자격 증명 내보내기

CLI를 사용하여 n8n에서 워크플로와 자격 증명을 내보낼 수 있습니다.

명령어 플래그:

플래그	설명
--help	도움말 프롬프트.
--all	모든 워크플로/자격 증명을 내보냅니다.
--backup	백업을 위한 --all --pretty --separate를 설정합니다. 선택적으로 --output을 설정할 수 있습니다.
--id	내보낼 워크플로의 ID.
--output	개별 파일을 사용할 경우 출력 파일 이름 또는 디렉토리.
--pretty	출력을 읽기 쉽게 포맷합니다.
--separate	각 워크플로에 대해 하나의 파일을 내보냅니다(버전 관리에 유용). --output으로 디렉토리를 설정해야 합니다.
--decrypted	자격 증명을 일반 텍스트 형식으로 내보냅니다.

워크플로

모든 워크플로를 표준 출력(터미널)으로 내보냅니다:

n8n export:workflow --all

ID를 사용하여 워크플로를 내보내고 출력 파일 이름을 지정합니다:

n8n export:workflow --id=<ID> --output=file.json

모든 워크플로를 특정 디렉토리에 하나의 파일로 내보냅니다:

n8n export:workflow --all --output=backups/latest/file.json

모든 워크플로를 특정 디렉토리에 --backup 플래그를 사용하여 내보냅니다(상세 내용 위 참조):

n8n export:workflow --backup --output=backups/latest/

자격 증명

모든 자격 증명을 표준 출력(터미널)으로 내보냅니다:

n8n export:credentials --all

ID를 사용하여 자격 증명을 내보내고 출력 파일 이름을 지정합니다:

n8n export:credentials --id=<ID> --output=file.json

모든 자격 증명을 특정 디렉토리에 하나의 파일로 내보냅니다:

n8n export:credentials --all --output=backups/latest/file.json

모든 자격 증명을 특정 디렉토리에 --backup 플래그를 사용하여 내보냅니다(상세 내용 위 참조):

n8n export:credentials --backup --output=backups/latest/

모든 자격 증명을 일반 텍스트 형식으로 내보냅니다. 이를 사용하여 구성 파일의 비밀 키가 다른 하나로 마이그레이션할 수 있습니다.

Sensitive information

모든 민감한 정보가 파일에 표시됩니다.

n8n export:credentials --all --decrypted --output=backups/decrypted.json

워크플로우 및 자격 증명 가져오기

CLI를 사용하여 n8n에서 워크플로우 및 자격 증명을 가져올 수 있습니다.

ID 업데이트

워크플로우 및 자격 증명을 내보낼 때 n8n은 해당 ID도 내보냅니다. 기존 데이터베이스에 동일한 ID를 가진 워크플로우와 자격 증명이 있는 경우, 덮어써질 것입니다. 이를 피하려면 가져오기 전에 ID를 삭제하거나 변경하십시오.

사용 가능한 플래그:

플래그	설명
--help	도움말 프롬프트.
--input	--separate를 사용하는 경우 입력 파일 이름 또는 디렉토리.
--projectId	지정된 프로젝트로 워크플로우 또는 자격 증명을 가져옵니다. --userId와 함께 사용할 수 없습니다.
--separate	--input으로 제공된 디렉토리에서 *.json 파일을 가져옵니다.
--userId	지정된 사용자에게 워크플로우 또는 자격 증명을 가져옵니다. --projectId와 함께 사용할 수 없습니다.

SQLite로 마이그레이션

n8n은 워크플로우 및 자격 증명의 이름을 128자로 제한하지만, SQLite는 크기 제한을 강제하지 않습니다.

이로 인해 가져오기 과정에서 열 이름이 너무 깁니다와 같은 오류가 발생할 수 있습니다.

이 경우 n8n 인터페이스에서 이름을 편집하고 다시 내보내거나, 가져오기 전에 JSON 파일을 직접 편집할 수 있습니다.

워크플로우

특정 파일에서 워크플로우를 가져옵니다:

n8n import:workflow --input=file.json

지정된 디렉토리에서 모든 워크플로우 파일을 JSON 형식으로 가져옵니다:

n8n import:workflow --separate --input=backups/latest/

자격 증명

특정 파일에서 자격 증명을 가져옵니다:

n8n import:credentials --input=file.json

지정된 디렉토리에서 모든 자격 증명 파일을 JSON 형식으로 가져옵니다:

n8n import:credentials --separate --input=backups/latest/

라이선스

클리어

n8n 데이터베이스에서 기존 라이선스를 지우고 n8n을 기본 기능으로 리셋합니다:

n8n license:clear

정보

기존 라이선스에 대한 정보를 표시합니다:

n8n license:info

사용자 관리

n8n CLI를 사용하여 사용자 관리를 리셋할 수 있습니다. 이는 사용자 관리를 설정 전 상태로 되돌립니다. 모든 사용자 계정이 제거됩니다.

비밀번호를 잊어버리고, 이메일로 비밀번호 재설정을 위한 SMTP 설정이 없는 경우 사용하십시오.

n8n user-management:reset

사용자에 대한 MFA 비활성화

사용자가 복구 코드를 잃어버린 경우, 이 명령을 사용하여 사용자에 대한 MFA를 비활성화할 수 있습니다. 그러면 사용자가 다시 로그인하여 MFA를 설정할 수 있습니다.

n8n mfa:disable --email=johndoe@example.com

LDAP 비활성화

아래 명령어를 사용하여 LDAP 설정을 리셋할 수 있습니다.

n8n ldap:reset

보안 감사

n8n 인스턴스에서 보안 감사를 실행하여 일반적인 보안 문제를 감지할 수 있습니다.

n8n audit