Repository navigation
Releases
PigeonBox v6.6.0
PigeonBox v6.6.0 生态列车。本页即全生态二进制产物的统一出口——组件产物由各仓 CI 自动回挂(下方矩阵)。
| 组件 | 版本 | 产物 |
|---|---|---|
| server / frontend | v6.6.0 | ghcr.io/pigeonbox/server + frontend;Helm: helm repo add pigeonbox https://pigeonbox.github.io/charts |
| desktop | desktop-v6.6.0 | desktop-v* Windows/macOS/Linux 安装包(纯客户端;设备直传请用 PigeonBeam) |
| fnos | v6.6.0 | fnos-v* fpk 应用包 |
| openwrt | v6.6.0 | openwrt-v* ipk + apk |
| qnap | v6.6.0 | qnap-v* QPKG 原生应用包(免 Container Station) |
| p2p | v0.10.0 | p2p-v* p2pc 二进制;镜像 ghcr.io/pigeonbox/p2p;NAS 三端随带 v0.10.0 |
| synology | v6.6.0 | synology-v* 部署包 |
| ugreen | v6.6.0 | ugreen-v* 部署包 |
| terramaster | v6.6.0 | terramaster-v* 部署包 |
底层: core v0.47.0 · contracts v0.26.0 · frontend-core v0.22.0 · chart 6.6.0。全部源码仓: https://github.com/orgs/pigeonbox/repositories
⚠️ 破坏性变更(3.0.0 起)——设备直传已拆为独立应用 PigeonBeam(信鸽直传)
Box 侧不再编排设备直传。以下能力已退役,请改用 PigeonBeam 客户端:
| 退役项 | 表现 | 替代 |
|---|---|---|
| admin 直传端点 | /admin/p2p/status、/tasks、/tasks/:id/log、/send、/send/upload、/recv、/cancel、/tasks/:id/approve、/publish 共 9 个端点 404 |
在 PigeonBeam 客户端完成设备间直传 |
| admin 直传控制台 | 管理台「设备直传」页已移除,联邦面迁至「联邦」页 | 同上 |
| MCP 直传工具 | p2p_status / p2p_tasks / p2p_send / p2p_recv 消失(p2p_peers / p2p_invites / p2p_accept 保留) |
同上 |
pb CLI 直传子命令 |
pb p2p status/tasks/send/recv/cancel 报「未知 p2p 子命令」(peers/invites/accept/push 保留) |
同上 |
配置 p2p.direct 段 |
该段被忽略并已在启动日志中提示;只配了 p2p.direct.registry_url 的实例会失去在线名录,请改配到 p2p.federation.registry_url |
同上 |
| server 镜像 / desktop 客户端 | 不再随包 p2pc(server)与 p2pc sidecar(desktop) | NAS 三仓仍随带 PigeonBeam(入口为 /beam) |
跨站取件路由(取件码本柜未命中时自动到联网站点查找)不受影响,联邦面整体保留。
⚠️ 破坏性变更(4.0.0 起)——旧版本兼容层退役
3.x 期间为「旧客户端/旧后端/旧链接/旧字段/旧形态」保留的兼容分支、别名与兜底整轮移除。
大部分是自动迁移(启动期幂等执行,无需人工介入);标注「需检查」的两项请逐条核对。
| 退役项 | 表现 | 处理 |
|---|---|---|
file_codes.prefix / file_codes.suffix 两列 |
列被删除;管理端/用户端列表不再下发这两个字段 | 自动迁移(启动期 ALTER TABLE DROP COLUMN;全库恒空、无写入方) |
契约字段 UserShareItemData.prefix / UserFileItem.prefix+suffix |
响应体不再含这两个键;前端类型同步删除 | 自动(前后端同版本升级即可);自研客户端若读这两个字段请改用 file_name |
旧直传开关 download.presign_anonymous_enabled |
该键不再被读取 | 自动迁移(读配置时并入 download.presign_policy:false⇒authenticated,true⇒everyone);需检查:曾用该键关闭匿名直传的站点,请确认 presign_policy 取值符合预期 |
| 旧文件清单形态(「虚拟行 id=0」) | 取件页文件清单不再出现 id=0 的合成项 | 自动迁移(启动期回填 file_code_files 子行) |
file_path 列双语义(「目录 + UUID 文件名」/「完整相对路径」) |
统一为「完整相对路径」 | 自动迁移(启动期归一存量行);需检查:若有自研脚本按旧形态拼路径,请改按完整相对路径 |
存储磁盘历史双层布局(<root>/uploads/uploads/…) |
读路径不再回退到双层位置 | 自动迁移(启动期同盘 rename 上提一层,冲突跳过不覆盖);需检查:若有脚本直接读 data/uploads/uploads/,请改读 data/uploads/ |
前端视图层的成功码双写(code===0 || code===200) |
官方前端内部收敛为「只认 200」 | 对集成方无影响:接口成功码恒为 code: 0(errcode.CodeSuccess,2026-10-15 起已统一),200 只是官方前端请求层把 0 归一化后的内部值 —— 集成方请继续只认 0 |
不受影响:MCP 协议多版本握手、联邦 wire 的 N-1 双格式、p2p 配对码、跨节点取件路由、
PigeonBeam 拆分(3.0.0 起)与联邦面(全部保留)。
⚠️ 已知外部缺口
Docker Hub 未配置(DOCKERHUB_USERNAME/DOCKERHUB_TOKEN 缺失/未探测到)⇒ 镜像仅推 ghcr;terramaster#99 / ugreen#132 的镜像前置未解。
PigeonBox v6.5.0
PigeonBox v6.5.0 生态列车。本页即全生态二进制产物的统一出口——组件产物由各仓 CI 自动回挂(下方矩阵)。
| 组件 | 版本 | 产物 |
|---|---|---|
| server / frontend | v6.5.0 | ghcr.io/pigeonbox/server + frontend;Helm: helm repo add pigeonbox https://pigeonbox.github.io/charts |
| desktop | desktop-v6.5.0 | desktop-v* Windows/macOS/Linux 安装包(纯客户端;设备直传请用 PigeonBeam) |
| fnos | v6.5.0 | fnos-v* fpk 应用包 |
| openwrt | v6.5.0 | openwrt-v* ipk + apk |
| qnap | v6.5.0 | qnap-v* QPKG 原生应用包(免 Container Station) |
| p2p | v0.10.0 | p2p-v* p2pc 二进制;镜像 ghcr.io/pigeonbox/p2p;NAS 三端随带 v0.10.0 |
| synology | v6.5.0 | synology-v* 部署包 |
| ugreen | v6.5.0 | ugreen-v* 部署包 |
| terramaster | v6.5.0 | terramaster-v* 部署包 |
底层: core v0.46.0 · contracts v0.26.0 · frontend-core v0.22.0 · chart 6.5.0。全部源码仓: https://github.com/orgs/pigeonbox/repositories
⚠️ 破坏性变更(3.0.0 起)——设备直传已拆为独立应用 PigeonBeam(信鸽直传)
Box 侧不再编排设备直传。以下能力已退役,请改用 PigeonBeam 客户端:
| 退役项 | 表现 | 替代 |
|---|---|---|
| admin 直传端点 | /admin/p2p/status、/tasks、/tasks/:id/log、/send、/send/upload、/recv、/cancel、/tasks/:id/approve、/publish 共 9 个端点 404 |
在 PigeonBeam 客户端完成设备间直传 |
| admin 直传控制台 | 管理台「设备直传」页已移除,联邦面迁至「联邦」页 | 同上 |
| MCP 直传工具 | p2p_status / p2p_tasks / p2p_send / p2p_recv 消失(p2p_peers / p2p_invites / p2p_accept 保留) |
同上 |
pb CLI 直传子命令 |
pb p2p status/tasks/send/recv/cancel 报「未知 p2p 子命令」(peers/invites/accept/push 保留) |
同上 |
配置 p2p.direct 段 |
该段被忽略并已在启动日志中提示;只配了 p2p.direct.registry_url 的实例会失去在线名录,请改配到 p2p.federation.registry_url |
同上 |
| server 镜像 / desktop 客户端 | 不再随包 p2pc(server)与 p2pc sidecar(desktop) | NAS 三仓仍随带 PigeonBeam(入口为 /beam) |
跨站取件路由(取件码本柜未命中时自动到联网站点查找)不受影响,联邦面整体保留。
⚠️ 破坏性变更(4.0.0 起)——旧版本兼容层退役
3.x 期间为「旧客户端/旧后端/旧链接/旧字段/旧形态」保留的兼容分支、别名与兜底整轮移除。
大部分是自动迁移(启动期幂等执行,无需人工介入);标注「需检查」的两项请逐条核对。
| 退役项 | 表现 | 处理 |
|---|---|---|
file_codes.prefix / file_codes.suffix 两列 |
列被删除;管理端/用户端列表不再下发这两个字段 | 自动迁移(启动期 ALTER TABLE DROP COLUMN;全库恒空、无写入方) |
契约字段 UserShareItemData.prefix / UserFileItem.prefix+suffix |
响应体不再含这两个键;前端类型同步删除 | 自动(前后端同版本升级即可);自研客户端若读这两个字段请改用 file_name |
旧直传开关 download.presign_anonymous_enabled |
该键不再被读取 | 自动迁移(读配置时并入 download.presign_policy:false⇒authenticated,true⇒everyone);需检查:曾用该键关闭匿名直传的站点,请确认 presign_policy 取值符合预期 |
| 旧文件清单形态(「虚拟行 id=0」) | 取件页文件清单不再出现 id=0 的合成项 | 自动迁移(启动期回填 file_code_files 子行) |
file_path 列双语义(「目录 + UUID 文件名」/「完整相对路径」) |
统一为「完整相对路径」 | 自动迁移(启动期归一存量行);需检查:若有自研脚本按旧形态拼路径,请改按完整相对路径 |
存储磁盘历史双层布局(<root>/uploads/uploads/…) |
读路径不再回退到双层位置 | 自动迁移(启动期同盘 rename 上提一层,冲突跳过不覆盖);需检查:若有脚本直接读 data/uploads/uploads/,请改读 data/uploads/ |
前端视图层的成功码双写(code===0 || code===200) |
官方前端内部收敛为「只认 200」 | 对集成方无影响:接口成功码恒为 code: 0(errcode.CodeSuccess,2026-10-15 起已统一),200 只是官方前端请求层把 0 归一化后的内部值 —— 集成方请继续只认 0 |
不受影响:MCP 协议多版本握手、联邦 wire 的 N-1 双格式、p2p 配对码、跨节点取件路由、
PigeonBeam 拆分(3.0.0 起)与联邦面(全部保留)。
⚠️ 已知外部缺口
Docker Hub 未配置(DOCKERHUB_USERNAME/DOCKERHUB_TOKEN 缺失/未探测到)⇒ 镜像仅推 ghcr;terramaster#99 / ugreen#132 的镜像前置未解。
PigeonBox v6.4.0
PigeonBox v6.4.0 生态列车。本页即全生态二进制产物的统一出口——组件产物由各仓 CI 自动回挂(下方矩阵)。
| 组件 | 版本 | 产物 |
|---|---|---|
| server / frontend | v6.4.0 | ghcr.io/pigeonbox/server + frontend;Helm: helm repo add pigeonbox https://pigeonbox.github.io/charts |
| desktop | desktop-v6.4.0 | desktop-v* Windows/macOS/Linux 安装包(纯客户端;设备直传请用 PigeonBeam) |
| fnos | v6.4.0 | fnos-v* fpk 应用包 |
| openwrt | v6.4.0 | openwrt-v* ipk + apk |
| qnap | v6.4.0 | qnap-v* QPKG 原生应用包(免 Container Station) |
| p2p | v0.10.0 | p2p-v* p2pc 二进制;镜像 ghcr.io/pigeonbox/p2p;NAS 三端随带 v0.10.0 |
| synology | v6.4.0 | synology-v* 部署包 |
| ugreen | v6.4.0 | ugreen-v* 部署包 |
| terramaster | v6.4.0 | terramaster-v* 部署包 |
底层: core v0.45.0 · contracts v0.25.0 · frontend-core v0.21.0 · chart 6.4.0。全部源码仓: https://github.com/orgs/pigeonbox/repositories
⚠️ 破坏性变更(3.0.0 起)——设备直传已拆为独立应用 PigeonBeam(信鸽直传)
Box 侧不再编排设备直传。以下能力已退役,请改用 PigeonBeam 客户端:
| 退役项 | 表现 | 替代 |
|---|---|---|
| admin 直传端点 | /admin/p2p/status、/tasks、/tasks/:id/log、/send、/send/upload、/recv、/cancel、/tasks/:id/approve、/publish 共 9 个端点 404 |
在 PigeonBeam 客户端完成设备间直传 |
| admin 直传控制台 | 管理台「设备直传」页已移除,联邦面迁至「联邦」页 | 同上 |
| MCP 直传工具 | p2p_status / p2p_tasks / p2p_send / p2p_recv 消失(p2p_peers / p2p_invites / p2p_accept 保留) |
同上 |
pb CLI 直传子命令 |
pb p2p status/tasks/send/recv/cancel 报「未知 p2p 子命令」(peers/invites/accept/push 保留) |
同上 |
配置 p2p.direct 段 |
该段被忽略并已在启动日志中提示;只配了 p2p.direct.registry_url 的实例会失去在线名录,请改配到 p2p.federation.registry_url |
同上 |
| server 镜像 / desktop 客户端 | 不再随包 p2pc(server)与 p2pc sidecar(desktop) | NAS 三仓仍随带 PigeonBeam(入口为 /beam) |
跨站取件路由(取件码本柜未命中时自动到联网站点查找)不受影响,联邦面整体保留。
⚠️ 破坏性变更(4.0.0 起)——旧版本兼容层退役
3.x 期间为「旧客户端/旧后端/旧链接/旧字段/旧形态」保留的兼容分支、别名与兜底整轮移除。
大部分是自动迁移(启动期幂等执行,无需人工介入);标注「需检查」的两项请逐条核对。
| 退役项 | 表现 | 处理 |
|---|---|---|
file_codes.prefix / file_codes.suffix 两列 |
列被删除;管理端/用户端列表不再下发这两个字段 | 自动迁移(启动期 ALTER TABLE DROP COLUMN;全库恒空、无写入方) |
契约字段 UserShareItemData.prefix / UserFileItem.prefix+suffix |
响应体不再含这两个键;前端类型同步删除 | 自动(前后端同版本升级即可);自研客户端若读这两个字段请改用 file_name |
旧直传开关 download.presign_anonymous_enabled |
该键不再被读取 | 自动迁移(读配置时并入 download.presign_policy:false⇒authenticated,true⇒everyone);需检查:曾用该键关闭匿名直传的站点,请确认 presign_policy 取值符合预期 |
| 旧文件清单形态(「虚拟行 id=0」) | 取件页文件清单不再出现 id=0 的合成项 | 自动迁移(启动期回填 file_code_files 子行) |
file_path 列双语义(「目录 + UUID 文件名」/「完整相对路径」) |
统一为「完整相对路径」 | 自动迁移(启动期归一存量行);需检查:若有自研脚本按旧形态拼路径,请改按完整相对路径 |
存储磁盘历史双层布局(<root>/uploads/uploads/…) |
读路径不再回退到双层位置 | 自动迁移(启动期同盘 rename 上提一层,冲突跳过不覆盖);需检查:若有脚本直接读 data/uploads/uploads/,请改读 data/uploads/ |
前端视图层的成功码双写(code===0 || code===200) |
官方前端内部收敛为「只认 200」 | 对集成方无影响:接口成功码恒为 code: 0(errcode.CodeSuccess,2026-10-15 起已统一),200 只是官方前端请求层把 0 归一化后的内部值 —— 集成方请继续只认 0 |
不受影响:MCP 协议多版本握手、联邦 wire 的 N-1 双格式、p2p 配对码、跨节点取件路由、
PigeonBeam 拆分(3.0.0 起)与联邦面(全部保留)。
⚠️ 已知外部缺口
Docker Hub 未配置(DOCKERHUB_USERNAME/DOCKERHUB_TOKEN 缺失/未探测到)⇒ 镜像仅推 ghcr;terramaster#99 / ugreen#132 的镜像前置未解。
PigeonBox v6.3.0
PigeonBox v6.3.0 生态列车。本页即全生态二进制产物的统一出口——组件产物由各仓 CI 自动回挂(下方矩阵)。
| 组件 | 版本 | 产物 |
|---|---|---|
| server / frontend | v6.3.0 | ghcr.io/pigeonbox/server + frontend;Helm: helm repo add pigeonbox https://pigeonbox.github.io/charts |
| desktop | desktop-v6.3.0 | desktop-v* Windows/macOS/Linux 安装包(纯客户端;设备直传请用 PigeonBeam) |
| fnos | v6.3.0 | fnos-v* fpk 应用包 |
| openwrt | v6.3.0 | openwrt-v* ipk + apk |
| qnap | v6.3.0 | qnap-v* QPKG 原生应用包(免 Container Station) |
| p2p | v0.10.0 | p2p-v* p2pc 二进制;镜像 ghcr.io/pigeonbox/p2p;NAS 三端随带 v0.9.8 |
| synology | v6.3.0 | synology-v* 部署包 |
| ugreen | v6.3.0 | ugreen-v* 部署包 |
| terramaster | v6.3.0 | terramaster-v* 部署包 |
底层: core v0.44.0 · contracts v0.25.0 · frontend-core v0.21.0 · chart 6.3.0。全部源码仓: https://github.com/orgs/pigeonbox/repositories
⚠️ 破坏性变更(3.0.0 起)——设备直传已拆为独立应用 PigeonBeam(信鸽直传)
Box 侧不再编排设备直传。以下能力已退役,请改用 PigeonBeam 客户端:
| 退役项 | 表现 | 替代 |
|---|---|---|
| admin 直传端点 | /admin/p2p/status、/tasks、/tasks/:id/log、/send、/send/upload、/recv、/cancel、/tasks/:id/approve、/publish 共 9 个端点 404 |
在 PigeonBeam 客户端完成设备间直传 |
| admin 直传控制台 | 管理台「设备直传」页已移除,联邦面迁至「联邦」页 | 同上 |
| MCP 直传工具 | p2p_status / p2p_tasks / p2p_send / p2p_recv 消失(p2p_peers / p2p_invites / p2p_accept 保留) |
同上 |
pb CLI 直传子命令 |
pb p2p status/tasks/send/recv/cancel 报「未知 p2p 子命令」(peers/invites/accept/push 保留) |
同上 |
配置 p2p.direct 段 |
该段被忽略并已在启动日志中提示;只配了 p2p.direct.registry_url 的实例会失去在线名录,请改配到 p2p.federation.registry_url |
同上 |
| server 镜像 / desktop 客户端 | 不再随包 p2pc(server)与 p2pc sidecar(desktop) | NAS 三仓仍随带 PigeonBeam(入口为 /beam) |
跨站取件路由(取件码本柜未命中时自动到联网站点查找)不受影响,联邦面整体保留。
⚠️ 破坏性变更(4.0.0 起)——旧版本兼容层退役
3.x 期间为「旧客户端/旧后端/旧链接/旧字段/旧形态」保留的兼容分支、别名与兜底整轮移除。
大部分是自动迁移(启动期幂等执行,无需人工介入);标注「需检查」的两项请逐条核对。
| 退役项 | 表现 | 处理 |
|---|---|---|
file_codes.prefix / file_codes.suffix 两列 |
列被删除;管理端/用户端列表不再下发这两个字段 | 自动迁移(启动期 ALTER TABLE DROP COLUMN;全库恒空、无写入方) |
契约字段 UserShareItemData.prefix / UserFileItem.prefix+suffix |
响应体不再含这两个键;前端类型同步删除 | 自动(前后端同版本升级即可);自研客户端若读这两个字段请改用 file_name |
旧直传开关 download.presign_anonymous_enabled |
该键不再被读取 | 自动迁移(读配置时并入 download.presign_policy:false⇒authenticated,true⇒everyone);需检查:曾用该键关闭匿名直传的站点,请确认 presign_policy 取值符合预期 |
| 旧文件清单形态(「虚拟行 id=0」) | 取件页文件清单不再出现 id=0 的合成项 | 自动迁移(启动期回填 file_code_files 子行) |
file_path 列双语义(「目录 + UUID 文件名」/「完整相对路径」) |
统一为「完整相对路径」 | 自动迁移(启动期归一存量行);需检查:若有自研脚本按旧形态拼路径,请改按完整相对路径 |
存储磁盘历史双层布局(<root>/uploads/uploads/…) |
读路径不再回退到双层位置 | 自动迁移(启动期同盘 rename 上提一层,冲突跳过不覆盖);需检查:若有脚本直接读 data/uploads/uploads/,请改读 data/uploads/ |
前端视图层的成功码双写(code===0 || code===200) |
官方前端内部收敛为「只认 200」 | 对集成方无影响:接口成功码恒为 code: 0(errcode.CodeSuccess,2026-10-15 起已统一),200 只是官方前端请求层把 0 归一化后的内部值 —— 集成方请继续只认 0 |
不受影响:MCP 协议多版本握手、联邦 wire 的 N-1 双格式、p2p 配对码、跨节点取件路由、
PigeonBeam 拆分(3.0.0 起)与联邦面(全部保留)。
⚠️ 已知外部缺口
Docker Hub 未配置(DOCKERHUB_USERNAME/DOCKERHUB_TOKEN 缺失/未探测到)⇒ 镜像仅推 ghcr;terramaster#99 / ugreen#132 的镜像前置未解。
PigeonBox v6.2.0
PigeonBox v6.2.0 生态列车。本页即全生态二进制产物的统一出口——组件产物由各仓 CI 自动回挂(下方矩阵)。
| 组件 | 版本 | 产物 |
|---|---|---|
| server / frontend | v6.2.0 | ghcr.io/pigeonbox/server + frontend;Helm: helm repo add pigeonbox https://pigeonbox.github.io/charts |
| desktop | desktop-v6.2.0 | desktop-v* Windows/macOS/Linux 安装包(纯客户端;设备直传请用 PigeonBeam) |
| fnos | v6.2.0 | fnos-v* fpk 应用包 |
| openwrt | v6.2.0 | openwrt-v* ipk + apk |
| qnap | v6.2.0 | qnap-v* QPKG 原生应用包(免 Container Station) |
| p2p | v0.9.8 | p2p-v* p2pc 二进制;镜像 ghcr.io/pigeonbox/p2p;NAS 三端随带 v0.9.8 |
| synology | v6.2.0 | synology-v* 部署包 |
| ugreen | v6.2.0 | ugreen-v* 部署包 |
| terramaster | v6.2.0 | terramaster-v* 部署包 |
底层: core v0.43.0 · contracts v0.25.0 · frontend-core v0.21.0 · chart 6.2.0。全部源码仓: https://github.com/orgs/pigeonbox/repositories
⚠️ 破坏性变更(3.0.0 起)——设备直传已拆为独立应用 PigeonBeam(信鸽直传)
Box 侧不再编排设备直传。以下能力已退役,请改用 PigeonBeam 客户端:
| 退役项 | 表现 | 替代 |
|---|---|---|
| admin 直传端点 | /admin/p2p/status、/tasks、/tasks/:id/log、/send、/send/upload、/recv、/cancel、/tasks/:id/approve、/publish 共 9 个端点 404 |
在 PigeonBeam 客户端完成设备间直传 |
| admin 直传控制台 | 管理台「设备直传」页已移除,联邦面迁至「联邦」页 | 同上 |
| MCP 直传工具 | p2p_status / p2p_tasks / p2p_send / p2p_recv 消失(p2p_peers / p2p_invites / p2p_accept 保留) |
同上 |
pb CLI 直传子命令 |
pb p2p status/tasks/send/recv/cancel 报「未知 p2p 子命令」(peers/invites/accept/push 保留) |
同上 |
配置 p2p.direct 段 |
该段被忽略并已在启动日志中提示;只配了 p2p.direct.registry_url 的实例会失去在线名录,请改配到 p2p.federation.registry_url |
同上 |
| server 镜像 / desktop 客户端 | 不再随包 p2pc(server)与 p2pc sidecar(desktop) | NAS 三仓仍随带 PigeonBeam(入口为 /beam) |
跨站取件路由(取件码本柜未命中时自动到联网站点查找)不受影响,联邦面整体保留。
⚠️ 破坏性变更(4.0.0 起)——旧版本兼容层退役
3.x 期间为「旧客户端/旧后端/旧链接/旧字段/旧形态」保留的兼容分支、别名与兜底整轮移除。
大部分是自动迁移(启动期幂等执行,无需人工介入);标注「需检查」的两项请逐条核对。
| 退役项 | 表现 | 处理 |
|---|---|---|
file_codes.prefix / file_codes.suffix 两列 |
列被删除;管理端/用户端列表不再下发这两个字段 | 自动迁移(启动期 ALTER TABLE DROP COLUMN;全库恒空、无写入方) |
契约字段 UserShareItemData.prefix / UserFileItem.prefix+suffix |
响应体不再含这两个键;前端类型同步删除 | 自动(前后端同版本升级即可);自研客户端若读这两个字段请改用 file_name |
旧直传开关 download.presign_anonymous_enabled |
该键不再被读取 | 自动迁移(读配置时并入 download.presign_policy:false⇒authenticated,true⇒everyone);需检查:曾用该键关闭匿名直传的站点,请确认 presign_policy 取值符合预期 |
| 旧文件清单形态(「虚拟行 id=0」) | 取件页文件清单不再出现 id=0 的合成项 | 自动迁移(启动期回填 file_code_files 子行) |
file_path 列双语义(「目录 + UUID 文件名」/「完整相对路径」) |
统一为「完整相对路径」 | 自动迁移(启动期归一存量行);需检查:若有自研脚本按旧形态拼路径,请改按完整相对路径 |
存储磁盘历史双层布局(<root>/uploads/uploads/…) |
读路径不再回退到双层位置 | 自动迁移(启动期同盘 rename 上提一层,冲突跳过不覆盖);需检查:若有脚本直接读 data/uploads/uploads/,请改读 data/uploads/ |
前端视图层的成功码双写(code===0 || code===200) |
官方前端内部收敛为「只认 200」 | 对集成方无影响:接口成功码恒为 code: 0(errcode.CodeSuccess,2026-10-15 起已统一),200 只是官方前端请求层把 0 归一化后的内部值 —— 集成方请继续只认 0 |
不受影响:MCP 协议多版本握手、联邦 wire 的 N-1 双格式、p2p 配对码、跨节点取件路由、
PigeonBeam 拆分(3.0.0 起)与联邦面(全部保留)。
⚠️ 已知外部缺口
Docker Hub 未配置(DOCKERHUB_USERNAME/DOCKERHUB_TOKEN 缺失/未探测到)⇒ 镜像仅推 ghcr;terramaster#99 / ugreen#132 的镜像前置未解。
PigeonBox v6.1.0
PigeonBox v6.1.0 生态列车。本页即全生态二进制产物的统一出口——组件产物由各仓 CI 自动回挂(下方矩阵)。
| 组件 | 版本 | 产物 |
|---|---|---|
| server / frontend | v6.1.0 | ghcr.io/pigeonbox/server + frontend;Helm: helm repo add pigeonbox https://pigeonbox.github.io/charts |
| desktop | desktop-v6.1.0 | desktop-v* Windows/macOS/Linux 安装包(纯客户端;设备直传请用 PigeonBeam) |
| fnos | v6.1.0 | fnos-v* fpk 应用包 |
| openwrt | v6.1.0 | openwrt-v* ipk + apk |
| qnap | v6.1.0 | qnap-v* QPKG 原生应用包(免 Container Station) |
| p2p | v0.9.8 | p2p-v* p2pc 二进制;镜像 ghcr.io/pigeonbox/p2p;NAS 三端随带 v0.9.8 |
| synology | v6.1.0 | synology-v* 部署包 |
| ugreen | v6.1.0 | ugreen-v* 部署包 |
| terramaster | v6.1.0 | terramaster-v* 部署包 |
底层: core v0.42.0 · contracts v0.25.0 · frontend-core v0.20.0 · chart 6.1.0。全部源码仓: https://github.com/orgs/pigeonbox/repositories
⚠️ 破坏性变更(3.0.0 起)——设备直传已拆为独立应用 PigeonBeam(信鸽直传)
Box 侧不再编排设备直传。以下能力已退役,请改用 PigeonBeam 客户端:
| 退役项 | 表现 | 替代 |
|---|---|---|
| admin 直传端点 | /admin/p2p/status、/tasks、/tasks/:id/log、/send、/send/upload、/recv、/cancel、/tasks/:id/approve、/publish 共 9 个端点 404 |
在 PigeonBeam 客户端完成设备间直传 |
| admin 直传控制台 | 管理台「设备直传」页已移除,联邦面迁至「联邦」页 | 同上 |
| MCP 直传工具 | p2p_status / p2p_tasks / p2p_send / p2p_recv 消失(p2p_peers / p2p_invites / p2p_accept 保留) |
同上 |
pb CLI 直传子命令 |
pb p2p status/tasks/send/recv/cancel 报「未知 p2p 子命令」(peers/invites/accept/push 保留) |
同上 |
配置 p2p.direct 段 |
该段被忽略并已在启动日志中提示;只配了 p2p.direct.registry_url 的实例会失去在线名录,请改配到 p2p.federation.registry_url |
同上 |
| server 镜像 / desktop 客户端 | 不再随包 p2pc(server)与 p2pc sidecar(desktop) | NAS 三仓仍随带 PigeonBeam(入口为 /beam) |
跨站取件路由(取件码本柜未命中时自动到联网站点查找)不受影响,联邦面整体保留。
⚠️ 破坏性变更(4.0.0 起)——旧版本兼容层退役
3.x 期间为「旧客户端/旧后端/旧链接/旧字段/旧形态」保留的兼容分支、别名与兜底整轮移除。
大部分是自动迁移(启动期幂等执行,无需人工介入);标注「需检查」的两项请逐条核对。
| 退役项 | 表现 | 处理 |
|---|---|---|
file_codes.prefix / file_codes.suffix 两列 |
列被删除;管理端/用户端列表不再下发这两个字段 | 自动迁移(启动期 ALTER TABLE DROP COLUMN;全库恒空、无写入方) |
契约字段 UserShareItemData.prefix / UserFileItem.prefix+suffix |
响应体不再含这两个键;前端类型同步删除 | 自动(前后端同版本升级即可);自研客户端若读这两个字段请改用 file_name |
旧直传开关 download.presign_anonymous_enabled |
该键不再被读取 | 自动迁移(读配置时并入 download.presign_policy:false⇒authenticated,true⇒everyone);需检查:曾用该键关闭匿名直传的站点,请确认 presign_policy 取值符合预期 |
| 旧文件清单形态(「虚拟行 id=0」) | 取件页文件清单不再出现 id=0 的合成项 | 自动迁移(启动期回填 file_code_files 子行) |
file_path 列双语义(「目录 + UUID 文件名」/「完整相对路径」) |
统一为「完整相对路径」 | 自动迁移(启动期归一存量行);需检查:若有自研脚本按旧形态拼路径,请改按完整相对路径 |
存储磁盘历史双层布局(<root>/uploads/uploads/…) |
读路径不再回退到双层位置 | 自动迁移(启动期同盘 rename 上提一层,冲突跳过不覆盖);需检查:若有脚本直接读 data/uploads/uploads/,请改读 data/uploads/ |
前端视图层的成功码双写(code===0 || code===200) |
官方前端内部收敛为「只认 200」 | 对集成方无影响:接口成功码恒为 code: 0(errcode.CodeSuccess,2026-10-15 起已统一),200 只是官方前端请求层把 0 归一化后的内部值 —— 集成方请继续只认 0 |
不受影响:MCP 协议多版本握手、联邦 wire 的 N-1 双格式、p2p 配对码、跨节点取件路由、
PigeonBeam 拆分(3.0.0 起)与联邦面(全部保留)。
⚠️ 已知外部缺口
Docker Hub 未配置(DOCKERHUB_USERNAME/DOCKERHUB_TOKEN 缺失/未探测到)⇒ 镜像仅推 ghcr;terramaster#99 / ugreen#132 的镜像前置未解。
PigeonBox UGREEN UGOS Pro v6.6.0
绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。
🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.6.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox
PigeonBox UGREEN UGOS Pro v6.5.0
绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。
🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.5.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox
PigeonBox UGREEN UGOS Pro v6.4.0
绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。
🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.4.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox
PigeonBox UGREEN UGOS Pro v6.3.0
绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。
🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.3.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox