You need to enable JavaScript to run this app. 如何让gRPC服务端仅监听IPv4地址
优惠活动
大模型
产品
解决方案
定价
更多

如何让gRPC服务端仅监听IPv4地址

问题根因

你遇到的现象是Linux系统默认开启IPv4/IPv6双栈绑定导致的:默认配置下,监听IPv6套接字的程序可以同时接收IPv4和IPv6的连接请求,IPv4地址会被映射为::ffff:IPv4格式的IPv6地址,因此哪怕你指定监听IPv4地址,gRPC底层默认优先使用双栈模式,lsof也会显示为IPv6监听记录。


方案1:修改代码强制禁用IPv6(推荐,无系统全局影响)

创建gRPC服务端时传入grpc.enable_ipv6参数关闭IPv6支持,即可强制服务仅在IPv4栈上运行,修改后的代码如下:

from concurrent import futures
import grpc

# 你的其他业务代码省略
server = grpc.server(
    futures.ThreadPoolExecutor(max_workers=10),
    # 追加options参数,关闭IPv6支持
    options=(("grpc.enable_ipv6", 0),)
)
protoc_pb2_grpc.add_ProtocServicer_to_server(StockProtocServicer(), server)
server.add_insecure_port("0.0.0.0:5000")
server.start()

修改后重启服务,执行lsof -i -n -P | grep 5000即可看到监听记录变为IPv4类型。


方案2:修改系统全局双栈配置(不推荐,影响所有程序)

如果不想修改代码,可以执行如下命令关闭系统的双栈映射功能,后续所有监听IPv6的程序将仅接收IPv6请求,监听IPv4的程序仅接收IPv4请求:

# 临时生效,重启后恢复
echo 1 > /proc/sys/net/ipv6/bindv6only

# 永久生效,写入配置文件
echo "net.ipv6.bindv6only = 1" >> /etc/sysctl.conf
sysctl -p

改完后重启你的gRPC服务即可生效。


内容的提问来源于stack exchange,提问作者rez

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 01:15:06