From 0d97fdc770fce5c6da0e30ac62900cd67b72d469 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=97=A9=E4=B8=8A=E8=82=9A=E5=AD=90=E7=96=BC?= Date: Thu, 27 Aug 2026 22:56:57 +0800 Subject: [PATCH] docs(zh): sync missing security subsections into README_zh (#5029) The English Security Notice has four subsections; the Chinese one had two. Translate the two that were missing: - Gateway Admin Is Equivalent to Code Execution - Deployment Defaults Both describe deployment-time security behavior, so a stale translation leaves Chinese-speaking operators without the loopback-default and first-run-setup guidance that English readers get. Verified against the code rather than translated blind: - stdio MCP allowlist defaults to {npx, uvx} and is extended via DEER_FLOW_MCP_STDIO_COMMAND_ALLOWLIST (backend/app/gateway/routers/mcp.py) - entry port publishes as ${BIND_HOST:-127.0.0.1}:${PORT:-2026} (docker/docker-compose.yaml) - /setup exists as the first-run admin creation route (frontend/src/app/(auth)/setup/page.tsx) Co-authored-by: zaoshangduziteng <309590849+zaoshangduziteng@users.noreply.github.com> --- README_zh.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README_zh.md b/README_zh.md index 2018e9880..e6e7bfc52 100644 --- a/README_zh.md +++ b/README_zh.md @@ -783,6 +783,16 @@ DeerFlow 具备**系统指令执行、资源操作、业务逻辑调用**等关 - **未授权的非法调用**：agent 功能被未授权的第三方、公网恶意扫描程序探测到，进而发起批量非法调用请求，执行系统命令、文件读写等高危操作，可能导致安全后果。 - **合规与法律风险**：若 agent 被非法调用用于实施网络攻击、信息窃取等违法违规行为，可能产生法律责任与合规风险。 +### Gateway 管理员权限等同于代码执行 + +管理员可以注册 stdio 类型的 MCP server，其命令会在 Gateway 容器内执行。API 会把可执行命令限制在一个允许清单内（默认为 `npx`、`uvx`，可通过 `DEER_FLOW_MCP_STDIO_COMMAND_ALLOWLIST` 扩展），并拒绝会导致任意代码求值的参数与环境变量。这属于纵深防御，而不是安全边界：这类启动器本身的用途就是拉取并运行远程包，因此请**将 Gateway 管理员权限视为等同于在宿主机上执行代码**，并据此谨慎授权。 + +### 部署默认值 + +Docker 部署栈默认只把入口端口发布在 `127.0.0.1` 上，与上文所述的本地可信环境模型一致。若需要从其他机器访问，请在 `.env` 中设置 `BIND_HOST`（例如 `BIND_HOST=0.0.0.0`），并且必须在落实下方的安全措施之后再这样做。 + +**请在主机变为可访问之前完成首次初始化设置。** 全新实例尚未创建任何账号，因此对于任何非仅回环访问的部署，请在启动后立即通过 `/setup` 创建管理员账号。 + ### 安全使用建议 **注意：建议您将 DeerFlow 部署在本地可信的网络环境下。** 若您有跨设备、跨网络的部署需求，必须加入严格的安全措施。例如，采取如下手段：