修正env

crypto_monitor_gate/.env.example

@@ -1,3 +1,17 @@
+# =============================================================================
+# 环境配置模板（可提交 Git）。程序运行时只读取同目录下的 .env。
+#
+# 首次部署 / 新机：
+#   cp .env.example .env
+#   nano .env          # 填入真实密钥、端口、代理等
+#
+# 升级代码（git pull）前建议备份（.env 不在 Git 中，pull 不会覆盖）：
+#   cp .env .env.backup.$(date +%Y%m%d)
+#
+# 从备份恢复：
+#   cp .env.backup.YYYYMMDD .env
+# =============================================================================
+
 APP_ENV=production
 # 服务监听地址（云服务器通常用 0.0.0.0）
 APP_HOST=0.0.0.0

crypto_monitor_gate/README.md

@@ -36,7 +36,10 @@ source .venv/bin/activate   # Windows: .venv\Scripts\activate
 pip install flask requests ccxt werkzeug PySocks Pillow
 ```
 
-## 配置（`.env`）
+## 配置（`.env.example` → `.env`）
+
+- **`.env.example`**：模板（可提交 Git）；首次：`cp .env.example .env` 后编辑。
+- **`.env`**：本机真实配置（勿提交）；`git pull` 不覆盖；升级前建议备份（见《部署文档》§5.2）。
 
 项目启动时加载**仓库根目录**下的 `.env`。常用项：
 
@@ -51,7 +54,7 @@ pip install flask requests ccxt werkzeug PySocks Pillow
 | `WECHAT_WEBHOOK` | 企业微信机器人 |
 | `EXCHANGE_DISPLAY_NAME` / `GATE_ACCOUNT_LABEL` | 页面与推送展示的账户文案 |
 
-其余见 **`.env` 内注释** 或 **`app.py` 顶部默认值**。
+其余见 **`.env.example` 内注释** 或 **`app.py` 顶部默认值**。
 
 ## 本地运行
 

crypto_monitor_gate/ecosystem.config.cjs

@@ -27,7 +27,7 @@ module.exports = {
       autorestart: true,
       watch: false,
       max_memory_restart: "800M",
-      // app.py 会从项目根目录加载 .env，此处无需重复 env_file
+      // app.py 从项目根目录 .env 加载（由 .env.example 复制而来，勿提交 Git）
     },
   ],
 };

crypto_monitor_gate/使用说明.md

@@ -24,7 +24,9 @@
 
 ## 2. 运行前必须配置（`.env`）
 
-至少检查以下项（具体键名以你仓库 `.env` 示例为准）：
+首次在本目录执行 **`cp .env.example .env`**，再编辑 `.env`（`.env` 勿提交 Git；`git pull` 不会改你的 `.env`，升级前建议 `cp .env .env.backup.$(date +%Y%m%d)`）。
+
+至少检查以下项（具体键名以 **`.env.example`** 为准）：
 
 | 类别 | 说明 |
 |------|------|

crypto_monitor_gate/部署文档.md

@@ -27,12 +27,18 @@
 ```bash
 mkdir -p /opt/crypto_monitor
 cd /opt/crypto_monitor
-# git clone ... 或解压同步的包
-cd crypto_monitor_gate
+git clone https://git.bz121.com/dekun/crypto_monitor.git
+cd crypto_monitor/crypto_monitor_gate
 ```
 
 下文用 **`/opt/crypto_monitor/crypto_monitor_gate`** 仅为示例，请换成你的实际绝对路径。
 
+拉取代码后，若目录下尚无 `.env`：
+
+```bash
+cp -n .env.example .env
+```
+
 ---
 
 ## 2. 配置 SSH 私钥与 `~/.ssh/config`
@@ -109,11 +115,32 @@ export PYTHONDONTWRITEBYTECODE=1
 
 ---
 
-## 5. 配置 `.env`（关键：Gate + 代理）
+## 5. 配置环境变量（`.env.example` → `.env`）
 
-项目通过 `app.py` 启动时 **自动加载项目根目录的 `.env`**。与交易所相关的变量必须是 **Gate** 前缀（**不要**再写 OKX 变量，否则代理不会生效、密钥也不会被识别）。
+| 文件 | 是否进 Git | 说明 |
+|------|------------|------|
+| **`.env.example`** | ✅ 是 | 变量模板与注释，可随 `git pull` 更新 |
+| **`.env`** | ❌ 否 | 本机真实配置；`app.py` **只读此文件** |
 
-至少确认：
+### 5.1 首次配置
+
+```bash
+cd /opt/crypto_monitor/crypto_monitor_gate
+
+cp -n .env.example .env
+nano .env
+```
+
+### 5.2 备份与 `git pull`
+
+- **`.env` 不在 Git 中**：`git pull` **不会**覆盖本地 `.env`。
+- 远端若更新 **`.env.example`**，pull 后请**手动**把新增变量补进你的 `.env`。
+- **升级前备份**：`cp .env .env.backup.$(date +%Y%m%d)`；恢复：`cp .env.backup.YYYYMMDD .env`。
+- **换机**：`scp` 复制 `.env`，或新机 `cp .env.example .env` 后重填。
+
+### 5.3 必填项检查（Gate + 代理）
+
+与交易所相关的变量必须是 **Gate** 前缀（**不要**再写 OKX 变量，否则代理不会生效、密钥也不会被识别）。至少确认：
 
 ```env
 APP_HOST=127.0.0.1