admin/xymediavault-releases
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

release: sync public installer asset README.md

Browse Source
This commit is contained in:
admin
2026-09-02 05:26:56 +00:00
parent 72b5a9ea9e
commit b1cd379f0e
1 changed files with 4 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+4
View File
@@ -14,8 +14,12 @@ Options include `--install-dir`, PostgreSQL connection options, `--postgres-pass
安装完成后，菜单 `5) 状态/诊断/维护` 提供本地媒体库维护子菜单：查看状态、一键挂载、按既有路径启动/重启，以及停用挂载。挂载目录必须是 root 可访问的已存在绝对目录，且首次配置时必须为空；路径及 `XYMEDIA_FUSE_ENABLED` 会持久化到 `.env`，应用配置固定使用容器内 `/mnt/xymediavault`。维护动作只停止和启动 `app`，不会停止 PostgreSQL；停用会卸载由 XyMediaVault 识别的 FUSE 挂载并恢复 base compose。脚本拒绝远程 Docker、符号链接路径和 foreign/unknown mount。 安装完成后，菜单 `5) 状态/诊断/维护` 提供本地媒体库维护子菜单：查看状态、一键挂载、按既有路径启动/重启，以及停用挂载。挂载目录必须是 root 可访问的已存在绝对目录，且首次配置时必须为空；路径及 `XYMEDIA_FUSE_ENABLED` 会持久化到 `.env`，应用配置固定使用容器内 `/mnt/xymediavault`。维护动作只停止和启动 `app`，不会停止 PostgreSQL；停用会卸载由 XyMediaVault 识别的 FUSE 挂载并恢复 base compose。脚本拒绝远程 Docker、符号链接路径和 foreign/unknown mount。
全新本机 bundled PostgreSQL 安装会从宿主机可用 IP 地址中选择数据库连接地址，在 `20000-40000` 范围随机选择对外端口，并生成符合 PostgreSQL 标识符规则的随机用户名和至少 32 位十六进制密码。可用 `XYMEDIA_POSTGRES_PUBLIC_PORT` 指定端口；端口仍映射到容器内固定的 `5432`。主机、公开端口、数据库和用户名写入 `.env`，密码只写入 `secrets/xymedia-postgres-password`。升级已有安装会保留 `.env` 中已有的 PostgreSQL 主机、端口、数据库和用户名，不会随机轮换，也不会删除旧的 `secrets/postgres-password`。安装成功后本机数据库连接信息会直接显示一次；主菜单 `7) 查看数据库连接信息` 是再次显示密码的主动操作。外部数据库安装只显示主机、端口、数据库和用户名，不显示用户提供的密码。
主菜单 `6) 查看小雅控制器地址和密钥` 可以查看本机控制器连接信息。选择 `2) 安装管理平台和本机小雅` 并完成安装后，安装器也会自动显示控制器地址和密钥；密钥不会写入安装日志。 主菜单 `6) 查看小雅控制器地址和密钥` 可以查看本机控制器连接信息。选择 `2) 安装管理平台和本机小雅` 并完成安装后，安装器也会自动显示控制器地址和密钥；密钥不会写入安装日志。
维护菜单中的 `5) 清理 XyMediaVault 容器及数据` 提供 `1) 只清理 XyMediaVault`、`2) 清理 XyMediaVault 和本机安装的小雅` 和取消选项。全新安装会在 `.env` 保存随机 `XYMEDIA_INSTANCE_ID`，并给安装器创建的 Compose 服务写入 managed、实例 ID 和 canonical 安装目录标签。清理要求 `.env` 身份与当前目录完全一致，并逐容器复核名称和所有权标签；缺少标签的旧容器、其他实例容器和用户容器均保留，不会按名称猜测删除。迁移容器只查询当前实例的 managed 标签，确认前冻结名称和 ID，确认后再次 inspect，发生变化则跳过。选项 1 保留用户小雅容器和外部 `XYMEDIA_XIAOYA_DATA_DIR`；选项 2 还要求 `.env` 标记 `XYMEDIA_XIAOYA_MANAGED=1` 且小雅 `/data` 挂载位于安装目录内。清理不执行 Docker prune；中断会保留 root-only `.cleanup.journal`，下次必须输入数字 `1` 才能恢复。真实旧安装若缺少身份标签会明确拒绝删除相关容器。
普通全新安装创建的持久容器名称为 `xymedia-postgres`、`xymedia-app`、`xymedia-xiaoya`、`xymedia-controller` 和 `xymedia-aliyuntvtoken`；数据库迁移是短生命周期任务，使用 Compose 自动生成的临时名称并在完成后删除。升级已有安装时，`.env` 中已有的 `XYMEDIA_XIAOYA_CONTAINER` 会原样保留，控制器只记录并连接该真实容器名，不会重命名用户已有的小雅容器。已有 PostgreSQL、app 等旧 Compose 容器由服务名管理，安装器不会按名称删除无关容器；旧名称可能在迁移期间暂时保留，需由管理员按实际项目状态处理孤立容器。 普通全新安装创建的持久容器名称为 `xymedia-postgres`、`xymedia-app`、`xymedia-xiaoya`、`xymedia-controller` 和 `xymedia-aliyuntvtoken`；数据库迁移是短生命周期任务，使用 Compose 自动生成的临时名称并在完成后删除。升级已有安装时，`.env` 中已有的 `XYMEDIA_XIAOYA_CONTAINER` 会原样保留，控制器只记录并连接该真实容器名，不会重命名用户已有的小雅容器。已有 PostgreSQL、app 等旧 Compose 容器由服务名管理，安装器不会按名称删除无关容器；旧名称可能在迁移期间暂时保留，需由管理员按实际项目状态处理孤立容器。
PostgreSQL 启动后安装器每 2 秒通过 Compose 查询其容器 ID，再读取 Docker health 状态，持续等待到 `healthy`，没有固定超时。应用启动后同样持续等待 `/api/health`；数据库迁移的原始输出会实时显示并追加到安装日志。已用秒数和状态会显示在终端；在等待期间按 Ctrl-C 会记录对应容器日志、停止等待并执行既有临时目录清理，安装以未完成状态退出。 PostgreSQL 启动后安装器每 2 秒通过 Compose 查询其容器 ID，再读取 Docker health 状态，持续等待到 `healthy`，没有固定超时。应用启动后同样持续等待 `/api/health`；数据库迁移的原始输出会实时显示并追加到安装日志。已用秒数和状态会显示在终端；在等待期间按 Ctrl-C 会记录对应容器日志、停止等待并执行既有临时目录清理，安装以未完成状态退出。