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>
This commit is contained in:
早上肚子疼 2026-08-27 22:56:57 +08:00 committed by GitHub
parent 9e2c1be697
commit 0d97fdc770
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -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 部署在本地可信的网络环境下。** 若您有跨设备、跨网络的部署需求,必须加入严格的安全措施。例如,采取如下手段: