> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/security.md).

# self-hosted サーバーのセキュリティ保護

self-hosted Inference を既定でローカルに保ち、Workflows を実行できるユーザーを選択し、モデル、メディア、トランスポートの制御を構成します。

セルフホスト型推論では、ローカル開発で制限のない設定が維持されます。カスタム Python は既定でローカル実行され、認証を設定しない限り、サーバーに API キーは必要ありません。CLI はサーバーを次のアドレスで公開します： `127.0.0.1` 既定では、以下の例外を除き、他のマシンから公開ポートに接続することはできません。

アップグレード時の動作とバージョンの適用範囲については、 [セキュリティ設定の移行](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/security-migration.md).

## ネットワークアクセスを制限する

Workflow 機能の利用可否を変更する前に、クライアントがサーバーに接続する方法を選択してください。

<table data-search="false"><thead><tr><th>起動方法</th><th>既定のネットワークアクセス</th><th>設定</th></tr></thead><tbody><tr><td>CPU または GPU ホスト上の Inference CLI</td><td>ホストのループバックアドレス、127.0.0.1:9001</td><td>別のホストアドレスを選択するには、--bind-address または -b を使用します。</td></tr><tr><td>Jetson イメージを使用する Inference CLI</td><td>すべてのホストインターフェース、0.0.0.0:9001</td><td>ローカルからのみアクセスできるようにするには、--bind-address 127.0.0.1 を使用します。</td></tr><tr><td>macOS および Windows デスクトップバンドル</td><td>127.0.0.1</td><td>別のインターフェースを選択するには、HOST を明示的に設定します。</td></tr><tr><td>手動での Docker または Compose の使用</td><td>ポートマッピングによって決まります</td><td>ローカルからのみアクセスできるようにするには、127.0.0.1:9001:9001 を使用します。</td></tr><tr><td>--tunnel を使用する Inference CLI</td><td>トンネルが接続できるよう、CLI は 0.0.0.0 で公開します。</td><td>LAN とトンネルの両方からのアクセスを確認してください。</td></tr></tbody></table>

### CLI でサーバーを起動する

`inference server start` はポート 9001 を次のアドレスで公開します： `127.0.0.1`。そのため、この方法で起動したサーバーに応答できるのは、起動したマシン上のプロセスだけです。ローカル開発にはこれが適切な既定値であり、このページに記載された制限の緩い既定設定が安全なのも、この構成だけです。ループバック以外のアドレスで公開すると、CLI が警告します。

```bash
# 既定値: このマシンからのみアクセス可能
inference server start

# 意図的な LAN アクセス: このホストにルーティングできるすべてのマシンからアクセス可能 - 先にセキュリティを確保してください
inference server start --bind-address 0.0.0.0 --env-file inference.env
```

{% hint style="warning" %}
**NVIDIA Jetson は例外です。** Jetson イメージはヘッドレスのエッジデバイスであり、ほとんどの場合、別のマシンから操作するため、 `inference server start` は次のアドレスで公開します： `0.0.0.0` 。デバイスにルーティングできるすべての接続元からアクセス可能で、そのデバイスが接続している Wi-Fi ネットワーク上の他の端末も含まれます。以下の制御を適用するか、 `inference server start --bind-address 127.0.0.1`.
{% endhint %}

### を使ってアクセスを制限してください。 `docker run`

イメージ側ではこの選択ができないため、 **コマンドラインで指定する必要があります。**. `HOST` はインターフェースを選択します。 *コンテナ* 内での設定です。コンテナには独自のネットワーク名前空間があります。 `HOST=127.0.0.1` を設定したイメージではコンテナ自身のループバックにバインドされますが、公開ポートからはそこに到達できず、ホストからもサーバーに接続できません。このため、すべてのイメージでは `HOST=0.0.0.0`が設定されています。ブリッジネットワークを使うコンテナ内ではこの設定を維持し、代わりにポートマッピングのホスト側で制限してください：

```bash
# このマシンからのみアクセス可能
docker run --rm -p 127.0.0.1:9001:9001 roboflow/roboflow-inference-server-cpu:latest

# このホストへのルーティングが可能なすべてのマシンからアクセスできます。まずセキュリティを確保してください
docker run --rm -p 9001:9001 roboflow/roboflow-inference-server-cpu:latest
```

次の2つのケースでは動作が異なります。

