ネットワーク要件

本ページに記載のファイアウォール例外申請・FQDN ホワイトリスト登録・UFW 設定・社内ネットワーク機器の設定変更は、すべてお客様側の責任範囲となります。 弊社（デジタルヒューマン株式会社）では情シスへのファイアウォール開放申請を代行しておりません。導入の遅延を避けるため、必ず事前に貴社のネットワーク管理者と本ページを共有してください。

インストール作業はお客様にご準備いただいたリモート接続を通じて実施します。機材のお預かりやオンサイトでの作業は承っておりません。リモート接続経由でのインストール準備（SSH / ngrok 等）については リモートインストール支援 をご覧ください。

概要

本ページは、ミニプレム（MiniPrem）を社内ネットワークに導入する際に必要となる、ファイアウォール設定・FQDN ホワイトリスト・WebRTC 用ポート・Azure TTSやElevenLabs（音声合成）リージョン選定・接続検証コマンドをまとめた早見資料です。日本のエンタープライズ環境ではアウトバウンド通信が厳しく制限されているケースが多いため、本ページを情報システム部門へ事前共有することで、ファイアウォール例外申請の往復回数を削減できます。

MiniPrem はデジタルヒューマンの映像・音声を WebRTC で表示端末へ配信します。MiniPrem ホストと表示端末が同一プライベートネットワーク内にある場合は P2P 接続、NAT/VPN/別 VLAN を跨ぐ場合は TURN/STUN 経由の中継接続が必要となり、それぞれで開放すべきポート構成が変わります。本ページではこの 2 パターンを並列で示します。

ハードウェア要件・OS 要件・apt パッケージ等の前提条件は 前提条件 を、リモート接続（SSH / ngrok / TeamViewer）経由のインストール支援手順は リモートインストール支援 を参照してください。

ファイアウォール早見表

下表は、MiniPrem ホスト側（Renny サーバー）と表示端末側それぞれについて、共通設定・P2P 追加・TURN/STUN 追加の 3 区分で開放が必要なポートを一覧化したものです。情シス申請時のチェックリストとしてそのままご利用いただけます。

MiniPrem ホスト側

項目	共通	P2P 追加	TURN/STUN 追加
SSH	TCP 22 IN（管理端末 IP から）	-	-
デジタルヒューマン プラットフォームの認証、Azure TTS / ElevenLabs など	TCP 443 OUT	-	-
DNS	UDP/TCP 53 OUT	-	-
HTTP/HTTPS	TCP 80/443 OUT	-	-
P2P 接続	-	UDP 49152-65535 IN（表示端末 IP から）	-
STUN/TURN	-	-	UDP 3478 OUT/IN
TURN TLS	-	-	TCP 5349 OUT
WebRTC（TURN）	-	-	UDP 49152-65535 OUT/IN

表示端末側

項目	共通	P2P 追加	TURN/STUN 追加
デジタルヒューマン プラットフォーム	TCP 443 OUT	-	-
DNS	UDP/TCP 53 OUT	-	-
HTTP/HTTPS	TCP 80/443 OUT	-	-
P2P 接続	-	UDP 49152-65535 OUT（通常は既に許可済み）	-
STUN/TURN	-	-	UDP 3478 OUT
TURN TLS	-	-	TCP 5349 OUT
WebRTC（TURN）	-	-	UDP 49152-65535 OUT

P2P 接続が成立する条件は「MiniPrem と表示端末が同一端末、もしくは NAT/VLAN を跨がず互いにプライベート IP で直接通信できる同一ネットワーク上にあること」です。NAT 越えが必要な場合は TURN/STUN 構成を選択してください。

必須 FQDN ホワイトリスト

アウトバウンド TCP 443 で許可が必要な FQDN の一覧です。日本のエンタープライズ環境ではドメイン単位のホワイトリスト申請が一般的なため、本セクションをそのまま情シス申請に添付してください。

プラットフォーム / シグナリング

FQDN	用途
*.uneeq.io	デジタルヒューマン プラットフォームのシグナリング・API・WebSocket 接続
*.digitalhumans.ne.jp	デジタルヒューマン日本向けプラットフォーム
*.hosted-experience.jp	デジタルヒューマン配布版インストーラー・シグナリング・静的コンテンツ
*.digitalhumans-demo.jp	デジタルヒューマンデモ用フロントエンド ホステッドエクスペリエンス デモ コンフィグレーター（表示端末側で使用）

Docker レジストリ

FQDN	用途
hub.docker.com	Docker Hub（旧構成 / デジタルヒューマン配布版）
cr.uneeq.io	Harbor レジストリ（公式 MiniPrem イメージ取得）

TTS（音声合成）/ STT（音声認識）

