====== PWstudio cpu 版 windows11_wsl2 安装指南 ======

适用系统：window11\\

<wrap important>
在开始之前，强烈建议先看一遍 [[pwstudio:readme|PWstudio 安装前必看]]，建立一个整体概念。
</wrap>

----

===== 1. 安装 WSL_Ubuntu 24.04 LTS =====

**方法一：**

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

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

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

a.打开 Microsoft Store;

b.搜索 Ubuntu 24.04 LTS;

c.点击"获取"或"安装"。

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

===== 2. 安装 Docker =====

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

点击链接, 从<wrap em>安装 Docker</wrap>章节开始: [[pwstudio:ubuntu_gpu#安装 Docker|跳转到安装 Docker章节]] 跟着文档安装到此章节再返回此文档

===== 3. PWstudio cpu 版安装 =====

点击链接, 从<wrap em>导入镜像</wrap>章节开始: [[pwstudio:quickstart_cpu#导入镜像|跳转到导入镜像章节]] 跟着文档安装到结尾

----

<wrap em>采用 wslc 起 PWstudio cpu 容器</wrap>

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

===== 1 wsl 安装更新 =====

以下命令均在 **PowerShell** 中执行：

  - 以管理员身份打开 PowerShell: 在 "开始" 菜单搜索 ''PowerShell'', 右键选择 "以管理员身份运行"

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

<code powershell>
wsl --update --pre-release
</code>

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

<code powershell>
wsl --shutdown
</code>

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

<code powershell>
wslc --version
</code>

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

===== 2 宿主机安装 server.py 服务 =====

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

===== 3. 导入镜像 =====

<code powershell>
wslc pull ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest
</code>

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

===== 4. 启动容器 =====

在 powershell 中:

<code 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
</code>

在 cmd 中:

<code powershell>
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
</code>

<WRAP center round info 10%>
在 powershell 或 cmd 下执行 ipconfig 查看对应 WSL 虚拟网卡的 ip, 如果提交作业报错, 可指定 ip 启动容器[[pwstudio:qa:q106|见列表2]]

或设置镜像网络
</WRAP>

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

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

~~DISCUSSION:off~~