Appearance
PanBox Sync - 跨网盘同步自动转码系统 概览
PanBox Sync 是一个面向跨网盘同步、文件处理、自动转码和资源保活的自托管系统，适合把已有资源做进一步分发与治理，尽量减少屏蔽、失效和单盘波动带来的影响。
产品定位
Sync 在 PanBox 体系中承担资源处理与保活的角色，主要负责：
- 在不同网盘之间同步资源
- 执行下载、处理、上传等任务链路
- 降低单盘依赖、资源失效和分发波动带来的风险
如果你的问题已经不是“怎么找到资源”，而是“怎么让资源更稳、更久、更适合长期分发”，通常就需要 Sync。
适用场景
- 需要把资源同步到多个网盘，降低单点依赖
- 需要批量执行下载、处理、上传等任务
- 需要对已沉淀的资源做长期保活与整理
- 需要尽量减少频繁补链、反复换盘带来的维护成本
核心能力
PanBox Sync 的核心是流水线并发处理：
- 下载 → 处理（可选）→ 上传
- 三队列：
download/transcode/upload - 多 Worker 并发执行
- 通过 SSE 推送实时进度
它更适合作为后台任务系统长期运行，把“跨盘分发、自动转码、资源保活”做成稳定能力，而不是偶发性的手工操作工具。
关于“转码”说明
文档与实现中常把处理中间阶段称为“转码”，但实际效果可能只是轻量处理，例如：
- 追加随机字节
- 改变文件指纹 / MD5
这不等同于媒体重新编码（re-encode）。正式使用前，建议先在小范围验证兼容性与完整性。
Docker 部署关键点
- 镜像：
kokojacket/panbox-sync:latest - 后端端口：默认
8000（可通过.env调整） - 可选内置 OpenList 端口：
5244 - 数据目录：Compose 将
./data挂载到容器内/app/backend/data
与其他产品的关系
Search：负责搜索入口与结果展示Autosave：负责资源转存与沉淀Sync：负责跨网盘同步、处理、自动转码与保活
Sync 更偏资源治理层，通常在已有资源库存之后发挥作用，用来提升资源稳定性和长期分发能力。
截图
