跳到主要内容

使用安装器部署

本机安装使用 Soln 桌面应用。在要运行 Soln 的电脑上操作；它会检查 Docker、引导登录、获取部署包并执行安装。安装完成后，还可以用它打开空间、添加已有空间或卸载本地空间。安装流程会自动下载并校验 Node.js、Cosign，使用随包提供的 CLI 完成部署。本机证书由 Soln 自行生成，不需要 OpenSSL。无需提前安装这些工具或配置 PATH。

1. 准备电脑和账号​

  1. 根据 本机环境准备准备对应系统的 Docker 和加密存储，Windows 还需准备虚拟化与 WSL2。部署数据会留在这台电脑上。
  2. 准备一个已创建的租户和具有 tenant.runtime.deployment.manage 权限的租户成员账号。如果尚未创建租户，先在控制面完成创建。
  3. 确保这台电脑能访问 Soln 控制面、镜像仓库，以及安装日志显示的工具与公共依赖下载地址。

安装器只会在确认磁盘加密后继续；勾选确认不等于开启加密。

2. 下载并打开安装器​

在这台电脑上打开 Soln 下载页，按系统和 CPU 架构选择安装包：Mac 分 Apple 芯片与 Intel，Windows 当前使用 x64 安装包。安装后启动 Soln。

若下载按钮尚不可用，请先确认该平台的安装器是否已发布。控制面部署页面中的“下载本机部署包”下载的是部署包，不是桌面安装器。

3. 跟随安装器完成三步​

在首页点击“注册更多工作空间”（首次使用时点击“点击注册工作空间”），选择“本机部署”。

  1. 准备运行环境：点击“检查 Docker”。如果提示未就绪，先启动 Docker Desktop，等待它完全启动后重新检查。
  2. 登录 Soln：点击“登录 Soln”，在打开的浏览器中登录控制面并选择要安装的租户。浏览器返回安装器后，安装器会自动获取该租户的部署包。核对显示的租户；如果已有该租户的本机 Runtime，安装器会要求确认重新部署，确认前先了解这会替换 Agent 凭据。
  3. 选择位置、确认加密并安装：第二步会显示“部署位置”。默认在用户主目录；需要使用其他磁盘或文件夹时，点击“更改部署位置”，选择部署根目录。安装器会检查该位置所在磁盘的加密状态；检测为已加密后继续，点击“安装”。Soln 会准备工具、校验发布与镜像、执行数据库迁移并启动服务。等待日志显示安装完成，再点击“开始使用”打开 Runtime。

默认部署目录是用户主目录下的 soln-tenant-runtime-<租户 ID>。选择其他位置后，配置、数据库、文件和备份都保存在所选部署目录内。Runtime 地址由安装器选取可用端口，通常是 https://soln-<租户子域名>.localhost:8443；以安装器显示的地址为准。首次打开若浏览器提示证书不受信任，按安装器提示信任本机证书。

4. 管理已有空间​

Soln 首页列出已找到的本地空间和手动添加的服务器空间。选中空间后点击“打开”，会在浏览器中访问该空间；“注册更多工作空间”会开始新的部署流程。

  • 添加已有空间 → 添加本地空间：选择已完成部署的根目录，即包含 .soln/deployment.json 的目录，不要选择其中的 data 或 .soln。添加操作只记录目录并显示入口，不会重新安装或启动容器。
  • 添加已有空间 → 添加服务器空间：填写空间名称和完整的 HTTPS 地址，可使用域名或 IP 地址。该操作只保存访问入口，不会在本机部署服务器空间。
  • 移除空间：在空间列表中右键目标空间，确认后仅移除首页入口。部署、数据库和文件不会删除；以后可以重新添加。
  • 彻底卸载本地空间：只对本地空间显示。在空间列表中右键目标空间，按弹窗提示输入引号中的空间名称确认。Soln 会显示“正在卸载”，停止并删除该空间的 Docker Compose 项目，删除所选部署目录内的配置、数据库、文件和备份，并尝试移除本机根证书；完成后自动关闭加载弹窗。此操作无法恢复，请先自行保留需要的数据。服务器空间不能通过本机菜单卸载。

彻底卸载要求部署数据位于该部署根目录的 data 子目录。若目录含其他文件、数据指向目录外，或 Docker 项目归属无法确认，Soln 会拒绝删除并显示错误。磁盘上的其他部署目录及 Docker 镜像缓存不在此次删除范围内。

安装失败时​

  • Windows 提示缺少虚拟机平台或 WSL：按 Windows 环境准备处理，按提示重启后重新检查。
  • 工具下载或校验失败：根据日志中的文件和地址检查下载，再回到安装器重试。自行安装其他版本的 Node.js 或 Cosign 不能替代这次经过校验的下载。
  • Docker 检查失败：确认 Docker Desktop 正在运行，回到第一步重试。
  • 镜像下载超时：先检查到镜像仓库的网络。安装器日志会显示失败的镜像；修复网络后在安装器中重试安装，不要重新登记租户。
  • 加密检查失败：先启用系统磁盘加密，再重新检查。不要仅靠勾选确认继续。
  • 已显示安装完成但页面打不开：先确认容器仍在运行，再检查安装器给出的准确地址和本机证书信任状态。

安装成功后可继续查看本机升级与回滚。

可选：通过 Linux 终端安装

上面的桌面安装器是主要路径。需要有意使用终端安装时，先自行准备 Docker、Node.js 22 或更高版本、Cosign 与加密存储。该路径不会使用桌面安装器的专用工具，不需要 OpenSSL。将下面的 example 和邮箱替换为自己的租户信息：

npm install -g @soln/cli@latest
sl deployment login --base-url https://api.solncn.com --tenant example --email operator@example.com --method email
sl deployment register --dir "$HOME/soln-tenant-runtime" --deployment-target local --runtime-origin https://soln-example.localhost:8443
sl deployment prepare --dir "$HOME/soln-tenant-runtime"
sl install --dir "$HOME/soln-tenant-runtime" --setup-file .soln-install-setup.json --confirm-encrypted-storage --yes
sl status --dir "$HOME/soln-tenant-runtime" --check --json

成功后删除 "$HOME/soln-tenant-runtime/.soln-install-setup.json" 并执行 sl deployment logout。