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

# 허용되는 입력 형식

자체 호스팅 Roboflow Inference 서버가 허용하는 입력 형식과, pickled numpy 페이로드 및 URL 이미지 가져오기처럼 덜 안전한 형식을 비활성화하는 방법입니다.

## 중요한 이유

추론 서버는 쉽게 통합할 수 있도록 설계되었으며, 이 때문에 편리하지만 보안성이 다소 낮을 수 있는 데이터 로드 방법도 제공됩니다. 프로덕션 배포에서는 구성 옵션을 사용해 이러한 동작을 비활성화할 수 있습니다.

이 페이지에서는 필요에 따라 서버를 더 안전하게 설정하거나 유연한 동작을 활성화하는 방법을 설명합니다.

## 피클로 직렬화된 numpy 객체 역직렬화

추론 서버에 요청을 보내는 한 가지 방법은 직렬화된 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,
    },
}

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

버전부터 `v0.14.0`이 페이로드 유형의 역직렬화는 기본적으로 비활성화되어 있습니다. 다음을 설정해 활성화할 수 있습니다. `ALLOW_NUMPY_INPUT=True`. 해당 플래그를 사용해 서버를 실행하는 방법은 [추론 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",
    },
}

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

요청에 지정된 URL에서 바로 이미지를 불러올 수 있습니다(`{"image": {"type": "url", "value": "https://..."}}`). 서버가 호출자가 제어하는 URL을 가져올 때마다 호출자는 서버가 자신을 대신해 요청을 보내도록 유도할 수 있습니다. 이를 서버 측 요청 위조(SSRF) 공격이라고 합니다. 내부 네트워크에 직접 접근할 수 없는 사람도 예를 들어 다음 주소를 서버에 가져오도록 요청할 수 있습니다.

* `http://169.254.169.254/latest/meta-data/`는 클라우드 메타데이터 서비스(AWS, GCP, Azure)로, 인스턴스 자격 증명을 반환할 수 있습니다.
* `http://127.0.0.1:9001/...` 및 기타 로컬호스트 서비스(관리자 패널, 데이터베이스, 추론 서버 자체의 인증되지 않은 엔드포인트)도 대상이 될 수 있습니다.
* `http://10.0.0.5/`, `http://192.168.1.1/`및 경계망 내부의 기타 사설(RFC1918), 링크 로컬, CGNAT 또는 IPv6 ULA 호스트도 대상이 될 수 있습니다.

공개 주소처럼 보이는 호스트 이름이라고 해서 대상이 공개 호스트라는 보장은 없습니다. 사설 IP로 해석되거나 사설 IP로 리디렉션될 수 있고, DNS 리바인딩을 사용할 수도 있습니다(검증 단계에서는 공개 IP로 해석된 뒤 실제 연결 시에는 사설 IP로 해석). 추론 서버에는 이러한 모든 경우를 제어하는 기능이 포함되어 있습니다.

### 필요하지 않다면 URL 입력 끄기

가장 강력한 제어 방법은 URL 이미지 자체를 받지 않는 것입니다. 클라이언트가 항상 이미지를 base64 또는 파일 업로드로 전송한다면 URL 가져오기를 완전히 비활성화하세요.

```bash
docker run --rm -p 127.0.0.1:9001:9001 \
  -e ALLOW_URL_INPUT=false \
  roboflow/roboflow-inference-server-cpu:latest
```

### URL 입력이 필요하다면 보안 강화하기

URL 이미지가 필요한 경우 다음 플래그로 서버가 가져올 수 있는 대상을 제한할 수 있습니다. 이 플래그를 함께 사용하면 내부 대상 요청을 거부하고, 연결을 검증된 IP에 고정해 DNS 리바인딩을 방지하며, 리디렉션의 각 단계를 다시 확인합니다.

