适用系统：window11

在开始之前，强烈建议先看一遍 PWstudio 安装前必看，建立一个整体概念。

方法一：

参考microsoft官方教程安装https://learn.microsoft.com/zh-cn/windows/wsl/install

方法二：也可以图形化安装：

从 Microsoft Store 安装如果您更习惯图形界面，可以在 Windows 应用商店中下载：

a.打开 Microsoft Store;

b.搜索 Ubuntu 24.04 LTS;

c.点击“获取”或“安装”。

以上两种方法选一种做就行，不需要都做。安装完成后，第一次打开 Ubuntu 应用，会要求你设置一个 Linux 用户名和密码，正常设置即可，记得把这组用户名密码记下来，后面可能会用到。

CPU 版本的 Docker 安装步骤和 GPU 版本一样，直接跳转过去即可。

点击链接, 从安装 Docker章节开始: 跳转到安装 Docker章节 跟着文档安装到此章节再返回此文档

点击链接, 从导入镜像章节开始: 跳转到导入镜像章节 跟着文档安装到结尾

采用 wslc 起 PWstudio cpu 容器

下面这部分是另一种通过 wslc（WSL 自带的容器工具）来启动 PWstudio cpu 容器的方式，跟上面第 2、3 步走的是不同的路线，二者选一种走完即可，不要两种都做。如果你已经按照上面第 2、3 步顺利完成安装，可以跳过下面这部分。

以下命令均在 PowerShell 中执行：

1. 以管理员身份打开 PowerShell: 在 “开始” 菜单搜索 PowerShell, 右键选择 “以管理员身份运行”

1. 更新到 WSL 预发布版：运行以下命令

wsl --update --pre-release

1. 重启 WSL 服务: 更新完成后, 运行此命令让更改生效

wsl --shutdown

1. 验证 wslc 是否可用: 关闭并重新打开你的终端(PowerShell 或 Windows 终端)

wslc --version

如果看到类似版本号的输出（比如 2.9.3.0），说明可以继续下一步了。

安装说明：点击链接, 在 Windows 下安装 server.py 服务 跟着文档安装好证书服务, 再进行下一步。

wslc pull ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest

这一步是下载 PWstudio cpu 版镜像，体积较大，根据网速可能需要几分钟到十几分钟，请耐心等待。

在 powershell 中:

wslc run -d --name qflowcpu `
  -v $env:TEMP\pwmat:/var/tmp/pwmat_host_secret:ro `
  --ulimit memlock=-1:-1 --ulimit stack=-1:-1 --shm-size=128G `
  -e SELINUX=disabled -p 80:80 -p 81:81 -p 2297:2297 -p 5010:5010 `
  --hostname=mstation ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest

在 cmd 中:

wslc run -d --name qflowcpu ^
  -v %TEMP%\pwmat:/var/tmp/pwmat_host_secret:ro ^
  --ulimit memlock=-1:-1 --ulimit stack=-1:-1 --shm-size=128G ^
  -e SELINUX=disabled -p 80:80 -p 81:81 -p 2297:2297 -p 5010:5010 ^
  --hostname=mstation ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest

以上两段二选一，跟你习惯用的终端类型对应即可，不要两个都执行。执行后没有报错，一般会输出一长串字符（容器 ID），说明容器已经启动。

跳转到: 5. 对容器登录、上传下载 跟着文档进行到文档结束。如果还不会用 SSH 工具登录，可以先看 MobaXterm 新手教程。