설치 · 사용법

n8n 워크플로 내보내기·가져오기 — JSON 보관과 확인

먼저 확인

n8n 워크플로는 에디터의 ··· → Download로 JSON 사본을 받고 대상 에디터의 Import from File로 가져올 수 있습니다. 이 파일은 전체 인스턴스 백업이 아닙니다. credential 이름·ID나 직접 넣은 민감한 값은 파일에 남을 수 있으므로 내용을 검토하고, 가져온 뒤 인증·노드·실행 조건을 대조한 다음 시험하세요.

기본 정보

출발
이미 만든 워크플로 · 에디터 접근 가능
파일
현재 흐름의 JSON 사본
따로 확인
인증 비밀값·외부 설정·실행 이력
최종 점검
노드/연결·시험 결과·게시/트리거 상태

1. 보관·가져오기 순서

  1. 1. 보관할 흐름 확인

    현재 편집 중인 워크플로와 보관할 시점을 확인합니다. Cloud의 선택 백업과 에디터의 현재 사본을 구분합니다.

  2. 2. JSON 내려받기

    캔버스 헤더의 Workflow 메뉴(···)에서 Download를 선택해 파일을 보관합니다.

  3. 3. 파일 내용 검토

    노드·설정과 credential 이름/ID, 직접 입력한 값·인증 헤더 등 공유하면 안 되는 내용이 있는지 확인합니다.

  4. 4. 대상에 가져오기

    대상 에디터에서 워크플로를 만들거나 열고 ··· → Import from File로 JSON을 선택합니다.

  5. 5. 재연결·시험

    필요한 인증과 의존성을 준비하고 노드·설정·실행 조건을 대조합니다. 작은 입력으로 결과를 확인한 뒤 게시·전환합니다.

2. 보관 범위

JSON과 별도 보관할 대상
구분 확인할 내용
워크플로 JSON 노드 구성·설정과 인증 참조 등 확인
인증·운영 환경 비밀값 재연결·변수·노드/서비스 의존성 별도 확인
전체 복원 실행 이력·모든 인스턴스 데이터까지 포함한다고 가정하지 않음

이 글은 이미 있는 흐름의 JSON 사본을 보관하고 가져오는 절차입니다. 처음 이용 환경을 고르거나 흐름을 만드는 과정은 n8n 대표 페이지에서 볼 수 있습니다. 서버 전체 복원에 필요한 저장소·키·운영 환경의 보관은 별도 범위입니다.

3. 현재 흐름 내려받기

  1. 보관할 워크플로를 열어 이름과 편집 상태를 확인합니다.
  2. 캔버스 헤더의 Workflow 메뉴(···)에서 Download를 선택합니다.
  3. JSON 파일을 보관하고 어느 환경·흐름·시점의 사본인지 함께 기록합니다.

Cloud console의 Export에서 백업을 골라 내려받는 일괄 파일은 선택한 백업 시점을 기준으로 합니다. 최근 수정이 빠질 수 있으므로 현재 개별 흐름의 사본을 원하면 에디터의 Download를 사용하고 내용을 대조하세요.

4. 파일 검토·공유

내려받은 JSON을 텍스트 편집기로 열어 필요한 노드와 설정이 담겼는지 확인합니다. 원본 사본은 보관하고 공유용으로 값을 가릴 때는 별도 복사본을 다루세요. 편집하다 구조를 손상시키지 않도록 JSON 형식을 유지합니다.

  • credential 이름·ID에 개인 이름이나 내부 업무명이 들어 있는지 봅니다.
  • HTTP Request 노드의 인증 헤더와 직접 붙인 토큰·주소·본문 값을 확인합니다. 특히 cURL에서 가져온 요청을 점검합니다.
  • 노드에 직접 넣은 업무 자료나 시험 입력도 공유 범위에 맞는지 확인합니다.

워크플로 내보내기가 credential 저장소의 비밀값을 이전하지 않는다는 설명과 파일 자체에 민감한 값이 전혀 없다는 말은 다릅니다. 공유 파일은 별도로 검토해야 합니다. 메뉴·형식은 공식 내보내기·가져오기 문서에서 확인할 수 있습니다.

5. 가져오기·재연결

  1. 대상 n8n 에디터에서 워크플로를 새로 만들거나 가져올 작업을 엽니다. 기존 작업을 편집한다면 먼저 그 사본도 보관합니다.
  2. 오른쪽 위 Workflow 메뉴(···)에서 Import from File을 선택하고 JSON을 엽니다.
  3. 캔버스의 노드와 연결이 보관한 흐름과 같은지 대조합니다.
  4. 필요한 credential을 대상 환경에서 준비하고 노드에 지정합니다. OAuth 연결은 다시 승인해야 할 수 있습니다.

변수·환경 설정·커뮤니티 노드와 외부 서비스도 대상 환경에 있는지 확인하세요. 하위 워크플로나 오류 처리 흐름을 참조한다면 그 연결도 대조합니다. 파일이 열렸다는 사실만으로 모든 의존성이 옮겨진 것은 아닙니다.

6. 실행·전환 확인

게시 전에 대조할 항목
구분 확인할 내용
노드·설정 인증 연결·참조 흐름·필요한 추가 노드
자동 실행 트리거·스케줄·시간대·현재 게시 상태
외부 연결 Webhook 주소·외부 서비스의 연결 대상
시험 결과 작은 입력과 각 노드 출력·최종 대상의 결과

작은 시험 입력으로 결과를 확인한 뒤 필요한 자동 흐름을 게시합니다. 다른 환경으로 전환할 때는 이전 흐름과 새 흐름이 같은 사건을 두 번 처리하지 않도록 실행 시점을 맞추세요. 파일을 가져오면 자동으로 비활성화된다고 가정하거나, 확인 없이 실제 업무 대상을 시험 입력으로 사용하지 않습니다.

공식 이전 점검 안내는 인증·의존성과 시험 후 게시를 구분합니다. 최신 CLI/API의 .n8np 패키지는 Preview의 별도 형식이므로 이 글의 에디터 JSON 파일과 혼용하지 마세요.

7. 자주 묻는 질문

n8n JSON 파일은 전체 백업인가요?

+

현재 워크플로의 구성 사본입니다. 인증 비밀값·실행 이력·모든 인스턴스 데이터가 함께 이전되는 전체 백업으로 볼 수 없습니다.

credential을 내보내지 않으니 JSON을 바로 공유해도 되나요?

+

이름/ID와 노드에 직접 입력한 민감한 값·인증 헤더가 남을 수 있습니다. 원본은 보관하고 공유용 복사본을 따로 검토하세요.

파일을 가져왔는데 노드가 실행되지 않으면 어떻게 하나요?

+

대상 환경의 인증 재지정, 필요한 노드·변수·외부 서비스와 참조 워크플로를 확인하세요. JSON을 읽은 것과 운영 환경이 준비된 것은 다릅니다.

Cloud 백업에서 받은 파일에 최신 수정이 없을 수 있나요?

+

선택한 백업 시점의 파일이므로 이후 편집은 빠질 수 있습니다. 현재 개별 흐름은 에디터의 Download에서 사본을 받고 내용을 대조하세요.

가져온 뒤 바로 Publish하면 되나요?

+

스케줄·시간대·Webhook·연결 계정과 대상, 이전 환경의 중복 실행 여부를 확인하고 작은 시험 결과를 대조한 뒤 게시하세요.

출처: n8n 에디터 JSON 내보내기·가져오기, n8n Cloud 이전·인증/의존성·전환 점검, 시험 실행·게시의 기본 흐름

함께 보면 좋은