UPnP PortMapper：网络端口映射的智能管理工具
项目地址: https://gitcode.com/gh_mirrors/po/portmapper UPnP PortMapper是一款简洁易用的工具，专门用于管理支持UPnP协议的路由器端口映射（端口转发）。通过这个小巧的应用，你可以轻松查看、添加或删除网络中的端口映射，让内部服务器对外可见。
为什么需要端口映射？
在私有网络中运行的服务器（如SSH、Web、游戏服务器等）通常无法直接从互联网访问。虽然可以通过路由器的网页管理界面配置端口转发，但使用UPnP PortMapper更加便捷：只需创建新预设或选择现有预设，然后点击一个按钮即可为当前计算机添加端口映射，IP地址会自动获取！
核心功能特性
智能自动化配置 只需预设一次，后续点击按钮即可完成端口映射配置，完全免去手动输入IP地址的麻烦。
跨平台兼容性 基于Java 11+开发，支持Windows、Mac OS X和Linux系统，真正实现一次配置，随处运行。
多语言支持 界面支持英语和德语，PortMapper会根据操作系统语言自动选择语言设置。
双重操作模式 除了直观的图形界面，还提供强大的命令行接口，支持自动化脚本和定时任务。
快速上手指南
环境准备
UPnP PortMapper需要JRE 11（Java运行时环境）或更高版本。建议从AdoptOpenJDK下载最新的OpenJDK JRE。
对于Windows系统，请选择.msi安装程序，它会设置环境变量JAVA_HOME并将Java添加到PATH中。
运行PortMapper
要运行PortMapper，双击JAR文件或在命令行中运行：
java -jar portmapper.jar
获取项目代码
如果需要从源码构建，可以克隆项目仓库：
git clone https://gitcode.com/gh_mirrors/po/portmapper
cd portmapper
./gradlew build
java -jar build/libs/portmapper-*.jar
实际应用场景
远程办公解决方案 通过快速设置端口映射，让你在任何地方都能安全访问公司内部服务器，实现真正的移动办公。
家庭网络资源共享 轻松搭建个人云存储或媒体服务器，亲友访问更便捷，家庭网络利用更充分。
游戏体验优化 解决多人游戏联机问题，端口映射让局域网游戏也能享受公网联机的乐趣。
技术架构优势
UPnP PortMapper采用模块化设计，集成多个第三方UPnP库，确保与各种路由器设备的兼容性：
- Cling：
org.chris.portmapper.router.cling.ClingRouterFactory（默认库） - weupnp：
org.chris.portmapper.router.weupnp.WeUPnPRouterFactory - SBBI UPnP lib：
org.chris.portmapper.router.sbbi.SBBIRouterFactory - DummyRouterFactory：仅用于测试
命令行接口使用
PortMapper提供完整的命令行接口，可以通过添加参数-h查看可用选项：
java -jar portmapper.jar -h
实用示例
创建特定IP地址的新端口映射：
java -jar portmapper.jar -add -externalPort <port> -internalPort <port> -ip <ip-addr> -protocol tcp
为本地计算机创建新端口映射（只需省略IP）：
java -jar portmapper.jar -add -externalPort <port> -internalPort <port> -protocol tcp
删除端口转发：
java -jar portmapper.jar -delete -externalPort <port> -protocol tcp
列出现有端口转发：
java -jar portmapper.jar -list
常见问题解决
路由器未找到
- 检查路由器是否支持UPnP并在路由器设置中激活
- 在设置中使用不同的UPnP库
- 检查计算机上是否激活了网络桥接，尝试停用它
端口映射过期问题
某些路由器会在一段时间后删除端口映射。为避免这种情况，可以使用PortMapper的命令行接口在无限循环中添加端口映射。
端口未转发
如果使用工具验证端口转发是否有效，请确保启动服务器进程。如果在转发的端口上没有运行服务器，工具可能会显示端口已关闭。
开发与参与
PortMapper也可作为Maven依赖在其他程序中使用：
<dependency>
<groupId>com.github.kaklakariada</groupId>
<artifactId>portmapper</artifactId>
<version>2.2.4</version>
</dependency>
如需参与项目开发，请参考开发者指南文档，了解详细的构建流程和贡献方式。
UPnP PortMapper以其简洁高效的特性，让端口映射变得简单，为网络连接开辟新的可能。无论你是技术爱好者还是寻求便捷网络解决方案的用户，这都是一个值得一试的开源工具。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
