修正env

crypto_monitor_binance/.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_binance/README.md

@@ -24,9 +24,12 @@ pip install flask requests ccxt werkzeug PySocks Pillow
 
 页面上的 **「当日资金(交易账户)」** 与 **「可开仓」可用 U** 仅统计 **Binance U 本位永续合约账户**（`fetch_balance` 的 `swap` / FAPI `assets` 中的 USDT），**不会**再用现货余额顶替。
 
-## 配置说明（`.env`）
+## 配置说明（`.env.example` → `.env`）
 
-项目启动时会加载**项目根目录**下的 `.env`。与 Binance 相关的常用变量：
+- **`.env.example`**：模板（可提交 Git）；首次：`cp .env.example .env` 后编辑。
+- **`.env`**：本机真实配置（勿提交）；`app.py` 只读此文件。`git pull` 不覆盖 `.env`；升级前可 `cp .env .env.backup.$(date +%Y%m%d)`。
+
+与 Binance 相关的常用变量：
 
 | 变量 | 说明 |
 |------|------|
@@ -39,7 +42,7 @@ pip install flask requests ccxt werkzeug PySocks Pillow
 | `EXCHANGE_DISPLAY_NAME` | 页面展示的交易所名称，默认 `Binance` |
 | `BINANCE_ACCOUNT_LABEL` | 推送文案中的账户备注 |
 
-其余变量（登录、企业微信、风控参数、数据库路径等）见仓库内 **`.env` 示例注释** 或 `app.py` 顶部默认值。
+其余变量（登录、企业微信、风控参数、数据库路径等）见 **`.env.example` 内注释** 或 `app.py` 顶部默认值。
 
 ## 本地运行
 

crypto_monitor_binance/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_binance/使用说明.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_binance/部署文档.md

@@ -30,12 +30,18 @@
 ```bash
 mkdir -p /opt/crypto_monitor
 cd /opt/crypto_monitor
-# git clone ... 或解压同步的包
-cd crypto_monitor_binance
+git clone https://git.bz121.com/dekun/crypto_monitor.git
+cd crypto_monitor/crypto_monitor_binance
 ```
 
 下文用 **`/opt/crypto_monitor/crypto_monitor_binance`** 仅为示例，请换成你的实际绝对路径。
 
+拉取代码后，若目录下尚无 `.env`，先从模板生成（**勿**把填好密钥的 `.env` 提交 Git）：
+
+```bash
+cp -n .env.example .env    # -n：已存在 .env 时不覆盖
+```
+
 ---
 
 ## 2. 配置 SSH 私钥与 `~/.ssh/config`
@@ -112,11 +118,38 @@ export PYTHONDONTWRITEBYTECODE=1
 
 ---
 
-## 5. 配置 `.env`（关键：Binance + 代理）
+## 5. 配置环境变量（`.env.example` → `.env`）
 
-项目通过 `app.py` 启动时 **自动加载项目根目录的 `.env`**。与交易所相关的变量使用 **`BINANCE_`** 前缀（与代码一致）。
+| 文件 | 是否进 Git | 说明 |
+|------|------------|------|
+| **`.env.example`** | ✅ 是 | 变量模板与注释，可随 `git pull` 更新 |
+| **`.env`** | ❌ 否 | 本机真实配置；`app.py` **只读此文件** |
 
-至少确认：
+### 5.1 首次配置
+
+```bash
+cd /opt/crypto_monitor/crypto_monitor_binance
+
+cp -n .env.example .env    # 已存在 .env 时不覆盖
+nano .env                  # 填入 API、登录密码、端口、代理等
+```
+
+### 5.2 备份与 `git pull`
+
+- **`.env` 已被仓库根目录 `.gitignore` 忽略**：`git pull` **不会**覆盖或删除你本地的 `.env`。
+- 若远端更新了 **`.env.example`**（新增变量名），pull 后请对照模板，**手动把新行补进你的 `.env`**（不会自动合并进 `.env`）。
+- **建议在每次 `git pull` 或大批量改配置前备份**：
+
+```bash
+cp .env .env.backup.$(date +%Y%m%d)
+# 恢复示例：cp .env.backup.20260516 .env
+```
+
+- **换机 / 迁移**：用 `scp` 复制整份 `.env` 到新机器对应目录；或在新机重新 `cp .env.example .env` 后填写。
+
+### 5.3 必填项检查（Binance + 代理）
+
+与交易所相关的变量使用 **`BINANCE_`** 前缀（与代码一致）。至少确认：
 
 ```env
 APP_HOST=127.0.0.1