n8n 자체 호스팅 시 전체 백업은 .n8n 사용자 폴더(설정 및 암호화 키 포함), 사용 중인 외부 데이터베이스, 외부 저장소, 그리고 커스텀 노드 경로를 모두 포함해야 합니다. 특히 암호화 키가 없으면 데이터베이스 내의 자격 증명을 복구할 수 없으므로 필수적으로 포함되어야 합니다.
대표 참고 사진 출처: Btrs · 사진 원본 · CC-BY-SA-4.0 · 원본 변경 없음. 참고 사진이며 제품 사용·성능의 증거가 아닙니다.
전체 백업의 핵심 구성 요소
전체 백업은 .n8n 사용자 폴더(기본값: ~/.n8n)를 포함해야 합니다.
이 폴더에는 설정 파일과 자격 증명 암호화 키가 포함되어 있으며, 기본 SQLite 데이터베이스를 사용하는 경우 데이터베이스 파일도 이 안에 위치합니다.
자격 증명은 데이터베이스에 암호화된 형태로 저장되므로, 설정 파일 내의 키나 별도로 설정한 N8N_ENCRYPTION_KEY가 없으면 복구된 데이터베이스에서 자격 증명을 복구할 수 없습니다.
설명 도해 · 하루보탬 Studio
설명 도해 · 하루보탬 Studio
데이터베이스 및 외부 저장소 구성에 따른 백업 차이
PostgreSQL과 같은 외부 데이터베이스를 사용하는 경우, 해당 데이터베이스 전용 도구를 사용하여 백업해야 합니다.
파일 시스템 저장 모드를 사용하여 바이너리 데이터나 실행 데이터를 저장하는 경우, 해당 데이터가 저장된 경로도 백업에 포함해야 합니다.
S3나 Azure Blob Storage와 같은 외부 저장소를 설정한 경우 해당 저장소도 함께 백업해야 하며, N8N_CUSTOM_EXTENSIONS 환경 변수로 설정된 커스텀 노드 경로도 반드시 포함해야 합니다.
커스텀 노드를 포함하지 않은 인스턴스로 복구할 경우 해당 노드를 참조하는 워크플로우가 작동하지 않기 때문입니다.
설명 도해 · 하루보탬 Studio
안전한 백업 실행을 위한 기술적 조건
기본 SQLite 데이터베이스를 사용하는 경우, n8n을 중지한 상태에서 .n8n 폴더를 복사해야 합니다.
n8n이 실행 중인 상태에서 데이터베이스 파일을 복사하면 일관성이 없는 백업이 생성될 수 있으므로, 중지가 불가능한 경우 일관된 스냅샷을 생성하는 도구를 사용해야 합니다.
Docker 환경에서 운영하는 경우, .n8n 폴더는 n8n_data 볼륨 내의 /home/node/.n8n 경로에 위치하므로 해당 경로를 확인해야 합니다.
설명 도해 · 하루보탬 Studio
설명 도해 · 하루보탬 Studio
적용 조건과 확인 범위
- 공식 문서에 명시된 자체호스팅 운영 범위와 백업에 포함·제외되는 대상을 구분한다.
- 실제 인스턴스 복구·성능·비용을 검증했다고 주장하지 않는다.
- 기본 SQLite 사용 시 n8n을 중지하거나 스냅샷 도구를 사용하여 일관된 백업을 생성해야 함
- Docker 환경의 경우 n8n_data 볼륨 내의 경로 확인 필요
- 커스텀 노드 경로(N8N_CUSTOM_EXTENSIONS)가 설정된 경우 해당 경로 포함 필수
확인일: 2026-10-01T02:01:51.603084+00:00