在线一键安装

这个功能解决什么问题

你有一台全新的 Linux 服务器，希望用最快的方式把 VortLab 私有化平台跑起来。在线一键安装不需要预装 Docker、不需要手工配置数据库和密钥——一条命令完成环境准备、镜像拉取、密钥生成和服务启动。

前置条件

项目	要求
操作系统	Linux（apt 或 yum 包管理系；Ubuntu 20.04+ / Debian 11+ / CentOS 8+ 均可）
权限	root 用户，或具有 sudo 权限的普通用户（脚本会自动提权）
网络	服务器可访问 download.vortlab.cn 和镜像仓库（出站）
硬件	4 核 CPU、8GB 内存起步（生产建议 16GB+），磁盘 10GB 起步（训练数据多时按需扩容）
GPU（仅 CUDA 版）	NVIDIA 显卡 + 已安装驱动（nvidia-smi 可正常执行），仅支持 x86_64 架构；CPU 版无 GPU 要求。驱动与容器工具链的准备步骤见 GPU 环境准备
端口	3000（Web 界面）、8000（API）

Docker 无需提前安装：脚本检测到缺失时会自动安装 Docker 与 Docker Compose v2。

需要准备的物料

• 安装令牌：由支持人员通过运营管理端签发，与你的客户身份、目标版本和**设备类型（CPU / CUDA）**绑定。令牌中已包含镜像仓库地址与访问凭据，不需要你手工填写。

设备类型：CPU 版与 CUDA 版（自 1.5.12 起）

私有化安装分两种设备变体，由安装令牌决定，安装过程无需手工选择：

• CPU 版：无 GPU 要求，通用场景。
• CUDA 版：使用 GPU 加速的后端镜像，训练与推理速度显著更快。要求服务器装有 NVIDIA 显卡和驱动（nvidia-smi 可正常执行），且仅支持 x86_64 架构；GPU 会在安装时自动透传给训练容器。安装脚本不会安装 NVIDIA 驱动，驱动与容器工具链需提前准备，详见 GPU 环境准备。

升级永远保持安装时的设备类型（CUDA 版升级后仍是 CUDA 版，反之亦然）。需要从 CPU 版切换到 CUDA 版（或反向）时，请联系支持人员走重新安装流程。

• License 文件（vortlab.lic）：按服务器硬件指纹签发。在线安装时不需要提前准备——安装令牌会自动附带 30 天试用期（见试用期说明），正式许可证在试用期内上传即可。

License 与硬件绑定

License 文件与服务器指纹（machine-id / 硬件标识 / 网卡 MAC）绑定。重装操作系统或更换主要硬件后，原 License 将失效，需要联系支持人员重新签发。

操作步骤

1. 获取安装令牌

   联系支持人员，提供你的客户信息与目标版本，获取一次性安装令牌。令牌有使用次数限制，仅对该台服务器有效。

2. 执行一键安装

   以 root（或 sudo 用户）执行：

   curl -sSL "https://download.vortlab.cn/install?t=<您的安装令牌>" | bash

   非 root 用户执行时会自动通过 sudo 提权（需要输入一次当前用户密码）。

   脚本会自动完成：安装预检（先检查操作系统、架构、镜像仓库连通性、时钟同步、磁盘空间等，CUDA 版还会检查 GPU 与驱动；预检会把所有问题一次性列出后再退出，方便逐项修复）→ 安装 Docker（如缺失）→ 登录镜像仓库 → 拉取平台镜像 → 生成数据库密码 / 管理员初始密码等密钥 → 启动全部服务 → 等待版本就绪自检。

3. （可选）带镜像防伪校验安装

   如果支持人员同时提供了镜像摘要校验值（sha256:...），建议采用两步安装方式，对拉取的镜像内容做 fail-closed 校验，防止镜像仓库标签被覆盖或污染：

   curl -sSL "https://download.vortlab.cn/install?t=<您的安装令牌>" -o /tmp/vortlab-install.sh
   BACKEND_IMAGE_DIGEST=sha256:... FRONTEND_IMAGE_DIGEST=sha256:... \
     sudo bash /tmp/vortlab-install.sh

4. 放置 License 文件

   将收到的 vortlab.lic 复制到安装目录并重启后端：

   cp vortlab.lic /opt/vortlab/license/vortlab.lic
   docker compose -f /opt/vortlab/config/docker-compose.online.yml \
     --env-file /opt/vortlab/config/.env restart backend

5. 验证安装

   curl http://localhost:8000/health

   返回 {"status":"ok", ...} 且 image_version 与安装的版本号一致，即安装成功。

6. 首次登录并修改密码

   浏览器打开 http://<服务器IP>:3000，使用初始管理员账号（用户名 admin）登录，密码为安装完成时屏幕打印的 INITIAL_ADMIN_PASSWORD（也可在服务器上执行 grep INITIAL_ADMIN_PASSWORD /opt/vortlab/config/.env 查看）。

   登录后请立即在头像菜单 → 设置 → 修改密码中更换。

环境变量说明

在线安装通常不需要手工设置环境变量（令牌已自动注入）。以下变量供分步安装或高级场景使用：

字段	类型	必填	默认值	说明
REGISTRY	文本	可选	（令牌注入）	镜像仓库地址，含命名空间
REGISTRY_USERNAME	文本	可选	（令牌注入）	镜像仓库用户名
REGISTRY_PASSWORD	文本	可选	（令牌注入）	镜像仓库密码
VERSION	版本号	可选	（令牌注入）	目标安装版本，如 1.1.0
INSTALL_DIR	路径	可选	/opt/vortlab	安装目录；数据、配置、备份都存放在此
BACKEND_IMAGE_DIGEST	摘要	可选	—	后端镜像 sha256 摘要，提供后启用 fail-closed 内容校验
FRONTEND_IMAGE_DIGEST	摘要	可选	—	前端镜像 sha256 摘要，同上
UPGRADER_IMAGE_DIGEST	摘要	可选	—	升级代理镜像 sha256 摘要，同上
SOCKET_PROXY_IMAGE_DIGEST	摘要	可选	—	Docker 代理镜像 sha256 摘要，同上

安装后的目录结构

路径	内容
/opt/vortlab/config/	compose 配置与 .env（含密钥，权限 600，勿外泄）
/opt/vortlab/data/	业务数据（数据集、模型、上传文件）
/opt/vortlab/license/	License 文件
/opt/vortlab/backups/	升级前的自动备份（数据库快照 + 配置快照）
/opt/vortlab/state/	升级代理运行状态与审计日志
/opt/vortlab/.version	当前已安装版本标记

关于版本升级

界面内在线升级能力自 1.1.0 版本起提供：在「管理中心 → 系统管理 → License」页面粘贴升级令牌即可升级，全程自动备份、失败自动回滚。1.1.0 之前安装的版本，请先通过支持人员提供的升级命令完成最后一次命令行升级，之后即可使用界面升级。

安全提醒

• 初始管理员密码在首次登录后立即修改。
• /opt/vortlab/config/.env 包含数据库密码等敏感信息，权限为 600，不要复制到不安全的位置。
• 升级前系统会自动在 backups/ 下创建数据库备份；不要随意删除该目录。