安装 Docker Server

默认 Docker 入口适合先在可信局域网中验证。它使用内置完整配置，通常不需要先编写 TOML；你必须明确保存媒体和应用私有状态。

准备目录

至少准备两个独立宿主机路径：

• 媒体存储，挂载到容器内 /data/storage；
• 应用私有状态，挂载到 /data/app-state。

官方 Compose 对应的环境变量是 LUMILIO_STORAGE 和 LUMILIO_STATE。未设置时会使用项目目录下的 ./lumilio/media 与 ./lumilio/app-state。

启动

1. 从同一个 GitHub Release 下载 Server bundle 与 SHA256SUMS.txt，验证归档校验和。
2. 解压 bundle；其中 .env 已按 OCI digest 固定本次发布的 multi-architecture 镜像。
3. 设置两个宿主机路径，并确认 Docker 可以写入。
4. 运行 docker compose up -d --wait。
5. 观察健康检查通过后，访问宿主机的 6680 端口。
6. 完成管理员和主资源库设置。

容器以 UID/GID 10001 运行。入口会检查两个挂载是否可写，并尝试修正挂载顶层权限；如果宿主文件系统拒绝，它会停止并输出可操作的权限错误。不要通过让整个媒体树永久变为任意用户可写来规避权限问题。

默认网络与注册边界

默认 Compose 使用主机网络并提供 HTTP。当前代码在初始化后仍显示公开注册入口；因此不要把未加访问控制的默认实例直接暴露到不可信网络。完成首次验证后，应阅读HTTPS 与访问边界和公开注册风险。

保留上一个 Server bundle、其中记录的 image digest，以及升级前数据库快照。数据库已经向前迁移时，回退必须把旧镜像与对应快照配对；不要用数据库回退覆盖媒体目录。