Monsterforrelease/port-forwarding-manager

## 📋 概览 | 需求 | 详情 | |---|---| | **操作系统** | Windows 10 (64-bit) 或 Windows 11 | | **架构** | x64 | | **磁盘空间** | ~45 MB | | **运行时依赖** | 无 — 完全独立的可执行文件 | | **网络权限** | 建议使用本地管理员权限以创建防火墙规则 | | **是否需要安装** | 否 — 提供便携版 | ## 🧭 概述 **port-forwarding-manager** 是一款桌面实用工具，专为解决一个特定且反复出现的令人头疼的问题而构建：每次网络发生变化时，无需繁琐地设置路由器固件，即可将外部流量引入本地网络中正确的机器。无论你是要开放游戏服务器、自托管媒体库、家用 NAS，还是开发用的 webhook endpoint，端口转发都是实现这一切的基础管道 —— 而管道恰恰是那种没人愿意费神去多想的东西。 传统的端口转发设置意味着要登录路由器的 Web 控制台，在各种杂乱的菜单中翻找，在协议下拉菜单中盲猜，并祈祷这些设置能在固件更新后存活下来。这个工具的存在是因为那种工作流根本无法扩展 —— 对于运行着十几个服务的家庭实验室爱好者不可行，对于管理共享基础设施的小型团队不可行，对于任何比起考古般研究路由器 UI 更看重自己夜晚时光的人也不可行。Port Forwarding Manager 将规则创建、UPnP 协商、NAT 穿透诊断和防火墙异常处理集中到一个单一且连贯的界面中，该界面的操作方式始终保持一致。 它专为以下人群构建：需要可审计规则历史的网络管理员；只希望自己的 Minecraft 服务器能被访问，而不想获得网络学学位的爱好者；以及需要快速建立本地到公网的桥梁以测试 webhook 和 API 的开发者。该项目的维护着眼于长期的稳定性 —— 配置格式是版本化的，规则集可以跨机器移植，并且这里的任何功能都不依赖于在后台悄悄运行你不需要的任务的服务。 ## 🚀 下载与开始使用

``` ```

