douban-backup 进阶技巧:如何备份他人账号、如何设置定时自动备份
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 个关键细节
- cookie 会过期:这是定时任务唯一会"卡住"的点。cookie 失效时程序会提示「未登录豆瓣,或登录已失效」(见 checkin 校验),此时重新登录浏览器即可恢复,无需改动任何配置。
- 请求间隔要留余量:定时任务多在夜间批量运行,建议加
--interval 2避免触发限流。 - 断点续备:即使中途中断,已抓取的数据也已落库(中断处理),下次运行自动补全。
常见问题速查
| 现象 | 原因 | 解决办法 |
|---|---|---|
| 提示「未登录豆瓣」 | 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 或任务计划程序,配合工具自带的增量备份与历史归档,你的书影音游剧标记就有了自动、持续、可追溯的保险。数据备份的本质是"平时不想起、用时一定在"——今晚就把定时任务加上吧。