WebDAV 设置备份恢复 — 换手机也能带走你的全部偏好

为什么需要备份

BiliPai 把所有数据存在手机本地 Room 数据库里：

倍速列表自定义
主题色和外观设置
插件配置（空降助手的跳过类型、弹幕增强的过滤关键词等）
播放历史和进度
视频笔记
收藏夹和稍后再看（这两项其实和 B 站服务器同步，不算本地数据）

换手机时这些数据就丢了。WebDAV 备份功能可以把它们导出到你自己的云存储上，新手机安装 BiliPai 后一键恢复。

WebDAV 是什么

WebDAV (Web Distributed Authoring and Versioning) 是一个基于 HTTP 的文件管理协议。通俗说就是"通过 HTTP 读写远程文件"。

很多云存储服务支持 WebDAV：

服务	是否支持 WebDAV	费用
坚果云	支持	免费版有每月上传流量限制
阿里云盘	支持	免费版有容量和流量限制
腾讯微云	部分支持	免费版有限制
OneDrive	通过额外设置支持	免费 5GB
自建服务器（Nextcloud、Synology NAS）	完整支持	免费（但自己要搭建）

配置 WebDAV

第一步：拿到 WebDAV 服务器信息

你需要准备：

服务器 URL：WebDAV 的访问地址（通常是 https://xxx.com/webdav/）
用户名：WebDAV 登录用户名
密码：WebDAV 登录密码

以坚果云为例

注册坚果云账号
登录网页版 → 设置 → 安全选项 → 添加应用 → 选择 "第三方应用密码"
记住应用密码（和登录密码不同，专门给 WebDAV 用的）
坚果云 WebDAV 地址格式：https://dav.jianguoyun.com/dav/你的邮箱/
用户名是你的坚果云邮箱，密码是刚才生成的应用密码

第二步：在 BiliPai 里填写

路径：设置 → 存储与数据 → WebDAV 备份 → 配置

依次填写：

服务器 URL
用户名
密码
点击 测试连接 → 如果返回"连接成功"就配置对了
选一个远程目录（比如 /BiliPai/backup/）

执行备份

配置好后：

设置 → 存储与数据 → WebDAV 备份 → 立即备份
BiliPai 打包当前所有设置和数据
上传到 WebDAV 服务器的指定目录
备份完成后在界面显示备份的文件名和时间

备份了什么

内容	备份
外观设置	是
播放设置（倍速列表、画质默认等）	是
插件配置	是
播放历史	可选
视频笔记	可选
登录 Cookie	默认不备份（出于安全考虑）

可以在 WebDAV 设置里选择哪些内容要备份。

恢复备份

在新手机上

安装 BiliPai → 进入 WebDAV 备份设置
填写相同的 WebDAV 服务器信息
点击恢复 → 显示远程目录里可用的备份列表
选一个备份 → 确认 → BiliPai 下载并导入
恢复完成后建议重启 BiliPai

恢复了什么

内容	恢复
外观设置	是（立即生效）
播放设置	是（立即生效）
插件配置	是（但前提是你安装了对应的插件）
播放历史	可选恢复
视频笔记	可选恢复

⚠️ 恢复登录 Cookie 是可选的，默认关闭。如果你选了备份 Cookie，恢复时也需要手动选择是否恢复。Cookie 从备份文件恢复可能触发 B 站的安全检测，建议恢复后立即检查登录状态。

自动备份

可以在 WebDAV 设置里开启自动备份：

每日 / 每周定时备份
手动触发时自动备份
App 启动时自动备份

自动备份会覆盖同位置的旧备份文件。想保留多个历史版本，手动选择不同目录或不同文件名。

备份安全

WebDAV 备份的安全性取决于：

WebDAV 服务器的安全性：用 HTTPS 连接，不要用 HTTP（明文传输）
WebDAV 密码的安全性：不要用和主账号相同的密码
备份文件的安全性：定期检查远程目录有没有被意外删除或篡改

BiliPai 不加密备份文件——它就是一个普通的 JSON 配置文件 + 一些文本文件。如果你特别在意安全，可以：