如何让Prometheus Python客户端的start_http_server支持IPv6？

核心解决思路 #

你的问题出在旧版本prometheus-client对IPv6地址的支持不完善，结合IPv6环境的需求，可通过以下几种方式解决：

方法一：升级客户端并直接指定IPv6地址

首先确保prometheus-client版本在0.14.0及以上，旧版本的start_http_server未适配IPv6地址解析逻辑。执行升级命令：

pip install --upgrade prometheus-client

然后使用以下代码启动服务：

from prometheus_client import start_http_server, Gauge
start_http_server(9669, addr='::')

新版本中addr='::'会自动识别IPv6地址族，无需额外处理方括号（方括号仅在URL中需要，而非服务绑定地址）。

方法二：手动创建IPv6套接字（兼容旧版本）

如果无法升级客户端，可手动创建IPv6套接字并传递给start_http_server：

import socket
from prometheus_client import start_http_server, Gauge

# 创建并配置IPv6套接字
sock = socket.socket(socket.AF_INET6, socket.SOCK_STREAM)
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
sock.bind(('::', 9669))
sock.listen(5)

# 通过套接字启动服务
start_http_server(sock=sock)

方法三：使用更灵活的start_wsgi_server替代

官方客户端提供的start_wsgi_server对IPv6支持更友好，可直接指定地址：

from prometheus_client import start_wsgi_server, Gauge
start_wsgi_server(9669, addr='::')

为什么之前的尝试失败 #

• 使用addr='[::]'报错：服务绑定地址不需要加方括号，方括号是HTTP URL中表示IPv6地址的语法，而非服务端绑定的格式。
• 旧版本中addr='::'报错：早期prometheus-client未自动处理IPv6地址族，需要手动指定或升级版本修复该逻辑。

内容的提问来源于stack exchange，提问作者nidooooz