* **`--network host`** （Linux）ではポートマッピングが完全に無効になり、コンテナがホストのネットワークインターフェースに直接バインドされます。この場合、 `-e HOST=127.0.0.1` *が* サーバーをローカルに限定する方法です。
* **Kubernetes** では各 Pod が独自のネットワーク名前空間を持つため、 `HOST=0.0.0.0` を維持し、バインドアドレスではなく Service の種類と NetworkPolicy で公開範囲を制御します。

{% hint style="warning" %}
**`-p 9001:9001` は、すべてのインターフェースを意味します。** アドレスを明示しない場合、Docker は `0.0.0.0`（ホストにパブリック IP がある場合はそれも含めて）すべてのインターフェースでポートを公開します。Linux では、ほとんどのデフォルト設定で Docker 独自の転送ルールが `ufw`/`firewalld` のルールより先に評価されるため、別途設定したホストファイアウォールではブロックできない場合があります。実際にリッスンしているポートは、次のコマンドで確認してください。 `docker port <container>` または `ss -tlnp | grep 9001`.
{% endhint %}

{% hint style="info" %}
Python サーバーの直接起動、ホストネットワーク、手動での Docker ポート公開には、それぞれ独自のネットワーク設定が必要です。CLI のデフォルト設定は、これらの経路を制限しません。
{% endhint %}

