Meshtastic-Android/main/docs/ja-rJP/user/settings-module-admin.html

<!DOCTYPE html>
<html lang="ja-rJP" dir="ltr">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>設定：モジュールと管理</title>
  <link rel="stylesheet" href="../../styles/docs.css">
</head>
<body data-page="settings-module-admin" data-locale="ja-rJP">
<pre class="markdown-content"># 設定：モジュールと管理

オプションの機能モジュールを設定し、デバイスの管理を行います。モジュールは、専用の機能で Meshtastic を拡張します。それぞれ個別に有効・無効を切り替えられます。

&gt; 💡 **ヒント：** 実際に使うモジュールだけを有効にすれば十分です。使わないモジュールを無効にすると、電波利用時間が減り、バッテリーを節約でき、設定もシンプルになります。 A module you expect can be missing for three reasons: your node's role doesn't enable it, your firmware is older than the release that added it, or the firmware build excludes it for this hardware.

モジュールの設定は、トグルスイッチ、ドロップダウン、テキストフィールド、スライダーを備えたカード形式のレイアウトを使用します：

![A toggle setting in the on position](../../assets/screenshots/settings_switch.png)

![A dropdown setting, expanded to show its list of options](../../assets/screenshots/settings_dropdown.png)

![A text field setting with a value entered](../../assets/screenshots/settings_text_field.png)

![A module settings card with its title and grouped controls](../../assets/screenshots/settings_titled_card.png)

## 追加機能の設定

Every module lives under **Settings → Module configuration**.

&gt; ⚠️ **Important:** Saving a module screen restarts the node — the button reads **Save &amp; restart**, and the node is unreachable for a few seconds afterwards. External Notification and Mesh Beacon are the exceptions: their button reads **Save**, and the node may still restart for some changes.

### MQTT module

インターネット接続のために、メッシュのメッセージを MQTT サーバーとの間で橋渡しします。 This is how you extend your mesh beyond LoRa range or integrate with home automation systems.

 設定項目                 | 説明                                                                                                                                                                                      |
 -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 MQTTを有効化             | MQTT ブリッジを切り替え                                                                                                                                                                          |
 アドレス                 | MQTT サーバーのアドレス                                                                                                                                                                          |
 ユーザー名                | 認証用のユーザー名                                                                                                                                                                               |
 パスワード                | 認証用のパスワード                                                                                                                                                                               |
 暗号化の有効化              | MQTT ペイロードを暗号化                                                                                                                                                                          |
 JSON出力の有効化           | Publish and consume MQTT messages as JSON. Marked deprecated in the protobuf schema, but it is still the only toggle for this behavior and the firmware still honors it |
 TLS の有効化             | セキュアな接続を使用                                                                                                                                                                              |
 ルート トピック             | MQTT のベーストピックパス                                                                                                                                                                         |
 クライアントへのプロキシの有効化     | Let a connected phone carry the node's MQTT traffic, instead of the node reaching the broker itself                                                                                     |
 このスマートフォンの MQTT プロキシ | The phone-side half of **Proxy to client enabled**: whether this phone acts as that relay. See [MQTT](mqtt)                                             |
 マップレポート              | Publish position to the public map — see the Map reporting group that follows                                                                                                           |

Turning **Map reporting** on reveals a consent card headed _Consent to Share Unencrypted Node Data
via MQTT_, with an **I agree.** switch under it. The rest of the card doesn't exist on screen
until you agree:

 設定項目                              | 説明                                                                                                                                                                                       |
 --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 同意します。                            | Explicit consent to transmit your node data, including an approximate position, unencrypted. Map reporting doesn't start without it                                      |
 Precision slider                  | The slider has no label of its own. It sets how coarsely your position is published, from 12 to 15; the line beneath reads _±_ the resulting distance, in your own units |
 マップレポートの間隔 (秒) | How often to report. A dropdown of fixed intervals from 1 hour to 72 hours — nothing shorter is offered                                                                  |

