Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

1.6 KB
Raw Blame

ADR-0105:Linux 无桌面容器分发

  • 状态:已接受,容器与目标设备验收分别记录
  • 日期:2026-10-15

背景

单人 VPS 与 NAS 需要浏览器访问的服务,媒体由宿主机目录或 CloudDrive2 提供。桌面托盘承担配置重载和首次资料处理,单独启动 Web 进程无法消费这些请求。

决策

  • 在 Windows、macOS 桌面分发之外提供 Linux 无桌面容器,修订 ADR-0023 的平台范围。
  • 复用 FastAPI、CLI、Windows 形态账本路径与 POSIX 挂载映射,不建立第二套应用或数据库。
  • peach.server 只维护 Web 子进程、配置重载和用户发起的资料处理;调度与媒体任务仍由应用持有。
  • Docker 镜像、CloudDrive2 镜像独立,媒体通过挂载传播共享。Peach 不申请 FUSE 或特权权限。
  • 持久化数据与媒体独立于镜像。已有账本不由入口自动迁移,缺配置时拒绝初始化。
  • Docker Hub 使用 longmeidao/peach,先验收再上传;初始目标为 amd64,ARM 通过实际验收后再纳入。
  • 安全模型仍为单人私有访问,容器端口默认只绑定宿主机回环。
  • 无桌面入口使用标准库地址分类,允许经过鉴权的回环与私有网络客户端管理配置,拒绝公网、链路本地、保留地址与带转发头的管理请求;桌面的本机管理边界保持独立。

验收边界

镜像验收覆盖锁定依赖、非 root 运行、全新临时卷、鉴权、配置重载、重启与数据持久化。网盘账号、FUSE、NAS 权限、真实播放与公网访问属于目标部署验收,未运行时不得宣称通过。