digitizable/reach
GitHub: digitizable/reach
Reach 是一款基于 GTK 4 的 Linux 桌面应用，为 Spectre 路径引擎提供可视化操作界面，用于构建和管理多跳网络路径。
Stars: 0 | Forks: 0
# Reach
**Reach** 是一款用于构建和操作多跳网络路径的 Linux 桌面应用程序。它提供了操作员界面：路径配置文件、适配器配置、连接控制、分流应用规则以及可选的插件。
路径引擎是 **[Spectre](https://github.com/digitizable/spectre)** (`spectred`)。Reach 通过本地 Unix socket 与其进行通信。
**平台：** Linux · **UI：** GTK 4 / libadwaita · **版本：** 0.6.0
## 功能
| 领域 | 描述 |
|------|-------------|
| **Paths** | 作为命名配置文件的有序跳（VPN、Tor、VLESS+REALITY、SOCKS/HTTP proxy） |
| **Adapters** | 具体的后端实例（endpoint、凭证、WireGuard 配置） |
| **Home** | 连接状态、路径图、可选的 Mullvad 出口映射、连接 / 断开 |
| **Territories** | 面向区域的配置文件及反向 / 拨出设置 |
| **Apps** | 通过 network namespace 进行 Clearnet / 排除列表的分流 |
| **Routing** | 系统路由和 kill switch（由 Spectre 实现） |
| **Plugins** | 可选的实验工具和操作员插件，不会增加默认安装的体积 |
## 插件
Reach 发行了一个小巧的核心。额外功能均为可选启用。
| 层级 | 内容 |
|-------|----------|
| **Default** | Paths、adapters、Home、territories、apps、托盘、基础诊断 |
| **Built-in packs** | 路径指纹测量；配套工具的安装界面（Settings → Plugins） |
| **Marketplace** | 从 GitHub 安装（`owner/repo`）至 `~/.local/share/reach/plugins/` |
官方 marketplace 示例：**[Hogwarts](https://github.com/digitizable/hogwarts)** — 命令与控制台（agents、control plane、listeners、playbooks）。
插件格式：[docs/PLUGIN_SPEC.md](docs/PLUGIN_SPEC.md)。模板：[examples/reach-plugin-hello](examples/reach-plugin-hello)。
**模式 (Settings → Plugins)：**
1. **Privacy** — 仅核心路径控制台
2. **Lab** — 指纹包 + 配套工具安装器（无 C2 通道）
3. **Operate** — 在通道上解锁 marketplace / 操作员插件
## 相关组件
这些是独立的代码库。除非您主动安装，否则 Reach 不会内置它们。
| 项目 | 角色 |
|---------|------|
| [Spectre](https://github.com/digitizable/spectre) | 路径核心：hops、本地 SOCKS、routing、kill switch |
| [Drift](https://github.com/digitizable/drift) | 拨出反向 agent 及接收端 |
| [Mirage](https://github.com/digitizable/mirage) | 位于反向接收端前方的 REALITY 伪装 |
| [Sounding](https://github.com/digitizable/sounding) | 用于表面和残余路径的测量工具 |
| [Laminar](https://github.com/digitizable/laminar) | 多跳组合 / 指纹测量 |
| [Hogwarts](https://github.com/digitizable/hogwarts) | Reach 的可选 C2 插件 |
```
Reach (desktop UI)
└── spectred (Spectre) ── path, SOCKS, routing
└── optional plugins / lab companions
```
## 安装
**1. Spectre 核心**
```
cd /path/to/spectre && ./install.sh
```
**2. Reach**
```
sudo apt install -y \
python3 python3-venv python3-gi python3-gi-cairo \
gir1.2-gtk-4.0 gir1.2-adw-1 \
libadwaita-1-0 libgtk-4-1
cd /path/to/reach
./install.sh
reach
```
**开发**
```
python3 -m venv .venv --system-site-packages
source .venv/bin/activate
python src/main.py
```
| 项目 | 默认值 |
|------|---------|
| 核心 socket | `$XDG_RUNTIME_DIR/spectre/spectre.sock` |
| 配置文件 | `~/.config/reach/config.json` |
| 数据 | `~/.local/share/reach/` |
卸载：`./uninstall.sh`。
## UI 导航
| 页面 | 用途 |
|------|---------|
| Home | 状态、路径图、映射、连接 |
| Paths | 配置文件和适配器 |
| Territories | 区域 / 反向设置 |
| Apps | 分流排除 |
| Tools | 诊断和已启用的实验工具 |
| Plugins | Marketplace 目录和安装 |
| Settings | 核心、网络、隐私、插件、更新 |
Deep link 包括 `paths:recipes`、`paths:adapters`、`settings:plugins`。
## 数据布局
| 路径 | 内容 |
|------|----------|
| `~/.config/reach/config.json` | 应用设置和插件启用标志 |
| `~/.local/share/reach/backends.json` | 适配器 |
| `~/.local/share/reach/profiles.json` | 路径配置文件 |
| `~/.local/share/reach/plugins/` | 已安装的 Marketplace 插件 |
| `~/.local/share/reach/lab/` | 可选的配套检出 |
| `~/.local/share/reach/desktop.log` | 应用程序日志（如果已启用） |
更新：Settings → Updates 会检查 [GitHub Releases](https://github.com/digitizable/reach/releases)。
## 安全性
- 插件以进程内 Python UI 的形式加载。请仅安装您信任的代码库。
- 操作员插件（包括 Hogwarts）仅供您被授权控制的系统和任务使用。
- 网络路径和 kill switch 行为取决于 Spectre 和主机权限；配置不当可能会阻断连接或导致流量泄漏——在依赖某项配置之前，请通过您自己的测试进行验证。
## 项目
- 主页：[anguish.sh/projects/reach](https://anguish.sh/projects/reach)
- 第三方声明：[data/THIRD_PARTY_NOTICES.md](data/THIRD_PARTY_NOTICES.md)
- 许可证：[GNU GPLv3](LICENSE)
### 捐赠
| | 地址 |
|--|---------|
| **BTC** | `sp1qqgly4w3je7m64xh72047u04hwyflyqqf3rfmxchmyht5dndpas4txqsuj9e0jc9l3yql9c3k5el3quyxfh6kr6c9zplmaavj59kuk5kny5jf7cjr` |
| **XMR** | `89SWJrVXxEgHNiVNSEdjWsXMtRzpzoUX7ebToit9x7iuQADTZh5BGVjTywoQ4gn3SuSEzDhXpCEybi17HpwgYs7v2Xfjdue` |
标签：GTK4, Linux桌面应用, 多跳路径, 安全合规, 插件架构, 流量分流, 系统路由, 网络代理, 调试插件, 逆向工具