暗号化、プライバシー、サーバーの設定を含む詳しい使い方は、[MQTT](mqtt) を参照してください。

### Serial module

外部デバイスとの連携（GPS モジュール、センサー、カスタムハードウェア）のために、シリアルポート通信を有効にします。有効にすると、ノードのシリアルポートで protobuf またはテキストデータを送受信でき、外部のマイコンやコンピューターがメッシュとやり取りできるようになります。

 設定項目              | 説明                                                                                                                                                                                                  |
 ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 シリアル通信を有効化        | シリアル通信を有効化                                                                                                                                                                                          |
 Echoを有効化          | 受信したシリアルデータをそのまま返す                                                                                                                                                                                  |
 シリアルモード           | Which protocol the port speaks — Default, Simple, Proto, Text message, NMEA, CalTopo, WS85 weather station, VE.Direct, MeshSolar config, Log, or Log (text only) |
 RX / TX           | GPIO pins for the serial connection                                                                                                                                                                 |
 シリアルボーレイト         | Port speed                                                                                                                                                                                          |
 タイムアウト            | How long to wait before considering an incoming message complete                                                                                                                                    |
 コンソールのシリアルポートを上書き | Take over the port the debug console normally uses                                                                                                                                                  |

### External Notification module

Controls buzzer, LED, or vibration alerts on your node hardware. メッセージ到着時に物理的に知らせる必要があるデバイスに便利です。特に無人設置や屋外設置で役立ちます。

There are two independent triggers — an incoming **message**, and a received **bell** character —
and each can drive the LED, the buzzer and the vibration motor separately, giving six toggles.

 設定項目                                 | 説明                                                                                                  |
 ------------------------------------ | --------------------------------------------------------------------------------------------------- |
 外部通知を有効化                             | Master toggle for the module                                                                        |
 Alert message LED / buzzer / vibra   | Which outputs fire on an incoming message                                                           |
 Alert bell LED / buzzer / vibra      | Which outputs fire on a received bell character                                                     |
 LED出力 (GPIO)      | Pin the LED is wired to                                                                             |
 LED出力 アクティブハイ                        | Whether the LED pin is active high or low                                                           |
 ブザー出力(GPIO)       | Pin the buzzer is wired to                                                                          |
 バイブレーション出力 (GPIO) | Pin the vibration motor is wired to                                                                 |
 PWMブザーを使用                            | Drive the buzzer with PWM, which allows tones rather than a single pitch                            |
 I2Sをブザーとして使用                         | Send the alert through an I2S audio output instead                                                  |
 出力時間 (ミリ秒)        | How long a single alert lasts                                                                       |
 繰り返し通知間隔（秒）                          | Keep repeating the alert for this long until it is acknowledged. 0 disables nagging |
 着信音                                  | The tone played on a PWM buzzer, in RTTTL. Can be imported from a file              |

### Store &amp; Forward module

一時的にオフラインだったノードのためにメッセージをバッファリングし、それらのノードが再接続したときに再送します。ノードが頻繁に圏内・圏外を行き来するメッシュに不可欠です。短時間の切断中にメッセージが失われないようにします。

 設定項目                                                   | 説明                                                     |
 ------------------------------------------------------ | ------------------------------------------------------ |
 一時保管と転送の有効化                                            | ストア＆フォワードを有効化                                          |
 ハートビート                                                 | このノードのストア＆フォワード機能を定期的に告知する                             |
 サーバーの最大保管レコード数  (デフォルト 約11,000レコード) | 保存するメッセージの最大数                                          |
 リクエスト可能な最大の履歴件数                                        | 再送するメッセージの最大数                                          |
 リクエスト可能な履歴の期間  (分)                  | 再送する時間の範囲                                              |
 サーバー                                                   | メッシュのストア＆フォワードサーバーとして動作する（十分なメモリが必要、例：PSRAM 搭載の ESP32） |

