> 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/serufuhosuto/inference-server/configuration/input-formats.md).

# 受け入れられる入力形式

## なぜこれが重要なのか

Inference サーバーは統合しやすいように設計されているため、便利ではあるものの、セキュリティがやや低い可能性のあるデータ読み込み方法がいくつか用意されています。本番環境へのデプロイでは、設定オプションを使ってそれらの動作を無効にできます。

このページでは、ニーズに応じてサーバーを強化する方法、またはより柔軟な動作を有効にする方法を説明します。

## pickle化された NumPy オブジェクトのデシリアライズ

Inference サーバーにリクエストを送信する方法の 1 つは、シリアル化された NumPy オブジェクトを使うことです:

```python
import cv2
import pickle
import requests

image = cv2.imread("...")
img_str = pickle.dumps(image)

infer_payload = {
    "model_id": "{project_id}/{model_version}",
    "image": {
        "type": "numpy",
        "value": img_str,
    },
    "api_key": "YOUR_API_KEY",
}

res = requests.post(
    "http://localhost:9001/infer/{task}",
    json=infer_payload,
)
```

バージョン `v0.14.0`、このペイロード形式のデシリアライズはデフォルトで無効です。次を設定することで有効にできます: `ALLOW_NUMPY_INPUT=True`。詳細は [Inference CLI](https://docs.roboflow.com/reference/inference/inference-cli/server) そのフラグを指定してサーバーを実行する方法についてのドキュメントを参照してください。このオプションは **Roboflow のホスト型 API では利用できません**.

{% hint style="warning" %}
サーバーが公開インターネットからのリクエストを受け付ける状態にある場合、またはワークスペースの API キーによる認証済みリクエストのみを受け付けるように制限されていない場合は、本番環境でこのオプションを有効にしないでください。
{% endhint %}

## 推論画像に URL を送信する

URL から画像を取得するのは便利ですが、サーバーを次の脅威にさらす可能性があります [サーバーサイドリクエストフォージェリ（SSRF）攻撃](https://en.wikipedia.org/wiki/Server-side_request_forgery):

```python
import requests

infer_payload = {
    "model_id": "{project_id}/{model_version}",
    "image": {
        "type": "url",
        "value": "https://some.com/image.jpg",
    },
    "api_key": "YOUR_API_KEY",
}

res = requests.post(
    "http://localhost:9001/infer/{task}",
    json=infer_payload,
)
```

このオプションは **デフォルトで有効です**。以下の環境変数のうち 1 つ以上を使ってサーバーを構成することを推奨します:

* `ALLOW_URL_INPUT` - 次に設定すると `False` あらゆる種類の画像 URL を拒否します。デフォルト: `True`.
* `ALLOW_NON_HTTPS_URL_INPUT` - 次に設定すると `False` URL では HTTPS プロトコルのみを許可します。デフォルト: `False`.
* `ALLOW_URL_INPUT_WITHOUT_FQDN` - 次に設定すると `False` 完全修飾ドメイン名のみを強制し、IP ベースの URL を拒否します。デフォルト: `False`.
* `WHITELISTED_DESTINATIONS_FOR_URL_INPUT` - URL リクエストで許可する送信先のカンマ区切りリスト。例: `WHITELISTED_DESTINATIONS_FOR_URL_INPUT=192.168.0.15,some.site.com`。それ以外を指す URL は拒否されます。
* `BLACKLISTED_DESTINATIONS_FOR_URL_INPUT` - URL リクエストで禁止する送信先のカンマ区切りリスト。
* `ALLOW_LOADING_IMAGES_FROM_LOCAL_FILESYSTEM` - 次に設定すると `False` 画像へのローカルファイルシステムアクセスを無効にします。デフォルト: `True`.
* `ALLOW_URL_TO_NON_GLOBAL_ADDRESSES` - 次に設定すると `False` ホストがグローバルでないアドレス（ループバック、プライベート/RFC1918、リンクローカル、およびクラウドメタデータ `169.254.169.254`、CGNAT、IPv6 ULA）に解決される URL を拒否し、接続を検証済みの IP に固定して DNS リバインディングでターゲットが置き換えられないようにします。デフォルト: `True` （ `False` 2026 年第 4 四半期に変更予定）。
* `VALIDATE_IMAGE_URL_REDIRECTS` - 次に設定すると `True` クライアントに無条件でリダイレクトを追従させるのではなく、1 ホップずつリダイレクトを追跡し、各ホップの URL（スキーム、FQDN、許可リスト、ブロックリスト、非グローバルアドレス）を再検証します。デフォルト: `False` （ `True` 2026 年第 4 四半期に変更予定）。
* `MAX_IMAGE_URL_REDIRECTS` - URL 画像の取得時に許可されるリダイレクト段数の厳格な上限。次に関係なく強制されます `VALIDATE_IMAGE_URL_REDIRECTS`。デフォルト: `30`.

参照: [セルフホスト型サーバーのセキュリティ保護](/deployment/ja/serufuhosuto/inference-server/configuration/security.md) SSRF 制御と推奨構成のより詳しい説明については、 [Inference CLI](https://docs.roboflow.com/reference/inference/inference-cli/server) 特定のフラグを指定してサーバーを実行するためのドキュメントを参照してください。
