From 43a87cf7cca55ad252a5b639fd88c09b990b6963 Mon Sep 17 00:00:00 2001
From: wangbo <wangbolhr@163.com>
Date: Mon, 2 Mar 2026 11:38:29 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=89=8D=E7=AB=AF=E6=96=B0=E5=A2=9E=20?=
 =?UTF-8?q?NUXT=5FPUBLIC=5FSG=5FAPIURL=20=E7=8E=AF=E5=A2=83=E5=8F=98?=
 =?UTF-8?q?=E9=87=8F=E6=94=AF=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- docker-compose.yml comfyAI-web 容器新增 NUXT_PUBLIC_SG_APIURL 环境变量
- .env.sample 新增 NUXT_PUBLIC_SG_APIURL 配置项及说明
- README.md 升级步骤补充前端环境变量配置说明

Made-with: Cursor
---
 .env.sample        |  4 ++++
 README.md          | 12 ++++++++++++
 docker-compose.yml |  2 ++
 3 files changed, 18 insertions(+)

diff --git a/.env.sample b/.env.sample
index 220faa0..e9c7ca6 100644
--- a/.env.sample
+++ b/.env.sample
@@ -9,6 +9,10 @@ NUXT_PUBLIC_BASE_APIURL=http://127.0.0.1:3001
 NUXT_PUBLIC_BASE_SOCKETURL=ws://127.0.0.1:3002
 #域名访问使用如下配置，配置为/,并代理/socket.io请求到3002端口
 #NUXT_PUBLIC_BASE_SOCKETURL=wss://yourwebsite.com/socket.io
+# Agent 服务治理 API 地址，前端管理页面需要。IP访问填http://<IP>:3003，域名访问填/asg-api
+NUXT_PUBLIC_SG_APIURL=http://127.0.0.1:3003
+#域名访问使用如下配置，通过nginx代理转发
+#NUXT_PUBLIC_SG_APIURL=/asg-api
 
 #############################################
 #2、以下部分可保持默认，如果没有端口冲突，生产环境可修改密码
diff --git a/README.md b/README.md
index 0228931..2fc3268 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,7 @@
 2. **新增 Nginx 反向代理**：在 `easyai-proxy.conf.sample` 中新增 `/asg-api/` 路径代理，用于暴露 ASG 服务的 REST API。
 3. **新增环境变量文件**：新增 `.env.ASG.sample` 文件，包含 ASG 服务所需的全部环境变量。
 4. 主服务 `comfy-server` 新增 `ASG_TCP_HOST` 和 `ASG_TCP_PORT` 环境变量，用于内部 TCP 微服务通信。
+5. **前端新增环境变量**：`.env` 中新增 `NUXT_PUBLIC_SG_APIURL`，用于前端治理管理页面调用 ASG API。
 
 #### 升级步骤
 
@@ -16,10 +17,21 @@
 将以下文件更新到最新版本：
 - `docker-compose.yml`
 - `easyai-proxy.conf.sample`
+- `.env.sample`（新增 `NUXT_PUBLIC_SG_APIURL`）
 
 新增文件复制到部署目录：
 - `.env.ASG.sample` → 复制为 `.env.ASG` 并根据实际环境修改
 
+**步骤 1.5：配置 `.env` 新增变量**
+
+在 `.env` 文件中添加 ASG 前端 API 地址：
+```dotenv
+# IP 直接访问方式
+NUXT_PUBLIC_SG_APIURL=http://<你的服务器IP>:3003
+# 域名 + Nginx 代理方式（需要配置步骤三的 Nginx 代理）
+#NUXT_PUBLIC_SG_APIURL=/asg-api
+```
+
 **步骤二：配置 `.env.ASG`**
 
 ```bash
diff --git a/docker-compose.yml b/docker-compose.yml
index 9e0310e..3f459a7 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -29,6 +29,8 @@ services:
       # 默认的服务器websocket地址，本地不需要更改，云服务需要修改为云端IP，并放行对应端口
       - NUXT_PUBLIC_BASE_SOCKETURL=${NUXT_PUBLIC_BASE_SOCKETURL}
       - NUXT_APP_CDN_URL=${NUXT_APP_CDN_URL}
+      # Agent 服务治理 API 地址（前端直接调用，走 Nginx 代理时配置为 /asg-api）
+      - NUXT_PUBLIC_SG_APIURL=${NUXT_PUBLIC_SG_APIURL}
     # 日志大小设置，避免日志文件过大
     env_file:
       - .env