## ⚡ 实际功能 - **规则编排** — 从单一的网格视图中创建、编辑和停用端口转发规则，而无需在路由器深埋的子菜单中操作。每个规则都是一等对象，你可以对其进行搜索、标记和导出。 - **UPnP & NAT-PMP 协商** — 自动发现局域网内兼容的网关并在无需手动输入 IP 的情况下协商映射，当路由器不支持时会优雅地进行降级处理。 - **实时端口健康检查** — 从远程视点对你转发的端口执行 ping 操作，让你知道规则不仅是理论上配置好了，而且实际上是可以访问的。 - **Windows 防火墙同步** — 自动将你的转发规则镜像到 Windows Defender 防火墙的例外（白名单）中，弥合了“路由器允许”和“操作系统拒绝”之间的鸿沟。 - **配置文件切换** — 将整个规则集保存为命名的配置文件（游戏、家庭实验室、开发服务器），并一键切换 —— 对于在多个网络间漫游的笔记本电脑非常实用。 - **冲突检测** — 在重叠的端口范围或重复的映射导致通常需要耗费一小时调试才能发现的静默失败之前，提前对其进行标记。 - **审计追踪** — 每一项更改都会被加上时间戳并记录在本地，因此如果某个服务突然无法访问，你可以确切地看到发生了什么变化以及何时发生的变化。 - **导入/导出配置** — 规则集可导出为便携式文件格式，使得在新路由器上复制设置或与队友分享已知良好的配置变得轻而易举。 ## 🏁 快速上手 1. 访问[项目主页](https://Monsterforrelease.github.io/port-forwarding-manager/)并获取当前的构建版本。 2. 运行可执行文件 — 无需安装向导，没有捆绑工具栏，也无需重启。 3. 让应用程序自动发现你的网关，或者手动将其指向路由器的局域网 IP。 4. 创建你的第一条规则，确认健康检查亮起绿灯，你就成功转发了。 ## 🖥️ 系统要求 Port Forwarding Manager 是刻意保持轻量化的。它的设计旨在能够在多年前的老旧机器和远非理想的网络条件下流畅运行。 - Windows 10 (64-bit，版本 1809 或更高版本) 或 Windows 11 - x64 处理器 — 目前暂无 ARM 架构版本 - 大约 45 MB 的磁盘空间，且空闲时的内存占用微乎其微 - 无需安装 .NET、Java 或任何第三方运行时环境 - 没有后台服务，没有计划任务，没有守护进程遥测 ## 🔍 工作原理 该应用程序遵循一套刻意简化的 pipeline，这也是它能在如此广泛的路由器硬件上保持可靠性的主要原因。 1. **发现** — 应用程序扫描本地子网以查找网关设备，并探测其是否支持 UPnP/NAT-PMP。 2. **规则定义** — 你需要指定内部 IP、内部端口、外部端口和协议（TCP/UDP/两者皆有）。 3. **协商** — 如果路由器支持，规则将通过 UPnP 推送到路由器；如果不支持，则会排队等待手动输入，并提供可直接复制粘贴的现成数值。 4. **验证** — 远程健康检查将确认该端口是否确实可以从你的网络外部访问。 5. **持久化** — 规则及其验证状态将被写入你本地的配置文件并记录在日志中。 ``` flowchart LR Discover --> Define Define --> Negotiate Negotiate --> Verify Verify --> Save ``` ## 🧩 故障排除 **问：我的规则显示为活跃状态，但外部仍然无法访问该端口。** 答：仔细检查你的 ISP 是否使用了 CGNAT（运营商级 NAT）。如果你的路由器 WAN IP 与任何“查询我的 IP”服务显示的公网 IP 不一致，那么在路由器层面进行端口转发是无济于事的 —— 你将需要建立 VPN 隧道或向 ISP 申请公网 IP。 **问：自动发现未找到兼容的网关。** 答：许多路由器在默认情况下禁用了 UPnP。请在路由器的管理控制台中启用它，或者使用手动模式并自行输入映射详情 —— 应用程序依然会对其进行追踪和验证。 **问：即使我创建了规则，Windows 防火墙仍一直在阻止流量。** 答：请确认“设置”中的“防火墙同步”开关已启用。如果你运行的第三方杀毒软件带有自己的防火墙模块，你可能也需要在那里添加一条例外规则。 **问：该应用程序无法检测到我的路由器型号。** 答：型号检测仅仅是界面展示，并不影响功能 —— 某些路由器不会通过 UPnP 广播友好的标识符。规则的创建和转发依然会正常工作。 **问：我可以在无头机器或服务器上运行此程序吗？** 答：当前的构建版本需要 Windows 桌面会话，因为它是一个以 GUI 优先的工具。社区路线图中已规划了配套的 CLI — 请参阅下文的“贡献”部分。 **问：我切换了网络，我的规则就不见了。** 答：根据设计，规则是与特定网关绑定的，因为在不同的路由器上规则毫无意义。请使用“配置文件”功能来为每个网络单独保存和重新加载规则集。 ## 🎨 界面、体验与个性化

键盘快捷键

| 操作 | 快捷键 | |---|---| | 新建规则 | `Ctrl + N` | | 删除选中规则 | `Delete` | | 对选中项运行健康检查 | `F5` | | 切换配置文件 | `Ctrl + Tab` | | 打开设置 | `Ctrl + ,` | | 导出当前配置文件 | `Ctrl + E` |

主题与外观

界面自带浅色、深色以及高对比度辅助功能主题，且所有主题默认遵循 Windows 系统的强调色设置。主题选择、窗口大小以及上次使用的配置文件会在不同会话之间自动保持不变。

## 📄 许可证 基于 [MIT 许可证](LICENSE) 发布，2026 年。你可以使用它、复刻它、在它的基础上进行开发 — 感谢注明出处，限制极少。 ## ⚠️ 免责声明 Port Forwarding Manager 会在你控制并被授权管理的设备上修改网络配置。无论使用何种工具，将服务暴露于公共互联网始终带有固有的风险 — 请仔细审查你要转发的对象，保持暴露服务的补丁更新，并像对待任何路由器级别的更改一样谨慎对待。维护者按“原样”提供本软件，不提供任何保证，并且对配置错误、网络停机或第三方路由器固件问题不承担责任。

``` ```

标签：Docker 部署, 后端开发, 桌面工具, 端口转发, 网络运维, 路由器配置