하루보탬

[카테고리:] 디지털 생활

  • n8n 자체 호스팅 시 메모리 부족(Out of Memory) 해결을 위한 설정 방법

    n8n 자체 호스팅 시 메모리 부족(Out of Memory) 해결을 위한 설정 방법

    n8n 자체 호스팅의 메모리 부족 상황에서는 n8n에 사용 가능한 메모리를 늘리거나 메모리 소비를 줄이는 방안을 검토할 수 있습니다. 특히 JavaScript heap out of memory 오류에는 V8 엔진의 old memory 할당량을 늘리는 방법이 도움이 될 수 있습니다.

    메모리 부족 문제의 원인과 유형

    n8n은 각 노드가 가져오고 처리할 수 있는 데이터의 양에 제한을 두지 않습니다.

    이러한 유연성으로 인해 워크플로우 실행 시 사용 가능한 메모리보다 더 많은 양을 요구하게 될 경우 오류가 발생할 수 있습니다.

    해결 방식 비교: 메모리 증설 vs 데이터량 축소: 메모리 증설: V8 엔진의 old memory 섹션에 추가 메모리를 할당하여 처리 용량을 확보합니다. 데이터량 축소: 노드별 데이터 처리량을 줄여 시스템의 메모리 소비를 직접적으로 제한합니다.
    해결 방식 비교: 메모리 증설 vs 데이터량 축소 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Fix memory issues

    해결을 위한 두 가지 접근 방식

    메모리 부족 상황에 직면했을 때 n8n에 할당되는 메모리 양을 늘리거나, 데이터 소비량을 줄이는 두 가지 옵션이 있습니다.

    자체 호스팅 환경에서는 특히 V8 JavaScript 엔진의 old memory 섹션에 추가 메모리를 할당하는 방식이 유용합니다.

    메모리 증설 설정 단계: 1. 현재 발생 중인 오류가 'JavaScript heap out of memory'인지 확인합니다. 2. CLI 또는 NODE_OPTIONS 환경 변수를 통해 --max-old-space-size=SIZE 설정을 적용합니다.
    메모리 증설 설정 단계 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Fix memory issues

    V8 엔진 메모리 할당량 증설 방법

    자체 호스팅 n8n을 사용하는 경우, CLI 또는 NODE_OPTIONS 환경 변수를 통해 설정을 변경할 수 있습니다.

    V8 옵션인 –max-old-space-size=SIZE를 사용하여 할당량을 늘리면 JavaScript heap out of memory 오류를 해결하는 데 도움이 됩니다.

    서비스 환경별 제약 사항: 메모리 증량 설정은 자체 호스팅(self-hosted) 환경에만 해당됩니다. n8n Cloud 사용 시의 메모리 제한은 별도의 Cloud 데이터 관리 정책을 따릅니다.
    서비스 환경별 제약 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Fix memory issues

    서비스 유형별 지원 범위 차이

    자체 호스팅과 n8n Cloud의 지원 범위와 제한을 구분해야 합니다.

    n8n Cloud의 메모리 제한에 관한 내용은 별도의 'Cloud data management'에서 확인해야 합니다.

    자체 호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아닙니다.

    다음 단계: 환경에 맞는 설정 선택: 자체 호스팅 환경이라면 NODE_OPTIONS 환경 변수 설정을 먼저 검토하십시오. Cloud 환경이라면 해당 서비스의 데이터 관리 문서를 확인하십시오.
    다음 단계: 환경에 맞는 설정 선택 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Fix memory issues

    적용 조건과 확인 범위
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아니다.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분한다.
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아님.
    • Cloud, 자체호스팅, Enterprise의 지원 범위와 제한을 구분함.
    • n8n Cloud의 메모리 제한은 별도의 'Cloud data management'를 확인해야 함.

    확인일: 2026-09-21T21:23:27.089553+00:00

  • n8n 바이너리 데이터 정리 조건: 활성 저장 모드를 바꾸면 정리 대상은?

    n8n 바이너리 데이터 정리 조건: 활성 저장 모드를 바꾸면 정리 대상은?

    n8n은 실행 데이터 정리의 일부로 바이너리 데이터 정리를 수행하며, 설정된 활성 바이너리 데이터 모드에 따라 해당 모드의 데이터만 삭제합니다. 대용량 파일 처리를 위한 구체적인 인프라 운영 비용이나 서비스별 지원 범위는 확인되지 않았습니다.

    바이너리 데이터의 정의 및 처리 방식

    바이너리 데이터는 워크플로우 실행 중 생성되거나 처리되는 이미지 파일 또는 문서와 같은 모든 파일 유형의 데이터를 의미합니다.

    큐 모드(Queue mode)에서 바이너리 데이터 저장소는 큐를 통해 전송하기에 너무 큰 웹훅 응답을 처리하는 역할도 수행합니다.

    저장 모드별 처리 범위: 멀티 모드 설정 시, n8n은 현재 활성화된 바이너리 데이터 모드(예: S3 또는 파일 시스템)의 데이터만 정리합니다.
    저장 모드별 처리 범위 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Handle binary data

    바이너리 데이터 정리(Pruning) 조건

    n8n은 실행 데이터 정리(execution data pruning)의 일환으로 바이너리 데이터 정리를 수행합니다.

    자세한 내용은 실행 데이터(Execution data)의 '실행 정리 활성화(Enable executions pruning)' 섹션을 확인하십시오.

    데이터 정리 확인 절차: 1. 현재 활성화된 바이너리 데이터 모드 확인 2. 실행 데이터 정리(Execution data pruning) 설정 확인 3. 해당 모드에 포함된 데이터의 삭제 주기 확인
    데이터 정리 확인 절차 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Handle binary data

    저장 모드별 데이터 정리 차이

    여러 바이너리 데이터 모드를 구성한 경우, 데이터 정리는 현재 활성화된 모드에서만 작동합니다.

    예를 들어, 데이터 저장 위치를 S3에서 파일 시스템(filesystem) 모드로 변경하면 n8n은 파일 시스템에 저장된 바이너리 데이터만 정리합니다.

    자세한 사항은 외부 저장소(External storage) 섹션을 참조하십시오.

    제한 및 미확인 사항: 자체 호스팅 인프라 운영 비용 및 Cloud/Enterprise 버전별 상세 지원 범위는 확인되지 않았습니다.
    제한 및 미확인 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio
    운영 환경 결정: 사용 중인 바이너리 데이터 모드를 확인하고, 해당 모드에 맞는 데이터 정리 정책을 수립하십시오.
    운영 환경 결정 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Handle binary data

    적용 조건과 확인 범위
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아니다.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분한다.
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아님.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분함.

    확인일: 2026-09-21T20:21:37.361121+00:00

  • n8n 자체 호스팅 시 데이터베이스 용량 관리 및 실행 데이터 최적화 방법

    n8n 자체 호스팅 시 데이터베이스 용량 관리 및 실행 데이터 최적화 방법

    n8n을 자체 호스팅할 때 실행 데이터의 양에 따라 데이터베이스 용량이 늘어나고 저장 공간이 부족해질 수 있습니다. 이를 방지하기 위해 n8n은 불필요한 데이터 저장을 방지하고 오래된 실행 데이터를 삭제(pruning)하는 환경 변수 설정을 권장합니다.

    데이터베이스 용량 문제의 원인과 공식 권장 사항

    실행 설정 및 데이터 규모에 따라 n8n 데이터베이스의 크기가 커지고 저장 공간이 부족해질 수 있습니다.

    이러한 문제를 방지하기 위해 n8n은 불필요한 데이터를 저장하지 않도록 설정할 것을 권장합니다.

    또한, 오래된 실행 데이터에 대한 삭제(pruning) 기능을 활성화할 것을 권장합니다.

    실행 데이터 저장 조건별 차이: 성공한 실행만 저장할지, 에러가 발생한 실행만 저장할지, 혹은 노드 진행 상황을 저장할지 선택할 수 있습니다.
    실행 데이터 저장 조건별 차이 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Manage execution data

    워크플로드별 실행 데이터 저장 옵션 비교

    워크플로우 설정 기능을 통해 개별 워크플로우 단위로 저장할 데이터의 범위를 선택할 수 있습니다.

    예를 들어, 오류가 발생한 실행 데이터만 저장하도록 설정하여 성공적인 실행 데이터의 저장을 방지할 수 있습니다.

    또한, 각 실행에 대한 노드 진행 상황이나 수동으로 실행된 데이터의 저장 여부를 선택할 수 있습니다.

    데이터 최적화 설정 순서: 1. 전체 실행 데이터의 pruning 설정 확인, 2. 워크플로우별 세부 저장 조건(에러, 성공, 진행 상황) 설정.
    데이터 최적화 설정 순서 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Manage execution data

    환경 변수를 통한 데이터 관리 설정 방법

    EXECUTIONS_DATA_SAVE_ON_ERROR=all 설정은 오류로 끝난 실행 데이터를 저장하도록 지정합니다. 성공한 실행 데이터의 저장 여부는 별도의 EXECUTIONS_DATA_SAVE_ON_SUCCESS 설정으로 제어합니다.

    EXECUTIONS_DATA_SAVE_ON_SUCCESS=none 설정을 통해 성공적인 실행 데이터를 저장하지 않습니다.

    EXECUTIONS_DATA_SAVE_ON_PROGRESS=false 설정을 통해 각 실행에 대한 노드 진행 상황을 저장하지 않습니다.

    EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false 설정을 통해 수동으로 실행된 데이터를 저장하지 않습니다.

    운영 환경 및 비용 고려사항: 자체 호스팅 인프라 운영 비용은 구독료와 별개이며, 실제 비용은 측정되지 않았습니다.
    운영 환경 및 비용 고려사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio
    다음 단계: 환경 변수 적용: 워크플로드의 실행량과 빈도에 따라 EXECUTIONS_DATA_SAVE_ON_ERROR 등 적절한 환경 변수를 설정하십시오.
    다음 단계: 환경 변수 적용 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Manage execution data

    적용 조건과 확인 범위
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아니다.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분한다.
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아님.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분함.

    확인일: 2026-09-21T19:18:35.011452+00:00

  • n8n 자체 호스팅 환경의 동시 실행 제한 및 대기열 관리

    n8n 자체 호스팅 환경의 동시 실행 제한 및 대기열 관리

    n8n 자체호스팅의 일반 모드에서는 환경 변수로 동시에 처리할 production 실행 수를 제한하고, 초과한 실행을 대기시킬 수 있습니다. 웹훅이나 트리거로 시작된 실행에 적용되는 이 동시 실행 제어를 별도의 Queue mode 도입과 혼동하지 않아야 합니다.

    동시 실행 제어의 필요성 및 기본 원리

    일반 모드에서 n8n은 동시에 실행될 수 있는 production 실행의 수를 제한하지 않습니다.

    너무 많은 실행이 동시에 발생하면 이벤트 루프에 부하가 걸려 성능 저하와 응답 지연이 발생할 수 있습니다.

    동시 실행 제한을 설정하면 허용 범위를 초과하는 실행은 대기열에 추가됩니다.

    실행 유형별 적용 여부: 웹훅/트리거 기반의 'production' 실행은 동시 실행 제어가 적용됩니다. 수동, 서브 워크플로우, 에러, CLI 실행은 동시 실행 제어가 적용되지 않습니다.
    실행 유형별 적용 여부 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Control concurrency

    동시 실행 제한 설정 및 작동 방식

    환경 변수 N8N_CONCURRENCY_PRODUCTION_LIMIT을 설정하여 동시 실행 제한을 활성화할 수 있습니다.

    대기열에 포함된 실행은 동시 실행 용량이 확보되는 대로 선입선출(FIFO) 순서로 처리됩니다.

    인스턴스가 재시작될 때, n8n은 동시 실행 제한 범위 내의 대기열 실행을 재개하고 나머지는 다시 대기열에 넣습니다.

    동시 실행 제어 활성화 및 확인: 1. N8N_CONCURRENCY_PRODUCTION_LIMIT 환경 변수를 설정하여 기능을 활성화합니다. 2. 로그를 통해 대기열에 추가되거나 해제되는 실행을 모니터링합니다. 3. 실행 탭 상단에서 활성 실행 수와 설정된 제한 값을 확인합니다.
    동시 실행 제어 활성화 및 확인 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Control concurrency

    적용 범위 및 제약 사항

    동시 실행 제어는 webhook 또는 trigger 노드에서 시작되는 'production' 실행에만 적용됩니다.

    수동 실행, 서브 워크플로우 실행, 에러 실행 또는 CLI를 통해 시작된 실행에는 동시 실행 제어가 적용되지 않습니다.

    대기열에 있는 실행은 재시도할 수 없으며, 취소 또는 삭제 시 대기열에서 제거됩니다.

    대기열 관련 제약 사항: 대기열에 있는 실행은 재시도(Retry)가 불가능합니다. 대기열에 있는 실행을 취소하거나 삭제하면 대기열에서도 즉시 제거됩니다.
    대기열 관련 제약 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Control concurrency

    모니터링 및 관리

    로그를 확인하여 대기열에 추가되거나 해제되는 실행을 모니터링할 수 있습니다.

    공식 문서에는 프로젝트 또는 워크플로우의 실행 탭 상단에서 활성 실행 수와 설정한 제한을 확인할 수 있다고 안내되어 있습니다.

    다만 같은 문서에 UI 표시는 향후 제공될 예정이라는 설명도 함께 있습니다. 적용 시점이 일치하지 않으므로, 설치한 버전의 실행 탭에서 실제 표시 여부를 확인하고 표시가 없으면 로그로 대기열 추가·해제를 확인하십시오.

    운영 환경 설정 결정: 현재 운영 환경의 동시 실행 규모를 파악하고, 이벤트 루프 성능 저하가 우려되는 경우 환경 변수를 설정하십시오. 대기열에 들어간 실행의 재시도가 필요한지 확인한 후 제어 기능을 도입하십시오.
    운영 환경 설정 결정 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Control concurrency

    적용 조건과 확인 범위
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아니다.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분한다.
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아님.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분함.
    • 동시 실행 제어는 'production' 실행(webhook, trigger)에만 적용되며, 수동/서브 워크플로우/에러/CLI 실행에는 적용되지 않음.
    • 대기열에 있는 실행은 재시도할 수 없으며, 취소 또는 삭제 시 대기열에서 제거됨.

    확인일: 2026-09-21T18:16:19.362778+00:00

  • n8n 대규모 운영을 위한 성능 확보 및 인프라 구성 전략

    n8n 대규모 운영을 위한 성능 확보 및 인프라 구성 전략

    n8n을 대규모 사용자, 워크플로우, 또는 실행이 발생하는 환경에서 운영할 때는 원활한 성능을 확보하기 위해 구성 변경이 필요합니다. 특히 확장성이 뛰어난 Queue mode와 데이터베이스 성능 향상을 위한 데이터 저장 및 정리 설정이 핵심적인 요소로 작용합니다.

    대규모 운영을 위한 핵심 모드 선택

    사용자 규모와 워크플로우 양에 따라 n8n의 구성 방식을 변경해야 합니다.

    n8n은 필요에 따라 서로 다른 모드로 실행될 수 있습니다.

    Queue mode는 가장 뛰어난 확장성을 제공하므로, 상세 설정은 Queue mode 섹션을 확인해야 합니다.

    운영 규모에 따른 모드 비교: 일반 모드 대비 Queue mode는 대규모 실행 환경에서 더 나은 확장성을 제공합니다.
    운영 규모에 따른 모드 비교 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Scaling

    데이터베이스 성능 최적화 설정

    데이터 저장 및 정리(Data saving and pruning) 설정을 통해 데이터베이스 성능을 개선할 수 있습니다.

    상세한 설정 방법은 Execution data 섹션을 참조하십시오.

    성능 최적화 확인 절차: 1. 운영 규모(사용자, 워크플로우, 실행 수) 파악 2. Queue mode 적용 여부 결정 3. 데이터 저장 및 정리(Data saving and pruning) 설정 확인
    성능 최적화 확인 절차 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Scaling

    인프라 구성 및 지원 범위 확인

    Cloud, 자체호스팅, Enterprise의 지원 범위와 제한은 구분되어 운영됩니다.

    자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아닙니다.

    인프라 및 비용 제약 사항: 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용은 측정되지 않았습니다. Cloud, 자체호스팅, Enterprise의 지원 범위는 각각 다릅니다.
    인프라 및 비용 제약 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio
    다음 단계: 인프라 결정: 현재의 워크플로우 규모를 분석하고 Queue mode 도입 필요성을 검토하십시오. 자체호스트 환경 선택 시 별도의 인프라 비용을 고려하십시오.
    다음 단계: 인프라 결정 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Scaling

    적용 조건과 확인 범위
    • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아니다.
    • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분한다.

    확인일: 2026-09-21T17:13:17.973182+00:00

  • n8n 패키지 기능을 활용한 워크플로우 이전 시 포함 및 제외 데이터 확인

    n8n 패키지 기능을 활용한 워크플로우 이전 시 포함 및 제외 데이터 확인

    n8n 패키지 기능은 워크플로우 구조, 폴더, 프로젝트 정보 등은 포함하지만, 보안이 필요한 자격 증명(Credential) 비밀값과 실행 기록 등은 포함하지 않습니다. 해당 기능은 현재 Preview 상태이며, 2.27.0 버전부터 제공됩니다.

    n8n 패키지 기능의 개요 및 현재 상태

    n8n 패키지는 워크플로우, 폴더, 프로젝트 정보 등 인스턴스의 일부를 구성하는 단일 파일입니다.

    n8n 패키지 기능은 현재 Preview 상태이며, 향후 업데이트에 따라 포맷과 API가 변경될 수 있으므로 중요한 자동화에 활용 시 주의가 필요합니다.

    이 기능은 n8n 2.27.0 버전부터 제공되며, 버전별로 지원 옵션이 다를 수 있으므로 본인의 버전을 확인해야 합니다.

    포함 vs 제외 데이터 비교: 포함: 워크플로우, 폴더, 프로젝트, 태그, 데이터 테이블 스키마. 제외: 자격 증명 비밀값, 실행 기록, 데이터 테이블 행(Rows).
    포함 vs 제외 데이터 비교 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: n8n packages Preview

    패키지 포함 데이터와 제외 데이터 비교

    워크플로우의 노드, 연결, 설정, 게시 및 보관 상태와 폴더의 계층 구조가 패키지에 포함됩니다.

    프로젝트의 이름, 설명, 아이콘과 태그, 워크플로우를 즐겨찾기로 표시한 여부가 포함됩니다.

    변수는 이름과 유형이 포함되며, 제외 설정이 없는 경우에만 값이 포함됩니다.

    반면, 실행 및 실행 기록(Executions)은 패키지에 포함되지 않습니다.

    패키지 이동 및 확인 절차: 1. 현재 인스턴스에서 .n8np 확장자의 압축 파일로 내보내기. 2. 대상 인스턴스에서 n8n API 또는 CLI를 통해 가져오기. 3. 가져온 후 누락된 자격 증명 비밀값 및 데이터 채우기.
    패키지 이동 및 확인 절차 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: n8n packages Preview

    자격 증명 및 데이터 테이블 처리 방식

    자격 증명(Credential)의 비밀값(Secret) 및 비공개 설정은 포함되지 않으며, 가져오기 시 빈 자리(Placeholder)로 생성됩니다.

    자격 증명은 패키지에 ID, 이름, 유형만 포함되며, 호스트나 API 키 같은 비공개 설정은 포함되지 않습니다.

    데이터 테이블의 경우, 행(Rows)은 포함되지 않으며 스키마(열 이름 및 유형)만 포함됩니다.

    운영 시 주의사항: Preview 상태이므로 중요한 자동화에 적용 시 업데이트 계획이 필요합니다. n8n 2.27.0 이상 버전에서 지원되며 버전별 옵션 차이가 있을 수 있습니다.
    운영 시 주의사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: n8n packages Preview

    이전 시 고려해야 할 기술적 제약 및 절차

    패키지는 .n8np 확장자를 가진 압축된 파일로, n8n API를 통해 내보내고 가져올 수 있습니다.

    n8n CLI를 통해서도 동일한 API 엔드포인트를 사용하여 패키지를 관리할 수 있습니다.

    n8n 에디터 내에서는 패키지를 직접 내보내거나 가져올 수 있는 기능이 없습니다.

    이전 전 체크리스트: 이전 전 포함되는 데이터와 제외되는 데이터(비밀값, 실행 기록 등)를 구분하여 확인하십시오. 자격 증명이 필요한 워크플로우의 경우, 이전 후 수동으로 비밀값을 입력해야 함을 고려하십시오.
    이전 전 체크리스트 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: n8n packages Preview

    적용 조건과 확인 범위
    • 요금제·Cloud/자체 호스팅·Preview 조건을 구분한 공식 문서 기반 안내입니다.
    • 실제 사용 경험·청구액·검색 수요를 측정한 결과는 아닙니다.
    • 가격·기능 설명은 확인한 공식 문서의 범위에 한정됩니다.
    • n8n packages 기능은 현재 Preview 상태이며, 향후 업데이트에 따라 포맷과 API가 변경될 수 있음.
    • n8n 2.27.0 버전부터 제공되며, 버전별로 지원 옵션이 다를 수 있음.
    • 자격 증명(Credential)의 비밀값(Secret) 및 비공개 설정은 포함되지 않으며, 가져오기 시 빈 자리(Placeholder)로 생성됨.
    • 데이터 테이블의 행(Rows)은 포함되지 않으며 스키마만 포함됨.

    확인일: 2026-09-21T16:10:24.662471+00:00

  • n8n 워크플로우 외부 공유 시 보안 주의사항 및 데이터 보호 방법

    n8n 워크플로우 외부 공유 시 보안 주의사항 및 데이터 보호 방법

    n8n 워크플로우를 JSON 형식으로 내보내어 공유할 때, 자격 증명 이름이나 HTTP 요청 헤더에 포함된 인증 정보가 노출되지 않도록 확인하고 조치해야 합니다.

    워크플로우 내보내기 형식 및 포함 정보

    n8n은 워크플로우를 JSON 형식으로 저장합니다.

    사용자는 워크플로우를 JSON 파일로 내보내거나, JSON 파일을 n8n 라이브러리로 가져올 수 있습니다.

    워크플로우를 내보내고 가져오는 방식은 여러 가지가 있습니다.

    자격 증명 데이터의 성격 비교: 자격 증명 ID는 민감하지 않으나, 이름(Names)은 설정에 따라 민감할 수 있습니다. HTTP Request 노드의 인증 헤더는 포함될 수 있으므로 주의가 필요합니다.
    자격 증명 데이터의 성격 비교 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Export and import

    공유 시 노출 위험이 있는 데이터 식별

    내보낸 워크플로우 JSON 파일에는 자격 증명(Credentials)의 이름과 ID가 포함됩니다.

    자격 증명 ID 자체는 민감하지 않으나, 사용자가 설정한 이름은 보안상 민감할 수 있습니다.

    cURL을 통해 가져온 HTTP Request 노드에는 인증 정보가 포함된 헤더가 포함될 수 있습니다.

    안전한 공유를 위한 체크리스트: 1. 워크플로우를 JSON 파일로 내보냅니다. 2. 파일 내 자격 증명 이름과 HTTP 헤더를 검토합니다. 3. 확인된 민감 정보를 제거하거나 익명화한 후 공유합니다.
    안전한 공유를 위한 체크리스트 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Export and import

    안전한 공유를 위한 전처리 단계

    자격 증명 정보를 보호하기 위해, JSON 파일을 공유하기 전에 해당 정보를 확인하십시오.

    확인된 민감 정보는 공유 전 JSON 파일에서 제거하거나 익명화해야 합니다.

    데이터 노출 범위 및 예외 사항: cURL을 통해 가져온 HTTP Request 노드는 인증 헤더를 포함할 수 있습니다. 기타 특정 환경(Cloud/자체호스팅 등)에 따른 보안 차이는 미확인 사항입니다.
    데이터 노출 범위 및 예외 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio
    공유 전 최종 조치 사항: 공유 전 JSON 파일 내의 자격 증명 이름을 확인하고 익명화 여부를 결정하십시오. HTTP Request 노드에 포함된 인증 정보가 포함되어 있는지 확인하십시오.
    공유 전 최종 조치 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Export and import

    적용 조건과 확인 범위
    • 요금제·Cloud/자체 호스팅·Preview 조건을 구분한 공식 문서 기반 안내입니다.
    • 실제 사용 경험·청구액·검색 수요를 측정한 결과는 아닙니다.
    • 가격·기능 설명은 확인한 공식 문서의 범위에 한정됩니다.
    • 원문이 뒷받침하지 않는 가격 비교나 기존 질문의 숫자 변형을 만들지 않음

    확인일: 2026-09-21T15:07:20.027425+00:00

  • n8n Cloud 무료 체험 종료 후 워크플로우 백업 및 다운로드 조건

    n8n Cloud 무료 체험 종료 후 워크플로우 백업 및 다운로드 조건

    n8n Cloud 무료 체험 기간이 종료된 후 워크플로우를 안전하게 확보하기 위해 확인해야 하는 기간과 관리 방법을 안내합니다.

    무료 체험 종료 후 워크플로우 보존 기간

    무료 체험이 종료된 후 워크플로우를 다운로드할 수 있는 기간은 90일입니다.

    이 기간이 지나면 모든 워크플로우는 영구적으로 삭제됩니다.

    기간에 따른 데이터 상태: 90일 이내: Cloud admin dashboard를 통해 최신 백업에서 워크플로우 다운로드 가능. 90일 이후: 모든 워크플로우 영구 삭제 및 복구 불가.
    기간에 따른 데이터 상태 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Download workflows

    다운로드 방법 및 관리 도구

    n8n Cloud 인스턴스 소유자는 n8n에 로그인한 뒤 Admin Dashboard를 열고, Manage 영역에서 Export 탭을 선택한 다음 Download Workflows를 누르면 됩니다.

    이때 워크플로우는 가장 최근의 백업에서 다운로드됩니다.

    워크플로우 확보 절차: 1. Cloud admin dashboard에 접속합니다. 2. 최신 백업에서 워크플로우를 다운로드합니다. 3. 90일 제한 기간 내에 완료해야 합니다.
    워크플로우 확보 절차 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Download workflows

    데이터 손실 방지를 위한 주의사항

    무료 체험 종료 후 90일이 지나면 모든 워크플로우는 영구 삭제되어 복구가 불가능합니다.

    정해진 기간 내에 다운로드를 완료하여 데이터 손실을 방지해야 합니다.

    데이터 삭제 제한 조건: 90일이 경과한 시점부터는 데이터 복구가 불가능합니다. 기타 추가적인 복구 지원이나 예외 조건은 확인되지 않음.
    데이터 삭제 제한 조건 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio
    다음 단계 안내: 무료 체험 종료 직후 Cloud admin dashboard에 접속하여 워크플로우를 즉시 다운로드하십시오. 90일이 지나기 전에 백업 상태를 최종 확인하십시오.
    다음 단계 안내 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Download workflows

    적용 조건과 확인 범위
    • 공식 문서에서 확인한 도입 조건과 제한을 유지한다.
    • 원문에 없는 가격·사용 경험·수익을 만들지 않는다.
    • 공식 문서에 명시된 90일의 다운로드 가능 기간 및 이후 영구 삭제 조건을 준수함.
    • 원문에 없는 가격, 사용 경험, 수익 관련 정보는 포함하지 않음.

    확인일: 2026-09-21T14:04:02.337629+00:00

  • n8n Cloud Gateway credits의 기능과 무료 체험 활용 방법

    n8n Cloud Gateway credits의 기능과 무료 체험 활용 방법

    n8n Cloud의 Gateway credits를 사용하면 별도의 계정 생성이나 API 키 관리 없이 지원되는 AI 모델 및 제3자 서비스를 워크플로우에 통합할 수 있습니다. 무료 체험 기간 동안 제공되는 소량의 크레딧을 통해 지원 서비스를 즉시 테스트할 수 있습니다.

    Gateway credits의 기능 및 지원 범위

    Gateway credits를 사용하면 지원되는 AI 모델 및 제3자 서비스를 워크플로우에서 활용할 수 있습니다.

    이 기능을 사용하면 별도의 공급자 계정을 생성하거나 API 키를 관리할 필요가 없습니다.

    지원되는 노드에서 Gateway credits를 선택하면, n8n이 미리 충전된 크레딧 잔액에서 사용량을 청구합니다.

    Gateway credits vs 자체 인증: Gateway credits 사용 시 n8n이 크레딧 잔액에서 비용을 청구하며, 자체 인증(Credentials) 사용 시에는 크레딧 소모 없이 작동합니다. 크레딧이 소진되어도 실행 중인(in-flight) 요청은 완료된 후 차액이 다음 충전 시 반영됩니다.
    Gateway credits vs 자체 인증 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Gateway credits

    플랜별 가용성 및 제한 사항

    Gateway credits는 n8n Cloud Starter 및 Pro 플랜에서 사용할 수 있으며, n8n 2.36.0 버전부터 제공됩니다.

    Gateway credits는 n8n Cloud Enterprise 또는 self-hosted n8n에서는 사용할 수 없습니다.

    크레딧 잔액이 0이 되면 Gateway credits를 사용하는 노드만 작동이 중지되며, 자체 인증 정보를 사용하는 노드는 영향을 받지 않습니다.

    실행 도중 잔액이 소진되면 n8n은 진행 중인 요청을 완료한 후 다음 충전 시점에 차액을 청구합니다.

    크레딧 확인 및 관리 절차: 노드 설정 내 Gateway credits 옵션 옆에서 잔액을 확인하거나, Cloud 관리 대시보드의 Gateway credits 탭에서 사용 내역을 확인합니다.
    크레딧 확인 및 관리 절차 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Gateway credits

    무료 체험 기간 활용 및 전환

    신규 Cloud 사용자는 가입 시 소량의 무료 크레딧을 받으며, 이는 무료 체험 기간에도 포함됩니다.

    무료 체험 기간 중에는 크레딧 충전이 불가능합니다.

    무료 체험 중 크레딧을 모두 소진한 경우, 유료 플랜으로 업그레이드해야 크레딧을 추가로 충전할 수 있습니다.

    무료 체험 및 플랜 제한: 무료 체험 시 소량의 크레딧이 제공되나, 체험 기간 중에는 수동/자동 충전이 불가능합니다. Enterprise 및 self-hosted 버전에서는 Gateway credits 기능을 지원하지 않습니다.
    무료 체험 및 플랜 제한 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio
    다음 단계 안내: 무료 체험 중 크레딧이 소진되면 유료 플랜으로 업그레이드하여 크레딧을 추가로 확보하십시오. 자체 인증이 필요한 서비스의 경우 별도의 인증 정보를 설정하여 크레딧 소모와 무관하게 운영할 수 있습니다.
    다음 단계 안내 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Gateway credits

    적용 조건과 확인 범위
    • 공식 문서에서 확인한 도입 조건과 제한을 유지한다.
    • 원문에 없는 가격·사용 경험·수익을 만들지 않는다.
    • Gateway credits는 n8n Cloud Starter, Pro 플랜에서만 제공되며, Enterprise 또는 self-hosted 버전에서는 사용할 수 없습니다.
    • 무료 체험 기간 중에는 크레딧 충전이 불가능하며, 크레딧 소진 시 유료 플랜으로 업그레이드해야 추가 충전이 가능합니다.
    • 크레딧 잔액이 0이 되면 해당 크레딧을 사용하는 노드만 작동이 중지되며, 자체 인증 정보를 사용하는 노드는 영향을 받지 않습니다.

    확인일: 2026-09-21T13:02:13.042942+00:00

  • n8n 워크플로우 검토(Review) 기능의 요금제별 제공 및 승인 절차

    n8n 워크플로우 검토(Review) 기능의 요금제별 제공 및 승인 절차

    워크플로우 검토 기능은 n8n Cloud와 Self-hosted 환경 모두 Enterprise 요금제에서 제공됩니다. 현재 Preview 상태이므로 운영 환경 적용 시 주의가 필요하며, 승인 상태에 따라 게시 차단 여부와 자동 게시 여부가 달라집니다.

    워크플로우 검토 기능의 가용성 및 환경 조건

    워크플로우 검토 기능은 n8n Cloud와 Self-hosted 환경 모두 Enterprise 요금제에서 제공됩니다.

    이 기능은 n8n 2.37.0 버전부터 지원되며, 인스턴스 관리자가 설정(Settings > Security & policies)에서 해당 기능을 활성화해야 합니다.

    현재 검토 기능은 Preview 상태이며, 일반 출시 전까지 변경될 수 있으므로 운영 환경 적용 시 주의가 필요합니다.

    승인 상태별 게시 제한 및 자동화 여부: Waiting for review: 승인 대기 중이며 게시가 차단됩니다. Changes requested: 수정 요청 시 게시가 차단되며, 새 버전 제출 시 다시 대기 상태가 됩니다. Approved: 승인 시 게시가 차단이 해제되며 요청자가 게시한 것으로 기록됩니다.
    승인 상태별 게시 제한 및 자동화 여부 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Review workflows Preview

    승인 상태에 따른 워크플로우 상태 변화

    Waiting for review: 고정된 버전이 결정을 기다리는 상태이며, n8n은 게시를 차단합니다.

    Changes requested: 검토자가 업데이트를 요청한 상태입니다. 누군가 새 버전을 제출하고 검토가 다시 Waiting for review로 돌아와 승인될 때까지 게시가 차단됩니다.

    Approved: 검토자나 관리자가 승인한 상태입니다. 검토가 종료되고 게시가 차단이 해제되며, n8n은 해당 버전을 자동으로 게시합니다.

    검토가 승인되었으나 드문 경우로 자동 게시가 되지 않는 경우, 편집기에서 Publish 버튼을 사용하여 직접 게시해야 합니다.

    Closed (no approval): 워크플로우가 삭제, 아카이브 또는 이동되어 검토할 내용이 없는 경우 검토가 승인 없이 종료될 수 있습니다.

    워크플로우 검토 및 승인 절차: 검토를 위해 Publish 메뉴에서 'Submit for review'를 선택하고 검토자를 할당합니다. 검토 중에도 워크플로우를 계속 편집할 수 있으며, 새 저장은 별도의 버전으로 생성됩니다.
    워크플로우 검토 및 승인 절차 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Review workflows Preview

    검토 프로세스 및 운영 시 주의사항

    검토 기능은 선택 사항이며, 활성화 후에도 현재 열려 있는 검토가 없는 워크플로우는 직접 게시할 수 있습니다.

    검토는 워크플로우의 한 고정된 버전에 연결됩니다. 검토가 진행되는 동안에도 편집을 계속할 수 있습니다.

    검토자가 할당되거나 검토자가 변경을 요청할 때 n8n은 이메일이나 외부 알림을 보내지 않습니다.

    수정이 필요한 사항은 왼쪽 사이드바의 Reviews 메뉴를 통해 확인해야 합니다.

    기능 제한 및 운영 주의사항: 현재 Preview 상태이므로 운영 환경(Production)에서 의존하는 것을 피해야 합니다. 검토자 할당이나 요청 시 이메일 등 외부 알림이 전송되지 않으므로 사이드바를 확인해야 합니다.
    기능 제한 및 운영 주의사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio
    도입 전 확인 및 결정 사항: Enterprise 요금제 사용 여부와 n8n 2.37.0 버전 이상 여부를 먼저 확인하십시오. Preview 기능의 불안정성을 고려하여 실제 운영 환경 적용 시의 리스크를 검토하십시오.
    도입 전 확인 및 결정 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
    설명 도해 · 하루보탬 Studio

    근거: Review workflows Preview

    적용 조건과 확인 범위
    • 공식 문서의 요금제·Cloud/자체호스팅·Preview 조건을 구분한다.
    • 실제 사용·실청구·검색 수요를 추정하지 않는다.
    • 원문이 뒷받침하지 않는 가격 비교나 기존 질문의 숫자 변형을 만들지 않는다.
    • n8n Cloud 및 Self-hosted 환경 모두 Enterprise 요금제에서만 제공됨
    • 현재 Preview 상태로 일반 출시 전 변경 가능성 있음
    • n8n 2.37.0 버전부터 지원되며 관리자 설정 필요

    확인일: 2026-09-21T11:59:02.289621+00:00