FQDN	用途
*.tts.speech.microsoft.com	Azure Cognitive Services TTS（全リージョン）
japaneast.tts.speech.microsoft.com	Azure TTS 日本東リージョン（最優先で許可）
api.elevenlabs.io	ElevenLabs TTS API

TURN/STUN サーバー

FQDN	用途
*.turn.uneeq.io	NAT 越え用 TURN/STUN サーバー（マルチリージョン）
turn.us.uneeq.io	米国 TURN サーバー

2026 年 6 月現在、上記 FQDN のうち *.digitalhumans.ne.jp / *.hosted-experience.jp / *.digitalhumans-demo.jp は弊社（デジタルヒューマン株式会社）固有のドメインです。デジタルヒューマン提供の固有ドメインのため、貴社の情シス申請に必ず含めてください。

P2P 接続（同一ネットワーク内）

MiniPrem と表示端末が同一プライベートネットワーク上にある場合に推奨される構成です。TURN サーバーを経由しないため遅延が最も小さく、運用品質が安定します。

MiniPrem ホスト側で必要なポート

プロトコル	ポート	方向	送信元	用途
UDP	49152-65535	IN	表示端末 IP	WebRTC P2P メディアストリーム（音声・映像・データチャネル）

WebRTC は動的ポート割り当て方式のため、ホスト側で 49152-65535 の UDP 動的ポート範囲全体を表示端末 IP からの IN 通信に対して開放する必要があります。

動作イメージ

表示端末                                    MiniPrem ホスト
UDP 53872（動的割り当て） ←―直接接続/P2P―→ UDP 49152-65535（動的割り当て）
                                          ↑この範囲への接続許可が必須

UFW 設定例（MiniPrem ホスト側 P2P 追加分）

#!/bin/bash
# P2P 接続時の追加設定（MiniPrem ホスト側）

# 表示端末の IP アドレスを設定
CLIENT_IP="192.168.200.100"  # ← 実際の表示端末 IP に変更

# 方法 1: 表示端末からのすべての通信を許可（推奨・最もシンプル）
sudo ufw allow from ${CLIENT_IP} comment "P2P from client ${CLIENT_IP}"

# 方法 2: 高位動的ポート範囲のみ許可（より厳格）
# sudo ufw allow from ${CLIENT_IP} to any port 49152:65535 proto udp comment "P2P WebRTC from client"

# IPv6 を使用する場合
# CLIENT_IPV6="fddf:6257:ea18:94b5:86ef:4cce:1dbf:2cee"
# sudo ufw allow from ${CLIENT_IPV6} comment "P2P from client IPv6"

sudo ufw reload

表示端末側

表示端末側は Outbound がデフォルト許可されている環境であれば追加設定は不要です。デフォルトポリシーが DENY の場合のみ、以下を追加します。

#!/bin/bash
# P2P 接続時の追加設定（表示端末側 / Linux UFW）
# Windows / macOS の場合は読み替えてください

SERVER_IP="192.168.200.200"  # ← 実際の MiniPrem ホスト IP に変更
sudo ufw allow out to ${SERVER_IP} proto udp comment "P2P to MiniPrem"
sudo ufw reload

P2P 接続を選択した場合、STUN/TURN 用の UDP 3478 / TCP 5349 / UDP 22000-23000 の開放は 不要 です。誤って TURN サーバー側の UDP 22000-23000 を開放しないよう注意してください。

TURN/STUN 構成（NAT 越え接続）

MiniPrem と表示端末が別のネットワーク（NAT/VPN/別 VLAN）に分かれている場合の構成です。通常のサービス運用ではこちらが標準的な構成となります。

MiniPrem ホスト側で必要なポート

プロトコル	ポート	方向	宛先/送信元	用途
UDP	3478	OUT/IN	*.turn.uneeq.io / turn.us.uneeq.io	STUN/TURN（NAT Traversal、ICE 候補収集）
TCP	5349	OUT	*.turn.uneeq.io / turn.us.uneeq.io	TURN over TLS（セキュアなフォールバック）
UDP	49152-65535	OUT/IN	*.turn.uneeq.io	WebRTC メディア（TURN 経由）

動作イメージ

MiniPrem ホスト           TURN サーバー              表示端末
UDP 49152-65535  ←―→   UDP 22000-23000  ←―→   UDP 49152-65535
   (動的)                   (TURN 側)                (動的)
    │                         │                       │
    └── UDP 3478 で STUN/TURN 接続確立 ─────────────────┘

UFW 設定例（MiniPrem ホスト側 TURN/STUN 追加分）

#!/bin/bash
# TURN/STUN 使用時の追加設定（MiniPrem ホスト側）

# STUN/TURN（最重要）
sudo ufw allow out 3478/udp comment 'STUN/TURN - NAT Traversal'
sudo ufw allow in 3478/udp comment 'STUN/TURN response'

# TURN over TLS（フォールバック）
sudo ufw allow out 5349/tcp comment 'TURN over TLS'

