Skip to content

v2.1.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 24 Jun 03:25
· 59 commits to main since this release
v2.1.1
d4a2311

BaiduPCS-Rust v2.1.1 发行说明

发布日期：2026-06-24

🎯 版本说明

v2.1.1 是在 v2.1.0（分享同步）基础上的维护版本，内容以优化与 Bug 修复为主：修复扫码登录在确认环节失败时被降级成假「临时用户」、系统设置页导航把顶部保存栏顶出可视区，并完善了分享同步的稳定性（手动触发、调度器、下载等待、历史数据归属），同时新增分享同步的运行明细分页与下载停滞自动重试两项增强。

  • 登录修复：扫码登录确认失败不再伪造 uid=0「临时用户」，避免假登录导致后续网盘 API 全部 errno=-6
  • 界面修复：系统设置左侧导航点击不再把顶部「保存设置」栏顶出可视区
  • 分享同步·稳定性：手动触发返回真实 run_id（不再假成功）、调度器不再静默吞错、下载等待改「空闲超时 + 硬上限」、owner_uid=0 历史数据启动期迁移
  • 分享同步·增强：运行明细分页接口（大 run 不再截断到 100 条）、下载停滞自动重试（pause→冷却→resume）

✅ 平滑升级：本版本不涉及任何不兼容的数据迁移，从 v2.1.0 升级无感知。仍建议升级前按惯例备份数据目录（见下方「升级说明」）。

🐛 登录与界面修复

  • 扫码登录·不再伪造临时用户：扫码登录在「确认环节」失败或拿不到真实 uid 时，过去会被降级成 uid=0、用户名「临时用户」的假「成功」，导致前端显示已登录、但实际会话不完整，调用任意网盘 API 都返回 errno=-6。现改为如实返回失败并提示重新扫码；同时增加 uid=0 守卫，杜绝假登录账号落库。
  • 系统设置·导航不再顶出保存栏：点击左侧锚点导航（如「下载」）时改为只滚动内容容器，不再连带滚动外层把顶部「保存设置」栏顶出可视区。

✨ 分享同步·稳定性与增强

感谢 @hamr-hub 贡献的分享同步后端修复与增强（PR #111）。

稳定性修复（来自 @hamr-hub PR #111）：

  • 手动触发：触发前做前置校验并返回真实 run_id，不再「假成功」；前端可凭 run_id 立即定位本次运行。
  • 调度器不吞错：定时 on_tick 改为返回 Result，失败落 warn 日志便于排查，不再静默丢弃错误。
  • 下载等待：等待逻辑改为「空闲超时 + 硬上限」双闸——空闲超时按「有无进展」判定（避免大文件下到一半被误杀），硬上限兜底；文件夹聚合速度改用「活跃下载状态」判断，修复进行中速度恒显示 0。
  • 历史数据归属：启动期对 owner_uid=0 的历史脏数据按当前活跃账号迁移归属。

功能增强（来自 @hamr-hub PR #111）：

  • 运行明细分页：新增 GET /share-sync/runs/:id/items 分页接口（count + 分页查询），前端运行详情弹窗接入分页，避免大 run 明细被截断到 100 条。
  • 下载停滞自动重试：检测到下载长时间无进展时，自动 pause →冷却→ resume 重启该下载（限次数 + 冷却，可经环境变量调参），减少卡死需人工干预的情况。

下游补充修复：

  • 修复为「立即返回 run_id」预建 run 的设计所引入的孤儿 run——并发去重命中、链接失效、账号未就绪等早退路径在绑定 run_id 前返回、未收尾，导致 run 永久卡 running；现各早退路径均收尾为失败。
  • 修复 resume_link_invalid 的状态不一致——恢复链接失效后「立即触发一次」失败时不再影响恢复接口返回（降级为只记日志）。

🔧 工程 / CI

  • 统一 Rust 工具链版本为 1.87（本地 / Docker / CI 一致）。
  • 增加 Conventional Commits 校验（PR 标题 + 逐 commit）。

🔧 升级说明

Docker 用户

# 升级前建议先备份挂载的 data 卷

# 拉取指定版本镜像
docker pull komorebicarry/baidupcs-rust:v2.1.1

# 或使用 latest 标签
docker pull komorebicarry/baidupcs-rust:latest

# 重启容器
docker-compose down && docker-compose up -d

二进制用户

从 Releases 页面下载对应平台的二进制文件，替换原有可执行文件后重启服务。

配置与数据

  • 本版本无破坏性数据迁移，从 v2.1.0 升级无需任何手动操作。
  • 升级仍建议按惯例备份 backend/config/ 与 backend/wal/（Docker 用户备份挂载的 data 卷）。
  • 默认端口仍为 18888，不影响现有反向代理 / 防火墙 / 书签。

📁 下载

平台 文件名
Windows (x86_64) BaiduPCS-Rust-v2.1.1-windows-x86_64.zip
Linux (x86_64) BaiduPCS-Rust-v2.1.1-linux-x86_64.tar.gz
Linux (ARM64) BaiduPCS-Rust-v2.1.1-linux-aarch64.tar.gz
macOS (x86_64) BaiduPCS-Rust-v2.1.1-macos-x86_64.tar.gz
macOS (ARM64) BaiduPCS-Rust-v2.1.1-macos-aarch64.tar.gz
Docker 镜像 BaiduPCS-Rust-v2.1.1-docker.tar.gz

完整更新日志：参见项目根目录的 CHANGELOG.md
问题反馈：欢迎通过 GitHub Issues 进行反馈

Contributors

hamr-hub
Assets 9
Loading