net/upnp: miniupnpd >= 2.3.10 exits if the STUN server lacks RFC 5780; help text names one that fails

オープン 初心者向け
#5,940 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
82/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
php
領域
documentation

調査の方向性

UPnP IGD と PCP の設定ページのヘルプテキストと、issue で言及されている os-upnp のリリースノートを見つけてください。記載されている STUN サーバーを提供された互換性の結果と照合し、設定するサーバーが RFC 5780 をサポートする必要があることを明確にしてください。ヘルプテキストに互換性のあるサーバーのみが記載され、リリースノートに古い設定ではサーバーの変更が必要になる場合があると記載されていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

Important notices
Before you add a new report, we ask you kindly to acknowledge the following:

Describe the bug
Since miniupnpd 2.3.10 (miniupnp/miniupnp#825, dc4a131d), the daemon accepts only STUN servers that implement RFC 5780 (they must return OTHER-ADDRESS). With any other server it logs STUN server not supported … for every response, then Performing STUN failed. EXITING, and does not start.

os-upnp 1.10 on 26.7.9 ships 2.3.11. A configuration that worked on 2.3.9 with a common public STUN server stops miniupnpd on upgrade; the settings page gives no hint. Widely used public servers fail: stun.l.google.com:19302 and stun.cloudflare.com:3478. One of the two servers named in the page's own help text fails as well: stun.counterpath.com.

Last known working: os-upnp 1.9 / miniupnpd 2.3.9.

To Reproduce

  1. Services → UPnP IGD & PCP: set STUN server stun.l.google.com, port 19302; save.
  2. Start the service on a 2.3.11 daemon.
  3. miniupnpd exits (log below).

Checked against each server with 2.3.11's own teststun (built from the port: 2.3.11 + 0f668f1, --disable-pppconn --firewall=pf --libpfctl --vendorcfg --portinuse --leasefile --igd2 --ipv6), on OPNsense 26.1.3 / FreeBSD 14.3:

STUN server 2.3.11
stun.l.google.com:19302 rejected: no OTHER-ADDRESS
stun.cloudflare.com:3478 rejected: no OTHER-ADDRESS
stun.counterpath.com:3478 (in the help text) fails: no usable response
stun.3cx.com:3478 (in the help text) works
stun.nextcloud.com:3478 works
stun.sipgate.net:3478 works

Expected behavior

  • The help text names only servers that work with the shipped daemon (drop stun.counterpath.com; upstream's miniupnpd.conf lists stun.nextcloud.com, stun.sipgate.net, stun.3cx.com).
  • The page says the server must support RFC 5780, and the release notes warn that a STUN host set before 1.10 may need changing.

Relevant log files

miniupnpd: STUN server not supported, not returning OTHER-ADDRESS / support CHANGE-REQUEST's required for endpoint-independent (1:1) CGNAT filtering tests per RFC 5780.
miniupnpd: STUN: Performing STUN failed: Device not configured
miniupnpd: Performing STUN failed. EXITING

Additional context
The check is intentional upstream (#825: "For unsupported servers, display an error indicating compatible ones, and then fail"), so the fix belongs in the plugin's guidance rather than the daemon.

Environment
OPNsense 26.1.3 (amd64), miniupnpd 2.3.11 built from opnsense/ports opnsense/miniupnpd at 87223be5; os-upnp 1.10 help text from opnsense/plugins master.

主要言語
PHP
スター
1.2k
フォーク
917
平均マージ
1日 15時間
マージ済み PR(30日)
20

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

opnsense/plugins のほかの issue

opnsense/plugins の issue をすべて見る

似ている issue

PHP の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。