n2n 异地局域网部署教程(Ubuntu / Windows 10 / Windows 11)
1. 概述
本文使用 n2n 3.0 系列搭建异地二层虚拟局域网。一个节点运行 supernode,其他节点运行 edge;各 Edge 连接到同一个 Supernode,并加入相同的 Community,即可通过 n2n 虚拟网络互通。
1.1 示例拓扑
假设有三台设备:
| 设备 | 角色 | 操作系统示例 | n2n 虚拟 IP | 说明 |
|---|---|---|---|---|
| A | Supernode | Ubuntu / Windows 10 / Windows 11 | 不分配 | 具有公网 IP,监听 UDP 726 |
| B | Edge B | Ubuntu / Windows 10 / Windows 11 | 192.168.99.10/24 |
异地节点 |
| C | Edge C | Ubuntu / Windows 10 / Windows 11 | 192.168.99.11/24 |
异地节点 |
示例公网参数:
- Supernode 公网 IP:
4.3.2.1(请替换为实际公网 IP 或域名) - Supernode UDP 端口:
726 - Community:
mynetwork - 加密密钥:
mysecretpass - 虚拟网段:
192.168.99.0/24
注意:原始配置给 B、C 分配的是
192.168.99.10和192.168.99.11,但原测试命令使用了10.0.0.2、10.0.0.3。本教程统一使用实际配置的192.168.99.x网段进行测试。
如果还要增加一台 Windows Edge,可分配 192.168.99.13/24,不要与其他节点或现有局域网地址冲突。
1.2 网络拓扑
Internet
|
4.3.2.1:726/UDP
|
+---------------+
| A |
| Supernode |
+---------------+
/ \
/ \
+-----------+ +-----------+
| B | | C |
| Edge | | Edge |
| .10/24 | | .11/24 |
+-----------+ +-----------+
\ /
\ /
n2n 虚拟局域网
192.168.99.0/24
Supernode 负责协助 Edge 节点发现和建立连接。正常情况下,Edge 之间的数据可尝试点对点传输;网络条件不允许时,通信可能经 Supernode 转发。
1.3 网络要求
- A 所在网络需要允许 UDP 726 入站。
- 如果 A 位于路由器或 NAT 后面,需要将公网 UDP 726 转发到 A 的内网地址。
- B、C 所在网络需要允许 Edge 发起 UDP 出站连接。
- 所有 Edge 必须使用相同的 Supernode 地址、Community 和密钥。
- 每个 Edge 的虚拟 IP 必须唯一,且处于同一网段。
2. Ubuntu 部署
以下保留原教程中已经验证的 Ubuntu 编译、启动参数和 systemd 服务流程。
示例用户名为 ubuntu,实际部署时请替换成设备上的 Linux 用户名。
2.1 安装依赖
sudo apt-get update
sudo apt-get install autoconf
如果编译时提示缺少编译工具,再安装:
sudo apt-get install build-essential automake libtool pkg-config
2.2 编译 n2n
在需要运行 Supernode 或 Edge 的 Ubuntu 设备上分别执行:
mkdir ~/n2n_ws
cd ~/n2n_ws
git clone -b 3.0-stable https://github.com/ntop/n2n.git n2n-3.0
cd n2n-3.0
./autogen.sh
./configure
# 编译后,当前目录下会生成 supernode 和 edge 程序
make
如果设备访问 GitHub 不稳定,可以将仓库地址替换为自己可信且可用的 GitHub 代理地址。
2.3 Supernode A 配置
在 A 设备上进入 n2n 编译目录:
cd ~/n2n_ws/n2n-3.0
touch n2n_startup.sh
chmod +x n2n_startup.sh
编辑 n2n_startup.sh:
#!/bin/bash
cd /home/ubuntu/n2n_ws/n2n-3.0
sudo ./supernode -p 726 -f
其中 /home/ubuntu 中的 ubuntu 为系统用户名,需要按实际情况修改。
启动测试:
cd ~/n2n_ws/n2n-3.0
sudo ./supernode -p 726 -f
保持进程运行。确认 A 的系统防火墙和云平台安全组已允许 UDP 726 入站。
2.4 Edge B 配置
在 B 设备上编译完成后,创建启动脚本:
cd ~/n2n_ws/n2n-3.0
touch n2n_startup.sh
chmod +x n2n_startup.sh
编辑 n2n_startup.sh:
#!/bin/bash
cd /home/ubuntu/n2n_ws/n2n-3.0
sudo ./edge -c mynetwork -k mysecretpass -a 192.168.99.10 -f -l 4.3.2.1:726
参数说明:
-c mynetwork:Community 名称。-k mysecretpass:Edge 加密密钥。-a 192.168.99.10:B 的虚拟 IP。-f:前台运行。-l 4.3.2.1:726:Supernode 公网地址和端口。
启动测试:
sudo ./n2n_startup.sh
2.5 Edge C 配置
在 C 设备上编译完成后,创建启动脚本:
cd ~/n2n_ws/n2n-3.0
touch n2n_startup.sh
chmod +x n2n_startup.sh
编辑 n2n_startup.sh:
#!/bin/bash
cd /home/ubuntu/n2n_ws/n2n-3.0
sudo ./edge -c mynetwork -k mysecretpass -a 192.168.99.11 -f -l 4.3.2.1:726
C 与 B 使用相同的 Community、密钥和 Supernode 地址,但虚拟 IP 必须不同。
启动测试:
sudo ./n2n_startup.sh
2.6 设置 Ubuntu 开机自启动
在需要开机自动运行 n2n 的 Ubuntu 设备上创建服务文件:
sudo vi /etc/systemd/system/n2n.service
添加以下内容:
[Unit]
Description=n2n
After=network.target
[Service]
ExecStart=/home/ubuntu/n2n_ws/n2n-3.0/n2n_startup.sh
Restart=always
RestartSec=5s
[Install]
WantedBy=multi-user.target
注意将 /home/ubuntu 中的 ubuntu 替换为实际用户名。
启用并启动服务:
sudo systemctl daemon-reload
sudo systemctl enable n2n.service
sudo systemctl start n2n.service
查看状态和日志:
systemctl status n2n.service
journalctl -u n2n.service -f
停止或重启服务:
sudo systemctl stop n2n.service
sudo systemctl restart n2n.service
原始启动脚本使用了
sudo。systemd 服务默认以 root 身份启动时通常不需要在脚本中再次使用sudo。如果服务启动时出现 sudo 交互或权限问题,可将脚本中的 sudo 去掉,并确认服务以 root 身份运行。
3. Windows 10 / Windows 11 部署
Windows 10 和 Windows 11 的 n2n 配置参数相同。以下步骤适用于 Windows 10 x64 和 Windows 11 x64。
如果使用 ARM64 设备,需要准备对应架构的 n2n 程序和 TAP 驱动,不能直接使用 x64 程序。
3.1 准备文件
原教程提供了以下 Windows 资源:
-
TAP-Windows6 驱动包:
http://www.aigrantli.com:8081/directlink/software/n2n/windows/tap-windows6/dist.win7.zip
-
n2n Windows x64 程序包:
建议将 n2n 解压到固定目录,例如:
D:\n2n\
edge.exe
supernode.exe
实际文件结构以压缩包内容为准。以下命令假设两个可执行文件位于 D:\n2n。
版本提示:原教程的 Ubuntu 使用
3.0-stable分支,Windows 压缩包名称标注为3.1.1_r1255。它们并非完全相同的构建版本。正式部署前建议先在测试环境验证互通;如果出现协议或参数兼容问题,应改用与 Ubuntu 端相同版本或兼容构建的 Windows 程序。
3.2 安装 TAP 虚拟网卡驱动
Supernode 不需要 TAP 网卡;只有运行 Edge 的 Windows 设备需要安装 TAP 驱动。
- 解压 TAP 驱动包。
- 根据系统架构选择驱动目录。Windows 10/11 x64 选择
amd64。 - 以管理员身份打开 CMD 或 PowerShell。
- 进入驱动目录并执行原教程中的安装命令:
cd /d D:\n2n\dist.win7\dist.win7\amd64
tapinstall install OemVista.inf TAP0901
如果目录与示例不同,请按实际解压路径修改。
出现以下提示表示安装程序报告驱动安装成功:
Drivers installed successfully.
安装后可在“设备管理器 → 网络适配器”中检查 TAP 虚拟网卡是否存在。
Windows 10/11 驱动注意事项:
- 原教程提供的
dist.win7驱动包较旧,在部分 Windows 10/11 环境中可能因驱动签名、系统安全策略或驱动兼容性而安装失败。 - 如果安装失败,优先使用受信任来源提供、支持当前 Windows 版本且带有效数字签名的 TAP-Windows6 驱动安装包。
- 不建议为了安装旧驱动而长期关闭 Windows 驱动签名强制或系统安全功能。
- 如果机器已经安装了可用的 TAP-Windows6 网卡,不要重复安装多个同类驱动。
3.3 Windows 防火墙设置
不建议直接关闭 Windows 防火墙。更安全的方式是按角色放行:
- Windows Supernode:允许
supernode.exe接收 UDP 726 入站。 - Windows Edge:允许
edge.exe通信,确保其能够向 Supernode 的 UDP 726 发起出站连接。 - 如果网络策略限制 UDP,需在系统防火墙、路由器和云平台安全组中检查相应规则。
可以通过 Windows Defender 防火墙高级安全设置创建入站规则,程序路径选择实际的 supernode.exe 或 edge.exe。
4. Windows Supernode 配置
以下步骤适用于 Windows 10 和 Windows 11。
假设 A 设备运行 Windows,公网 IP 为 4.3.2.1,Supernode 监听 UDP 726。
4.1 启动 Supernode
以管理员身份打开 CMD:
cd /d D:\n2n
supernode.exe -p 726
保持命令窗口运行。
如果程序提示参数不支持,先查看该 Windows 构建实际支持的参数:
supernode.exe --help
4.2 配置公网访问
如果 A 直接拥有公网 IP,确认系统防火墙允许 UDP 726 入站。
如果 A 位于路由器/NAT 后面,需要在路由器配置:
协议:UDP
公网端口:726
内网地址:A 设备的局域网 IP
内网端口:726
如果 A 部署在云服务器,还需要在云安全组中放行 UDP 726。
4.3 Windows Supernode 开机启动
推荐使用 Windows“任务计划程序”:
- 打开“任务计划程序”。
- 选择“创建任务”,不要选择“创建基本任务”。
- 在“常规”页填写名称,例如
n2n-supernode。 - 勾选“使用最高权限运行”。
- 在“触发器”页新建触发器,选择“启动时”。
- 在“操作”页选择“启动程序”:
- 程序或脚本:
D:\n2n\supernode.exe - 添加参数:
-p 726 - 起始于:
D:\n2n
- 程序或脚本:
- 保存任务,并手动运行一次验证。
如果程序路径不同,请替换为实际路径。任务计划程序中的“起始于”建议填写可执行文件所在目录。
5. Windows Edge B 配置
以下步骤适用于 Windows 10 和 Windows 11。假设 B 的 n2n 虚拟 IP 为 192.168.99.10/24。
5.1 启动 Edge B
以管理员身份打开 CMD:
cd /d D:\n2n
edge.exe -c mynetwork -k mysecretpass -a 192.168.99.10 -l 4.3.2.1:726
参数说明:
| 参数 | 含义 |
|---|---|
-c mynetwork |
Community 名称,必须与其他 Edge 一致 |
-k mysecretpass |
加密密钥,必须与其他 Edge 一致 |
-a 192.168.99.10 |
B 的 n2n 虚拟 IP |
-l 4.3.2.1:726 |
Supernode 公网 IP 和 UDP 端口 |
Windows Edge 命令不添加 Linux 的 -f 参数。启动后保持命令窗口运行。
如果系统中安装了多个 TAP 网卡,可先查看:
edge.exe --help
根据程序帮助输出中的 TAP 适配器列表,必要时使用 -d 指定要使用的适配器名称。只有存在多个 TAP 设备且程序选错网卡时,才需要额外指定。
5.2 Edge B 开机启动
使用“任务计划程序”创建任务:
- 任务名称:
n2n-edge-B。 - 勾选“使用最高权限运行”。
- 触发器选择“启动时”。
- 操作选择“启动程序”:
- 程序或脚本:
D:\n2n\edge.exe - 添加参数:
-c mynetwork -k mysecretpass -a 192.168.99.10 -l 4.3.2.1:726 - 起始于:
D:\n2n
- 程序或脚本:
- 保存后手动运行任务,检查 Edge 是否正常启动。
6. Windows Edge C 配置
以下步骤同样适用于 Windows 10 和 Windows 11。假设 C 的 n2n 虚拟 IP 为 192.168.99.11/24。
6.1 启动 Edge C
以管理员身份打开 CMD:
cd /d D:\n2n
edge.exe -c mynetwork -k mysecretpass -a 192.168.99.11 -l 4.3.2.1:726
C 的 Community、密钥和 Supernode 地址必须与 B 一致,只有虚拟 IP 不同。
6.2 Edge C 开机启动
使用“任务计划程序”创建任务:
- 任务名称:
n2n-edge-C。 - 勾选“使用最高权限运行”。
- 触发器选择“启动时”。
- 操作选择“启动程序”:
- 程序或脚本:
D:\n2n\edge.exe - 添加参数:
-c mynetwork -k mysecretpass -a 192.168.99.11 -l 4.3.2.1:726 - 起始于:
D:\n2n
- 程序或脚本:
- 保存后手动运行任务,检查 Edge 是否正常启动。
7. Windows 10 与 Windows 11 配置对照
| 项目 | Windows 10 | Windows 11 |
|---|---|---|
| n2n 程序 | 使用对应架构的 Windows 版本 | 使用对应架构的 Windows 版本 |
| Supernode | supernode.exe -p 726 |
supernode.exe -p 726 |
| Edge B | edge.exe ... -a 192.168.99.10 ... |
相同 |
| Edge C | edge.exe ... -a 192.168.99.11 ... |
相同 |
| TAP 驱动 | 安装受支持的 TAP-Windows6 驱动 | 安装受支持的 TAP-Windows6 驱动 |
| 开机启动 | 任务计划程序 | 任务计划程序 |
| 防火墙 | 按程序/端口放行 | 按程序/端口放行 |
Windows 10 与 Windows 11 的主要差异通常在驱动签名、安全策略和系统权限设置,不在 n2n 的 Edge/Supernode 参数本身。
8. 连通性测试
8.1 检查虚拟网卡地址
Ubuntu:
ip addr
检查 n2n 创建的虚拟网卡,确认地址为 192.168.99.10/24 或 192.168.99.11/24。
Windows:
ipconfig /all
检查 TAP 虚拟网卡是否存在,以及其 IPv4 地址是否与该节点配置一致。
8.2 B 设备 ping C 设备
在 B 设备运行:
ping 192.168.99.11
Windows CMD 中同样执行:
ping 192.168.99.11
8.3 C 设备 ping B 设备
在 C 设备运行:
ping 192.168.99.10
Windows CMD 中同样执行:
ping 192.168.99.10
如果双向 ping 正常,说明两个 Edge 的虚拟网络基本连通。
如果 ping 不通,不一定代表 n2n 隧道没有建立。Windows 防火墙可能默认阻止 ICMP Echo 请求;可临时放行 ICMP 入站规则后再测试。
8.4 使用 NoMachine 远程桌面
确认 n2n 虚拟网络连通后,可以在 B、C 设备上分别安装 NoMachine,并使用对端的 n2n 虚拟 IP 进行连接。
下载地址:
https://downloads.nomachine.com/linux/
例如:
- 从 B 访问 C:连接
192.168.99.11。 - 从 C 访问 B:连接
192.168.99.10。
NoMachine 需要在目标设备上正常运行,并确保其远程桌面服务端口未被目标设备防火墙拦截。
9. 常见问题排查
9.1 Edge 无法连接 Supernode
检查:
- Supernode 是否已经启动。
- Supernode 是否监听 UDP 726。
- A 的公网 IP 或域名是否正确。
- 云安全组、路由器端口转发和系统防火墙是否放行 UDP 726。
- Edge 是否使用了正确的
-l 公网IP:端口参数。
9.2 Edge 已启动,但 B、C 不能互相 ping
检查:
- B、C 是否使用相同的
-cCommunity。 - B、C 是否使用相同的
-k密钥。 - B、C 是否连接到相同的 Supernode。
- 两个 Edge 的虚拟 IP 是否唯一,且处于同一网段。
- TAP 网卡是否成功创建并配置了预期 IP。
- 防火墙是否阻止 ICMP 或 n2n 通信。
9.3 Windows 找不到 TAP 网卡
检查:
- TAP 驱动是否安装成功。
- 设备管理器中是否存在 TAP 虚拟网卡。
- 驱动是否与系统架构匹配。
- 驱动是否被 Windows 安全策略或签名检查拦截。
- 如果存在多个 TAP 网卡,查看
edge.exe --help输出,并按需通过-d指定网卡。
9.4 Windows 任务计划程序启动失败
检查:
- 程序路径是否正确。
- “起始于”是否设置为 n2n 程序所在目录。
- 是否勾选“使用最高权限运行”。
- 参数是否完整,参数之间是否有空格。
- 手动以管理员身份执行同一条命令,确认程序本身可以正常运行。
9.5 Ubuntu systemd 服务启动失败
查看状态:
systemctl status n2n.service
查看日志:
journalctl -u n2n.service -n 100 --no-pager
重点检查脚本路径、执行权限、用户名目录、程序权限以及 sudo 是否出现交互等待。
10. 节点配置汇总
| 节点 | 角色 | Supernode 地址 | Community | 虚拟 IP | 端口 |
|---|---|---|---|---|---|
| A | Supernode | — | — | 不分配 | UDP 726 |
| B | Edge | 4.3.2.1:726 |
mynetwork |
192.168.99.10/24 |
— |
| C | Edge | 4.3.2.1:726 |
mynetwork |
192.168.99.11/24 |
— |
| D(可选) | Edge | 4.3.2.1:726 |
mynetwork |
192.168.99.13/24 |
— |
部署时必须保持一致的项目:
- Supernode 公网地址和 UDP 端口。
- Edge 的 Community 名称。
- Edge 的加密密钥。
- Edge 虚拟网段。
- 每台 Edge 独立且不冲突的虚拟 IP。
11. 参考资料
-
Ubuntu 系统入门教程——整合 n2n 实现异域局域网:
https://www.ncnynl.com/archives/202205/5233.html -
ROS2 入门教程——跨域网络通讯:
https://www.ncnynl.com/archives/202212/5798.html -
n2n 官方项目:
https://github.com/ntop/n2n -
n2n 官方 Advanced 配置文档:
https://github.com/ntop/n2n/blob/dev/doc/Advanced.md -
n2n 官方 TAP 配置说明:
https://github.com/ntop/n2n/blob/dev/doc/TapConfiguration.md -
n2n 官方配置文件说明:
https://github.com/ntop/n2n/blob/dev/doc/ConfigurationFiles.md -
n2n 官方 Windows 构建说明:
https://github.com/ntop/n2n/blob/dev/doc/Building.md -
TAP-Windows6 驱动项目:
https://github.com/OpenVPN/tap-windows6 -
TAP-Windows9 驱动下载链接:
https://build.openvpn.net/downloads/releases/ -
TAP-Windows 驱动下载链接:
https://build.openvpn.net/downloads/releases/tap-windows-9.24.7-I601-Win10.exe -
Windows N2N软件下载链接:
https://github.com/happynclient/happynwindows/releases
12. 安全提示
mysecretpass是示例密钥,正式部署请替换为足够复杂且不易猜测的密钥。- 不要将 n2n 的加密密钥公开在可访问的代码仓库或公共文档中。
- 只开放必要的 UDP 端口,不建议为了排查问题而长期关闭整机防火墙。
- Supernode 的公网 UDP 端口应限制在业务需要的范围内,并定期检查服务运行状态。
- 本教程中的公网 IP、用户名、磁盘路径和下载地址均为示例或原教程地址,实际部署时请核对其可用性。
评论区