# Docker 环境网络 engine 使用 Docker Engine 的用户自定义 bridge 网络,每个环境实例独占一个网络。Docker 自动选择可用网段、配置 IPv4 转发与 NAT。engine 自动读取宿主的非回环 IPv4 DNS,将解析配置只读挂载到 gVisor 环境,缺失时使用 1.1.1.1 和 8.8.8.8;无需配置 `network.json`、CNI 或手工填写 DNS。Docker 默认地址池耗尽、与现有路由冲突或宿主防火墙拦截时会明确失败,不改写其他业务网络。 `isolated` 使用 Docker `none` 网络;`public-only` 使用独立 bridge、禁用 IPv6 和网络内互通,由 engine 在启动容器前建立专用 nftables 规则: - 允许公网 TCP 22、80、443;DNS 仅允许访问创建网络时选定的解析服务器(TCP/UDP 53)。 - 拒绝宿主入站、宿主主动访问容器、其他环境、私有与保留网段、链路本地、云元数据地址。 - 自动选择的解析服务器可能是内网 DNS;解析结果不绕过 IP 访问限制。不承诺阻止 DNS 隧道或通过允许的 HTTPS 服务转发流量。 - 不自动添加内网服务例外。宿主管理员可显式配置 RFC1918 IPv4 网段;宿主本地地址仍不可访问。 网络、容器与防火墙均核对 engine 标签、实例规格摘要和网络 ID。未知同名对象拒绝接管;删除只清理本实例对象,不执行 Docker 全局 prune 或防火墙 flush。每次启动和周期检查重新核对网络并原子刷新规则;无法确认网络隔离时停止容器并报告失败。管理员主动清空规则时仍存在周期检查窗口,应先停止对应环境。 宿主预检检查 Docker API、cgroup v2 限制、专用 `monkeyai-runsc` runtime、IPv4 转发及 nftables 查询。通过才报告 `public-only`;真实互联网可达性仍取决于宿主路由、防火墙、DNS 与远端服务。 ## 私网白名单 在宿主的 `/etc/monkeyai-engine/config.json` 中设置 `"allow_private_cidrs": ["10.2.98.116/32"]`,即可允许本宿主的 `public-only` 云电脑访问这个远端私网 IP 的 TCP 服务。使用 CIDR 列表,最多 64 项,仅支持 RFC1918 IPv4;优先用 `/32`。此项按地址授权,不限业务端口;TCP/53 仍受原 DNS 规则限制。它不放行宿主本机、其他云电脑、DNAT 到私网的转发、云元数据或非白名单私网,也不改变 `isolated`。 修改宿主配置后重启 `monkeyai-engine`。规则由引擎在容器启动及运行检查时加载;缩小或撤销白名单前,请先停止受影响的云电脑(包括后台显示失败但容器仍运行的实例),再按新配置启动,避免旧规则遗留。 已有 containerd/CNI 网络不自动迁移或接管。切换前用旧 engine 删除运行实例并确认清理,持久目录保留;旧 `network.json` 不再被 Docker 驱动读取。 宿主 DNS 若返回代理 fake-IP(例如 198.18.0.0/15)或未放行的私网地址,public-only 会拒绝访问该结果。网络数量受 Docker 默认地址池限制,较大规模需由宿主管理员配置合适的 default-address-pools。