跳到主要内容

本机环境准备：Windows

当前 Soln Windows 安装器为 x64，适用于 Intel、AMD 电脑。Windows 版本需满足 Docker Desktop 的要求。无需提前安装 Node.js、Cosign 或 OpenSSL。

1. 准备虚拟化与 WSL2​

Docker Desktop 的 WSL2 后端需要硬件虚拟化、Windows 的“虚拟机平台”功能和 WSL。这三项需要分别准备。

  • 硬件虚拟化：打开“任务管理器 → 性能 → CPU”，确认虚拟化已启用。未启用时，按电脑厂商说明进入 BIOS/UEFI 开启。
  • Windows 功能：在“启用或关闭 Windows 功能”中启用“虚拟机平台”和“适用于 Linux 的 Windows 子系统”，按提示授权管理员权限。
  • 重启电脑：系统提示后重启 Windows；只重启 Docker Desktop 不会让系统组件生效。
  • WSL：尚未安装时，在管理员 PowerShell 执行：
wsl --install --no-distribution

WSL 下载慢时，可从 Soln GitCode WSL 发行版下载微软官方 MSI 原包。Intel/AMD 电脑选择 wsl.3.0.3.0.x64.msi，双击安装，按提示重启。供 Docker Desktop 使用时无需额外安装 Ubuntu。

安装后检查：

wsl --version

能显示 WSL 和内核版本即可。下载页提供 ARM64 WSL 文件，不代表当前 Soln Windows 安装器支持 ARM64。

2. 安装并启动 Docker Desktop​

从 Docker Desktop Windows 安装说明下载安装包，使用 WSL2 后端和 Linux 容器。启动后等待显示 Engine running。

提示“Virtual Machine Platform is not enabled”时，检查虚拟机平台是否启用、Windows 是否已重启。提示“WSL is not installed”时，完成上面的 WSL 安装。

3. 准备加密存储​

为部署文件夹所在卷开启 BitLocker 或设备加密，等待完全加密，并确保保护已开启。正在加密或保护已暂停时，不能视为准备完成。

部署目录放在自己的用户目录或已加密卷上的其他受保护文件夹中。Soln 会检查实际选择的卷，确认操作不会替你开启磁盘加密。

4. 打开 Soln 完成安装​

继续本机安装。系统提示管理员授权或证书信任时按需确认。安装流程会自动下载、校验 Node.js 和 Cosign，并生成本机 HTTPS 证书。