# WebRTC メディア（TURN 経由）
sudo ufw allow out 49152:65535/udp comment 'WebRTC media via TURN (out)'
sudo ufw allow in 49152:65535/udp comment 'WebRTC media via TURN (in)'

sudo ufw reload

UDP 49152-65535 を全 IP から許可するとセキュリティリスクがあります。可能な場合は TURN サーバーの IP アドレスを sudo ufw allow from <TURN_SERVER_IP> to any port 49152:65535 proto udp のように指定してください。 また、TURN サーバー側で使用される UDP 22000-23000 は MiniPrem ホスト側で開放する必要は ありません。

表示端末側

通常 Outbound はデフォルト許可のため追加設定不要ですが、厳格なファイアウォール環境では以下を許可します。

# STUN/TURN
sudo ufw allow out 3478/udp comment 'STUN/TURN'
# TURN over TLS
sudo ufw allow out 5349/tcp comment 'TURN over TLS'
# WebRTC メディア（TURN 経由）
sudo ufw allow out 49152:65535/udp comment 'WebRTC media via TURN'
sudo ufw reload

UFW 完全設定スクリプト（MiniPrem ホスト側）

共通設定・P2P・TURN/STUN を組み合わせた完全な UFW 設定スクリプトです。ADMIN_IP / CLIENT_IP / TURN_SERVER_IP を貴社環境に合わせて書き換えてご利用ください。

#!/bin/bash
# MiniPrem TURN/STUN 使用 - 完全なファイアウォール設定
set -e

ADMIN_IP="192.168.200.10"        # ← 管理端末 IP（SSH 用）
# TURN_SERVER_IP="203.0.113.10"  # ← TURN サーバー IP が分かる場合は設定

# 既存ルールのバックアップ
sudo ufw status numbered > /root/ufw_backup_$(date +%Y%m%d_%H%M%S).txt

# デフォルトポリシー
sudo ufw default deny incoming
sudo ufw default allow outgoing

# IPv6 サポート
sudo sed -i 's/IPV6=no/IPV6=yes/' /etc/default/ufw

# === 共通設定 ===
sudo ufw allow from ${ADMIN_IP} to any port 22 proto tcp comment 'SSH from admin'
sudo ufw allow out 443/tcp comment 'プラットフォーム + Azure TTS'
sudo ufw allow out 53/udp comment 'DNS query'
sudo ufw allow out 53/tcp comment 'DNS query TCP'
sudo ufw allow out 80/tcp comment 'HTTP'

# === TURN/STUN 設定 ===
sudo ufw allow out 3478/udp comment 'STUN/TURN'
sudo ufw allow in 3478/udp comment 'STUN/TURN response'
sudo ufw allow out 5349/tcp comment 'TURN over TLS'

if [ -n "${TURN_SERVER_IP}" ]; then
    sudo ufw allow from ${TURN_SERVER_IP} to any port 49152:65535 proto udp comment 'WebRTC from TURN'
    sudo ufw allow out to ${TURN_SERVER_IP} port 49152:65535 proto udp comment 'WebRTC to TURN'
else
    sudo ufw allow out 49152:65535/udp comment 'WebRTC media via TURN (out)'
    sudo ufw allow in 49152:65535/udp comment 'WebRTC media via TURN (in)'
fi

sudo ufw reload
sudo ufw status numbered

Azure TTS リージョン選定（日本からの RTT 計測）

Azure TTS のリージョン選定は、デジタルヒューマンの発話レイテンシに直結します。デフォルトでは japaneast を選択するケースが多いですが、ピーク時の遅延次第では他リージョンへの切替を検討する価値があります。下記のスクリプトを MiniPrem ホスト上で実行することで、主要 13 リージョンに対する 5 回平均 RTT を計測できます。

計測対象リージョン（13 リージョン）

リージョン	地域
japaneast	日本（東京）
japanwest	日本（大阪）
eastus / eastus2	米国東部
westus / westus2	米国西部
centralus / southcentralus	米国中部
southeastasia	シンガポール
eastasia	香港
koreacentral / koreasouth	韓国
eastindia	インド東部

計測スクリプト

tmpfile=$(mktemp)
for region in japaneast japanwest eastus eastus2 westus westus2 \
              centralus southcentralus southeastasia eastasia \
              koreacentral koreasouth eastindia; do
    url="https://${region}.tts.speech.microsoft.com"
    echo "リージョン: $region への接続テスト"
    sum=0
    for i in {1..5}; do
        t=$(curl -s -o /dev/null -w "%{time_total}" "$url")
        printf "  %d 回目: %s 秒\n" "$i" "$t"
        sum=$(echo "$sum + $t" | bc)
    done
    avg=$(echo "scale=6; $sum/5" | bc)
    printf "  → 平均 RTT: %s 秒\n" "$avg"
    echo "${region},${avg}" >> "$tmpfile"
