FRP 服务端 IPv4 监听问题解析

问题背景

在使用 FRP 项目时，用户发现即使配置文件中明确指定了 bindAddr = "0.0.0.0"，FRP 服务端仍然会监听 IPv6 接口（显示为 :::7000）。这引发了关于 FRP 网络监听行为的疑问。

技术原理

双栈监听机制

现代 Linux 系统默认启用 IPv6 双栈功能。当应用程序监听 ::（IPv6 任意地址）时，如果没有设置 IPV6_V6ONLY 套接字选项，系统会自动允许该套接字同时接受 IPv4 和 IPv6 连接。这是操作系统层面的行为，而非 FRP 特有的实现。

0.0.0.0 与 :: 的关系

• 0.0.0.0 是 IPv4 的"任意地址"表示
• :: 是 IPv6 的"任意地址"表示
• 在双栈系统中，监听 :: 通常意味着同时监听 IPv4 和 IPv6

FRP 的实现细节

FRP 服务端在启动时会根据配置绑定到指定地址和端口。从日志可以看到，FRP 确实按照配置尝试在 0.0.0.0:7000 上监听，但系统底层将其映射到了双栈监听模式。

解决方案

如果需要强制只使用 IPv4，有以下几种方法：

1. 使用具体 IPv4 地址：在配置中指定服务器的具体 IPv4 地址而非 0.0.0.0

2. 系统级配置：

   • 禁用系统的 IPv6 功能
   • 设置 net.ipv6.bindv6only=1 系统参数

3. 应用级配置：

   • 如果 FRP 支持，可以设置 IPV6_V6ONLY 套接字选项

实际影响评估

虽然显示为 IPv6 监听，但实际上 IPv4 客户端仍然可以正常连接。这种双栈监听行为不会影响 FRP 的正常功能使用，只是显示上的区别。

最佳实践建议

对于大多数使用场景，保持默认的双栈监听是最佳选择，这样可以同时支持 IPv4 和 IPv6 客户端。只有在特定需要限制仅 IPv4 的环境中，才需要考虑上述强制 IPv4 的方案。