esp_wifi_repeater

フル機能のWiFi NATルーター（そして今ではWiFiリピーター、別名L2ブリッジでもあります）

NEW 2026: 初回リリースから10年を経て、それはついに、ずっとそうであろうとしていたものになりました：真のWiFiリピーター。既存のドキュメントやリンクを壊さないために、標準エディションは依然として、すべての高度な機能を備えた有名なNATルーターバージョンのままです。しかし、本格的なL2ブリッジの簡素化されたバージョンに興味があるなら、以下のセクション ESP8266 WiFi Repeater - L2 bridge をご覧ください。

これは、esp8266 および esp8285 上での WiFi NAT ルーターの実装です。また、ACL を備えたパケットフィルタリングファイアウォール、ポートマッピング、トラフィックシェーピング、リモートモニタリング（またはパケットスニッフィング）用のフック、MQTT 管理インターフェース、簡単な GPIO 操作、および電力管理のサポートも含まれています。より広いエリアをカバーするためにメッシュ構成で複数のルーターをセットアップするための新しいモード「Automesh」も含まれています。

NAT 機能を Arduino プロジェクトに統合する方法をお探しなら - こちら をご覧ください。

EPS32 NAT Router は ESP32 向けの高度なプロジェクトです。

典型的な使用シナリオは次のとおりです。

• 既存のWiFiネットワーク用のシンプルなレンジエクステンダー
• バッテリー駆動の屋外（メッシュ）ネットワーク
• ゲスト用に異なるSSID/パスワードを持つ追加のWiFiネットワークを設定する
• IoTデバイス用の安全で制限されたネットワークを設定する
• WPA2 EnterpriseネットワークをWPA-PSKに変換する
• WiFiトラフィック解析用のモニタープローブ
• ルート、ACL、トラフィックシェーピングを使ったネットワーク実験
• 基本的なI/O機能とMQTT制御を備えたメッシュIoTデバイス

デフォルトでは、ESP は STA およびソフトAPとして動作し、あらゆる IP トラフィックを透過的に転送します。NAT を使用しているため、ネットワーク側にも接続ステーション側にもルーティングエントリは必要ありません。ステーションはデフォルトで DHCP により 192.168.4.0/24 ネットワーク内で設定され、既存の WiFi ネットワークから DNS レスポンダアドレスを受け取ります。

測定結果によると、双方向で約 5 Mbps を達成できるため、ストリーミングも可能です。

いくつかの詳細はこの ビデオ で説明されています。

Webインストーラー

デバイスへの直接フラッシュには Web-Installer を使用してください。

初回起動

esp_wifi_repeater は次のデフォルト設定で起動します。

• ap_ssid: MyAP, ap_password: none, ap_on: 1, ap_open: 1
• network: 192.168.4.0/24

初回起動（またはファクトリーリセット）後、ESP はオープンAPと ssid "MyAP" を持つ WiFi ネットワークを提供します。有効な ssid やパスワードを知らないため、まだアップリンクAPへの自動再接続は試みません。

この WiFi ネットワークに接続し、シンプルな Web インターフェースまたはコンソール経由の全オプションを含む完全な設定のいずれかで基本設定を行ってください。

基本Web設定インターフェース

Web インターフェースでは、基本的な転送機能に必要なすべてのパラメータを設定できます。この主要な作業については rubfi に感謝します: https://github.com/rubfi/esp_wifi_repeater/ 。ブラウザで "http://192.168.4.1" を開いてください。次のページが表示されます。

まず、アップリンク WiFi ネットワークの適切な値、つまり "STA Settings" を入力します。オープンネットワークの場合はパスワード "none" を使用します。本当に automesh モードを使用したい場合にのみ "Automesh" ボックスにチェックを入れます。"Connect" をクリックします。ESP は再起動し、あなたの WiFi ルーターに接続します。数秒後、ステータス LED が点滅するはずです。

automesh を選択した場合、設定は完了です。"Soft AP Settings" の設定は必要ありません。automesh モードではこれらの設定は "STA Settings" と同じだからです。接続されたすべての ESP リピーターによって同じ ssid が提供されます。