&gt; 💡 **ヒント：** ストア＆フォワードは、十分なメモリを持つノード（PSRAM 搭載の ESP32）で最も良く機能します。ルーターノードは通常は常時起動しているため、理想的な候補です。

### Range Test module

&gt; ⚠️ **Warning:** Range Test only works on a secured primary channel. As long as your primary channel
&gt; still uses the default channel key, the interval and CSV controls stay disabled — you can still
&gt; switch an already-enabled module off — and saving force-disables the module if the channel has
&gt; reverted to public.

ノード間のリンク品質を評価するための、自動レンジテストツールです。有効にすると、ノードはカウンターを増やしながらテストメッセージを定期的に送信します。受信側のノードがこれらのメッセージを記録するため、歩いたり車で移動したりして、後からどの距離でメッセージが届かなくなったかを分析できます。

 設定項目                                         | 説明                                                                                       |
 -------------------------------------------- | ---------------------------------------------------------------------------------------- |
 レンジテストを有効化                                   | レンジテストを有効化                                                                               |
 送信者のメッセージ間隔 (秒)           | Time between test transmissions, chosen from a dropdown of fixed intervals               |
 ストレージにCSVファイルを保存(ESP32のみ) | Log received test data to the node's own filesystem. ESP32 hardware only |

### Telemetry module

ノードがメッシュと共有するテレメトリデータを制御します。テレメトリには、デバイスの状態（バッテリー、連続稼働時間）と環境センサーのデータ（温度、湿度、気圧）が含まれます。

Each of the four metric groups has its own enable toggle and its own interval, so you can report
battery health often and sensors rarely.

 設定項目             | 説明                                                                                                                                                                               |
 ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 デバイステレメトリを送信     | Master toggle for device metrics. Only shown on firmware 2.7.12 and newer                                                        |
 デバイスメトリクスの更新間隔   | How often to report battery, uptime and channel utilization                                                                                                                      |
 環境メトリクスモジュールを有効化 | Report the attached environment sensors                                                                                                                                          |
 環境メトリクスの更新間隔     | How often to report them                                                                                                                                                         |
 環境メトリクスを画面上で有効化  | Also show these readings on the device's own display                                                                                                                             |
 環境メトリクスは華氏を使用    | Use °F on the device's display. This is the node's screen only — the app follows your phone's locale, see [Units &amp; Locale](units-and-locale) |
 空気品質測定モジュールを有効化  | Report particulate and CO₂ sensor data                                                                                                                                           |
 空気品質メトリクスの更新間隔   | How often to report them                                                                                                                                                         |
 電源メトリクスモジュール有効   | Report the per-channel voltage and current readings                                                                                                                              |
 電源メトリクスの更新間隔     | How often to report them                                                                                                                                                         |
 電源メトリクスを画面上で有効化  | Also show power readings on the device's display                                                                                                                                 |

対応センサーと設定の推奨事項については、[テレメトリとセンサー](telemetry-and-sensors) を参照してください。

### Canned Message module

Pre-configured messages accessible from the node's physical buttons (for nodes with rotary encoders, keypads, or similar input hardware). スマートフォンを接続していなくても送信できる、クイック送信メッセージのリストを定義します。フィールドでの使用に最適です。

 設定項目                                           | 説明                                                                                                        |
 ---------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
 ~~Canned message enabled~~                     | ⚠️ **Deprecated** in the protobuf schema                                                                  |
 メッセージ                                          | 改行で区切ったメッセージのリスト                                                                                          |
 ベルを送信                                          | Send a bell character alongside the message, so a receiving node's External Notification module can sound |
 ロータリーエンコーダ #1 を有効化                             | Use a rotary encoder as the input device                                                                  |
 GPIO pin for rotary encoder A / B / Press port | The three pins the encoder is wired to                                                                    |
 Generate input event on Press / CW / CCW       | Which key event each encoder action produces                                                              |
 上下/選択入力を有効化                                    | A separate, simpler input scheme using up/down/select buttons rather than an encoder                      |
 ~~Allow input source~~                         | ⚠️ **Deprecated** in the protobuf schema                                                                  |

