docs: update

docs/deployment/agent.md

@@ -135,7 +135,10 @@ docker run -d --name openflare-agent --restart unless-stopped \
 > **非 Root 安全加固运行**
 > Agent 容器内部已完成安全加固，在启动后会统一以低权限非 root 用户 `openflare` 运行。
 > 容器已内置了 `cap_net_bind_service` 内核能力，使得低权限进程依然能够正常监听宿主机的 `80` 和 `443` 特权端口。
-> 同时，OpenResty 运行时所需的各种临时路径（包括 PID 路径、各类临时缓存目录如 `client_body_temp_path`、`proxy_temp_path` 等）都由 Agent 控制器动态渲染并自动重定向至挂载的 `/data` 数据目录，彻底避免在非 root 权限运行时写入默认系统路径而导致的权限拒绝错误（Permission Denied）。
+> 同时，OpenResty 运行时所需的各种临时路径（包括 PID 路径、各类临时缓存目录如 `client_body_temp_path`、`proxy_temp_path` 等）都由 Agent 控制器动态渲染并自动重定向至容器内的 `/data` 目录，彻底避免在非 root 权限运行时写入默认系统路径而导致的权限拒绝错误（Permission Denied）。
+> 具体物理缓存写入路径为：
+> * 临时缓存目录：`/data/var/cache/nginx`
+> * 代理缓存目录：`/data/var/cache/openflare_proxy`
 
 ## 启动与验证
 

docs/deployment/deployment.md

@@ -118,7 +118,7 @@ go run main.go all
 Docker 部署是 Agent 推荐的部署方式。Docker 部署时直接运行 Agent 镜像，该镜像基于 OpenResty 镜像制作，内置 Agent 控制器与 OpenResty 二进制。未显式配置 `node_ip` 时，Agent 会优先通过第三方 API 获取真实出口 IP，避免把 Docker 网桥地址登记为节点 IP。
 
 > [!NOTE]
-> Agent 镜像已完成非 Root 安全加固，统一以普通用户 `openflare` 权限运行，通过内核 capabilities 授权（`cap_net_bind_service`）监听 80/443 特权端口，并自动重定向临时文件和 PID 路径至挂载数据卷以防止写入冲突。
+> Agent 镜像已完成非 Root 安全加固，统一以普通用户 `openflare` 权限运行，通过内核 capabilities 授权（`cap_net_bind_service`）监听 80/443 特权端口，并自动重定向临时文件和 PID 路径至容器内 `/data` 目录以防止写入冲突。
 
 挂载配置文件：
 
@@ -127,7 +127,6 @@ docker pull ghcr.io/rain-kl/openflare-agent:latest
 docker rm -f openflare-agent 2>/dev/null || true
 docker run -d --name openflare-agent --restart unless-stopped \
   -p 80:80 -p 443:443/tcp -p 443:443/udp \
-  -v openflare-agent-data:/data \
   -v ./agent.json:/etc/openflare/agent.json:ro \
   ghcr.io/rain-kl/openflare-agent:latest
 ```

docs/deployment/relay.md

@@ -50,15 +50,21 @@ docker rm -f openflare-relay 2>/dev/null || true
 
 docker run -d --name openflare-relay --restart unless-stopped \
   -p 7000:7000 \
+  -p 17500:17500 \
   -e OPENFLARE_SERVER_URL=http://your-server:3000 \
   -e OPENFLARE_AGENT_TOKEN=YOUR_AGENT_TOKEN \
-  -v openflare-relay-data:/var/lib/openflare-relay \
+  -v openflare-relay-data:/app/data \
   ghcr.io/rain-kl/openflare-relay:latest
 ```
 
 > [!TIP]
 > 这里的 `-p 7000:7000` 映射的是 `frpc` 客户端连接中继的端口。如果管理端配置了自定义的 `relay_bind_port`，请对应修改宿主机端口映射。
 
+> [!NOTE]
+> **开启内嵌 frps Web UI**:
+> 如果在 Server 控制端开启了中继流量监控面板（即数据库/系统设置中的 `relay_frps_web_ui_enabled` 设为 `true`），你需要将 Web 端口（默认是 `17500`，由系统设置中的 `relay_frps_web_ui_port` 控制）也通过 `-p 17500:17500` 映射到宿主机。
+> 登录 Web UI 时的用户名固定为 `admin`，密码为当前中继节点的 `agent_token`。
+
 ---
 
 ## 宿主机手动运行

docs/deployment/server.md

@@ -41,9 +41,9 @@ services:
       DB_ENABLED: "false" # 禁用 PostgreSQL，自动启用内置 SQLite 后备
       SQLITE_PATH: "/data/openflare.db"
       REDIS_ENABLED: "true"
-      REDIS_ADDRS: "redis:6379"
+      REDIS_ADDR: "redis:6379"
       CLICKHOUSE_ENABLED: "true"
-      CLICKHOUSE_HOSTS: "clickhouse:9000"
+      CLICKHOUSE_HOST: "clickhouse:9000"
     depends_on:
       redis:
         condition: service_healthy

docs/deployment/upgrade.md

@@ -17,15 +17,4 @@ docker compose up
 
 ## Agent 升级
 
-Agent 可以随意升级，升级后会在下次心跳时自动拉取最新配置。升级方式：
-
-```
-docker pull ghcr.io/rain-kl/openflare-agent:beta
-docker rm -f openflare-agent 2>/dev/null || true
-docker run -d --name openflare-agent --restart unless-stopped \
-  -p 80:80 -p 443:443/tcp -p 443:443/udp \
-  -e OPENFLARE_SERVER_URL=<OPENFLARE_SERVER_URL> \
-  -e OPENFLARE_AGENT_TOKEN=<OPENFLARE_AGENT_TOKEN> \
-  ghcr.io/rain-kl/openflare-agent:beta
-  
-```
+Agent 是完全无状态的，升级时直接拉取最新镜像重建容器即可。具体部署命令与安装方式请参考 **[接入 Agent](./agent.md)**。