<table data-search="false"><thead><tr><th>변수</th><th>기본값</th><th>효과</th></tr></thead><tbody><tr><td>ALLOW_URL_INPUT</td><td>True</td><td>URL 이미지 입력의 전체 활성화 스위치입니다. False로 설정하면 모든 URL 이미지 요청이 거부됩니다.</td></tr><tr><td>ALLOW_LOADING_IMAGES_FROM_LOCAL_FILESYSTEM</td><td>True</td><td>로컬 파일 시스템에서 이미지를 불러오지 않도록 하려면 False로 설정하세요.</td></tr><tr><td>ALLOW_URL_TO_NON_GLOBAL_ADDRESSES</td><td>True</td><td>False인 경우, 호스트가 비전역 주소(루프백, 사설, 링크 로컬/메타데이터, CGNAT, IPv6 ULA 등)로 확인되는 URL은 거부되며, 두 번째 DNS 응답으로 대상이 바뀌지 않도록 연결을 검증된 IP에 고정합니다.</td></tr><tr><td>VALIDATE_IMAGE_URL_REDIRECTS</td><td>False</td><td>True인 경우, 리디렉션을 한 번에 한 단계씩 따라가며 각 단계의 URL을 다시 검증합니다. 검증 없이 리디렉션을 그대로 따라가지 않습니다.</td></tr><tr><td>MAX_IMAGE_URL_REDIRECTS</td><td>30</td><td>위 플래그와 관계없이 적용되는 리디렉션 단계의 최대 횟수입니다.</td></tr><tr><td>ALLOW_NON_HTTPS_URL_INPUT</td><td>False</td><td>False인 경우, https:// URL만 허용됩니다.</td></tr><tr><td>ALLOW_URL_INPUT_WITHOUT_FQDN</td><td>False</td><td>False인 경우, 호스트가 단독 IP이거나 공개 접미사가 없는 URL은 거부되므로 호출자는 실제 도메인 이름을 사용해야 합니다.</td></tr><tr><td>WHITELISTED_DESTINATIONS_FOR_URL_INPUT</td><td>설정되지 않음</td><td>쉼표로 구분된 허용 대상 목록(subdomain.domain.suffix)입니다. 설정하면 이 대상만 허용됩니다.</td></tr><tr><td>BLACKLISTED_DESTINATIONS_FOR_URL_INPUT</td><td>설정되지 않음</td><td>항상 거부할 대상을 쉼표로 구분해 지정하는 차단 목록입니다.</td></tr></tbody></table>

공개 HTTPS 이미지 URL은 허용하면서 보안을 강화하는 구성은 다음과 같습니다.

```bash
docker run --rm -p 127.0.0.1:9001:9001 \
  -e ALLOW_URL_TO_NON_GLOBAL_ADDRESSES=false \
  -e VALIDATE_IMAGE_URL_REDIRECTS=true \
  roboflow/roboflow-inference-server-cpu:latest
```

가장 엄격하게 제어하려면 허용 목록을 추가해 서버가 이미지 제공에 사용하는 정확한 호스트에만 접속하도록 설정합니다.

```bash
docker run --rm -p 127.0.0.1:9001:9001 \
  -e ALLOW_URL_TO_NON_GLOBAL_ADDRESSES=false \
  -e VALIDATE_IMAGE_URL_REDIRECTS=true \
  -e WHITELISTED_DESTINATIONS_FOR_URL_INPUT=images.example.com,cdn.example.com \
  roboflow/roboflow-inference-server-cpu:latest
```

{% hint style="warning" %}
2026년 4분기에 기본값 두 가지가 변경됩니다. `ALLOW_URL_TO_NON_GLOBAL_ADDRESSES` ( `False`로 변경되고) `VALIDATE_IMAGE_URL_REDIRECTS` ( `(`True
{% endhint %}

{% hint style="info" %}
)는 현재 이전 버전과의 호환성을 위해 기존의 제한이 느슨한 동작을 기본값으로 사용합니다. 두 기본값 모두 2026년 4분기에 보안 설정값으로 변경될 예정입니다. 변경으로 인한 예기치 못한 영향을 방지하려면 지금 값을 명시적으로 지정하세요. 보안 설정값을 사용해 미리 적용하거나, Workflow에서 내부 URL 가져오기에 실제로 의존한다면 기존 설정값을 지정할 수 있습니다.
{% endhint %}

{% hint style="info" %}
Python SDK에도 동일한 제어가 적용됩니다. `inference-sdk` 클라이언트는 URL에서 이미지를 불러올 때 동일한 URL 정책과 SSRF 보호를 적용하고 같은 환경 변수를 읽습니다. 따라서 전송 전에 URL 이미지 데이터를 미리 로드하는 클라이언트도 보호됩니다.
{% endhint %}

서버 측 비디오 소스에 대해서는 [비디오 구성](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/video-configuration.md#server-side-video-references)을 참조하세요. 네트워크 액세스 및 인증은 [서버 보안](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security.md) 으로 돌아가세요.
