Skip to content

Releases

PigeonBox v6.6.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 23:04

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

Choose a tag to compare

@github-actions github-actions released this 17 Nov 22:21

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

Choose a tag to compare

@github-actions github-actions released this 17 Nov 21:05

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

Choose a tag to compare

@github-actions github-actions released this 17 Nov 19:43

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

Choose a tag to compare

@github-actions github-actions released this 17 Nov 18:09

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

Choose a tag to compare

@github-actions github-actions released this 17 Nov 01:22

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

Choose a tag to compare

@zy84338719 zy84338719 released this 17 Nov 23:02

绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。


🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.6.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox

PigeonBox UGREEN UGOS Pro v6.5.0

Choose a tag to compare

@zy84338719 zy84338719 released this 17 Nov 21:37

绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。


🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.5.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox

PigeonBox UGREEN UGOS Pro v6.4.0

Choose a tag to compare

@zy84338719 zy84338719 released this 17 Nov 21:03

绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。


🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.4.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox

PigeonBox UGREEN UGOS Pro v6.3.0

Choose a tag to compare

@zy84338719 zy84338719 released this 17 Nov 19:35

绿联 NAS(UGOS Pro)compose 一键部署包(见 Assets)。安装说明见 ugreen 仓 README。


🗂 组件仓库: pigeonbox/ugreen · 完整变更日志: v6.3.0
🌐 生态总览 / Latest: pigeonbox/pigeonbox