iStoreOS功能:服务 > UPnP IGD 和 PCP > 高级设置

菜单路径:服务 > UPnP IGD 和 PCP

菜单链接:https://192.168.100.1/cgi-bin/luci/admin/services/upnp

当前标签:高级设置

配置选项

使用 STUN

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:启用 STUN(Session Traversal Utilities for NAT)功能,用于检测路由器的公网 IP 地址和 NAT 类型,帮助在对称型 NAT 环境下正确处理 UPnP 映射。常用于需要穿透严格防火墙或双层 NAT 的场景。

配置详情

  • 类型checkbox
  • 默认值false

STUN 主机

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:设置 STUN 服务器的域名或 IP 地址,用于与外部服务器通信以探测 NAT 类型和公网 IP。用户可自定义为可靠的 STUN 服务,如 Google 或 Twilio 提供的公共 STUN 服务器。

配置详情

  • 英文名称stun_host
  • 类型text
  • 默认值stun.sipgate.net

使用示例

示例:stun.l.google.com
格式:仅输入域名或IP地址,不要包含端口或协议

STUN 端口

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:指定 STUN 服务器使用的端口号,默认为标准 STUN 端口 3478。某些网络环境可能需要更换为其他端口以绕过防火墙限制。

配置详情

  • 英文名称stun_port
  • 类型text
  • 描述:3478

使用示例

示例:3478
注意:通常保持默认即可,除非特定运营商封锁该端口

强制转发

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:强制创建端口转发规则,即使当前网络环境不建议或存在冲突。启用后可提升设备获取外部端口映射的成功率,但可能影响防火墙安全性。

配置详情

  • 类型checkbox
  • 默认值true

启用安全模式

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:开启安全模式,限制只有局域网内受信任的设备才能请求端口映射,防止恶意设备滥用 UPnP 功能进行端口暴露,推荐家庭网络中保持启用。

配置详情

  • 类型checkbox
  • 默认值true

通知的时间间隔

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:设置 UPnP 设备通知其他设备的周期时间(秒),用于广播自身服务状态。较短间隔可提高响应速度,但增加网络开销;默认 900 秒(15 分钟)较为平衡。

配置详情

  • 英文名称notify_interval
  • 类型text
  • 描述:900

使用示例

示例:600
范围:建议设置在 300~1800 之间

SOAP/HTTP 端口

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:设置 UPnP 服务监听的 SOAP/HTTP 端口,用于响应来自局域网设备的控制请求。更改此端口会影响设备发现过程,需确保无冲突。

配置详情

  • 英文名称port
  • 类型text
  • 描述:5000
  • 默认值5000

使用示例

示例:5000
注意:避免使用已被占用或敏感服务使用的端口

服务网址

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:定义 UPnP 控制服务的基础 URL 地址,客户端将通过此地址访问设备描述和服务接口。通常指向路由器管理页面或虚拟路径。

配置详情

使用示例

示例:http://192.168.1.1:5000/rootDesc.xml
格式:完整的 HTTP 地址,包含协议和路径

设备 UUID

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:设置设备的唯一标识符(UUID),用于在网络中区分不同的 UPnP 设备。每个设备必须有唯一的 UUID,否则可能导致服务冲突或识别错误。

配置详情

  • 英文名称uuid
  • 类型text

使用示例

示例:uuid:12345678-1234-5678-9abc-def012345678
格式:标准 UUID 字符串,可自动生成

通告的设备型号

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:自定义对外广播的设备型号名称,用于在 UPnP 客户端(如媒体播放器、游戏机)上显示更易识别的设备信息。

配置详情

  • 英文名称model_number
  • 类型text

使用示例

示例:iStoreOS_Router_UPnP
说明:可填写品牌+型号,便于局域网设备识别

通告的设备序列号

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:设置UPnP设备对外通告的序列号,用于标识路由器设备。用户可在设备管理或网络发现中看到此序列号,可用于自定义设备识别信息。

配置详情

  • 英文名称serial_number
  • 类型text

使用示例

SN12345678

用系统运行时间代替进程运行时间

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:启用后,UPnP服务将使用系统启动时间作为运行时间,而非服务进程自身的运行时间。适用于希望时间显示更稳定一致的场景,避免重启服务导致时间重置。

配置详情

  • 类型checkbox
  • 默认值true

启用额外的日志

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:开启后会记录更详细的UPnP操作日志,包括端口映射请求、客户端信息等。适合排查连接问题或监控设备网络行为时使用,但可能增加日志输出量。

配置详情

  • 类型checkbox
  • 默认值false

服务租约文件

功能位置:服务 > UPnP IGD 和 PCP → 高级设置

功能说明:指定UPnP服务保存当前端口租约信息的文件路径,用于持久化记录动态端口映射状态。重启服务时可恢复之前的映射规则,确保连接不中断。

配置详情

  • 英文名称upnp_lease_file
  • 类型text
  • 描述:/var/run/miniupnpd.leases
  • 默认值/var/run/miniupnpd.leases

使用示例

/var/run/miniupnpd.leases