feat(web): add web_host config and password hint for safer deployment

README.md

@@ -204,7 +204,8 @@ cow install-browser
   "group_speech_recognition": false,                          # 是否开启群组语音识别
   "voice_reply_voice": false,                                 # 是否使用语音回复语音
   "use_linkai": false,                                        # 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台模型
-  "web_password": "",                                         # Web 控制台访问密码，留空则不启用密码保护
+  "web_host": "0.0.0.0",                                      # Web 控制台监听地址，设为 "127.0.0.1" 表示仅本机可访问
+  "web_password": "",                                         # Web 控制台访问密码，留空则不启用密码保护（公网部署强烈建议设置）
   "agent": true,                                              # 是否启用 Agent 模式，启用后拥有多轮工具决策、长期记忆、Skills 能力等
   "agent_workspace": "~/cow",                                 # Agent 的工作空间路径，用于存储 memory、skills、系统设定等
   "agent_max_context_tokens": 50000,                          # Agent 模式下最大上下文 tokens，超出将自动智能压缩处理
@@ -719,6 +720,7 @@ Coding Plan 是各厂商推出的编程包月套餐，所有厂商均可通过 O
 }
 ```
 
+- `web_host`: 默认为 `0.0.0.0`（所有网卡可访问），如只在本机使用可改为 `127.0.0.1` 仅监听本地
 - `web_port`: 默认为 9899，可按需更改，需要服务器防火墙和安全组放行该端口
 - `web_password`: 访问密码，留空则不启用密码保护。部署在公网环境时建议设置
 - 如本地运行，启动后请访问 `http://localhost:9899/chat` ；如服务器运行，请访问 `http://ip:9899/chat` 

channel/web/web_channel.py

@@ -696,7 +696,10 @@ class WebChannel(ChatChannel):
             return f.read()
 
     def startup(self):
+        host = conf().get("web_host", "0.0.0.0")
         port = conf().get("web_port", 9899)
+        # Treat wildcard binds as public exposure for the security hint below.
+        is_public_bind = host in ("0.0.0.0", "", "::")
 
         # 打印可用渠道类型提示
         logger.info(
@@ -712,7 +715,10 @@ class WebChannel(ChatChannel):
         logger.info("[WebChannel]   9. wechatmp_service - 企业公众号")
         logger.info("[WebChannel] ✅ Web控制台已运行")
         logger.info(f"[WebChannel] 🌐 本地访问: http://localhost:{port}")
+        if is_public_bind:
             logger.info(f"[WebChannel] 🌍 服务器访问: http://YOUR_IP:{port} (请将YOUR_IP替换为服务器IP)")
+            if not _is_password_enabled():
+                logger.info("[WebChannel] 提示：当前未设置 web_password，如需公网部署请配置访问密码")
 
         try:
             import webbrowser
@@ -772,7 +778,7 @@ class WebChannel(ChatChannel):
         # Build WSGI app with middleware (same as runsimple but without print)
         func = web.httpserver.StaticMiddleware(app.wsgifunc())
         func = web.httpserver.LogMiddleware(func)
-        server = web.httpserver.WSGIServer(("0.0.0.0", port), func)
+        server = web.httpserver.WSGIServer((host, port), func)
         server.daemon_threads = True
         # Default request_queue_size(5) / timeout(10s) / numthreads(10) are
         # too small: when SSE streams occupy many threads, the backlog fills

config.py

@@ -205,6 +205,7 @@ available_setting = {
     "Minimax_base_url": "",
     "deepseek_api_key": "",
     "deepseek_api_base": "https://api.deepseek.com/v1",
+    "web_host": "0.0.0.0",  # Web console bind address; set to "127.0.0.1" to restrict access to localhost only
     "web_port": 9899,
     "web_password": "",  # Web console password; empty means no authentication required
     "web_session_expire_days": 30,  # Auth session expiry in days

docs/channels/web.mdx

@@ -10,6 +10,7 @@ Web 控制台是 CowAgent 的默认通道，启动后会自动运行，通过浏
 ```json
 {
   "channel_type": "web",
+  "web_host": "0.0.0.0",
   "web_port": 9899,
   "web_password": "",
   "enable_thinking": false
@@ -19,6 +20,7 @@ Web 控制台是 CowAgent 的默认通道，启动后会自动运行，通过浏
 | 参数 | 说明 | 默认值 |
 | --- | --- | --- |
 | `channel_type` | 设为 `web` | `web` |
+| `web_host` | Web 服务监听地址，设为 `127.0.0.1` 表示仅本机可访问 | `0.0.0.0` |
 | `web_port` | Web 服务监听端口 | `9899` |
 | `web_password` | 访问密码，留空表示不启用密码保护 | `""` |
 | `web_session_expire_days` | 登录会话有效天数 | `30` |
@@ -26,6 +28,10 @@ Web 控制台是 CowAgent 的默认通道，启动后会自动运行，通过浏
 
 配置密码后，访问控制台时需先输入密码完成登录。登录状态默认保持 30 天，期间重启服务也无需重新登录。密码也支持在控制台的「配置」页面中在线修改。
 
+<Note>
+  默认监听 `0.0.0.0`（所有网卡可访问），方便本机和局域网/服务器场景开箱即用。**部署到公网时务必设置 `web_password`**，或将 `web_host` 改为 `127.0.0.1` 仅允许本机访问。控制台启动时会自动检测并提示这一风险。
+</Note>
+
 ## 访问地址
 
 启动项目后访问：