debug

docs/17_domainCheck_全流程部署实操手册.md

@@ -71,6 +71,26 @@
 - Redis `6+`
 - Nginx
 
+关键说明：
+
+- 这里的 Python 不是“系统自带什么就用什么”
+- 必须明确安装 `python3.11`
+- 不能只装系统默认 `python3`
+- 因为后续部署命令直接使用的是 `python3.11 -m venv .venv`
+
+推荐先执行：
+
+```bash
+dnf install -y python3.11 python3.11-devel
+python3.11 --version
+```
+
+期望输出类似：
+
+```text
+Python 3.11.x
+```
+
 ### 2. 目录约定
 
 统一使用：
@@ -109,6 +129,12 @@ ln -s /www/wwwroot/getDomain/domainCheck /opt/domaincheck/domainCheck
 
 当前建议统一走 `git` 管理和更新，不再手工散传目录。
 
+执行口径：
+
+- 这里建议直接使用 `root`
+- 不建议使用 `www` 用户执行整套部署命令
+- 因为后面还会接着写 `systemd`、`/etc/default/`、`/opt/domaincheck/` 和服务启停
+
 第一次部署建议：
 
 ```bash
@@ -138,6 +164,17 @@ git checkout main
 git pull --ff-only origin main
 ```
 
+### 1.1 先确认 Python 3.11 已安装
+
+如果当前机器还没有 `python3.11`，先执行：
+
+```bash
+dnf install -y python3.11 python3.11-devel
+python3.11 --version
+```
+
+只有确认 `python3.11` 命令存在后，再继续下面的虚拟环境步骤。
+
 ### 2. 创建 Python 虚拟环境
 
 ```bash