WeiBack-rs 📥

WeiBack-rs 是一个使用Rust🦀开发的开源软件，它可以帮助你备份自己在微博上的数据。

注意：本项目仅为技术学习和交流，请在遵守当地相关法律法规的前提下使用本项目

---

特点 💡

亮色界面	暗色界面

• 支持备份微博收藏到本地
• 支持备份PC网页端无法查看的微博
• 下载图片清晰度可选
• 可随时将本地微博数据导出为HTML
• 导出的 HTML 页面外观与 Weibo 原生界面接近，阅读体验良好
• 支持把已经备份的博文在微博平台上取消收藏
• 亮/暗主题，Windows下跟随系统

安装 💻

下载预编译可执行文件

从Releases下载最新版本对应平台的预编译文件压缩包，解压即可。

从源码编译

• 克隆或下载本项目到本地
• 在项目根目录下运行 cargo build --release 命令，编译生成可执行文件
• 在生成的可执行文件同目录下新建 res 文件夹
• 将模板 templates/ 文件夹复制到新建的可执行文件 weiback-rs 同目录下。即，weiback-rs 可执行文件需要访问到同目录下 templates/*.html 模板文件。

注意

提供 MacOS 平台的可执行文件下载，但因本人不使用 MacOS，所以不负责解决 MacOS 上平台相关的Bug。

---

使用 📜

准备工作

注意：若已经使用过本工具，可能需要进行一些准备工作，首次使用请忽略

• res 文件夹的 weiback.db 为数据库文件，保存有备份的所有数据。
• 如果需要在新版本中使用该数据库文件，直接将其移动到新版本的 res 文件夹下。
• 有可能需要对数据库文件进行升级才能在新版本下使用，目前需要升级的版本有：
  • 2023-12-30 v0.1.6
  • 2024-01-09 v0.2.0
• 请使用一同提供的 db-upgrade-tool 工具进行升级：在 weiback-rs 同目录下执行，查看日志文件判断是否成功。

登录

• 首次使用需要登录，启动后点击登录开始登录流程。
• 手机扫描二维码并确认。

备份收藏

• 主界面进入备份收藏栏。
• 可同时下载微博图片，图片清晰度可选。
• 默认下载全部收藏。
• 高级设置可设置下载范围。
• 点击“开始”按钮开始任务，原始数据将下载到本地。

备份用户

• 主界面进入 备份用户 栏。
• 同样可以设置是否同时下载图片，以及图片清晰度。
• 输入用户 id，这是一串十位的数字。用户id的获取方法：点进对方主页，对方主页地址后缀即为id，如 https://weibo.com/u/1111681197 中 1111681197 为需要输入的id。
• 输入后鼠标停在输入框可显示用户名和头像。
• 点击“开始”按钮开始任务，原始数据将下载到本地。

注意 由于 weibo 的限制，对用户微博的备份有数量有限（一千到两千条之间，不太确定）。同时可能有部分微博会备份失败，失败的情况可以在日志中查看。后续会加强这部分功能。

本地导出

• 主界面进入本地导出栏。
• 点击开始导出数据库中全部收藏。
• 若下载时未同时下载图片，导出时会自动下载图片。
• 选中按时间逆序，导出后的HTML中，最新的微博将出现在最上方。
• 点击开始按钮，开始对本地微博进行导出，导出格式目前支持HTML。
• 点击对本地微博取消收藏将取消收藏所有本地微博。注意：该操作不可逆，谨慎操作。后续将实现取消范围自由指定的功能。
• 高级选项，导出范围可设置。
• 考虑到数千数万条收藏导出到单一HTML文件带来阅读不便，默认导出每个HTML文件包含50条博文。高级选项中可设置。 目前界面操作还比较凌乱，后续将进行优化

其它技巧

• HTML导出使用了 tera，如果不满意目前的 HTML 样式，可以根据 DOC 自行修改 templates/posts.html 文件。
• 备份的所有数据都保存在 res/weiback.db sqlite3 数据库文件里。目前包含四个表 posts、users、picture和picture_blob，分别是博文数据、用户数据、图片信息以及图片内容数据。在 weiback 的导出、浏览和搜索功能还不完善或未实现的现在，完全可以使用数据库工具直接查看、搜索所备份的内容。

面向数据库纯新手的简单入门教程：

1. Windows 用户可以免费在 Windows 应用商店安装 DBeaver CE 数据库管理软件，Linux 或 Mac 用户可以自行用包管理器安装 sqlite3，以下教程皆以 DBeaver 为例，Linux/Mac 用户自行搜索 sqlite3 使用方法。
2. 安装 Dbeaver 并打开，在左上角选择新建数据库连接，然后在弹出界面指定 weiback.db 的路径：
3. 左侧可以看到一些表，表里便存储有你备份的全部数据，双击打开，选到上方 data 页，便可以看到你的全部数据了：
4. 还可以使用 SQL 语句指定你想查看的数据，如 SELECT id, text_raw FROM posts WHERE text_raw LIKE '%西北旺%'; 可以看到包含"西北旺"的所有微博；比如你还限制一下用户可以这样 SELECT id, text_raw FROM posts WHERE text_raw LIKE '%在西北旺，美团的“美食榜单%' LIMIT 1 AND uid = 10101010;；或者，你觉得这个查询需要把整个 db 文件遍历一遍，太慢了，而你只需要其中的一条 SELECT id, text_raw FROM posts WHERE text_raw LIKE '%在西北旺，美团的“美食榜单%' LIMIT 1 LIMIT 1;。要使用语句只需要在上方新建一个 SQL 脚本，输入你需要的语句，然后 Ctrl+Enter 即可执行： 更多 SQL 使用方法请自行搜索学习，此举是为了方便 weiback-rs 未完全开发时想看看自己备份内容的用户。

---

开发计划 📅

• 微博元数据下载
• 微博附带图片提取并下载
• 数据库保存
• HTML格式导出
• 图形界面
• 取消收藏
• 二维码登录
• 部分微博仅能在客户端查看，备份这部分博文
• 备份指定用户博文
• 备份自己的博文
• 对备份失败的微博进行重试或丢弃
• 界面展示微博
• 对已经删除或无权限的微博进行过滤
• 本地微博搜索、过滤功能
• 指定微博取消收藏
• ...

---

其它 🐵

WeiBack 的油猴脚本版本 WeiBack，也可在 Greasyfork 下载安装。功能相比本软件较弱，仅能导出，无法保存到本地数据库。但会比较方便，适合数据不多的用户临时使用。

---

FAQ ❓

• 为什么备份速度这么慢？
  • 因为过快的接口请求频率会增加微博官方的负载，可能增加被 ban 甚至是法律风险。因此在请求之间增加了合理的等待时间，以模拟正常的微博访问。建议备份开始后放一边做其它事。
• 为什么下载的微博有遗漏？
  • 可能是因为你在备份期间添加加或删除了收藏，导致微博返回的数据错位了。建议备份时不要在微博上进行添加或删除。
• 为什么微博显示收藏很多，但全部下载后发现没有那么多？
  • 可能原因是：博主设置了自己的微博仅半年可见，半年后就无法浏览；微博被发布者删除；因不可抗原因被平台删除等。这些微博甚至不会在网页端显示。所以会发现备份的微博数量少了很多。可以下载微博官方客户端对这些微博收藏进行集中清理。清理过程中会发现除了已经无法查看的微博，还有正常的微博没有被备份，这决不是本软件的问题喵，本软件只是忠实地收录微博返回的数据，这一定是微博返回数据的遗漏......多次进行备份->对已备份的取消收藏->对无法查看的手动取消收藏便可以解决问题。

问题排查 🐞

• 首先确保 weiback-rs（Linux平台）或weiback-rs.exe（Windows平台）可执行文件同目录下存在 templates 文件夹。该文件夹内保存有 templates 模板文件夹。
• 查看 weiback.log 日志文件排查错误。
• 通过邮箱联系我，或提交 Issue。

---

贡献 🤝

欢迎其他开发者参与贡献，可以通过以下方式：

• 提交 issue 报告问题或建议
• 提交 pull request 提交代码或文档

开源协议 📝

本项目使用 Apache 2.0 License 开源协议。

联系方式 📧

如果你有任何问题或反馈，可以通过以下方式联系我：

• 邮箱：[email protected]