ループバック以外にバインドすると、信頼できないクライアントからサーバーにアクセスされる可能性があります。このページで説明するデフォルト設定は、そのような利用を想定していません。まず [リモートクライアントを許可する前に](#before-allowing-remote-clients) の手順を確認してください。

## 認証を必須にする

推論、Workflow、および統合された `WORKSPACES_WHITELISTED_FOR_LOCAL_DEPLOYMENT` に許可する Workspace のスラッグを設定すると、推論、Workflow、および統合された `/inference_pipelines/*` リクエストで API キーが必須になります。クライアントはキーを次のいずれかで送信できます。 `Authorization: Bearer YOUR_API_KEY`、 `api_key` クエリパラメーター、またはサポート対象の JSON リクエストボディ。サーバーは Roboflow API を通じて Workspace のメンバーシップを検証します。

たとえば、CLI に渡す `inference.env` ファイルに次の内容を記述します。

```dotenv
WORKSPACES_WHITELISTED_FOR_LOCAL_DEPLOYMENT=your-workspace-url-slug
```

別の ID 管理システムを使用する場合や、Roboflow API に接続せずに認証を行う必要がある場合は、サーバーの前段に認証プロキシを配置し、クライアントがプロキシを迂回できないようにしてください。

### ヘルスチェックと可観測性

Workspace のチェックを行うと、次のエンドポイントは `/`, `/docs`, `/redoc`, `/info`, `/healthz`, `/readiness`, `/metrics`, `/openapi.json`、静的アセット、およびオプトインで利用可能になる `/secure-gateway/health` エンドポイントは、APIキーなしで利用できます。これにより、ヘルスチェックと [テレメトリー](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/telemetry.md)を維持できます。出力に機密情報が含まれる場合は、ネットワークアクセスを制限してください。TLSクライアント証明書が有効になっている場合、その要件はこれらのエンドポイントにも適用されます。

## 信頼できる呼び出し元にはCustom Pythonを利用可能にする

`ALLOW_CUSTOM_PYTHON_EXECUTION_IN_WORKFLOWS=True` および `WORKFLOWS_CUSTOM_PYTHON_EXECUTION_MODE=local` がデフォルトのままなので、ローカルユーザーはオプトインせずにCustom Pythonを実行できます。このコードはサーバープロセス内で、そのプロセスの権限を使って実行されます。認証によって実行を送信できるユーザーは制御されますが、認証済みの呼び出し元がサンドボックス化されるわけではありません。Workspace認証がない状態でローカルのCustom Pythonが有効になっていると、サーバーはセキュリティに関する通知をログに記録します。

### 不要な場合はローカル実行を無効にする

設定を `ALLOW_CUSTOM_PYTHON_EXECUTION_IN_WORKFLOWS=False` にすると、ローカルのCustom Python実行が拒否されます。Modal実行は別のモードであり、このフラグでは無効になりません。詳しくは [カスタムブロック](https://docs.roboflow.com/workflows/blocks/blocks/custom-blocks) および [オフライン移行ガイダンス](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/security-migration.md#offline-custom-python).

## モデルへのアクセスを保護する

[モデルパッケージのセキュリティ](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/model-security.md) では、Workspace認証、モデルごとの認可、実行可能パッケージを読み込む権限を区別しています。特に、オンラインのモデルごとの認可は、ローカルのパッケージを直接読み込む方式と併用できません。ファイルシステムのパスには、認可対象となるRoboflowモデルのIDがないためです。

## 動画ワークロードを構成する

[動画の構成](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/video-configuration.md) では、管理対象パイプラインプロセスの上限、ウォームワーカー、サーバー側のメディア参照について説明しています。プロセス数の上限はリソース使用量を抑えますが、呼び出し元の認証やコードの分離は行いません。

## ネットワーク通信を保護する

ホスト外との通信には、サーバーまたは認証済みTLSプロキシで [HTTPS](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/https.md) を使用してください。送信方向の [セキュアゲートウェイ](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/secure-gateway.md#connecting-inference-servers) 接続には独自のTLS構成があり、サーバーの待ち受けアドレスとは別に設定されます。

## 画像の取得を制限する

呼び出し元が指定した画像URLにより、サーバーが内部サービスやメタデータエンドポイントにアクセスする可能性があります。 [受け付ける入力形式](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/input-formats.md#sending-urls-to-inference-images) では、アプリケーションに必要な形式を維持しながら、URL入力を無効にする方法、接続先を制限する方法、リダイレクトを検証する方法を説明しています。これらの画像取得制御は、他のWorkflow統合や動画通信に対するネットワーク制限の代わりにはなりません。

## Webhook Sinkの接続先を制限する

Webhook Sinkは、Workflowのデータをプライベートネットワーク上のサービスに送信できます。Self-hosted Inferenceでは、既存のファクトリーやLANのWebhookを引き続き利用できるよう、デフォルトでこれらの接続先が許可されています。

呼び出し元に接続先の選択を任せられない場合は、 `ALLOW_WEBHOOK_WORKFLOWS_SINK_TO_NON_GLOBAL_ADDRESSES=False` に設定してください。これにより、ループバック、プライベート、リンクローカル（クラウドメタデータを含む）、CGNAT、予約済み、マルチキャストの各アドレスへの接続が拒否されます。Webhookリクエストではホスト名を一度だけ解決し、検証済みのアドレスに接続します。どちらの設定でも、リダイレクトとHTTP(S)プロキシは拒否されます。

## リモートクライアントを許可する前に

ループバック以外のアドレスにバインドすると、信頼できないクライアントがサーバーにアクセスできるようになります。このページの寛容なデフォルト設定は、そのような利用を想定したものではありません。ポートを公開する前に、少なくとも次の点を確認してください。

* バインドアドレスを慎重に選択する: `inference server start` を、 `--bind-address`なしで実行するか、 `-p 127.0.0.1:9001:9001` を `docker run`に指定します。リモートクライアントが必要な場合を除き、この設定を使用してください。
* 既知のクライアントだけがアクセスできるようにします。プライベートネットワークまたはVPC内にとどめ、パブリックIPではなくVPN、SSHトンネル、またはサービスメッシュ経由でサーバーに接続します。また、ホストファイアウォールやクラウドファイアウォール、セキュリティグループを使って、ポート `9001` へのアクセスを必要とする特定のクライアントだけに許可します。
* プロキシでWorkspace認証、または独自の認証を有効にします。認証がないと、ポート `9001` に到達できる誰もが、ハードウェア上でモデルやWorkflowsを実行でき、Roboflowアカウントの利用枠が消費されます。
* 信頼できないネットワークを経由する通信にはTLSを設定します。
* Custom Pythonと実行可能なモデルパッケージは、サーバーの権限を与えてもよい信頼できる呼び出し元だけが利用できるようにします。アクセス可能なサーバーで有効にしたままにすると、ローカルのCustom Pythonは、Workflowを送信できる誰もが利用できるリモートコード実行機能になります。
* URL画像入力を無効にするか、 [Accepted Input Formats](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/input-formats.md#sending-urls-to-inference-images).
* 次のように設定します。 `ALLOW_WEBHOOK_WORKFLOWS_SINK_TO_NON_GLOBAL_ADDRESSES=False` 呼び出し元が信頼できるプライベートサービスまたはローカルサービスにWebhookを送信する必要がある場合を除きます。
* サーバーをより広範囲に公開する必要がある場合は、リバースプロキシ（nginx、Traefik、Caddy、またはクラウドロードバランサー）をサーバーの前段に配置します。これにより、TLS、レート制限、アクセスログを一元的に追加できます。
* ヘルスチェックとメトリクスコレクターが引き続き接続できることを確認します。

認証とTLSを設定せずに、推論ポートをパブリックインターネットに直接公開しないでください。

再試行、容量、監視については、 [本番環境対応チェックリスト](https://docs.roboflow.com/deployment/ja/production-checklist.md) を使用してください。
