Releases: JamesHa0/portproxy-gui
Releases · JamesHa0/portproxy-gui
Release list
v1.3.0 - 新增端口状态检测
✨ 新增功能
- 端口状态检测:并发检测每条端口转发规则的综合健康状态
- 🟢 正常:监听正常 + 目标可达
- 🟡 后端不可达:监听正常,但目标端口连不上
- 🔴 监听异常:端口未监听,或已被其他进程占用
- 错误信息分级:连接超时 / 连接被拒绝 / DNS 解析失败 / 网络不可达 / 未监听 / 被占用
- 桌面版:刷新时自动检测,双击或右键查看详细原因
- Web 版:列表先加载,状态异步回填,点击查看详情
🔧 改进
- 代码重构:提取公共逻辑到
portproxy_common.py,桌面版与 Web 版共用,消除 600+ 行重复代码 - 检测采用并发执行(ThreadPoolExecutor),规则再多也不卡界面
📦 下载
PortProxy.exe(桌面版,Windows)
🗒️ 说明
- 检测目标端口连通性时使用 2 秒超时
- 端口占用检测通过对比系统 IP Helper(iphlpsvc)进程识别,公平判定"被其他程序占用"
v1.2.0 — 日志面板 / 深色模式 / 国际化 / WSL 检测 / CSV 导入
PortProxy GUI v1.2.0
基于 Windows 自带 netsh interface portproxy 的可视化端口转发管理器(桌面版,零第三方依赖)。
本次更新(相比 v1.1.0)
- 新增 P3 命令日志面板:记录每次 netsh 执行的完整命令与输出(最多 200 条),桌面版 Ctrl+L 切换、Web 版可折叠卡片,便于排查转发失败原因
- 新增 P3 深色模式:桌面版 THEME_LIGHT / THEME_DARK 双主题字典 + 注册表持久化;Web 版 CSS 变量 + localStorage 一键切换
- 新增 P3 国际化(i18n):新建 i18n.py 模块(中/英双语约 100 个 key),桌面版设置菜单切换语言;Web 版 data-i18n 属性 + 语言按钮,偏好自动持久化
- 新增 P3 WSL2 转发检测:桌面版"工具 → 检测 WSL 转发"、Web 版顶部提示条,检测成功后一键预填目标地址为 WSL IP
- 新增 P3 CSV 批量导入:支持
type,listenAddress,listenPort,connectAddress,connectPort格式,自动识别 UTF-8 / GBK 编码,与 JSON 导入共用去重与校验逻辑 - 修复:server.py 编辑规则时 edit_type / edit_lp 等变量在重复检查前未定义导致的 NameError
- 修复:index.html addRule() 中 var 声明位于对象字面量内的 JS 语法错误
- 修复:relaunch_as_admin() 中错误引用 self 的遗留代码
使用
- 下载 PortProxy.exe
- 双击运行(首次会请求管理员权限,用于 netsh 端口转发)
- 仅支持 TCP(netsh portproxy 限制)
校验
- 文件:PortProxy.exe
- 若需要完整性校验,可在本地执行
Get-FileHash -Algorithm SHA256 PortProxy.exe
备注
- 桌面版与 Web 版(server.py / index.html)核心功能一致;本 Release 以桌面 EXE 为主交付对象。
- 已知限制:仅 TCP、主要面向 Windows。
- 语言与主题设置保存在注册表
HKCU\Software\PortProxyGUI,重装后自动恢复。
v1.1.0 — 托盘/自启增强 + 启动崩溃修复
PortProxy GUI v1.1.0
基于 Windows 自带 netsh interface portproxy 的可视化端口转发管理器(桌面版,零第三方依赖)。
本次更新(相比 v1.0.0)
- 新增 P0:非管理员启动时自动请求 UAC 提权(runas),桌面端多类型下拉支持 v4tov4 / v4tov6 / v6tov4 / v6tov6
- 新增 P1:JSON 导入/导出(一键备份与迁移)、添加规则时防火墙入站端口一键放行、规则编辑(先删后增同监听点)
- 新增 P2:系统托盘(最小化/关闭隐入托盘,左/右键菜单显示·刷新·退出)、开机自启(写入当前用户注册表 Run 键)
- 修复:Treeview
actions列未定义导致的启动崩溃 - 修复:64 位系统下托盘窗口过程子类化(wndproc)原型未声明导致的界面卡死/闪退
使用
- 下载
PortProxy.exe - 双击运行(首次会请求管理员权限,用于 netsh 端口转发)
- 仅支持 TCP(netsh portproxy 限制)
校验
- 文件:
PortProxy.exe - 若需要完整性校验,可在本地执行
Get-FileHash -Algorithm SHA256 PortProxy.exe
备注
- 桌面版与 Web 版(server.py / index.html)核心功能一致;本 Release 以桌面 EXE 为主交付对象。
- 已知限制:仅 TCP、主要面向 Windows。
PortProxy GUI v1.0.0
PortProxy GUI v1.0.0
基于 Windows netsh interface portproxy 的端口转发图形化管理工具 —— 桌面版正式发布。
功能特性
- 可视化查看 / 添加 / 删除端口转发规则(v4tov4)
- 启动即检测管理员权限,无权限时置顶红色警告并提示以管理员身份运行
- 中文系统
netsh输出 GBK/CP936 兼容解码,避免乱码 - 端口(1–65535)与地址(IPv4 / 主机名)前端 + 后端双重校验
- 添加已存在规则时返回「规则已存在」友好提示,而非裸报错
- 解析
netsh输出使用正则匹配数据行,兼容中英文表头 - 仅支持 TCP 协议(netsh 限制),界面已注明
使用方式
- 下载下方
PortProxy.exe - 右键 → 以管理员身份运行(netsh interface portproxy 必须管理员权限)
- 在图形界面中管理端口转发规则
说明
PortProxy.exe为单文件打包应用,无需安装 Python 运行环境。- 端口转发规则本身由 Windows 持久保存,重启后依然生效。
资产
PortProxy.exe— Windows 桌面端单文件应用