release: sync public installer asset README.md

2026-09-03 02:10:32 +00:00
parent 7fa19879d9
commit 81c50e508c
1 changed files with 1 additions and 1 deletions
@@ -22,7 +22,7 @@ Options include `--install-dir`, PostgreSQL connection options, `--postgres-pass

 普通全新安装创建的持久容器名称为 `xymedia-postgres`、`xymedia-app`、`xymedia-xiaoya` 和 `xymedia-controller`；数据库迁移是短生命周期任务，使用 Compose 自动生成的临时名称并在完成后删除。复用已有小雅时不会创建 `xymedia-xiaoya`，`.env` 中保存真实容器名，控制器只记录并连接该容器，不会重命名用户已有的小雅容器。已有 PostgreSQL、app 等旧 Compose 容器由服务名管理，安装器不会按名称删除无关容器。

-PostgreSQL 启动后安装器每 2 秒通过 Compose 查询其容器 ID，再读取 Docker health 状态，持续等待到 `healthy`，没有固定超时。应用启动后同样持续等待 `/api/health`；数据库迁移的原始输出会实时显示并追加到安装日志。已用秒数和状态会显示在终端；在等待期间按 Ctrl-C 会记录对应容器日志、停止等待并执行既有临时目录清理，安装以未完成状态退出。
+安装器不会在数据库准备阶段启动 app。选择小雅 profile 时只启动对应的小雅服务；本机 PostgreSQL 启动后每 2 秒通过 Compose 查询其容器 ID，再读取 Docker health 状态，持续等待到 `healthy`，没有固定超时。随后在同一 Compose 网络中启动临时 `postgres:17-bookworm` 客户端，通过应用实际使用的宿主机 IP、公开端口、用户名和密码执行 `SELECT 1`，外部连接验证成功后才运行数据库迁移，迁移成功后才启动 app。外部数据库跳过本机 PostgreSQL，但执行相同的外部连接验证。应用启动后同样持续等待 `/api/health`；数据库迁移的原始输出会实时显示并追加到安装日志。已用秒数和状态会显示在终端；在等待期间按 Ctrl-C 会记录对应容器日志、停止等待并执行既有临时目录清理，安装以未完成状态退出。

 FUSE 维护要求安装目录、`.env`、`config.yaml` 和 `state` 由 root 拥有且不允许 group/world 写入；不满足时脚本会拒绝执行。快照、配置写入临时文件和日志均在 `/tmp` 下随机命名的 root 私有目录中通过 `mktemp` 创建，权限为 `700/600`，不会在可写安装目录中创建可预测临时文件或持久日志。