VISTO USER GUIDE / 09

Docker 部署说明

本章供已有 Docker 经验的维护者使用。当前公共源码白名单尚未包含 Compose 全套交付，因此不要把本章当作已存在的公开 Docker 下载入口。请使用对应版本明确提供并验收的完整 Docker 源码或交付目录；只拿到 macOS 公共快照时，请选择 macOS 安装路径。

前置条件与结构

需要 Docker Engine 26+、Docker Compose v2、至少 4 GB 可用内存、足够持久卷空间和可用的本机端口。官方 Compose 分为 core 与 web：浏览器连接 Web，Web 代理 Core；Core 的 8787 端口不应直接暴露给宿主机。

在提供 compose.yaml 的部署目录里生成首次初始化令牌：

export VISTO_HOST_MANAGEMENT_TOKEN="$(openssl rand -base64 32)"
docker compose up -d --build
docker compose ps

本机浏览器打开 http://127.0.0.1:8080/，输入刚生成的令牌并完成首次设置。令牌不要提交到仓库或发给成员。记录当前部署目录、Compose 配置、固定镜像与数据卷信息，以便维护时使用。

日常命令

docker compose ps
docker compose logs --tail 100 core
docker compose exec core visto-server doctor
docker compose down

down 用于停止这套部署。不要添加 -v，否则可能删除持久业务数据卷。项目数据、加密秘密和默认托管媒体位于数据卷；额外挂载和远程存储还要独立备份。

备份与恢复

在同一部署目录，由维护者运行交付中的脚本：

./scripts/docker/backup-visto-docker.sh --backup-dir ./backups

恢复会替换当前卷，先核对备份与同名 JSON 元数据、SHA-256、目标部署及异盘副本，再执行：

./scripts/docker/restore-visto-docker.sh \
  --backup-file './backups/<实际备份文件>.tar.gz' \
  --confirm-restore

这些 Docker 脚本的选项与 macOS 原生脚本不同，不混用 --check-only 或原生安装路径。更新时只使用该版本发布说明公布的固定 image@sha256: 引用，不猜测镜像仓库或可变 latest 标签。更新失败、断网、磁盘不足等最终容器实机回归仍须在目标环境验收；本文不把静态脚本检查记成实机通过。