====== PWstudio cpu 版安装 ======

<wrap important>
本篇假设你已经装好了 Docker（如果还没装，请先回到 [[pwstudio:start|首页]] 根据你的系统选择对应的安装篇章）。如果你是新手、还不熟悉终端操作，也建议先看一眼 [[pwstudio:readme|安装前必看]] 和 [[pwstudio:mobaxterm|MobaXterm 新手教程]]。
</wrap>

===== 1. 需求 =====

  * 已安装 docker（可用 ''docker --version'' 检查，能看到版本号说明装好了）

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

安装说明：点击链接, [[pwstudio:server|在 Linux 下安装 server.py 服务]] 跟着文档安装好证书服务, 再进行下一步。这一步是为了后面能正常拿到 qflow 的使用许可（license），不要跳过。

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

<code bash>
sudo docker pull ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest
</code>

这一步是把 PWstudio cpu 版的镜像下载到服务器本地，根据网络情况可能需要几分钟到十几分钟，终端会持续显示下载进度，属于正常现象，请耐心等待；这一步没有指定的目录要求。

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

<code bash>
sudo docker run -d --name qflowcpu \
  -v /var/tmp/pwmat_host_secret:/var/tmp/pwmat_host_secret:ro \
  --ulimit memlock=-1:-1 --ulimit stack=-1:-1 \
  --shm-size=128G --privileged -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>

执行成功后一般会输出一长串字母数字组成的字符串（容器 ID），说明容器已经启动。可以用 ''docker ps'' 查看容器是否正常运行（''STATUS'' 列显示 "Up ..." 就说明正常）。

<WRAP center round todo 10%>
81:81 不能变。 容器内的81端口必须映射成宿主机的 81 端口

通过如下命令查看正在运行的容器：

<code bash>
docker ps
</code>

通过如下命令查看所有容器(启动的 或 停止的)：

<code bash>
docker ps -a
</code>

执行后能看到一个表格，如果表格里有一行 ''NAMES'' 列显示 ''qflowcpu''，''STATUS'' 列显示 ''Up ...''（比如 "Up 5 minutes"），就说明容器正在正常运行。

启动容器前，如有同名容器占用，需停止和删除旧容器：

<code bash>
docker stop qflowcpu
</code>

删除同类型旧容器：
<code bash>
docker rm qflowcpu
</code>

停止、删除之后，再重新执行上面的 ''docker run'' 命令即可。

<WRAP center round alert 60%>
  - 删除容器, 容器里的数据也会被删除❗
  - 容器里的 qflow 工作流不能导出
</WRAP>

</WRAP>


===== 5. 对容器登录、上传下载 =====

  * 通过 SSH 客户端登录、上传、下载<wrap notice>推荐</wrap>

^ 地址        ^ 端口号  ^ 用户名  ^ 密码             ^
| [宿主机ip]  | 2297    | pwmat   | PWmat2022        |
| [宿主机ip]  | 2297    | root    | PWmatSimplyBest  |

上表 ''[宿主机ip]'' 替换成你服务器真实的 IP 地址，其它按表格填写即可，不需要修改。

<wrap tip>
还不会用 SSH 客户端登录、上传下载文件的，可以看这份新手教程：[[pwstudio:mobaxterm|如何用 MobaXterm 登录服务器并上传下载文件]]
</wrap>

  * 可以通过 docker 命令直接访问容器

<code bash>
docker exec -it qflowcpu bash

# 使用完退回宿主机
exit
</code>

===== 6. qstudio、qflow 访问登录 =====

从这一步开始，改为使用**网页浏览器**操作（推荐 Chrome 或 Edge），访问地址：%%http://[宿主机ip]%%

^ 账号 ^ 密码 ^
| 15000000000 | PWmat2022 |

如果粘贴密码提示错误，可能是浏览器兼容性问题，手动输入密码即可。

~~DISCUSSION:off~~