automesh を使用しない場合は、ページを再読み込みして "Soft AP Settings" を変更できます。"Set" をクリックすると、再び ESP が再起動します。これで、新しく設定された Soft AP を介してトラフィックを転送する準備が整います。これらの変更は設定インターフェースにも影響することに注意してください。つまり、さらに設定を行うには、新しく設定された WiFi ネットワークのいずれかを介して ESP に接続してください。Soft AP 経由でアクセスする場合は、変更した場合に備えて Soft AP ネットワークのアドレスを覚えておいてください（ESP はこのネットワーク内では常にアドレス x.x.x.1 を持ちます）。

必要に応じて、"lock" チェックボックスをオンにして "Lock" をクリックできます。これで、アップリンク WiFi ネットワークのパスワードでロックを解除しない限り、設定を変更できなくなります（ネットワークがオープンでもパスワードを定義してください）。

Web インターフェースで非 ASCII 文字や特殊文字を入力する場合は、"My%20AccessPoint" のような HTTP スタイルの 16 進エンコーディングを使用する必要があります。これにより、文字列 "My AccessPoint" が生成されます。この 16 進エンコーディングを使用すると、0 を除く任意のバイト値を入力できます（C 内部の理由による）。

間違えて ESP との接続をすべて失った場合でも、シリアルコンソールを使用して回復できます（"reset factory"、以下を参照）。

コマンドラインインターフェース

高度な設定は、コンソールインターフェースのコマンドラインから行う必要があります。このコンソールは、115200 ボーのシリアルポートまたは tcp ポート 7777（例: 接続された STA からの "telnet 192.168.4.1 7777"）を介して利用できます。

初期設定には次のコマンドを使用します:

• set ssid your_home_router's_SSID
• set password your_home_router's_password
• set ap_ssid ESP's_ssid
• set ap_password ESP's_password
• show (パラメータを確認するため)
• save
• reset

繰り返しますが、非 ASCII 文字や特殊文字を入力したい場合は、HTTP スタイルの 16 進エンコーディング（例: "My%20AccessPoint"）を使用するか、CLI のみのショートカットとしてバックスラッシュ付きの C スタイル引用符（例: "My\ AccessPoint"）を使用できます。どちらの方法でも文字列 "My AccessPoint" になります。

コマンドラインはさらに多くのコマンドを理解します:

基本コマンド

ほぼすべての環境で動作させるのに十分です。

• help: 短いヘルプメッセージを表示します
• set [ssid|password] value: アップリンク AP の設定を変更します（ホームルーターの WiFi 設定）。オープンネットワークではパスワード "none" を使用します。
• set [ap_ssid|ap_password] value: ESP のソフトAPの設定を変更します（ステーション用）
• show [config|stats]: 現在の設定、またはいくつかのステータス情報と統計を表示します
• save [dhcp]: 現在の設定パラメータ、ACL、ルーティングエントリ [+ 現在の DHCP リース] をフラッシュに保存します
• lock [password]: 現在の設定を保存してロックします。変更は許可されません。以前に設定されている場合はパスワードを省略できます（デフォルトはアップリンク WiFi のパスワード）
• unlock password: 設定のロックを解除します。lock コマンドのパスワードが必要です
• reset [factory]: esp をリセットします。'factory' はオプションで WiFi パラメータをデフォルト値にリセットします（ロックされたデバイスではシリアルコンソールからのみ動作します）
• quit: リモートセッションを終了します

高度なコマンド

ほとんどの set コマンドは、save と reset の後にのみ有効になります。

コマンドライン入力の "単一の #" 以降、行末まではコメントとして扱われ、無視されます。

Automesh Config

• set automesh [0|1]: automesh モードをオンにするかオフにするかを選択します（デフォルトはオフ）。詳細は https://github.com/martin-ger/esp_wifi_repeater#automesh-mode を参照
• set am_threshold dB: "悪い" 接続とみなすしきい値を設定します（負の dB で指定、デフォルト 85、すなわち -85 dB）
• set am_scan_time secs: automesh モードで ESP がスリープする前にアップリンク AP を探す時間間隔を秒単位で設定します（0 は無効、デフォルト）
• set am_sleep_time secs: アップリンク AP が見つからない場合に automesh モードで ESP がスリープする時間間隔を秒単位で設定します（0 は無効、デフォルト）

