备份与恢复

你的交易日志在磁盘上就是两样东西，且必须一起备份：

附件的元数据保存在数据库中 —— 只恢复其中之一会造成截图失效或文件成为孤儿。

内置 —— 定时快照（SQLite）

API 会自动为 SQLite 数据库做快照：默认每天一次，写入 /data/backups（Docker）或数据库文件旁的 backups/ 文件夹，文件名为 tradermemos-YYYYMMDD-HHMMSSZ.db，保留最新 14 份。每份快照都是 VACUUM INTO 生成的一致性拷贝，fsync 后再重命名到位，因此不会出现写了一半却带着快照名的文件； 清理时也只会删除完全符合该命名的文件。可通过 TM_BACKUP_DIR、TM_BACKUP_KEEP、 TM_BACKUP_INTERVAL_MIN 和 TM_BACKUP_ENABLED 调整（见配置）。

设置 → 关于 → 备份（仅所有者）显示上次备份、目录和最近的错误，并提供“立即备份”按钮。 备份失败或最新快照早于两倍间隔时，设置图标会出现红点。

快照只包含数据库，而且和数据库在同一块磁盘上 —— 请自行把目录同步到服务器之外（rclone、restic、 Syncthing 等），并一并复制 /data/attachments。在 Docker 中，可绑定挂载一个宿主机路径并让 TM_BACKUP_DIR 指向它，方便同步工具读取。

恢复时：停止 API，用快照覆盖 tradermemos.db，删除旁边的 tradermemos.db-wal / tradermemos.db-shm，然后重新启动 API。

方式 1 —— 应用层导出（任何部署都适用）

应用内的导入 → 导出（或 GET /api/v1/exports）可生成：

在任意 TraderMemos 实例导入 ZIP / JSON 即可恢复 —— 全新安装时初始化向导的可选导入步骤 可以直接接收，之后任何时候也可通过导入页面完成。成交记录在服务端自动去重，重复导入 是安全的。

在主机之间迁移、切换数据库（SQLite ↔ Postgres），或想要一份真正能打开的异地副本时， 用这种方式最合适。

方式 2 —— 数据卷快照（Docker，完整拷贝）

SQLite 运行在 WAL 模式下，不要直接复制正在使用的数据库文件 —— 请先停止 API （仅几秒停机），否则可能丢失最近的写入：

cd TraderMemos
docker compose stop api
docker run --rm --volumes-from "$(docker compose ps -aq api)" -v "$PWD":/backup alpine \
  tar czf "/backup/tradermemos-$(date +%F).tar.gz" -C /data .
docker compose start api

在全新主机上恢复：

cd TraderMemos
make up                       # 创建容器与空数据卷
docker compose stop api
docker run --rm --volumes-from "$(docker compose ps -aq api)" -v "$PWD":/backup alpine \
  sh -c "rm -rf /data/* && tar xzf /backup/tradermemos-2026-08-01.tar.gz -C /data"
docker compose start api

可用 cron 自动化，并将压缩包同步到异地（rclone、restic 等）。数据卷中的 tradermemos.db.migrate.lock 是临时文件，可放心排除。

Postgres

导出数据库并复制附件数据卷：

docker compose exec postgres pg_dump -U tm tradermemos > tradermemos-$(date +%F).sql
# 附件仍在 tm_data 数据卷中 → 按方式 2 备份 /data/attachments

恢复时用 psql -U tm tradermemos < backup.sql 导入空数据库，再启动 API （迁移会自动对齐）。

每次升级前

升级版本前先做一次快照 —— schema 迁移在启动时自动执行，且不支持自动降级。参见 更新升级。