Natter源码解析：STUN协议实现与端口转发机制

Natter源码解析：STUN协议实现与端口转发机制

【免费下载链接】Natter Expose your TCP/UDP port behind full-cone NAT to the Internet. 项目地址: https://gitcode.com/gh_mirrors/na/Natter

Natter是一款强大的网络工具，能够将处于全锥形NAT（Network Address Translation）后的TCP/UDP端口暴露到互联网，实现内网服务的对外访问。本文将深入解析Natter的核心源码，重点探讨STUN协议实现与端口转发机制，帮助开发者理解其工作原理与实现细节。

STUN协议实现：NAT类型检测的关键

STUN（Session Traversal Utilities for NAT）协议是Natter实现NAT穿透的基础。在Natter的源码中，natter-check/natter-check.py文件完整实现了STUN客户端功能，用于检测网络环境的NAT类型。

STUN协议常量定义

在natter-check/natter-check.py中，定义了STUN协议相关的常量和NAT类型枚举：

STUN_PORT   = 3478  # STUN协议默认端口
NAT_UNKNOWN          = -1
NAT_OPEN_INTERNET    = 0  # 公网环境，无NAT
NAT_FULL_CONE        = 1  # 全锥形NAT
NAT_RESTRICTED       = 2  # 限制锥形NAT
NAT_PORT_RESTRICTED  = 3  # 端口限制锥形NAT
NAT_SYMMETRIC        = 4  # 对称NAT
NAT_SYM_UDP_FIREWALL = 5  # 对称UDP防火墙

这些定义为后续的NAT类型检测提供了基础。

STUN协议交互流程

Natter的STUN客户端实现了RFC 3489标准的NAT类型检测流程。核心代码位于_check_udp_nat方法中，通过与多个STUN服务器交互，分析返回的网络地址信息来判断NAT类型：

# 尝试连接STUN服务器
sock.connect((stun_host, self.STUN_PORT))
# 发送STUN请求
sock.sendto(data, (stun_host, self.STUN_PORT))
# 检查STUN响应包
# ... 解析响应，提取映射后的公网地址和端口 ...

通过比较不同STUN服务器返回的映射地址，Natter能够准确判断当前网络的NAT类型，这是实现端口转发的前提。

端口转发机制：Natter的核心功能

Natter的端口转发功能主要通过natter.py实现，结合iptables工具实现Linux系统下的NAT规则配置。

iptables NAT规则配置

在natter.py中，通过调用iptables命令创建自定义的NAT链（NATTER和NATTER_SNAT），实现端口转发：

# 创建NATTER链
self.iptables_cmd + ["-t", "nat", "-N", "NATTER"]
# 将PREROUTING链的流量跳转到NATTER链
self.iptables_cmd + ["-t", "nat", "-I", "PREROUTING", "-j", "NATTER"]
# 创建NATTER_SNAT链用于源地址转换
self.iptables_cmd + ["-t", "nat", "-N", "NATTER_SNAT"]
# 将POSTROUTING链的流量跳转到NATTER_SNAT链
self.iptables_cmd + ["-t", "nat", "-I", "POSTROUTING", "-j", "NATTER_SNAT"]

这些规则的配置使得Natter能够拦截指定端口的流量，并进行转发处理。

端口转发规则添加

当用户添加端口转发规则时，Natter会在NATTER链中添加相应的DNAT（目的地址转换）规则：

# 添加DNAT规则示例
iptables_args = [
    "-t", "nat",
    "-I", "NATTER",
    "-p", proto,
    "--dport", str(public_port),
    "-j", "DNAT",
    "--to-destination", f"{local_ip}:{local_port}"
]

同时，在NATTER_SNAT链中添加SNAT（源地址转换）规则，确保返回流量能够正确路由：

# 添加SNAT规则示例
iptables_args = [
    "-t", "nat",
    "-I", "NATTER_SNAT",
    "-p", proto,
    "-d", local_ip,
    "--dport", str(local_port),
    "-j", "SNAT",
    "--to-source", public_ip
]

这种双向的地址转换机制，实现了从公网到内网服务的透明访问。

Natter的模块化设计

Natter采用模块化设计，将不同功能组织在不同的目录和文件中，提高了代码的可维护性和扩展性。

核心模块路径

• STUN协议实现：natter-check/natter-check.py
• 端口转发核心逻辑：natter.py
• Docker部署支持：natter-docker/
• MicroPython模块：micropython/

NatterUtils模块

在micropython/cmodule/natterutils/modnatterutils.c中，定义了Natter的工具函数模块，提供了端口复用等网络功能的支持：

#define NATTERUTILS_HAVE_REUSE_PORT  // 启用端口复用功能

这个模块为Natter在嵌入式环境中的运行提供了必要的网络工具支持。

实际应用与部署

Natter提供了多种部署方式，包括直接运行Python脚本和Docker容器化部署。

Docker部署

在natter-docker/目录下，提供了多种服务的Docker Compose配置文件，例如qbittorrent、transmission等，方便用户快速部署需要端口转发的服务：

# 示例：natter-docker/qbittorrent/docker-compose.yml
version: '3'
services:
  qbittorrent:
    image: linuxserver/qbittorrent
    ports:
      - "6881:6881/udp"
      - "6881:6881/tcp"
    # ... 其他配置 ...

NAT类型检查

部署完成后，可以使用Natter提供的NAT类型检查工具验证网络环境：

python natter-check/natter-check.py

检查结果示例：

Checking TCP NAT...                  [   OK   ] ... NAT Type: 1
Checking UDP NAT...                  [   OK   ] ... NAT Type: 1

其中NAT Type: 1表示当前网络为全锥形NAT，是Natter工作的理想环境。

总结

Natter通过实现STUN协议和巧妙配置iptables NAT规则，解决了处于NAT后的服务对外暴露的问题。其核心在于准确的NAT类型检测和灵活的端口转发规则管理。通过模块化的设计和多种部署方式，Natter为不同场景下的端口转发需求提供了可靠的解决方案。无论是开发调试还是生产环境部署，Natter都是一款值得深入学习和使用的网络工具。

通过本文的源码解析，希望能帮助开发者更好地理解Natter的工作原理，为二次开发和定制化应用提供参考。如需了解更多细节，可以查阅项目的官方文档和源码实现。

【免费下载链接】Natter Expose your TCP/UDP port behind full-cone NAT to the Internet. 项目地址: https://gitcode.com/gh_mirrors/na/Natter