WiFi Config

• set ap_on [0|1]: ソフトAPを無効にするか (ap_on=0)、有効にするかを選択します (ap_on=1、デフォルト)
• set ap_open [0|1]: ソフトAPが WPA2-PSK セキュリティを使用するか (ap_open=0、ap_password が設定されている場合は自動)、オープンにするかを選択します (ap_open=1)
• set auto_connect [0|1]: STA が AP への再接続を試み続けるかどうかを選択します。auto_connect は最初のフラッシュ後または "reset factory" 後はオフ (0) です。新しい SSID を入力すると自動的にオン (1) になります。
• set ssid_hidden [0|1]: ソフトAPの SSID を非表示にするか (ssid_hidden=1)、表示するかを選択します (ssid_hidden=0、デフォルト)
• set phy_mode [1|2|3]: WiFi の PHY_MODE を設定します (1=b、2=g、3=n(デフォルト))
• set country CC: WiFi の電波規制国コードを 2 文字の ISO 3166-1 コードで設定します (例: "US"、"DE"、"CN"、"JP")。米国以外のコードはチャンネル 12 と 13 を解放します。空 (デフォルト) の場合は SDK デフォルトを変更しません。この設定はフラッシュに保存され、起動のたびに再適用されます。
• set bssid xx:xx:xx:xx:xx:xx: 接続先のアップリンク AP の特定の BSSID を設定します (デフォルト 00:00:00:00:00:00 は任意を意味します)
• set [ap_mac|sta_mac] xx:xx:xx:xx:xx:xx: STA および SOFTAP の MAC アドレスをユーザー定義の値に設定します (MAC アドレスの最初のバイトのビット 0 を 1 にすることはできません)
• set sta_mac random: 再起動のたびに新しいランダムな STA MAC を設定します
• set sta_hostname name: STA の名前を設定します (アップリンク AP に表示されます)
• set max_clients [1-8]: SoftAP に接続できる STA の数を設定します (ESP の SoftAP 実装の制限は 8、デフォルト)
• scan: AP のスキャンを実行します
• connect: 現在設定されている ssid と password で AP への接続を試みます
• disconnect: アップリンク AP から切断します

WPA2 Enterprise Config

• set use_peap[0|1]: STA が単純な WPA-PSK で接続するか (use_peap=0、デフォルト)、WPA2 Enterprise (PEAP) を使用するかを選択します
• set peap_identity value: PEAP の '外部' ID を設定します (最初に RADIUS サーバーに提示される文字列。[email protected] など)
• peap_username value: PEAP ユーザー名を設定します
• peap_password value: PEAP パスワードを設定します

TCP/IP Config

• set network ip-addr: 内部ネットワークの IP アドレスを設定します。ネットワークは常に /24、ルーターは常に x.x.x.1 です
• set dns dns-addr: DHCP 経由でクライアントに配布される静的 DNS アドレスを設定します
• set dns dhcp: DHCP からの動的 DNS アドレスの使用を設定します（デフォルト）
• set ip ip-addr: STA インターフェースに静的 IP アドレスを設定します
• set ip dhcp: STA インターフェースに動的 IP アドレスを設定します（デフォルト）
• set netmask netmask: STA インターフェースに静的ネットマスクを設定します
• set gw gw-addr: STA インターフェースに静的ゲートウェイアドレスを設定します
• set max_nat no_of_entries: NAPT テーブルのサイズを設定します（デフォルト 512）
• set max_portmap no_of_entries: portmap テーブルのサイズを設定します（デフォルト 32）
• set tcp_timeout secs: TCP 接続の NAPT タイムアウトを設定します（0=デフォルト（1800 秒））
• set udp_timeout secs: UDP 接続の NAPT タイムアウトを設定します（0=デフォルト（2 秒））
• set lease min: 内部ネットワーク DHCP サーバーのリース時間を分単位で設定します（デフォルト 120）
• show dhcp: dhcp リーステーブルの現在のステータスを表示します