コミュニティソリューション

ZimaOS 1.2.5でのJellyfinポート1900/1901の競合:過去の修正と現在の状況

An October 2024 IceWhale support thread where new ZimaOS LAN-discovery services occupied ports used by Jellyfin. Staff provided temporary systemctl stop/disable commands, users saw the conflict return after reboot, and ZimaOS 1.3.0 later listed ports 1900/1901 as fixed for Plex/media compatibility.

これは現在の Jellyfin セットアップ要件ではなく、特定の過去バージョンに関する問題です。ZimaOS 1.2.5 では、IceWhale が Windows LAN デバイス検出および DLNA 関連サービスを追加しました。これらのサービスがポート 1900 と 1901 を使用していたため、Jellyfin が正常に起動または再起動できない場合がありました。

当初の公式回避策では検出サービスを停止した

777-Spider は、競合している ZimaOS サービスとして minidlnad.servicessdpd.service を特定し、一時的に停止・無効化するコマンドを投稿しました。ユーザーが手順に従うと、Jellyfin は再び動作しました。

これらのコマンドは、IceWhale のスタッフがこの特定の過去リリース向けに投稿したものなので、信頼できる一次情報です。ただし、現在の標準設定として扱うべきではありません。

再起動後に競合が再発した

情報源のユーザーは、ZimaOS を再起動すると Jellyfin が再び失敗したと報告しました。その後の Docker エラーでは、ポート 1901/tcp がすでに使用中であることが示されました。

Zima-Jerry がポート 1901 の使用元として ssdpd を特定した

Zima-Jerry は、新しい UPnP/Windows デバイスブロードキャストサービスがポート 1901 を使用しており、無効化操作が想定どおり保持されていなかったと説明しました。次のリリースまでは、起動後にユーザーが再度 ssdpd.service を停止する必要がある場合がありました。

IceWhale はポートを移動すると説明した

公式回答では、ssdpd が使用していた 1901 番ポートを次期リリースで変更し、Jellyfin が検出サービスと競合しないようにするとも説明されていました。

ZimaOS 1.3.0 では後にポート競合が修正項目として記載された

IceWhale の ZimaOS 1.3.0 リリースノートには、Plex を利用できるようにポート 1900 と 1901 の占有を修正したと明記されています。このリリースレベルの修正が重要な現在の境界です。最新の ZimaOS を使用しているユーザーは、2024 年の記事に書かれているというだけで、まず古いサービスを無効化して Jellyfin のトラブルシューティングを始めるべきではありません。

現在のポート競合は実際のエラーから診断する

現在の Jellyfin コンテナが address already in use で失敗する場合は、Docker エラーから正確なポートを特定し、そのポートを使用しているホストプロセスまたはコンテナを確認してください。過去の ssdpd/minidlnad の不具合だと決めつけないでください。

DLNA と検出用のポートは Jellyfin の Web ポートとは異なる

Jellyfin の通常のブラウザーインターフェースは、SSDP/DLNA 検出とは異なるポートを使用します。そのため、検出機能で競合が発生していても WebUI は動作する場合があります。また、別のサービスがすでに使用しているホストポートをアプリ定義が公開しようとすると、コンテナが失敗することがあります。

systemctl disable で無効化が想定どおり維持されなかった理由

ユーザーは、最初に無効化コマンドを実行したにもかかわらず、再起動後にサービスが戻ってきたと報告しました。Zima-Jerry は、1.2.5 の環境では ssdpd が実際には無効化状態を維持していなかったことを認めました。そのため、リリースレベルの修正が提供されるまでは、公式の回避策でも起動後にサービスを再度停止する必要がありました。

Docker エラーによって正確なポートが特定された

再起動後のエラーには、failed to bind port 0.0.0.0:1901/tcpaddress already in use が含まれていました。このような Docker メッセージは、ポート競合と Jellyfin のデータベースまたはメディア権限の問題を区別する最も迅速な手がかりになります。

古い systemctl コマンドは ZimaOS 1.2.5 に限定して扱う

情報源にあるコマンドは、特定の一時的なリグレッションに対する公式の対応でした。最新の ZimaOS ビルドでは、検出サービスを停止すると機能が失われるだけで、実際の競合が解決しない可能性があります。まず現在のポート使用元を確認し、そのうえで本当に原因となっているサービスを変更してください。

過去の Jellyfin ポートに関する FAQ

この競合が記録されていた ZimaOS のバージョンはどれですか?

ZimaOS 1.2.5 です。

関係していたサービスはどれですか?

IceWhale のスタッフは、minidlnad.servicessdpd.service を特定しました。

IceWhale は後に修正しましたか?

はい。ZimaOS 1.3.0 のリリースノートには、1900/1901 番ポートの占有問題が修正されたと記載されています。

現在のユーザーはこれらのサービスを自動的に無効化すべきですか?

いいえ。まず、現在実際にポートを使用している対象を特定してください。