### Audio module

メッシュ上での低帯域幅の音声通信のための、Codec2 音声サポートです。これは、Codec2 コーデックを使って音声を非常に小さなデータパケットにエンコードする、**実験的**な機能です。

 設定項目           | 説明                                   |
 -------------- | ------------------------------------ |
 CODEC 2 を有効化   | オーディオモジュールを有効化                       |
 CODEC2 サンプルレート | 音質と帯域幅のトレードオフ                        |
 PTT端子          | GPIO pin for the push-to-talk button |
 I2S ワードセレクト    | I2S WS 用の GPIO ピン                    |
 I2S データ IN     | I2S DIN 用の GPIO ピン                   |
 I2S データ OUT    | I2S DOUT 用の GPIO ピン                  |
 I2S クロック       | GPIO pin for the I2S bit clock       |

&gt; ℹ️ **Note:** Audio requires specific hardware (I2S microphone and speaker). 音質は非常に低帯域です。「聞き取れる無線の声」程度で、電話並みの品質ではないと考えてください。

### Remote Hardware module

メッシュネットワーク経由での GPIO 制御です。リモートのノードが、別のノードの GPIO ピンを読み書きできるようにします。リレーの作動、スイッチの読み取り、離れた場所からの外部ハードウェア制御に便利です。

&gt; ⚠️ **Warning:** Turning on **Allow undefined pin access** gives remote nodes access to all GPIO pins, which could interfere with the node's own hardware. Turn it on only on dedicated GPIO nodes.

 設定項目            | 説明                                    |
 --------------- | ------------------------------------- |
 リモートハードウェアを有効化  | リモート GPIO アクセスを有効化                    |
 未定義のピンへのアクセスを許可 | 任意の GPIO ピンへのアクセスを許可（セキュリティリスク）       |
 使用可能な端子         | このノードがリモートの読み書き用に公開する GPIO ピン（最大 4 個） |

### Neighbor Info module

直接受信した隣接ノードの情報をブロードキャストし、メッシュのトポロジーマッピングを可能にします。有効にした各ノードは、受信できる他のノードとその信号品質のリストを定期的に共有します。

 設定項目                        | 説明                                                                             |
 --------------------------- | ------------------------------------------------------------------------------ |
 近隣ノード情報を有効化                 | 隣接ノードのブロードキャストを有効化                                                             |
 更新間隔 (秒) | 隣接ノードのリストをブロードキャストする頻度                                                         |
 LoRaで送信                     | MQTT／スマートフォンだけでなく、LoRa 経由でも隣接ノード情報をブロードキャストします。デフォルトの鍵と名前を使用しているチャンネルでは利用できません |

See [Local Mesh Discovery](discovery) for how to use neighbor data for mesh topology exploration.

### Ambient Lighting module

対応ハードウェア上の、オンボードの NeoPixel やその他のアドレサブル RGB LED を制御します。視覚的なステータス表示、通知ライト、装飾的な演出に使用できます。

 設定項目   | 説明               |
 ------ | ---------------- |
 LEDの状態 | LED のオン／オフを切り替え  |
 電流     | LED の電流制限（0〜31）  |
 赤／緑／青  | 各色チャンネルの値（0〜255） |

### Detection Sensor module

