iConnect — 异地内网组网系统

纯中心化转发的异地虚拟局域网组网工具。所有设备流量经由 Core 服务端中转，无需 P2P 打洞，适配多层 NAT / 弱网 / 端口封锁环境。

架构

Core Server (公网 IP, TCP 单端口)
   **
   **── Client A (OpenWrt 路由器, 异地内网)
   **── Client B (Linux 服务器, 异地内网)
   **── Client C (OpenWrt 路由器, 异地内网)

全部流量: Client A → Core → Client B, 禁止 Client 之间直连

安装指南

一、服务端（x86_64）

适用: 绝大多数 Linux x86_64 发行版（二进制使用 musl 静态链接，不依赖系统 GLIBC）

防火墙要求: 仅开放 TCP 1993（组网）

# 1. 下载服务端安装包并解压
tar xzf iconnect-server-v1.1.2-x86_64.tar.gz

# 2. 交互式安装（可自定义组网名称、密钥、端口）
sudo bash install.sh

# 3. 安装完成后自动启动，输出连接信息

安装后服务:

二、客户端 x86_64（Linux 服务器 / 虚拟机）

# 1. 下载客户端安装包并解压
tar xzf iconnect-client-v1.1.2-x86_64.tar.gz

# 2. 命令行模式安装（非交互）
sudo bash install.sh 服务器IP 1993 组网名称 组网密钥

# 或交互模式
sudo bash install.sh

安装后 systemctl start/stop iconnectd 管理客户端。虚拟 IP 由 DHCP 自动分配。

三、客户端 aarch64（OpenWrt / ARM64 Linux）

# 1. 下载客户端安装包并解压（在 OpenWrt / ARM64 Linux 上执行）
tar xzf iconnect-client-v1.1.2-aarch64.tar.gz

# 2. 命令行模式安装
sh install.sh 服务器IP 1993 组网名称 组网密钥

# 或交互模式
sh install.sh

安装后 /etc/init.d/iconnect start/stop 管理客户端。

四、防火墙配置

# UFW
sudo ufw allow 1993/tcp

# firewalld
sudo firewall-cmd --add-port=1993/tcp --permanent
sudo firewall-cmd --reload

获取配网密钥和配置信息

安装脚本会把配置写入 systemd 服务文件，可通过以下方式查看：

# 查看服务启动参数（含组网名称、密钥、虚拟网段、端口）
cat /etc/systemd/system/iconnectd.service

# 查看运行时日志中的连接信息
journalctl -u iconnectd -n 50

# 查看已分配的虚拟 IP 和 peer 状态
iconnect-cli peer list
iconnect-cli route list

客户端安装时需要的连接信息（服务器 IP、端口、组网名称、组网密钥）即服务端安装完成时屏幕输出的内容，建议保存。

端口说明

目录结构

iconnect/
**── README.md
**── .cargo/
**   **── config.toml           # musl 静态链接器配置
**── deploy/                   # 部署脚本与配置
**   **── install-server.sh     # 服务端一键安装
**   **── install-client.sh     # 客户端一键安装
**   **── build-all.sh          # 源码构建脚本（musl 静态）
**   **── Dockerfile.build      # 固定构建环境镜像
**   **── proxy.py              # Web 代理（可选）
**   **── reset-pwd.py          # 密码重置脚本（可选）
**   **── iconnect.db           # 数据库模板
**── dist/packages/            # 编译好的安装包
**── iconnectd/                # Core 源码 (Rust)
**── iconnect-web/             # Web 管理端源码 (Rust + Vue)，可选组件

核心特性

• 纯中心化转发：100% 流量经 Core 中转，无 P2P
• 单端口：仅需开放 1 个 TCP 端口（1993）
• 适配弱网：无需 NAT 打洞，穿透多层路由
• DHCP 自动分配 IP：客户端连上即获虚拟 IP
• 跨平台：Linux x86_64 / OpenWrt aarch64，均使用 musl 静态链接
• CLI 管理：通过命令行查看设备状态与配置
• 轻量化：适配 OpenWrt 低配置路由器

平台支持

管理命令

# 服务管理
systemctl start/stop/status iconnectd

# 查看日志
journalctl -u iconnectd -f
tail -f /var/log/iconnectd.log

# 设备状态
iconnect-cli peer list
iconnect-cli route list

文档

• CLI 命令行手册

许可证

基于 EasyTier v2.6.4 二次开发，继承原项目 MPL-2.0 许可证。