Server CLI는 n8n 설치와 동일한 머신에서 실행되는 내장 명령줄 인터페이스입니다. 관리 작업을 위한 직접적인 데이터베이스 액세스를 제공하며, n8n이 실행되고 있지 않을 때도 대부분의 명령을 실행할 수 있습니다.

Server CLI와 n8n CLI 중 언제 무엇을 사용할지#

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를 사용하세요.

워크플로 게시하기#

publish:workflow를 사용하여 ID로 워크플로를 게시합니다. 선택적으로 versionId를 전달하여 특정 이력 버전을 게시할 수도 있습니다.

명령 플래그:

ID로 워크플로의 현재 초안을 게시합니다:

n8n publish:workflow --id=

워크플로의 특정 이력 버전을 게시합니다:

n8n publish:workflow --id= --versionId=

워크플로 게시 취소하기#

unpublish:workflow를 사용하여 ID로 워크플로 하나를 게시 취소하거나, 한 번에 모든 워크플로를 게시 취소할 수 있습니다.

명령 플래그:

ID로 워크플로를 게시 취소합니다:

n8n unpublish:workflow --id=

모든 워크플로를 게시 취소합니다:

n8n unpublish:workflow --all

update:workflow (더 이상 사용되지 않음)#

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

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

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

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

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

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

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

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

엔티티 내보내기#

CLI를 사용하여 n8n에서 데이터베이스 엔티티를 내보낼 수 있습니다. 이 도구를 사용하면 SQLite와 같은 한 데이터베이스 유형에서 모든 엔티티 유형을 내보내 Postgres와 같은 다른 데이터베이스 유형으로 가져올 수 있습니다.

명령 플래그:

n8n export:entities --outputDir=./outputs --includeExecutionHistoryDataTables=true

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

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

명령 플래그:

워크플로#

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

n8n export:workflow --all

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

n8n export:workflow --id= --output=file.json

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

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

--backup 플래그(위에서 설명)를 사용하여 모든 워크플로를 특정 디렉터리에 내보냅니다:

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

특정 워크플로 버전 내보내기#

--version과 함께 versionId를 전달하여 워크플로의 특정 이력 버전을 내보낼 수 있습니다:

n8n export:workflow --id= --version= --output=workflow-v1.json

워크플로의 게시된 버전 내보내기#

--published를 사용하여 현재 초안 대신 워크플로의 현재 게시/활성 버전을 내보냅니다:

n8n export:workflow --id= --published --output=published.json

--published를 --all과 결합하여 모든 워크플로의 게시된 버전을 내보낼 수 있습니다. 게시된 버전이 없는 워크플로는 건너뜁니다:

n8n export:workflow --all --published --output=workflows.json

자격 증명#

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

n8n export:credentials --all

ID로 자격 증명을 내보내고 출력 파일 이름을 지정합니다:

n8n export:credentials --id= --output=file.json

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

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

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

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

모든 자격 증명을 일반 텍스트 형식으로 내보냅니다. 이를 사용하여 구성 파일에서 다른 시크릿 키를 가진 다른 설치로 마이그레이션할 수 있습니다.

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

엔티티 가져오기#

이 명령을 사용하여 이전 export:entities 명령의 엔티티를 가져올 수 있으며, 내보낸 데이터베이스 유형과 다른 데이터베이스 유형으로 엔티티를 가져올 수 있습니다. 현재 지원되는 데이터베이스 유형은 SQLite, Postgres입니다.

가져오기 전에는 데이터베이스가 비어 있어야 합니다. 이는 --truncateTables 매개변수로 강제할 수 있습니다.

명령 플래그:

n8n import:entities --inputDir ./outputs --truncateTables true

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

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

사용 가능한 플래그:

워크플로#

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

n8n import:workflow --input=file.json

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

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

기본적으로 import:workflow는 가져온 모든 워크플로를 비활성화합니다. 대신 각 JSON 파일의 active 필드를 유지하려면 --activeState=fromJson을 전달하세요(멀티 메인 및 큐 모드에서만 지원):

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

자격 증명#

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

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 CLI를 사용하여 커뮤니티 노드를 관리할 수 있습니다. 현재는 커뮤니티 노드와 자격 증명을 제거하는 것만 가능하며, 이는 커뮤니티 노드가 불안정성을 유발할 때 유용합니다.

명령 플래그:

노드#

패키지 이름으로 커뮤니티 노드를 제거합니다:

n8n community-node --uninstall --package 

예를 들어, Evolution API 커뮤니티 노드를 제거하려면 다음과 같이 입력합니다:

n8n community-node --uninstall --package n8n-nodes-evolution-api

자격 증명#

커뮤니티 노드 자격 증명을 제거합니다:

n8n community-node --uninstall --credential  --userId 

예를 들어, Evolution API 커뮤니티 노드 자격 증명을 제거하려면, 리포지터리를 방문하여 credentials.ts 파일에서 name을 찾습니다:

n8n community-node --uninstall --credential evolutionApi --userId 1234

보안 감사#

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

n8n audit

Footnotes

1. n8n에서 인타이틀먼트(entitlement)는 특정 기간 동안 n8n 인스턴스에 플랜 제한 기능에 대한 액세스 권한을 부여합니다. ↩