ノードを、動きやドアを検知するセンサーアラートシステムに変えます。 GPIO ピンが状態の変化（動きの検知、ドアの開放）を検出すると、ノードはメッシュ経由でアラートメッセージをブロードキャストします。

 設定項目                                     | 説明                                          |
 ---------------------------------------- | ------------------------------------------- |
 検出センサーを有効化                               | 検知センサーを有効化                                  |
 モニターのGPIOピン                              | センサーに接続された GPIO ピン                          |
 検出トリガーの種類                                | ピンの状態を検知イベントにどう対応させるか（例：アクティブハイ／ロー、エッジトリガー） |
 INPUT_PULLUP モードを使用 | ピンの内蔵プルアップ抵抗を有効にする                          |
 最小ブロードキャスト間隔(秒)       | アラートのブロードキャスト間の最小時間                         |
 状態のブロードキャスト間隔 (秒)     | 定期的な状態ブロードキャストの間隔                           |
 アラートメッセージ付きのベルを送信                        | アラートにベル文字を含める                               |
 名前                                       | このセンサーのカスタム名                                |

### Paxcounter module

People counter using Wi-Fi and BLE probe requests. スマートフォンやノートパソコンがネットワークを探すときに発するプローブ要求を受動的に受信して、近くのデバイスを数えます。 ESP32 デバイスでのみ利用できます。

 設定                          | 説明                                                                                                               |
 --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
 Paxcounter を有効化             | 人数カウントを有効化                                                                                                       |
 更新間隔 (秒) | カウントを報告する頻度                                                                                                      |
 Wi-Fi RSSI threshold        | Ignore Wi-Fi probes weaker than this, so distant devices aren't counted (defaults to −80 dBm) |
 BLE RSSI threshold          | The same cut-off for BLE advertisements (defaults to −80 dBm)                                 |

&gt; 💡 **ヒント：** Paxcounter は、登山口やイベント会場などの人出を推定するのに便利です。カウントはおおよその値です。1 人が複数のデバイスを持っていることがあります。

### Status Message module

