# n2n-gui

**Repository Path**: migeking_admin/n2n-gui

## Basic Information

- **Project Name**: n2n-gui
- **Description**: N2N VPN graphical manager - tkinter GUI for ntop/n2n v2
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-21
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# N2N GUI

[ntop/n2n](https://github.com/ntop/n2n) 点对点 VPN（v2 版本）的图形化管理工具。

通过 tkinter 图形界面管理 Supernode（中心节点）和 Edge（边缘节点），无需手敲命令行。

## 界面预览

```
┌─────────────────────────────────────────────────┐
│  N2N VPN 管理器                                  │
│  ┌──────────────┐  ┌──────────────┐             │
│  │  Supernode   │  │    Edge      │             │
│  │  🟢 运行中   │  │  🔴 未运行   │             │
│  │  [▶] [■] [⚙] │  │  [▶] [■] [⚙]│             │
│  └──────────────┘  └──────────────┘             │
│  ┌─────────────────────────────────────────┐    │
│  │  系统信息                                │    │
│  │  Edge: /usr/local/sbin/edge             │    │
│  │  Supernode: /usr/local/sbin/supernode   │    │
│  │  版本: n2n v.2.9.1 ...                  │    │
│  └─────────────────────────────────────────┘    │
└─────────────────────────────────────────────────┘
```

## 功能

- **仪表盘** — 一页概览 Supernode 和 Edge 的运行状态
- **Supernode 管理** — 端口、联邦、管理端口、安全设置
- **Edge 管理** — 社区名称、加密、虚拟 IP（CIDR）、路由、压缩、用户认证等
- **实时日志** — 实时输出，自动滚动
- **配置存档** — 保存/加载多套配置方案
- **原生 n2n v2** — 使用 v2 CLI 语法（`-p` 代替端口、CIDR 子网掩码等）

## 环境要求

- Python 3.6+
- tkinter（通常 Python 自带）
- n2n v2 二进制文件：`edge` 和 `supernode`（从 [ntop/n2n](https://github.com/ntop/n2n) 安装）
- root 权限（创建 TAP 设备需要）

### 安装 n2n v2

```bash
# 从源码编译
git clone https://github.com/ntop/n2n.git
cd n2n
./autogen.sh
./configure
make
sudo make install
```

## 安装

```bash
git clone https://gitee.com/migeking_admin/n2n-gui.git
cd n2n-gui
```

## 使用

```bash
# 普通用户运行（功能受限 — Edge 启动可能失败）
python3 n2n_gui.py

# 推荐使用启动脚本
bash run.sh
# 选择选项 2（sudo 模式）
```

### 快速开始

1. **启动 Supernode** — 设置端口（默认 7654）并启动
2. **配置 Edge** — 填写社区名称、Supernode 地址、加密密钥、虚拟 IP（如 `10.0.0.2/24`）
3. **启动 Edge** — 自动创建 TAP 设备并建立连接
4. **验证互通** — ping 其他 Edge 的虚拟 IP

> 所有 Edge 节点必须使用相同的社区名称和加密密钥。

## 配置文件

配置保存在 `~/.config/n2n-gui/profiles.json`。

详细配置说明请参考 [CONFIG.md](CONFIG.md)。

## 项目结构

```
n2n-gui/
├── n2n_gui.py      # 主 GUI 程序
├── run.sh          # sudo 启动脚本
├── CONFIG.md       # 配置指南
├── README.md       # 本文件
├── LICENSE         # GPL-3.0 许可证
└── .gitignore
```

## 许可证

GNU General Public License v3.0 — 详见 [LICENSE](LICENSE)。

n2n 同样采用 GPL-3.0 许可证。本项目为图形界面封装，不包含 n2n 二进制文件。