{"title":"백업 및 복원","slug":"backup-restore","category":"guides","summary":"백업을 위해 메모리 내보내기, 마인드 간 마이그레이션, 데이터 손실 후 복원.","audience":["human","llm"],"tags":["guide","backup","restore","migration"],"difficulty":"beginner","updated":"2026-06-27","word_count":232,"read_minutes":1,"lang":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# 백업 및 복원\n\nSynapse는 메모리 백업, 마이그레이션 및 재해 복구를 위한 전체 내보내기/가져오기를\n제공합니다. 이 가이드는 필수 작업을 다룹니다.\n\n## 내보내기\n\n### 전체 마인드 내보내기\n\n마인드의 모든 메모리를 JSON으로 내보내기:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export > backup.json\n```\n\n응답 형식:\n\n```json\n{\n \"mind_id\": \"m_xyz789\",\n \"mind_name\": \"Work Mind\",\n \"exported_at\": \"2026-06-27T...\",\n \"memory_count\": 142,\n \"memories\": [\n {\n \"id\": \"mem_001\",\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\",\n \"source\": \"user\",\n \"verified\": true,\n \"created_at\": \"2026-06-15T...\",\n \"updated_at\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### 증분 내보내기 (Diff)\n\n타임스탬프 이후 변경된 메모리만 내보내기:\n\n```bash\nSINCE=$(date -d \"2026-06-01\" +%s)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=$SINCE\" > incremental.json\n```\n\n응답:\n\n```json\n{\n \"added\": [...],\n \"updated\": [...],\n \"deleted\": [...]\n}\n```\n\n### 자동화된 백업\n\ncron을 통해 일일 백업 예약:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/cron \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"schedule\": \"0 2 * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/mind-export\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n }'\n```\n\n> [!NOTE]\n> cron 엔드포인트는 응답을 받지만 저장하지 않습니다. 실제 백업을\n> 위해 cron을 응답을 저장하는 자체 백업 서버로 지정하십시오.\n\n### 더 나은 방법: 외부 백업 스크립트\n\n```bash\n#!/bin/bash\n# backup-synapse.sh\nMIND_KEY=\"${SYNAPSE_MIND_KEY}\"\nDATE=$(date +%Y%m%d)\nBACKUP_DIR=\"/backups/synapse\"\n\nmkdir -p \"$BACKUP_DIR\"\n\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export \\\n > \"$BACKUP_DIR/synapse-$DATE.json\"\n\n# Keep last 30 days\nfind \"$BACKUP_DIR\" -name \"synapse-*.json\" -mtime +30 -delete\n\necho \"Backup saved: $BACKUP_DIR/synapse-$DATE.json\"\n```\n\ncrontab에 추가:\n\n```cron\n0 2 * * * /usr/local/bin/backup-synapse.sh\n```\n\n## 복원\n\n### 동일 마인드로 복원\n\n```bash\n# Parse backup and re-POST each memory\njq -c '.memories[]' backup.json | while read mem; do\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$(echo \"$mem\" | jq '{category, key, content, tags, priority}')\"\ndone\n```\n\n### 새 마인드로 복원\n\n```bash\n# 1. Create new mind\nNEW_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\":\"Restored Mind\",\"description\":\"Restore from backup\"}' \\\n | jq -r .mind_key)\n\n# 2. Import memories to new mind\njq -c '.memories[]' backup.json | while read mem; do\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer $NEW_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$(echo \"$mem\" | jq '{category, key, content, tags, priority}')\"\ndone\n```\n\n### Python 복원 스크립트\n\n```python\nimport json\nimport requests\n\nURL = \"https://synapse.schaefer.zone\"\nMIND_KEY = \"mk_...\"\n\ndef restore(backup_file):\n with open(backup_file) as f:\n data = json.load(f)\n \n for mem in data[\"memories\"]:\n requests.post(\n f\"{URL}/memory\",\n headers={\n \"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\"\n },\n json={\n \"category\": mem[\"category\"],\n \"key\": mem[\"key\"],\n \"content\": mem[\"content\"],\n \"tags\": mem.get(\"tags\", []),\n \"priority\": mem.get(\"priority\", \"normal\")\n }\n )\n \n print(f\"Restored {len(data['memories'])} memories\")\n\nrestore(\"backup.json\")\n```\n\n## 마인드 간 마이그레이션\n\n```python\ndef migrate_memories(source_key, target_key):\n \"\"\"Migrate all memories from source mind to target mind.\"\"\"\n # Export from source\n r = requests.get(\n f\"{URL}/memory/mind-export\",\n headers={\"Authorization\": f\"Bearer {source_key}\"}\n )\n data = r.json()\n \n # Import to target\n for mem in data[\"memories\"]:\n requests.post(\n f\"{URL}/memory\",\n headers={\n \"Authorization\": f\"Bearer {target_key}\",\n \"Content-Type\": \"application/json\"\n },\n json={\n \"category\": mem[\"category\"],\n \"key\": mem[\"key\"],\n \"content\": mem[\"content\"],\n \"tags\": mem.get(\"tags\", []),\n \"priority\": mem.get(\"priority\", \"normal\")\n }\n )\n \n print(f\"Migrated {len(data['memories'])} memories\")\n```\n\n## 기타 데이터 백업\n\n다음도 백업하는 것을 잊지 마십시오:\n\n| 데이터 유형 | 엔드포인트 |\n|-----------|----------|\n| Memories | `GET /memory/mind-export` |\n| Tasks | `GET /mind/tasks` |\n| Scripts | `GET /scripts` |\n| Webhooks | `GET /webhooks` |\n| Cron jobs | `GET /cron` |\n| Variables | `GET /var` |\n| Chat history | `GET /chat/history?limit=10000` |\n\n## 검증\n\n복원 후 검증:\n\n```bash\n# Count memories\ncurl -s -H \"Authorization: Bearer $KEY\" \\\n https://synapse.schaefer.zone/memory/stats | jq .total\n\n# Compare with backup\njq .memory_count backup.json\n```\n\n## 모범 사례\n\n> [!TIP]\n> - **매일 백업** — cron으로 자동화\n> - **복원 테스트** — 복원할 수 없는 백업은 쓸모가 없음\n> - **여러 버전 유지** — 최소 30일\n> - **오프사이트 저장** — S3, Backblaze B2 등\n> - **민감한 백업 암호화** — 메모리에 PII가 포함될 수 있음\n> - **복원 프로세스 문서화** — 필요할 때 잊어버릴 것입니다\n\n## 다음 단계\n\n- [Memory API](/docs/api/memory)\n- [Cron 및 Scheduler](/docs/api/cron) — 자동화된 백업용\n","content_html":"

백업 및 복원

\n

Synapse는 메모리 백업, 마이그레이션 및 재해 복구를 위한 전체 내보내기/가져오기를\n제공합니다. 이 가이드는 필수 작업을 다룹니다.

\n

내보내기

\n

전체 마인드 내보내기

\n

마인드의 모든 메모리를 JSON으로 내보내기:

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mind-export > backup.json

응답 형식:

\n
{\n  "mind_id": "m_xyz789",\n  "mind_name": "Work Mind",\n  "exported_at": "2026-06-27T...",\n  "memory_count": 142,\n  "memories": [\n    {\n      "id": "mem_001",\n      "category": "identity",\n      "key": "user_name",\n      "content": "Michael Schäfer",\n      "tags": ["person", "identity"],\n      "priority": "critical",\n      "source": "user",\n      "verified": true,\n      "created_at": "2026-06-15T...",\n      "updated_at": "2026-06-27T..."\n    }\n  ]\n}

증분 내보내기 (Diff)

\n

타임스탬프 이후 변경된 메모리만 내보내기:

\n
SINCE=$(date -d "2026-06-01" +%s)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/diff?since=$SINCE" > incremental.json

응답:

\n
{\n  "added": [...],\n  "updated": [...],\n  "deleted": [...]\n}

자동화된 백업

\n

cron을 통해 일일 백업 예약:

\n
curl -X POST https://synapse.schaefer.zone/cron \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "schedule": "0 2 * * *",\n    "endpoint": "https://synapse.schaefer.zone/memory/mind-export",\n    "method": "GET",\n    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n  }'
cron 엔드포인트는 응답을 받지만 저장하지 않습니다. 실제 백업을\n위해 cron을 응답을 저장하는 자체 백업 서버로 지정하십시오.

더 나은 방법: 외부 백업 스크립트

\n
#!/bin/bash\n# backup-synapse.sh\nMIND_KEY="${SYNAPSE_MIND_KEY}"\nDATE=$(date +%Y%m%d)\nBACKUP_DIR="/backups/synapse"\n\nmkdir -p "$BACKUP_DIR"\n\ncurl -s -H "Authorization: Bearer $MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mind-export \\\n     > "$BACKUP_DIR/synapse-$DATE.json"\n\n# Keep last 30 days\nfind "$BACKUP_DIR" -name "synapse-*.json" -mtime +30 -delete\n\necho "Backup saved: $BACKUP_DIR/synapse-$DATE.json"

crontab에 추가:

\n
0 2 * * * /usr/local/bin/backup-synapse.sh

복원

\n

동일 마인드로 복원

\n
# Parse backup and re-POST each memory\njq -c '.memories[]' backup.json | while read mem; do\n  curl -X POST https://synapse.schaefer.zone/memory \\\n    -H "Authorization: Bearer YOUR_MIND_KEY" \\\n    -H "Content-Type: application/json" \\\n    -d "$(echo "$mem" | jq '{category, key, content, tags, priority}')"\ndone

새 마인드로 복원

\n
# 1. Create new mind\nNEW_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{"name":"Restored Mind","description":"Restore from backup"}' \\\n  | jq -r .mind_key)\n\n# 2. Import memories to new mind\njq -c '.memories[]' backup.json | while read mem; do\n  curl -X POST https://synapse.schaefer.zone/memory \\\n    -H "Authorization: Bearer $NEW_KEY" \\\n    -H "Content-Type: application/json" \\\n    -d "$(echo "$mem" | jq '{category, key, content, tags, priority}')"\ndone

Python 복원 스크립트

\n
import json\nimport requests\n\nURL = "https://synapse.schaefer.zone"\nMIND_KEY = "mk_..."\n\ndef restore(backup_file):\n    with open(backup_file) as f:\n        data = json.load(f)\n    \n    for mem in data["memories"]:\n        requests.post(\n            f"{URL}/memory",\n            headers={\n                "Authorization": f"Bearer {MIND_KEY}",\n                "Content-Type": "application/json"\n            },\n            json={\n                "category": mem["category"],\n                "key": mem["key"],\n                "content": mem["content"],\n                "tags": mem.get("tags", []),\n                "priority": mem.get("priority", "normal")\n            }\n        )\n    \n    print(f"Restored {len(data['memories'])} memories")\n\nrestore("backup.json")

마인드 간 마이그레이션

\n
def migrate_memories(source_key, target_key):\n    """Migrate all memories from source mind to target mind."""\n    # Export from source\n    r = requests.get(\n        f"{URL}/memory/mind-export",\n        headers={"Authorization": f"Bearer {source_key}"}\n    )\n    data = r.json()\n    \n    # Import to target\n    for mem in data["memories"]:\n        requests.post(\n            f"{URL}/memory",\n            headers={\n                "Authorization": f"Bearer {target_key}",\n                "Content-Type": "application/json"\n            },\n            json={\n                "category": mem["category"],\n                "key": mem["key"],\n                "content": mem["content"],\n                "tags": mem.get("tags", []),\n                "priority": mem.get("priority", "normal")\n            }\n        )\n    \n    print(f"Migrated {len(data['memories'])} memories")

기타 데이터 백업

\n

다음도 백업하는 것을 잊지 마십시오:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
데이터 유형엔드포인트
MemoriesGET /memory/mind-export
TasksGET /mind/tasks
ScriptsGET /scripts
WebhooksGET /webhooks
Cron jobsGET /cron
VariablesGET /var
Chat historyGET /chat/history?limit=10000
\n

검증

\n

복원 후 검증:

\n
# Count memories\ncurl -s -H "Authorization: Bearer $KEY" \\\n     https://synapse.schaefer.zone/memory/stats | jq .total\n\n# Compare with backup\njq .memory_count backup.json

모범 사례

\n

다음 단계

\n\n","urls":{"html":"/docs/guides/backup-restore","text":"/docs/guides/backup-restore?format=text","json":"/docs/guides/backup-restore?format=json","llm":"/docs/guides/backup-restore?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}