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

# स्वीकृत इनपुट फ़ॉर्मैट

self-hosted Roboflow Inference server द्वारा स्वीकार किए जाने वाले input formats, और pickle किए गए numpy payloads तथा URL image fetching जैसे कम सुरक्षित विकल्पों को कैसे अक्षम करें।

## यह क्यों महत्वपूर्ण है

Inference सर्वर को आसानी से एकीकृत करने के लिए बनाया गया है, इसलिए इसमें डेटा लोड करने के कुछ सुविधाजनक, लेकिन संभावित रूप से कम सुरक्षित तरीके उपलब्ध हैं। प्रोडक्शन डिप्लॉयमेंट के लिए, कॉन्फ़िगरेशन विकल्पों की मदद से आप इन व्यवहारों को बंद कर सकते हैं।

यह पेज बताता है कि अपनी ज़रूरतों के अनुसार सर्वर को अधिक सुरक्षित बनाने या अधिक लचीला व्यवहार सक्षम करने के लिए उसे कैसे कॉन्फ़िगर करें।

## Pickle किए गए numpy ऑब्जेक्ट का डीसीरियलाइज़ेशन

Inference सर्वर को अनुरोध भेजने का एक तरीका सीरियलाइज़ किए गए 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` सेट करें। इस फ़्लैग के साथ सर्वर चलाने का तरीका जानने के लिए [Inference CLI](https://docs.roboflow.com/reference/inference/inference-cli/server)  के दस्तावेज़ देखें। Roboflow के होस्ट किए गए API में यह विकल्प उपलब्ध नहीं है।

{% hint style="warning" %}
अगर सर्वर खुले इंटरनेट से अनुरोध स्वीकार करता है या उसे केवल आपके वर्कस्पेस की API key से प्रमाणित अनुरोध स्वीकार करने के लिए लॉक नहीं किया गया है, तो प्रोडक्शन में यह विकल्प सक्षम न करें।
{% endhint %}

## इमेज के URL को inference के लिए भेजना

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,
)
```

Inference अनुरोध में दिए गए 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/...` और अन्य लोकलहोस्ट सेवाएँ: एडमिन पैनल, डेटाबेस या Inference सर्वर के अपने अनधिकृत एंडपॉइंट।
* `http://10.0.0.5/`, `http://192.168.1.1/`और आपके नेटवर्क की सीमा के पीछे मौजूद अन्य निजी (RFC1918), लिंक-लोकल, CGNAT या IPv6 ULA होस्ट।

सार्वजनिक दिखने वाला होस्टनेम इस बात का प्रमाण नहीं है कि लक्ष्य सार्वजनिक है: यह किसी निजी IP पर रिज़ॉल्व हो सकता है, निजी IP पर रीडायरेक्ट कर सकता है या DNS rebinding का इस्तेमाल कर सकता है (वैलिडेशन जाँच के समय सार्वजनिक IP पर रिज़ॉल्व होना, फिर वास्तविक कनेक्शन के लिए निजी IP पर रिज़ॉल्व होना)। Inference में इन सभी स्थितियों से बचाव के नियंत्रण उपलब्ध हैं।

### ज़रूरत न हो तो 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 rebinding रुकती है) और हर रीडायरेक्ट चरण की दोबारा जाँच होती है।

<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 होने पर, ऐसा URL अस्वीकार कर दिया जाता है जिसका होस्ट किसी गैर-ग्लोबल पते (लूपबैक, निजी, लिंक-लोकल/मेटाडेटा, CGNAT, IPv6 ULA आदि) पर resolve होता है। कनेक्शन को सत्यापित IP से पिन किया जाता है, ताकि DNS से मिला दूसरा उत्तर लक्ष्य को बदल न सके।</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 होने पर, ऐसे URL अस्वीकार कर दिए जाते हैं जिनका होस्ट सिर्फ़ IP पता हो या जिनमें सार्वजनिक प्रत्यय न हो। इसलिए कॉल करने वालों को वास्तविक डोमेन नाम का इस्तेमाल करना होगा।</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" %}
Q4 2026 में दो डिफ़ॉल्ट बदल रहे हैं। `ALLOW_URL_TO_NON_GLOBAL_ADDRESSES` (को `False`) और `VALIDATE_IMAGE_URL_REDIRECTS` (को `True`) अभी पश्चगामी संगतता के लिए पुराने, उदार व्यवहार पर डिफ़ॉल्ट होते हैं। दोनों डिफ़ॉल्ट को Q4 2026 में सुरक्षित मानों पर बदलने की योजना है। अभी इन्हें स्पष्ट रूप से सेट करें—जल्दी अपनाने के लिए सुरक्षित मानों पर, या पुराने मानों पर यदि कोई Workflow वास्तव में आंतरिक URL से फ़ेच करने पर निर्भर करता है—ताकि यह बदलाव आपको अचानक प्रभावित न करे।
{% endhint %}

{% hint style="info" %}
प्रॉक्सी इस सुरक्षा को दरकिनार कर देते हैं। यदि सर्वर के लिए HTTP(S) प्रॉक्सी कॉन्फ़िगर की गई है, तो गंतव्य का resolve प्रॉक्सी करता है (Inference नहीं), इसलिए गैर-ग्लोबल पतों को ब्लॉक करना और कनेक्शन को IP से पिन करना लागू नहीं किया जा सकता। ऐसा पता चलने पर सर्वर चेतावनी देता है। यदि आप इन नियंत्रणों पर निर्भर हैं, तो प्रॉक्सी की पहुँच को सीमित करें।
{% endhint %}

{% hint style="info" %}
Python SDK में भी यही नियंत्रण हैं। `inference-sdk` क्लाइंट URL से इमेज लोड करते समय यही URL नीति और SSRF सुरक्षा लागू करता है और उन्हीं पर्यावरण वेरिएबल को पढ़ता है। इसलिए भेजने से पहले URL वाली इमेज को लोड करने वाला क्लाइंट भी सुरक्षित रहता है।
{% endhint %}

सर्वर-साइड वीडियो स्रोतों के लिए देखें [वीडियो कॉन्फ़िगरेशन](https://docs.roboflow.com/deployment/hi/self-hosted/inference-server/configuration/video-configuration.md#server-side-video-references). नेटवर्क पहुँच और प्रमाणीकरण के लिए [सर्वर सुरक्षा](https://docs.roboflow.com/deployment/hi/self-hosted/inference-server/configuration/security.md) पर लौटें।
