6-1. 자동 백업 + 보안 설정 (.env, Credentials)

워크플로우를 만들고 모니터링하고 관리하는 방법까지 배웠습니다. 한 가지 빠진 조각이 있습니다. 실수로 워크플로우를 삭제하거나 잘못 수정했을 때 되돌릴 수단입니다. 이 클립에서는 백업과 보안 두 가지를 함께 다룹니다.

1. 백업이 필요한 이유

워크플로우 하나를 만드는 데 짧게는 10분, 길게는 몇 시간이 걸립니다. 그런데 실수로 삭제하거나 수정 중에 기존 설정을 날려버리면 복원할 방법이 없습니다.

n8n에는 기본적으로 "되돌리기" 기능이 없습니다. 삭제하면 그대로 사라집니다. 이를 방지하는 유일한 수단이 백업입니다.

2. Claude Code로 워크플로우 백업하기

백업은 Claude Code에게 한마디면 충분합니다.

"워크플로우 전부 백업해줘"

Claude Code가 내부적으로 수행하는 과정은 다음과 같습니다.

결과물로 backups/ 폴더 안에 워크플로우별 JSON 파일이 생성됩니다. 이 파일들만 있으면 언제든 워크플로우를 복원할 수 있습니다.

3. 버전 이력까지 함께 백업

현재 상태뿐 아니라 수정 이력까지 백업할 수 있습니다. n8n_workflow_versions 도구를 사용합니다.

"날씨 알림 워크플로우의 버전 이력도 함께 백업해줘"

"어제까지는 잘 돌아갔는데 오늘 수정한 뒤로 에러가 난다"는 상황에서 어제 버전으로 되돌릴 수 있습니다. 현재 상태 백업과 버전 이력 백업을 함께 운영하는 것을 권장합니다.

4. 보안 3원칙

백업 다음으로 중요한 것이 보안입니다. 특히 API 키와 비밀번호를 다루는 방식을 반드시 익혀야 합니다. 세 가지 원칙을 기억합니다.

.env 파일 예시는 다음과 같습니다.

N8N_API_KEY=your-api-key-here
N8N_BASE_URL=http://localhost:5678

.gitignore에는 한 줄을 추가합니다.

.env

코드에서는 이 값을 환경 변수로 불러와 사용합니다. API 키 값이 코드에 직접 노출되지 않으므로 안전합니다.

5. n8n Credentials — 외부 서비스 키 중앙 관리

Slack, 텔레그램, 기상청 API 같은 외부 서비스 키는 어디에 저장해야 할까요. n8n에는 Credentials(자격증명) 기능이 있습니다.

n8n 대시보드 좌측 메뉴의 Credentials에서 외부 서비스의 API 키를 중앙 한 곳에 저장합니다.

장점은 두 가지입니다.

• 워크플로우마다 API 키를 따로 입력할 필요 없이 Credential을 선택만 하면 됩니다.
• API 키가 바뀌어도 Credential 하나만 수정하면 모든 워크플로우에 반영됩니다.

워크플로우 안에 API 키를 직접 적는 대신, 항상 Credentials 기능을 사용합니다.

6. 실습 — 백업 + 보안 설정 한 번에

Claude Code에게 세 단계를 순서대로 지시합니다.

Step 1 · 워크플로우 백업

"현재 n8n에 있는 워크플로우를 전부 backups 폴더에 JSON으로 백업해줘"

Step 2 · .env 파일 확인

"프로젝트 루트에 .env 파일이 있는지 확인하고, API 키가 코드에 직접 노출된 곳이 있으면 알려줘"

Step 3 · .gitignore 확인

".gitignore에 .env가 포함되어 있는지 확인해줘. 없으면 추가해줘"

이 세 단계만 거치면 백업과 보안 기본 설정이 완료됩니다. 백업 명령을 주기적으로 실행하는 습관을 들이는 것을 권장합니다.

7. 마무리

★ 핵심. 백업은 한 줄 명령으로, 보안은 세 원칙으로 끝납니다.

다음 클립에서는 팀 공유를 다룹니다. 혼자 쓰던 스킬과 워크플로우를 팀원과 함께 쓰는 방법을 익힙니다.