综合 安全默认值收紧后,监听地址在哪一层被改回去:OTel Collector v0.104 与 EMQX 6.3 对照

2026-11-17 00:04:16

安全默认值收紧后,监听地址在哪一层被改回去:OTel Collector v0.104 与 EMQX 6.3 对照

本文只讨论一件事:进程监听地址的默认值从 0.0.0.0 收紧以后,在交付链路上被哪一层放宽了。不涉及 PHP 会话配置默认值(#8590)或 llama.cpp API 参数默认值(#8597)那类进程内配置项。

现象

OpenTelemetry Collector 在 v0.103.0 之前,所有 server 默认拿未指定地址 0.0.0.0 监听全部网卡;v0.104.0 起默认绑定改为 localhost,OTLP receiver 的 OTLP/gRPC 与 OTLP/HTTP 端点分别落在 localhost:4317 与 localhost:4318。

EMQX 6.3 的 hardened 方案同样收紧:MQTT 监听器与 Dashboard HTTP 监听器在 bind 省略、或只写端口时,只监听回环地址,要接受外部连接必须写显式地址,例如 bind = "0.0.0.0:1883"。

但同一份 EMQX 文档写明了覆盖点:官方 Docker 镜像的入口脚本在 EMQX_NODE__DEFAULT_LISTENER_ADDRESS 未设置或为空时,会把它设为 all。于是 hardened 对 bind 的要求在镜像层被直接放宽,容器内所有监听器仍绑到全部网卡。

链路由此分成三层:二进制/应用默认 → 打包与镜像 → 端口发布与 NAT。

第一层:二进制与应用默认

OTel 的收紧有完整时间线。讨论自 CVE-2022-27664 起;v0.63.0(2022-09)加警告并改进文档;v0.94.0(2023-09)引入特性门 component.UseLocalHostAsDefaultHost,允许主动选择新行为;该门在 v0.104.0(2024-06)默认启用,受安全审计与 CVE-2024-36129 推动。受影响的组件是一份长名单:

  • receivers:otlp、awsfirehose、awsxray、influxdb、jaeger、loki、opencensus、sapm、signalfx、skywalking、splunk_hec、zipkin、zookeeper
  • extensions:awsproxy、health_check、jaegerremotesampling
  • processors:remotetap

需要覆盖默认值的写法是显式给 endpoint:

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: ${env:HOST_IP}:4317

HOST_IP 设成要绑的地址,如 Kubernetes 的 status.podIP。自 v0.63.0 起,endpoint 写 0.0.0.0 时 Collector 会记录警告——只是警告,不是拒绝。

EMQX 6.3 起提供节点级安全配置方案,由环境变量 EMQX_SECURITY_PROFILE 选择:legacy(默认,保持早期版本行为)、hardened(更严格),计划 7.0 起默认 hardened。该文件位置按安装形态区分:rpm/deb 为 /etc/emqx/emqx.env,Docker 镜像为 /opt/emqx/etc/emqx.env,tar.gz 为 etc/emqx.env。emqx 命令每次调用都会加载它,启动时读一次,发生在解析配置文件之前,因此无法在配置文件里设置;只接受 legacy / hardened / 空,其他值节点启动失败;集群每个节点必须一致。

hardened 除 bind 之外的行为变化:

  • 拒绝内置默认 cookie 与常见示例值 emqxsecretcookie,需配置非默认 node.cookie 或 EMQX_NODE__COOKIE
  • 必须显式配置认证,无认证器或全部禁用时拒绝客户端;某监听器要允许匿名须设 enable_authn = false
  • 认证后端故障即拒绝(后端错误、响应格式错误、前置条件求值错误、JWT 验证密钥不可用),不走下一个认证器;可用 authentication_settings.ignore_backend_failures = true 回退
  • JWT 认证器不忽略缺失的 JWT,需 on_missing_jwt = ignore
  • 混合认证链中 JWT 与密码从同一字段读取时,需 precondition = "is_jwt(password)"
  • JWKS 出站 TLS 校验证书与主机名,自签端点需在该端点设 ssl.verify = verify_none
  • 不接受 Dashboard 默认凭据,默认密码 public 无法登录(含升级前创建的管理员),切换前先改密码

Redis 是这条线上的历史对照。Redis 设计为在受信环境由受信客户端访问,不应直接暴露到互联网。自 3.2.0 起,默认配置(绑定所有接口)且无密码时进入 protected mode:只回复环回接口的查询,对其他地址返回错误说明。管理员仍可关掉保护模式或手动绑所有接口。

第二层:打包与镜像

OTel 的分发形态把默认值重新钉死。从 OpenTelemetry Collector Helm Chart v0.47.1 与官方 Docker 镜像 v0.87.0 起,所有组件的默认配置已显式设置端点值。也就是说,在这些形态里实际监听地址由 Chart values 或镜像内配置决定,二进制层的 localhost 默认不再参与决策;而一旦这个显式值是 0.0.0.0,第一层的收紧就被完全跳过。

EMQX 的覆盖更直接,机制在 node.default_listener_address。它控制未指定地址的监听器绑到哪里,取值包括 loopback(127.0.0.1,Dashboard 启用 inet6 时用 ::1)、nodename(节点名 @ 后的主机部分)、all(0.0.0.0)、具体 IP、主机名。显式 IP:port 始终优先。启动时读取一次,改动需重启。Docker 镜像的入口脚本把未设置的 EMQX_NODE__DEFAULT_LISTENER_ADDRESS 填成 all,理由写在文档里:容器的回环接口无法通过发布的端口访问。

第三层:端口发布与 NAT

到这一步,容器内绑的是 all,主机侧还有一次决定:-p 1883:1883 这类端口发布把容器端口映射到主机接口,而主机侧绑哪个地址是发布参数的事。容器内即使坚持绑回环,发布出来的端口也连不进去;容器内绑 all,主机侧再绑全接口,最终就是公网可达。

Redis 缺的正是这一层的对照:protected mode 只在应用层生效,条件是「默认配置且无密码」。bind 被改成全接口、或者加了密码、或者手动关掉保护,保护就退出,后面没有任何一层再拦一次。

可复核命令

不要靠读配置判断实际监听,直接看套接字。Ubuntu 自 6.06 LTS 起遵循「无开放端口」策略:默认安装不应有监听网络服务,极少数例外需经技术委员会与安全团队批准,软件包或发行版升级也不得暴露之前未暴露的信息。这条策略可以作为基线对照。

ss -utln | grep -vE '127\.0\.0|\[::1\]'
sudo ss -utlnp | grep -vE '127\.0\.0|\[::1\]'

先跑在容器内(看得到 0.0.0.0:4317 还是 127.0.0.1:4317),再跑在主机上(看发布端口落在哪个地址)。两处结果不一致,就是中间某层做了覆盖。

互斥与失效点

  • OTel:v0.104.0 起可禁用 component.UseLocalHostAsDefaultHost 暂时退出该变更,但该门未来会标记稳定,禁用只是延后。显式 endpoint 永远压过默认值,写 0.0.0.0 只有一条警告。
  • EMQX:只在配置里写端口、不写地址,不会把 bind 持久化为 IP:port,因此相同配置的节点可能监听不同地址——这是排查时最容易漏掉的一处。EMQX_SECURITY_PROFILE 启动读一次,运行期无法切换;集群节点取值不一致会直接失效。
  • Redis:protected mode 的前提是「默认配置且无密码」,任意一条被改即退出保护。另外 CONFIG 命令可修改工作目录与 dump 文件名,从而把 RDB 写到任意路径,Redis 本身不需 root 权限,建议用非特权用户运行;AUTH 明文传输,无法防御能窃听的攻击者。
  • 发行版侧的「无开放端口」策略约束的是打包与安装阶段,管不到运行期被改写后的监听状态。

取舍

收紧默认值拦的是误配置:不写 endpoint 就只听本机,是最省事的正确行为。容器镜像放宽它,是因为「端口发布要能访问」是刚性需求,回环地址在 NAT 后面等于不可用。两者都没错,冲突点在于放宽发生在用户看不见的层——入口脚本、Chart values、端口发布参数。

所以可操作的做法只有一条:把这三处的显式地址当配置项管理,让镜像层端点、EMQX_NODE__DEFAULT_LISTENER_ADDRESS、发布端口的绑定地址都能进 review,而不是在安全方案勾了 hardened 之后就认为默认值已经生效。EMQX 的 node.default_listener_address 说明了这种设计的两面性:显式优先既是逃生口,也是唯一的审计口。

参考文档:

推荐文章

程序员茄子在线接单