douban-backup 进阶技巧:如何备份他人账号、如何设置定时自动备份

原创2026-10-31 15:43:511,918 阅读

douban-backup 进阶技巧:如何备份他人账号、如何设置定时自动备份

douban-backup 是一款零配置的命令行豆瓣备份工具,一个 Python 单文件脚本即可把账号的书、电影、音乐、游戏、剧集标记(想看 / 在看 / 看过)完整备份到 SQLite,并导出为结构化的 Excel 文件。本文教你两个进阶玩法:备份他人豆瓣账号的标记数据,以及设置定时自动备份,让备份从此一劳永逸。

项目文件:douban_backup.py、说明文档:README.md、许可证:LICENSE

准备工作:获取 douban-backup 项目

开始前先克隆仓库并确认能跑通一次基础备份(需已安装 uv,且浏览器已登录豆瓣):

git clone https://gitcode.com/gh_mirrors/dou/douban-backup
cd douban-backup
uv run douban_backup.py

运行成功后会生成两个文件:douban_backup.db(SQLite 原始数据)和 douban_interests.xlsx(导出的 Excel)。

💡 两种进阶技巧都建立在"基础备份能跑通"之上,建议先手动执行一次并观察输出的进度条。

进阶技巧一:如何备份他人豆瓣账号

默认情况下,工具备份的是当前登录账号的标记。想备份别人(比如朋友、或你早年注册的旧账号),核心是 --user 参数,传入对方的豆瓣数字 ID 即可。

第一步:找到对方的数字 ID

用浏览器打开目标用户的豆瓣主页,地址栏 URL 形如:

https://www.douban.com/people/用户名/12345678/

斜杠后面的 12345678 就是数字 ID。注意:主页 URL 里没有这段数字的公开主页,需通过其个人主页详情页获取。

第二步:执行他人账号备份

# 备份他人账号(需对方数字 ID)
uv run douban_backup.py --user 12345678

# 建议指定独立输出文件,避免覆盖自己的备份
uv run douban_backup.py --user 12345678 -o 朋友标记.xlsx

# 标记量大时放慢请求间隔,避免触发限流
uv run douban_backup.py --user 12345678 --interval 2

执行时命令行会显示登录账号与备份目标,例如:

登录账号:我自己(备份目标:12345678)

📌 参数细节:--user 在 douban_backup.py 中定义,最终在 main 函数 里决定"抓谁的接口"。认证仍然来自你自己登录浏览器的 cookie——你只能备份你的登录态下有权访问的公开数据。

使用建议与边界

  • ⚖️ 仅用于备份你自己的或你有权访问的公开数据,请遵守豆瓣使用条款;
  • 他人的数据存在同一个 douban_backup.db 中(以 user_id 区分),可用 --db 指定独立数据库文件隔离存放:
uv run douban_backup.py --user 12345678 --db friend.db -o friend.xlsx
  • 他人标记量通常较大,建议配合 --interval 2 降低被限流(429)的概率。

进阶技巧二:如何设置定时自动备份

douban-backup 内置增量备份机制:每次运行以时间戳为版本号,仅当某条目的状态 / 短评 / 评分 / 标签发生变化时才更新,旧版本自动归档到 history 字段(逻辑见 Storage.put_interest)。这意味着可以无脑反复运行,不会产生冗余数据——这正是定时备份可行的基础。

推荐策略:每天只写数据库(--no-export),每周导出一次 Excel。

Linux / macOS:一行 cron 搞定

执行 crontab -e,添加以下两行:

# 每天凌晨 3 点增量备份(只写数据库,不导出)
0 3 * * * cd /你的路径/douban-backup && uv run douban_backup.py --no-export

# 每周日晚 10 点导出一份 Excel
0 22 * * 0 cd /你的路径/douban-backup && uv run douban_backup.py --export-only -o 豆瓣标记_本周.xlsx
  • --no-export:只备份到数据库,不生成文件,见 参数定义;
  • --export-only:仅从已有数据库重新导出,不发起任何抓取,适合随时"补一份 Excel"。

Windows:任务计划程序定时备份

打开"任务计划程序"→ 创建基本任务,或直接用命令创建(每周一凌晨 3 点执行):

schtasks /Create /SC WEEKLY /D MON /ST 03:00 /TN "DoubanBackup" /TR "cd /d D:\douban-backup && uv run douban_backup.py --no-export"

定时备份的 3 个关键细节

  1. cookie 会过期:这是定时任务唯一会"卡住"的点。cookie 失效时程序会提示「未登录豆瓣,或登录已失效」(见 checkin 校验),此时重新登录浏览器即可恢复,无需改动任何配置。
  2. 请求间隔要留余量:定时任务多在夜间批量运行,建议加 --interval 2 避免触发限流。
  3. 断点续备:即使中途中断,已抓取的数据也已落库(中断处理),下次运行自动补全。

常见问题速查

现象 原因 解决办法
提示「未登录豆瓣」 cookie 过期 浏览器重新登录豆瓣,再运行一次
HTTP 429 / 封禁 请求过快被限流 调大 --interval,如 --interval 3
500 错误 豆瓣接口偶发故障 工具会自动退化为逐条抓取,无需处理
导出的 Excel 打开是空表 数据库尚无该账号数据 先运行一次不带 --export-only 的备份

全部命令参数一览

完整参数表见 README.md,核心速记如下:

参数 作用
--user ID 备份指定用户(数字 ID),默认当前登录账号
--db PATH 指定 SQLite 数据库路径(默认 douban_backup.db)
-o, --output 导出路径,支持 .xlsx 或 .csv
--interval SEC 请求间隔秒数,默认 1.0
--no-export 只备份到数据库,不导出文件
--export-only 仅从已有数据库导出,不抓取
--browser / --cookie 指定 cookie 来源浏览器或手动提供 cookie

写在最后

掌握 --user 与 --interval,你就能安全地备份多个豆瓣账号;再配上 cron 或任务计划程序,配合工具自带的增量备份与历史归档,你的书影音游剧标记就有了自动、持续、可追溯的保险。数据备份的本质是"平时不想起、用时一定在"——今晚就把定时任务加上吧。

登录后查看全文
douban-backup