修正env

2026-05-16 23:39:37 +08:00
parent a86d1a44dd
commit eb32ec70b5
22 changed files with 250 additions and 40 deletions
@@ -30,7 +30,7 @@

 ### 与四个 `crypto_monitor_*` 目录的关系（已对照 `app.py`）

-各策略项目在**本目录**加载 `.env`（`load_env_file`），并用其中的 **`APP_HOST` / `APP_PORT`** 启动 **Flask 网页**（`app.py` 里 `HOST`、`PORT`）。这是你在浏览器里打开策略/监控后台用的端口，例如你截图里的 `APP_PORT=5001`。
+各策略项目在**本目录**用 **`.env`**（由 **`cp .env.example .env`** 生成，勿提交 Git；`git pull` 不覆盖）加载配置（`load_env_file`），并用其中的 **`APP_HOST` / `APP_PORT`** 启动 **Flask 网页**（`app.py` 里 `HOST`、`PORT`）。这是你在浏览器里打开策略/监控后台用的端口，例如 `APP_PORT=5001`。

 子代理 **不用 `APP_PORT`**，而是用环境变量 **`PORT`**（FastAPI/uvicorn 监听）。若子代理与 Flask 抢同一端口，后启动的会起不来，因此中控默认把子代理配在 **`15200`～`15203`**，与常见 `5000` 段 Flask 配置**错开**。

@@ -3,7 +3,7 @@
 # 用法：在任意目录执行  bash /path/to/manual_trading_hub/scripts/start_agents_3screen.sh
 # 若 hub 单独在 /opt/manual_trading_hub，四个策略目录在别的路径，请先：
 #   export MANUAL_TRADING_REPO_ROOT=/path/to/含_crypto_monitor_*_的目录
-# 依赖：各策略目录下存在 .env；manual_trading_hub/.venv 已 pip install -r requirements.txt
+# 依赖：各策略目录已 cp .env.example .env 并配置；manual_trading_hub/.venv 已 pip install -r requirements.txt
 # 日志：manual_trading_hub/logs/<会话名>.log（若 screen 里进程秒退，tail 该文件排查）
 # 查看：screen -ls    接入：screen -r mt-agent-bn   停：./stop_agents_3screen.sh

@@ -1,5 +1,7 @@
 # Ubuntu 后台运行（中控 + 子代理）

+各 `crypto_monitor_*` 策略目录：首次 **`cp .env.example .env`** 并编辑；**`.env` 不进 Git**，`git pull` 不覆盖。升级前建议 `cp .env .env.backup.$(date +%Y%m%d)`。子代理启动前须 **`source` 该目录 `.env`**（见下文）。
+
 前台跑 `python agent.py` / `python hub.py` 时，关掉终端进程会结束。要**常驻后台**，可用下面三种之一（推荐 **systemd**）。

 ---
@@ -15,7 +15,7 @@
 ## 二、前置条件

 1. 已安装 **Python 3.10+**，且 `pip` 可用。
-2. 各策略目录下已配置好交易所 API（与平时运行 Flask 时相同的 `.env` 或环境变量）。各项目 `app.py` 会读取同目录 `.env` 中的 **`APP_HOST` / `APP_PORT`** 用于 **Flask**；子代理使用环境变量 **`PORT`**，二者不能占用同一端口。
+2. 各策略目录下已配置好交易所 API：在对应 `crypto_monitor_*` 目录执行过 **`cp .env.example .env`** 并填好密钥（与平时运行 Flask 时同一份 **`.env`**，或等价环境变量）。各项目 `app.py` 会读取同目录 `.env` 中的 **`APP_HOST` / `APP_PORT`** 用于 **Flask**；子代理使用环境变量 **`PORT`**，二者不能占用同一端口。策略目录的 **`.env` 不在 Git 中**，`git pull` 不会覆盖；升级前建议在各策略目录 `cp .env .env.backup.$(date +%Y%m%d)`。
 3. 本机端口 **`15200`～`15203`、5100**（及你各策略 `.env` 里的 `APP_PORT`）无冲突；若被占用，须改子代理 `PORT` 并同步修改 `HUB_AGENTS`。
 4. **Linux 路径约定（可选）**：若部署在 Ubuntu 等环境，建议将整个代码树放在 **`/opt/crypto_monitor/`** 下（与 `scripts/后台运行-Ubuntu.md` 示例一致），例如策略目录为 `/opt/crypto_monitor/crypto_monitor_binance`、中控为 `/opt/crypto_monitor/manual_trading_hub`。

@@ -172,8 +172,9 @@ Windows 可将 `hub.py` 与各 `agent.py` 写入「启动」文件夹，或使

 ## 九、升级与回滚

- **升级**：在 `manual_trading_hub` 下 `git pull`（若使用 Git）后，重新 `pip install -r requirements.txt` 即可。
- **回滚**：恢复上一版本代码与依赖；配置仅环境变量与浏览器 localStorage，无数据库。
+- **升级**：在仓库根目录 `git pull` 后，于 `manual_trading_hub` 重新 `pip install -r requirements.txt`（若依赖有变）。**各策略目录 `.env` 不会被 pull 覆盖**；若 `.env.example` 有新增变量，请对照模板**手动补进**你的 `.env`。
+- **升级前备份（推荐）**：在每个用到的 `crypto_monitor_*` 目录执行 `cp .env .env.backup.$(date +%Y%m%d)`。
+- **回滚**：恢复上一版本代码与依赖；配置在各策略 `.env` 与浏览器 localStorage，无中控数据库。

 ---