The status message has no module screen. It is edited with the rest of the node's identity, on
[Settings — Radio &amp; User](settings-radio-user#user-profile).

### Mesh Beacon module

Broadcasts an invitation to your mesh, and receives invitations from others. The entry appears only
on nodes running firmware 2.8.0 or newer. See [Local Mesh Discovery](discovery) for the full
walkthrough.

### TAK module

ATAK および WinTAK と相互運用するための、Team Awareness Kit 連携です。 Two things have to be
true before the entry appears in the module list: the node runs firmware 2.8.0 or newer, and its
**Device Role** on **Settings → Device configuration → Device** is set to `TAK` or `TAK_TRACKER`.
詳しい設定と使い方は、[TAK 連携](tak) を参照してください。

## 管理

### リモート管理

管理者鍵を共有しているノードをリモートで設定します：

1. ノードリストで対象のノードを選択します。
2. そのノードの「**設定**」に移動します。
3. 設定を変更します。
4. 「**保存**」をタップします。変更がメッシュ経由で送信されます。

&gt; ⚠️ **Important:** Requires an admin key configured on both your node and the target node.

### Device Actions

**Settings → Administration** holds five one-shot actions, each behind a confirmation dialog:

 操作          | 内容                                                                                             |
 ----------- | ---------------------------------------------------------------------------------------------- |
 時刻を設定       | Sends your phone's clock to the node                                                           |
 再起動         | Restarts the node                                                                              |
 シャットダウン     | Powers the node down                                                                           |
 出荷時にリセット    | Returns every setting to its factory default                                                   |
 NodeDBをリセット | Clears the node database. This dialog carries a **Preserve Favorites?** switch |

&gt; ⚠️ **Warning:** Factory reset erases all settings, channels, and keys, and cannot be undone. Before you reset, use **Export configuration** to save the node's settings and **Backup Keys** on the Security screen to save its keys, so you can put both back afterwards.

### バックアップと復元

**Settings → Backup &amp; Restore** writes the connected node's whole configuration to a file with
**Export configuration**, and reads a saved file back in with **Import configuration**. Export
before a factory reset, or to copy one node's setup onto another. The section is shown for your
own node only, not over remote admin.

### 詳細設定

**Settings → Advanced** collects the tools that read or rewrite local state, and is likewise shown
for your own node only: **Firmware Update** on OTA-capable hardware, **Clean Node Database**,
**TAK Server**, **Local Mesh Discovery**, and the **Debug Panel**.

#### ノードデータベースの整理

Prunes nodes from your node database — from the app's copy _and_ from the node's own, so this is
not a display-only cleanup. The two filters combine rather than acting separately; the screen puts
it as _Selections are additive_.

- **Clean up nodes last seen older than N days** — always applied. The slider runs from 7 days to
  365 and starts at 30; with **Clean up only unknown nodes** turned on, its floor drops to 0.
- **Clean up only unknown nodes** — narrows the same purge to nodes that never sent their user
  info. The age limit still applies on top of it.

The screen lists the nodes queued for deletion as you move the filters. **Clean Now** carries the
purge out, after one more confirmation, and it can't be undone. Favorited nodes, ignored nodes,
and nodes with a public key heard in the last seven days are never removed, whatever the filters
say — that is why the queued list can be shorter than you expect.

#### デバッグ

診断出力の表示・絞り込み・エクスポートを行う「**パケット**」タブと「**アプリログ**」タブを開きます。詳しい手順は、[デバッグログ](debug-logs) を参照してください。

### App Settings

The **App Settings** block on the **Settings** screen configures the app rather than the node, and
appears only when your own node is selected. It is grouped rather than flat:

**Privacy**

- **Allow analytics and crash reporting** — opt in or out of diagnostics.
- **Provide phone location to mesh** — share this phone's position when the node has no GPS fix.
- **Homoglyph encoding** — how look-alike characters in names are handled.

**Appearance**

- **Units** — metric, imperial, or follow the system. This is the entry
  [Units &amp; Locale](units-and-locale) sends you to.
- **Theme** and **Language**.
- **Show full message timestamps**.

**Persistence**

- A cache limit for how much history is kept.
- **Export rangetest packets**, **Export all packets** and **Export node database**.

**On their own**

- **Node Layout** — how much detail each row of the node list shows.
- **Wi-Fi Provisioning for mPWRD-OS** — see [Connections](connections).
- **Message Filter** — hides incoming messages that contain words you list. With no words
  configured it does nothing.
- **System AI** — appears only where app functions are available; see
  [App Functions](app-functions).

A **Permissions** block sits above App Settings, so a user who skipped a permission during
onboarding can get back to it, and **App Info** sits below.

### 概要

**Settings → About** carries the app's own identity rather than the node's:

Three sections:

- **What is Meshtastic?** — a short description of the project.
- **Apps** — opens with **Need Hardware?**, a rotating carousel of popular devices that links out
  to where to buy one. It also lists the GitHub repository, the running app version, and
  **Acknowledgements** (see the next section).
- **Project information** — links to the website, to this documentation, and to the GNU GPL v3
  license the app is released under.

The footer states the copyright and that the app is free software with no warranty, which you
may redistribute under the same license.

### 謝辞

Reached from **About**, this lists every open-source library the app ships, with its license,
generated at build time by AboutLibraries. It was previously called the license screen.

### Troubleshooting remote admin

- **「対象ノードから応答がありません」**：対象が圏外、オフライン、または管理者鍵が一致していない可能性があります。両方のノードで管理者鍵が一致しているか確認してください。
- **変更が適用されない**：一部の設定は、反映に再起動が必要です。保存後に「再起動」を実行してみてください。
- **リモートの設定が表示されない**：自分のノードに、対象ノードの管理者鍵があることを確認してください。管理チャンネルは、管理者鍵を設定すると自動的に構成されます。

## 関連トピック

- [Settings — Radio &amp; User](settings-radio-user) — core node and user profile settings
- [モジュール設定リファレンス](https://meshtastic.org/docs/configuration/module)：meshtastic.org にある詳細なモジュールのドキュメント
- [FAQ](https://meshtastic.org/docs/faq/)：meshtastic.org のよくある質問
</pre>
</body>
</html>