douban-backup 快速上手:5 分钟零配置导出豆瓣书影音 Excel

原创2026-10-31 09:18:011,730 阅读

douban-backup 快速上手:5 分钟零配置导出豆瓣书影音 Excel

douban-backup 是一个命令行豆瓣备份工具:一条命令即可把你在豆瓣的电影 / 音乐 / 图书 / 游戏 / 剧集标记(想看 · 在看 · 看过)全部抓下来,存进 SQLite,并导出为一份 14 个 sheet、结构规范的 Excel 工作簿(douban_interests.xlsx)。整个项目只有一个 Python 脚本 douban_backup.py,uv run 直跑、零配置,适合想给自己的豆瓣账号做数据备份、又讨厌复杂部署的新手。

🎯 为什么需要豆瓣账号备份?

你的豆瓣标记数据散落在网页里,随时可能:

  • 换设备、换账号后无法批量查看;
  • 想统计"今年读了多少书、评了几星"却没有结构化数据;
  • 豆瓣服务策略变化导致数据无法迁移。

douban-backup 把这一切变成可反复运行、可增量更新的本地数据库 + Excel 文件,数据真正握在自己手里。

✅ 准备工作:只需要 2 件事

准备项 说明
安装 uv 快速 Python 包管理器,macOS 执行 brew install uv 即可
已登录豆瓣 在 Chrome / Edge / Brave / Firefox / Safari 任一浏览器中登录 douban.com

uv 会自动安装脚本所需的全部依赖(requests、beautifulsoup4、lxml、openpyxl 等),不需要你手动 pip install。

拿到代码(仓库地址:git clone https://gitcode.com/gh_mirrors/dou/douban-backup),进入目录即可开始。

🚀 一键运行:1 条命令完成备份

uv run douban_backup.py

就这一条命令。脚本会:

  1. 自动从浏览器读取豆瓣登录 cookie(默认依次尝试已安装的浏览器);
  2. 抓取当前账号全部 5 类 × 3 状态的标记数据;
  3. 写入本地 SQLite 数据库 douban_backup.db;
  4. 导出 douban_interests.xlsx 到当前目录。

💡 不想用 uv?也可以 pip install requests beautifulsoup4 lxml browser_cookie3 openpyxl 后直接 python douban_backup.py。

macOS 用户首次读取 Chrome cookie 时系统会弹钥匙串授权框,点「始终允许」即可。

🔐 Cookie 配置:3 种方式任选

Cookie 是读取豆瓣数据的关键,脚本支持 3 种提供方式(详见 README.md):

方式 命令
自动读浏览器(默认,推荐) uv run douban_backup.py
指定浏览器 uv run douban_backup.py --browser chrome
手动粘贴 cookie 串 uv run douban_backup.py --cookie 'ck=xxx; dbcl2="123:abc"; bid=yyy'

手动获取 cookie 的方法:浏览器打开 douban.com → F12 打开开发者工具 → Network → 点任意请求 → 复制请求头里的 Cookie 整串。

📊 导出的 Excel 长什么样?

导出格式与 Chrome 扩展「豆伴」的结构完全一致,方便无缝迁移。工作簿固定包含 14 个 sheet,按"类型 / 状态"拆分并中文命名(定义见 douban_backup.py):

  • 电影:看过 / 在看 / 想看
  • 音乐:听过 / 在听 / 想听
  • 图书:读过 / 在读 / 想读
  • 游戏:玩过 / 在玩 / 想玩
  • 剧集:看过的舞台剧 / 想看的舞台剧(剧集无「在看」)

每个 sheet 有统一的 9 列固定表头(douban_backup.py):

标题 / 简介 / 豆瓣评分 / 链接 / 创建时间 / 我的评分 / 标签 / 评论 / 可见性

sheet 内按标记 id 倒序排列,打开即可浏览,也方便在 Excel 里筛选、透视分析。

🛠️ 常用参数速查

参数 作用
--user ID 备份指定用户的数字 ID(默认当前登录账号)
-o, --output 指定导出路径,支持 .xlsx 或 .csv
--interval 请求间隔秒数(默认 1.0,遇 429 可调大)
--no-export 只备份到数据库,不导出文件
--export-only 仅从已有数据库重新导出,不抓取
-v, --verbose 输出调试日志

实用示例:

# 只重新导出,不再抓取(最快)
uv run douban_backup.py --export-only -o 我的标记.xlsx

# 备份别人的公开数据(需对方数字 ID)
uv run douban_backup.py --user 12345678

# 放慢请求速度,避免被限流
uv run douban_backup.py --interval 2

🔁 增量备份:放心反复运行

每次运行以时间戳为版本号,只有当某条目的状态 / 短评 / 评分 / 标签发生变化时才会更新数据库(增量逻辑见 douban_backup.py),旧版本归档到 history 字段形成历史轨迹,完全相同的重复标记不会产生冗余数据。也就是说:今天备份一次,下个月再备份一次,变化清晰可追溯,而且不会越跑越大。

⚠️ 注意事项

  • 默认请求间隔 1 秒;如遇 429 / 限流,请调大 --interval;
  • cookie 会过期,出现"未登录"提示时重新获取即可;
  • 已删除的豆瓣标记无法通过备份恢复;
  • 请仅用于备份自己的或你有权访问的公开数据,遵守豆瓣使用条款。

📁 项目文件一览

文件 说明
douban_backup.py 核心脚本:客户端、SQLite 存储、抓取与导出全部在这一个文件里
README.md 完整文档:特性、参数、导出格式说明
LICENSE MIT 开源协议

5 分钟,一条命令,你的豆瓣书影音标记就有了自己的"离线档案"。建议把 uv run douban_backup.py 加进定期习惯,数据备份这件事,早做一次早安心。

<输出文章结束>

登录后查看全文
douban-backup