C# 中监听 IPv6 回环地址（Loopback Address）----socket和tcp

在 C# 中监听 IPv6 回环地址（Loopback Address），通常指的是绑定到 ::1 这个特定地址，或者使用通配符地址 :: 并配合选项来实现。

以下是几种实现方式和关键注意事项：

🎯 核心实现方式

1. 直接监听 IPv6 回环地址 ::1

这是最直接的方式，服务将只接受来自本机的 IPv6 连接。

using System;

using System.Net;

using System.Net.Sockets;

// 创建一个只监听 IPv6 回环地址 (::1) 的 Socket

IPAddress ipv6Loopback = IPAddress.IPv6Loopback; // 等同于 IPAddress.Parse("::1")

IPEndPoint endPoint = new IPEndPoint(ipv6Loopback, 端口号);

Socket listener = new Socket(AddressFamily.InterNetworkV6, SocketType.Stream, ProtocolType.Tcp);

listener.Bind(endPoint);

listener.Listen(10);

Console.WriteLine("正在监听 [::1]:端口号");

1. 监听所有 IPv6 地址，但仅限 IPv6 (IPV6_V6ONLY)

如果你希望服务监听本机所有 IPv6 地址（包括回环 ::1 和其他网卡的 IPv6 地址），但不希望它同时接受 IPv4 连接（即关闭“双栈”功能），可以使用 IPv6Only 设置。

using System;

using System.Net;

using System.Net.Sockets;

// 监听所有 IPv6 地址 (::)

IPAddress ipv6Any = IPAddress.IPv6Any; // 等同于 IPAddress.Parse("::")

IPEndPoint endPoint = new IPEndPoint(ipv6Any, 端口号);

Socket listener = new Socket(AddressFamily.InterNetworkV6, SocketType.Stream, ProtocolType.Tcp);

// 关键设置：开启 IPv6 Only 模式

// 这会阻止 IPv4 流量通过 IPv6 套接字访问（即禁用 IPv4 映射地址）

listener.SetSocketOption(SocketOptionLevel.IPv6, SocketOptionName.IPv6Only, true);

listener.Bind(endPoint);

listener.Listen(10);

Console.WriteLine("正在监听 所有IPv6地址:端口号 (IPv6 only)");

1. 使用 TcpListener (更高级的封装)

如果你使用 TcpListener 类，可以这样操作：

// 监听 IPv6 回环

TcpListener listener = new TcpListener(IPAddress.IPv6Loopback, 端口号);

listener.Start();

// 或者监听所有 IPv6 地址

// TcpListener listener = new TcpListener(IPAddress.IPv6Any, 端口号);

// listener.Server.SetSocketOption(SocketOptionLevel.IPv6, SocketOptionName.IPv6Only, true);

// listener.Start();

💡 重要概念区分

在编写代码时，请注意以下区别，以避免连接被拒绝的错误：

• ::1 (回环地址)：只能本机访问。如果你从另一台电脑尝试连接，会失败。
• :: (通配符地址)：表示“所有可用的 IPv6 接口”。如果不设置 IPv6Only，在 Windows 上它通常默认允许双栈（Dual-stack），即同时接收 IPv6 和 IPv4 连接；在 Linux 上行为可能不同，有时需要显式设置。
• IPAddress.IPv6Any：其值为 ::，用于监听所有 IPv6 地址。

🛡️ 连接测试

在启动监听后，你可以使用以下命令测试连接是否正常：

• Telnet 测试：telnet ::1 端口号
• PowerShell 测试：

Test-NetConnection -ComputerName ::1 -Port 端口号

总结建议：

如果你的需求仅仅是“本机进程间通信”，请使用 ::1 (IPAddress.IPv6Loopback)。如果你需要监听外部 IPv6 连接且不想处理 IPv4，记得设置 SocketOption 为 IPv6Only = true。