done
echo -e "\n=== Azure TTS 全リージョン RTT 結果（RTT が短い順）==="
sort -t, -k2,2n "$tmpfile" | awk -F, '{printf("  %2d. %-20s : %s 秒\n", NR, $1, $2)}'
rm -f "$tmpfile"

日本国内から計測した場合、通常は japaneast が最短 RTT となります。ただし国内バックボーンの混雑時には koreacentral や japanwest が同等以下になるケースもあるため、本番環境では実測値を基にリージョンを決定することを推奨します。

WebRTC パケットロス品質判定

映像のコマ落ち・再接続が発生した際に、原因がネットワーク側か MiniPrem 側かを切り分けるための定量基準です。MiniPrem ホスト上で以下のコマンドを実行し、10 秒間で 500 パケットを送信してロス率を計測します。

ping -s 1200 -i 0.02 -c 500 digitalhumans-demo.jp

判定基準

パケットロス	判定	デジタルヒューマンの動作	推奨対策
≤ 1%	優秀	非常に滑らか	対策不要
≤ 3%	良好	滑らか	対策不要
≤ 5%	注意	やや不安定	ネットワーク環境の確認
≤ 10%	警告	不安定（途切れ頻発）	有線化・5GHz Wi-Fi・ルータ再起動
> 10%	不適	使用困難	ISP 問い合わせ・回線見直し

推奨対策（パケットロス 3% 超の場合）

1. 有線接続への切り替えを検討

2. Wi-Fi の場合は 5GHz 帯の使用を推奨

3. ルーター / アクセスポイントの再起動

4. ネットワーク帯域の確保（他アプリケーションの停止）

5. ISP への問い合わせ

接続検証コマンド

ファイアウォール設定後、または映像が表示されない場合の一次切り分けに使用するコマンドです。

UFW 状態確認

# UFW 状態確認
sudo ufw status numbered

# 特定ポートの確認
sudo ufw status numbered | grep -E "(3478|5349|49152|443)"

# UFW ログ確認
sudo tail -f /var/log/ufw.log

P2P 接続テスト

# 表示端末から MiniPrem ホストへの UDP 接続テスト
nc -u -v -z <MiniPrem ホスト IP> 49152

# MiniPrem ホストで待ち受け確認
ss -unap | grep -E "49[0-9]{3}|5[0-9]{4}|6[0-5]{4}"

TURN/STUN 接続テスト

# STUN サーバーへの接続テスト
nc -u -v -z turn.uneeq.io 3478

# TURN over TLS の接続テスト
nc -v -z turn.uneeq.io 5349

chrome://webrtc-internals/ での確認

表示端末側 Chrome で chrome://webrtc-internals/ を開き、セッション接続中に以下の値を確認します。

// P2P 接続の場合
"googLocalCandidateType": "host"
"googRemoteCandidateType": "host"
"iceConnectionState": "connected"

// TURN 経由の場合
"googLocalCandidateType": "relay"
"googRemoteCandidateType": "relay"
"iceConnectionState": "connected"

// 使用ポート確認
"googLocalAddress": "192.168.200.200:49152"
"googRemoteAddress": "192.168.200.100:53872"

iceConnectionState が connected にならず checking / failed で止まる場合は、UDP 49152-65535 範囲のいずれかが遮断されている可能性が高いです。本ページの早見表に従ってファイアウォール設定を見直してください。

ホスト疎通確認 URL

弊社サポートが顧客環境からの疎通可否を確認する際に使用する URL リストです。インストール前に MiniPrem ホストから以下の URL へ HTTP ステータスが正常に返ることを確認してください。

echo "Docker Hub 接続テスト:"
curl -s -o /dev/null -w "HTTP Status: %{http_code}, Time: %{time_total}s\n" https://hub.docker.com

echo "デジタルヒューマン プラットフォーム API 接続テスト:"
curl -s -o /dev/null -w "HTTP Status: %{http_code}, Time: %{time_total}s\n" https://api.uneeq.io

echo "デジタルヒューマン配布版インストーラー・シグナリング・静的コンテンツ接続テスト:"
curl -s -o /dev/null -w "HTTP Status: %{http_code}, Time: %{time_total}s\n" https://hosted-experience.jp

echo "デジタルヒューマンデモ接続テスト:"
curl -s -o /dev/null -w "HTTP Status: %{http_code}, Time: %{time_total}s\n" http://digitalhumans-demo.jp

不明点や疎通エラーが発生した場合は、計測結果（miniprem_precheck_YYYYMMDD_HHMM.txt）を サポート窓口 までお送りください。

関連ドキュメント

• はじめに

• 前提条件

• リモートインストール支援

• 問題診断ガイド

• Harbor レジストリ

• トラブルシューティング