Skip to content

Releases: JamesHa0/portproxy-gui

v1.3.0 - 新增端口状态检测

Choose a tag to compare

@JamesHa0 JamesHa0 released this 07 Aug 13:50

✨ 新增功能

  • 端口状态检测:并发检测每条端口转发规则的综合健康状态
    • 🟢 正常:监听正常 + 目标可达
    • 🟡 后端不可达:监听正常,但目标端口连不上
    • 🔴 监听异常:端口未监听,或已被其他进程占用
    • 错误信息分级:连接超时 / 连接被拒绝 / DNS 解析失败 / 网络不可达 / 未监听 / 被占用
    • 桌面版:刷新时自动检测,双击或右键查看详细原因
    • Web 版:列表先加载,状态异步回填,点击查看详情

🔧 改进

  • 代码重构:提取公共逻辑到 portproxy_common.py,桌面版与 Web 版共用,消除 600+ 行重复代码
  • 检测采用并发执行(ThreadPoolExecutor),规则再多也不卡界面

📦 下载

  • PortProxy.exe(桌面版,Windows)

🗒️ 说明

  • 检测目标端口连通性时使用 2 秒超时
  • 端口占用检测通过对比系统 IP Helper(iphlpsvc)进程识别,公平判定"被其他程序占用"

v1.2.0 — 日志面板 / 深色模式 / 国际化 / WSL 检测 / CSV 导入

Choose a tag to compare

@JamesHa0 JamesHa0 released this 23 Jul 14:08

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 的遗留代码

使用

  1. 下载 PortProxy.exe
  2. 双击运行(首次会请求管理员权限,用于 netsh 端口转发)
  3. 仅支持 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 — 托盘/自启增强 + 启动崩溃修复

Choose a tag to compare

@JamesHa0 JamesHa0 released this 20 Jul 04:25

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)原型未声明导致的界面卡死/闪退

使用

  1. 下载 PortProxy.exe
  2. 双击运行(首次会请求管理员权限,用于 netsh 端口转发)
  3. 仅支持 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

Choose a tag to compare

@JamesHa0 JamesHa0 released this 18 Jul 09:00

PortProxy GUI v1.0.0

基于 Windows netsh interface portproxy 的端口转发图形化管理工具 —— 桌面版正式发布。

功能特性

  • 可视化查看 / 添加 / 删除端口转发规则(v4tov4)
  • 启动即检测管理员权限,无权限时置顶红色警告并提示以管理员身份运行
  • 中文系统 netsh 输出 GBK/CP936 兼容解码,避免乱码
  • 端口(1–65535)与地址(IPv4 / 主机名)前端 + 后端双重校验
  • 添加已存在规则时返回「规则已存在」友好提示,而非裸报错
  • 解析 netsh 输出使用正则匹配数据行,兼容中英文表头
  • 仅支持 TCP 协议(netsh 限制),界面已注明

使用方式

  1. 下载下方 PortProxy.exe
  2. 右键 → 以管理员身份运行(netsh interface portproxy 必须管理员权限)
  3. 在图形界面中管理端口转发规则

说明

  • PortProxy.exe 为单文件打包应用,无需安装 Python 运行环境。
  • 端口转发规则本身由 Windows 持久保存,重启后依然生效。

资产

  • PortProxy.exe — Windows 桌面端单文件应用