windows-proxy-route-manager

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #llm #android #linux #nodejs #cli #kubernetes #ios #openai #open-source

windows-proxy-route-manager

(★ 48)

Windows proxy diagnostics and private network route bypass tools for development environments.

windows-proxy-route-manager Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🌐 Windows Proxy Route Manager

[中文](#-windows-proxy-route-manager) | [English](#english)

> **轻量级 Windows 代理路由管理器，让应用和域名的流量按规则走代理或直连，无需手动编辑复杂的代理配置。**
>
> **A lightweight Windows proxy routing manager that allows per-application and per-domain traffic routing without complicated proxy configuration.**

[![Windows](https://img.shields.io/badge/platform-Windows-0078D6?logo=windows&logoColor=white)](https://github.com/Mrxing233/windows-proxy-route-manager/releases)
[![Release](https://img.shields.io/github/v/release/Mrxing233/windows-proxy-route-manager?display_name=tag)](https://github.com/Mrxing233/windows-proxy-route-manager/releases)
[![License](https://img.shields.io/github/license/Mrxing233/windows-proxy-route-manager)](https://raw.githubusercontent.com/Mrxing233/windows-proxy-route-manager/main/LICENSE)

适用于使用 Clash Verge Rev 的用户：通过图形界面管理 `DIRECT` 和 TUN 路由排除规则，查看规则命中与代理核心日志，告别反复修改 YAML。

> **分支说明**：`main` 用于产品介绍、发布与使用说明；桌面端源码位于 [`app-0.1.7`](https://github.com/Mrxing233/windows-proxy-route-manager/tree/app-0.1.7) 分支；Agent Skill 与诊断脚本说明位于 [`skill`](https://github.com/Mrxing233/windows-proxy-route-manager/tree/skill) 分支。

| 想要做什么 | 前往位置 |
| --- | --- |
| 下载并使用桌面端 | [最新 Windows x64 安装包](https://github.com/Mrxing233/windows-proxy-route-manager/releases/download/v0.1.7/Traffic-Route-Manager_0.1.7_x64-setup.exe) |
| 查看桌面端源码 | [`app-0.1.7` 分支](https://github.com/Mrxing233/windows-proxy-route-manager/tree/app-0.1.7) |
| 使用 Agent Skill | [`skill` 分支](https://github.com/Mrxing233/windows-proxy-route-manager/tree/skill) |

## 🚀 立即开始

1. 下载并安装 Windows x64 安装包。
2. 启动 Clash Verge Rev，并开启需要使用的代理模式或 TUN 模式。
3. 打开本工具，添加直连或路由排除规则并查看命中情况。

👉 **[下载最新版 Windows x64 安装包](https://github.com/Mrxing233/windows-proxy-route-manager/releases/download/v0.1.7/Traffic-Route-Manager_0.1.7_x64-setup.exe)**

- [查看全部版本与更新说明](https://github.com/Mrxing233/windows-proxy-route-manager/releases)
- [查看桌面应用源码（app-0.1.7 分支）](https://github.com/Mrxing233/windows-proxy-route-manager/tree/app-0.1.7)

## ✨ 功能亮点

- **图形化规则管理**：新增、删除、搜索和分页查看 `DIRECT` 与 TUN 路由排除规则。
- **流量命中统计**：统计 TUN 排除后的系统 TCP 直连次数，并保留命中记录，便于排查规则是否生效。
- **代理规则查看**：按策略组浏览强制代理规则，展开即可查看域名明细。
- **实时日志诊断**：实时查看、筛选和分页代理核心运行日志。
- **运行状态一览**：集中查看系统代理、TUN、代理模式和本机控制器状态。

## 🖥️ 界面预览

![流量路由管理器主界面](https://raw.githubusercontent.com/Mrxing233/windows-proxy-route-manager/main/docs/images/app-dashboard.png)

## 🛠️ 辅助诊断脚本

仓库还提供 Windows/macOS 命令行脚本，用于检查应用代理设置、比较直连与代理连接，以及维护私有网络的路由绕过规则。

> 本项目不提供代理服务器、账号凭证、流量隧道或访问规避服务。请仅在已获授权的网络和设备上使用。

### Windows：诊断应用代理

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\diagnose-windows-app-proxy.ps1 -ProxyPort 7897 -AppName Git -TestUrl https://example.com/
```

### macOS：诊断应用代理

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --app-name git --test-url https://example.com/
```

只打印建议的环境变量：

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --print-env
```

写入当前 shell profile：

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --set-shell-env
```

为新启动的 GUI 应用设置环境变量：

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --set-launchctl-env
```

### 路由绕过规则

预览将要修改的内容，不写入文件：

```powershell
python .\scripts\update_route_whitelist.py --entry internal.example.test=10.0.0.10 --entry 10.0.0.0/24 --dry-run
```

正式写入：

```powershell
python .\scripts\update_route_whitelist.py --entry internal.example.test=10.0.0.10 --entry 10.0.0.0/24
```

```bash
python3 ./scripts/update_route_whitelist.py --entry internal.example.test=10.0.0.10 --entry 10.0.0.0/24
```

公网 IP/CIDR，或 `域名=公网 IP` 默认不会加入 `DIRECT`/绕过规则。只有明确确认公网目标也必须绕过代理时，才使用 `--allow-public-direct`。

## 📮 联系方式

mr.xing0324@outlook.com

---

# 🌐 Windows Proxy Route Manager

> **A lightweight Windows proxy routing manager that allows per-application and per-domain traffic routing without complicated proxy configuration.**
>
> Manage `DIRECT` and TUN route-exclusion rules visually, instead of editing complex proxy configuration files by hand.

Built for Clash Verge Rev users. Manage routing rules through a desktop interface, check rule hits, and inspect proxy-core logs in one place.

> **Branches**: `main` contains the product overview, releases, and user documentation. The desktop source code is in the [`app-0.1.7`](https://github.com/Mrxing233/windows-proxy-route-manager/tree/app-0.1.7) branch, while the Agent Skill and its diagnostic documentation are in the [`skill`](https://github.com/Mrxing233/windows-proxy-route-manager/tree/skill) branch.

| Goal | Where to go |
| --- | --- |
| Download and use the desktop app | [Latest Windows x64 installer](https://github.com/Mrxing233/windows-proxy-route-manager/releases/download/v0.1.7/Traffic-Route-Manager_0.1.7_x64-setup.exe) |
| Browse desktop source code | [`app-0.1.7` branch](https://github.com/Mrxing233/windows-proxy-route-manager/tree/app-0.1.7) |
| Use the Agent Skill | [`skill` branch](https://github.com/Mrxing233/windows-proxy-route-manager/tree/skill) |

## 🚀 Get Started

1. Download and install the Windows x64 installer.
2. Start Clash Verge Rev and enable the proxy mode or TUN mode you need.
3. Open this application, add direct-connect or route-exclusion rules, then check whether they are being hit.

👉 **[Download the latest Windows x64 installer](https://github.com/Mrxing233/windows-proxy-route-manager/releases/download/v0.1.7/Traffic-Route-Manager_0.1.7_x64-setup.exe)**

- [View all releases and release notes](https://github.com/Mrxing233/windows-proxy-route-manager/releases)
- [View desktop app source code (app-0.1.7 branch)](https://github.com/Mrxing233/windows-proxy-route-manager/tree/app-0.1.7)

## ✨ Highlights

- **Visual rule management**: create, remove, search, and page through `DIRECT` and TUN route-exclusion rules.
- **Traffic-hit statistics**: count TCP direct connections excluded from TUN and retain hit records to help verify rules.
- **Proxy rule viewer**: browse forced-proxy rules by policy group and expand them to view domains.
- **Live log diagnostics**: view, filter, and page through proxy-core logs in real time.
- **Status at a glance**: check system proxy, TUN, proxy mode, and local controller status together.

## 🖥️ Preview

![Traffic Route Manager dashboard](https://raw.githubusercontent.com/Mrxing233/windows-proxy-route-manager/main/docs/images/app-dashboard.png)

## 🛠️ Diagnostic Scripts

The repository also provides Windows/macOS command-line scripts for checking application proxy settings, comparing direct and proxied connectivity, and maintaining private-network route-bypass rules.

> This project does not provide proxy servers, credentials, traffic tunnels, or access-circumvention services. Use it only on networks and devices where you have authorization.

### Windows: diagnose an application proxy

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\diagnose-windows-app-proxy.ps1 -ProxyPort 7897 -AppName Git -TestUrl https://example.com/
```

### macOS: diagnose an application proxy

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --app-name git --test-url https://example.com/
```

Print suggested environment variables:

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --print-env
```

Append them to the current shell profile:

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --set-shell-env
```

Set environment variables for newly launched GUI applications:

```bash
bash ./scripts/diagnose-macos-app-proxy.sh --proxy-port 7897 --set-launchctl-env
```

### Route-bypass rules

Preview changes without writing to a file:

```powershell
python .\scripts\update_route_whitelist.py --entry internal.example.test=10.0.0.10 --entry 10.0.0.0/24 --dry-run
```

Apply the changes:

```powershell
python .\scripts\update_route_whitelist.py --entry internal.example.test=10.0.0.10 --entry 10.0.0.0/24
```

```bash
python3 ./scripts/update_route_whitelist.py --entry internal.example.test=10.0.0.10 --entry 10.0.0.0/24
```

Public IP/CIDR entries and `domain=public-ip` entries are excluded from `DIRECT`/bypass rules by default. Use `--allow-public-direct` only after confirming that the public destination must also bypass the proxy.

## 📮 Contact

mr.xing0324@outlook.com

windows-proxy-route-manager

windows-proxy-route-manager Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

windows-proxy-route-manager

windows-proxy-route-manager Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README