Skip to content

armgit / peach

Public Imported from GitHub
0

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

docs(docker): 说明无托盘诊断导出入口

longmeidao6d256e2271a6
diff --git a/docs/DIAGNOSTICS.md b/docs/DIAGNOSTICS.md
index b75761148..e9bca07cd 100644
--- a/docs/DIAGNOSTICS.md
+++ b/docs/DIAGNOSTICS.md
@@ -6,7 +6,7 @@
## 反馈入口
-馆藏处理失败时,重试失败项,再从托盘「导出诊断报告」或系统诊断页「下载诊断报告」取得 ZIP。用户只需提供一个 ZIP。下载限运行 Peach 的本机,已登录的同源设备可以上报浏览器错误;开放访问模式不提供匿名远程上报。
+馆藏处理失败时,重试失败项,再从托盘「导出诊断报告」或系统诊断页「下载诊断报告」取得 ZIP。用户只需提供一个 ZIP。桌面部署下载限运行 Peach 的本机;Docker 部署允许已登录的私有网络客户端下载,拒绝代理转发。网页不可用时,可按 [Docker 诊断导出](DOCKER.md#导出诊断报告) 在容器内生成 ZIP。已登录的同源设备可以上报浏览器错误;开放访问模式不提供匿名远程上报。
错误发生时必须实际记录底层证据。完整问题清单位于 `state/library-processing-<job_id>.issues.jsonl`。通用问题清单不能还原被丢弃的 FFmpeg 错误;没有原始记录的历史失败需要重试取证。
diff --git a/docs/DOCKER.md b/docs/DOCKER.md
index d5ec10dc9..78d0a9c04 100644
--- a/docs/DOCKER.md
+++ b/docs/DOCKER.md
@@ -103,6 +103,24 @@ VAAPI 尝试顺序为硬件解码加 `scale_vaapi` / `h264_vaapi`、软件解码
`/app/amane-runtime` 同时包含 GPL-3.0 许可证、来源说明和 `amane-corresponding-source.zip`;归档包含固定 revision 的完整 amane 源码、Peach 桥、锁文件、构建入口,以及 zhconv 和 certifi 的固定源码。依赖许可证保留在独立环境内。
+## 导出诊断报告
+
+Docker 部署使用网页「Peach 配置 → 系统诊断 → 下载诊断报告」,无需桌面托盘。已登录的私有网络客户端可以下载;通过反向代理或公网访问时,改用容器内导出。
+
+网页不可用时,在 Compose 文件所在目录执行下面的命令,在正在运行的 `peach` 服务容器中生成脱敏 ZIP。目标文件已存在会拒绝覆盖;再次导出时同时更换两条命令中的文件名。
+
+```text
+docker compose exec peach python -m peach.support_bundle /tmp/peach-support.zip
+```
+
+将 ZIP 复制到当前目录:
+
+```text
+docker compose cp peach:/tmp/peach-support.zip ./peach-support.zip
+```
+
+报告包含版本、运行日志和任务状态,不包含数据库、媒体或配置原文。发送前检查内容,脱敏范围见 [日志与诊断](DIAGNOSTICS.md)。容器不连接宿主机桌面托盘;管理与诊断入口均在网页和 CLI 中提供。
+
## 更新与范围
更新镜像并重建容器时保留 `/data`。数据库有待执行迁移时,先备份并按 [运行与配置](OPERATIONS.md) 的迁移流程处理;Docker 启动入口不会自动迁移已有数据库。健康检查使用 `/healthz?ready=1`。