diff --git a/gate_order_executor/config.example.yaml b/gate_order_executor/config.example.yaml
index 876cd22..478c6ad 100644
--- a/gate_order_executor/config.example.yaml
+++ b/gate_order_executor/config.example.yaml
@@ -61,3 +61,6 @@ database:
 proxy:
   enabled: true
   url: "socks5h://127.0.0.1:1080"
+
+# ⚠️ NAV_ALLOW_EMBED / NAV_EMBED_ORIGINS 是「进程环境变量」，不要写在本文件！
+# 请配置在 PM2 deploy/ecosystem.config.cjs 的 env 段，或 systemd Environment=。
diff --git a/gate_order_executor/deploy/ecosystem.config.cjs b/gate_order_executor/deploy/ecosystem.config.cjs
index 3001b8f..39c99b4 100644
--- a/gate_order_executor/deploy/ecosystem.config.cjs
+++ b/gate_order_executor/deploy/ecosystem.config.cjs
@@ -32,6 +32,9 @@ module.exports = {
       time: true,
       env: {
         PYTHONUNBUFFERED: "1",
+        // 本地导航 iframe 嵌入（勿写进 config.yaml，须在此或 pm2 ecosystem）
+        // NAV_ALLOW_EMBED: "true",
+        // NAV_EMBED_ORIGINS: "http://192.168.8.6:5070",
       },
     },
   ],
diff --git a/onchain_scout_gate/config.example.yaml b/onchain_scout_gate/config.example.yaml
index bd46c6f..1fc28d2 100644
--- a/onchain_scout_gate/config.example.yaml
+++ b/onchain_scout_gate/config.example.yaml
@@ -96,3 +96,5 @@ daily_report:
   run_time_cn: "08:30"
   push_wecom: true
   run_on_startup: false
+
+# ⚠️ NAV_ALLOW_EMBED / NAV_EMBED_ORIGINS 是进程环境变量，勿写在本文件；见 deploy/ecosystem.config.cjs
diff --git a/onchain_scout_gate/deploy/ecosystem.config.cjs b/onchain_scout_gate/deploy/ecosystem.config.cjs
index cc5d08b..d31e83a 100644
--- a/onchain_scout_gate/deploy/ecosystem.config.cjs
+++ b/onchain_scout_gate/deploy/ecosystem.config.cjs
@@ -31,6 +31,9 @@ module.exports = {
       time: true,
       env: {
         PYTHONUNBUFFERED: "1",
+        // 本地导航 iframe 嵌入（勿写进 config.yaml，须在此或 pm2 ecosystem）
+        // NAV_ALLOW_EMBED: "true",
+        // NAV_EMBED_ORIGINS: "http://192.168.8.6:5070",
       },
     },
   ],
diff --git a/部署说明.md b/部署说明.md
index d299c3c..228526b 100644
--- a/部署说明.md
+++ b/部署说明.md
@@ -432,9 +432,10 @@ pm2 save
 | 扫描端 | 8088 | `/dashboard` |
 | 执行器 | 8090 | `/dashboard` |
 
-**云上（PM2 / systemd 环境变量）** — 允许本地导航页嵌入：
+**云上（PM2 / systemd 环境变量）** — 允许本地导航页嵌入（**不要写进 config.yaml**）：
 
-```env
+```bash
+# PM2：编辑 deploy/ecosystem.config.cjs 的 env 段，然后 pm2 restart ...
 NAV_ALLOW_EMBED=true
 NAV_EMBED_ORIGINS=http://192.168.8.6:5070
 ```