> 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/roboflow-cloud/cloud-streaming/install-a-connector.md).

# कनेक्टर इंस्टॉल करें

Roboflow Video Connector को macOS, Linux, Windows, या Docker पर इंस्टॉल और चलाएँ।

Roboflow Video Connector आपके कंप्यूटर या स्थानीय नेटवर्क से जुड़े कैमरों को Cloud Streaming से जोड़ता है। इसे ऐसी मशीन पर चलाएँ जो कैमरों तक पहुँच सकती हो और उनके इस्तेमाल के दौरान ऑनलाइन रहे। मॉडल का अनुमान Roboflow के क्लाउड में चलता है, कनेक्टर में नहीं।

इंस्टॉल करने के बाद, [कोई स्रोत कनेक्ट करें](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/connect-a-source.md).

## शुरू करने से पहले

"Deployments", फिर "Cloud Streaming", फिर "Add Video Source" और फिर "Connect a Camera" खोलें। अगर वर्कस्पेस में पहले से कोई कनेक्टर है, तो "Add a new connector" पर क्लिक करें। अपने OS का टैब चुनें, "Copy Command" पर क्लिक करें और कमांड चलाएँ: इसमें आपके वर्कस्पेस की API key शामिल होती है। कुंजियाँ चैट, सोर्स कंट्रोल या स्क्रीनशॉट में न डालें।

नेटिव आर्काइव macOS और Linux के लिए x86-64 और ARM64 पर, तथा Windows के लिए x86-64 पर उपलब्ध हैं। Linux के लिए glibc 2.28 या बाद का संस्करण और GnuTLS (`libgnutls30` या `gnutls`).

) आवश्यक है। कनेक्टर तीनों ऑपरेटिंग सिस्टम पर USB कैमरे खोजता है। Linux पर यह केवल V4L2 डिवाइस खोजता है।

## CLI

### macOS या Linux पर इंस्टॉल करें

सार्वजनिक इंस्टॉलर चलाएँ:

```sh
curl --proto =https --proto-redir =https -fsSL https://repo.roboflow.com/rfv-connector/latest/install.sh | sh
~/.rfv-connector/rfv-connector --version
```

इंस्टॉलर आपके ऑपरेटिंग सिस्टम और आर्किटेक्चर का पता लगाता है, फिर इंस्टॉल करने से पहले चुनी गई रिलीज़ के चेकसम जाँचता है। निष्पादन योग्य फ़ाइल है `~/.rfv-connector/rfv-connector`; `~/.rfv-connector` अकेले एक डायरेक्टरी है।

इंस्टॉलर निष्पादन योग्य फ़ाइल को आपके PATH में नहीं जोड़ता। मौजूदा टर्मिनल में छोटा कमांड इस्तेमाल करने के लिए:

```sh
export PATH="$HOME/.rfv-connector:$PATH"
rfv-connector --version
```

आगे के टर्मिनलों के लिए इस export को अपनी शेल की स्टार्टअप फ़ाइल में जोड़ें (उदा.: `~/.zshrc`)।

EU डाउनलोड मिरर भी उपलब्ध है:

```sh
curl --proto =https --proto-redir =https -fsSL https://repo.roboflow.eu/rfv-connector/latest/install.sh | RFV_DOWNLOAD_BASE=https://repo.roboflow.eu/rfv-connector sh
```

इससे इंस्टॉलेशन फ़ाइलें डाउनलोड होने का स्रोत बदलता है। यह प्रोसेसिंग क्षेत्र नहीं चुनता और न ही API एंडपॉइंट बदलता है।

### Windows पर इंस्टॉल करें

PowerShell में इंस्टॉलर चलाएँ, फिर संस्करण जाँचें:

```powershell
irm https://repo.roboflow.com/rfv-connector/latest/install.ps1 | iex
& "$env:USERPROFILE\.rfv-connector\current\rfv-connector.exe" --version
```

सेटअप डायलॉग के "Windows" टैब में "Download Installer" पर क्लिक करके भी `roboflow-connector.bat`डाउनलोड कर सकते हैं। इसे इंस्टॉल करने और कनेक्टर शुरू करने के लिए इस पर डबल-क्लिक करें।

इसके बजाय ZIP आर्काइव से इंस्टॉल करने के लिए:

1. सार्वजनिक [रिलीज़ संस्करण पॉइंटर](https://repo.roboflow.com/rfv-connector/latest/LATEST_VERSION.txt).
2. से एक संस्करण चुनें `rfv-connector_windows_amd64.zip` और `checksums.txt` उसी संस्करण वाले डायरेक्टरी से डाउनलोड करें, `https://repo.roboflow.com/rfv-connector/<VERSION>/`। पॉइंटर में दिया गया संस्करण, उसके `v` उपसर्ग सहित इस्तेमाल करें (उदा.: `v0.11.0`).
3. PowerShell में आर्काइव का चेकसम निकालें:

```powershell
Get-FileHash .\rfv-connector_windows_amd64.zip -Algorithm SHA256
```

4. इसकी तुलना सटीक ZIP फ़ाइलनाम के SHA256 से करें, जो इसमें दिया गया है `checksums.txt` में। अगर चेकसम मौजूद न हो या मेल न खाए, तो आर्काइव न चलाएँ।
5. पूरा आर्काइव किसी स्थायी फ़ोल्डर में निकालें। इनके साथ रखें `ffmpeg.exe`और स्रोत फ़ाइलों तथा नोटिस को एक्ज़ीक्यूटेबल के साथ रखें।

रिलीज़ पर कोड-साइन नहीं किए गए हैं, इसलिए macOS या Windows आपको चेतावनी दे सकता है। अगर आपका संगठन इसकी अनुमति देता है, तो macOS में "Privacy & Security" के अंतर्गत "Open Anyway" पर क्लिक करें, या Windows में "More info" और फिर "Run anyway" पर क्लिक करें।

### कनेक्टर शुरू करें और कॉन्फ़िगर करें

सेटअप डायलॉग में दिया गया कमांड चलाएँ, या अपनी वर्कस्पेस कुंजी यहाँ सेट करें `ROBOFLOW_API_KEY` और कनेक्टर शुरू करें:

```sh
~/.rfv-connector/rfv-connector --api-key "$ROBOFLOW_API_KEY"
```

Windows पर, PowerShell में:

```powershell
& "$env:USERPROFILE\.rfv-connector\current\rfv-connector.exe" --api-key "$env:ROBOFLOW_API_KEY"
```

अगर आपने ZIP आर्काइव से इंस्टॉल किया है, तो इसके बजाय निकाले गए फ़ोल्डर से `.\rfv-connector.exe` चलाएँ।

स्टार्टअप पर RTSP कैमरे जोड़ने के लिए, हर कैमरे के लिए एक बार `--rtsp "name=rtsp://..."` जोड़ें। आप बाद में ऐप से भी कैमरे जोड़ सकते हैं।

कनेक्टर एक स्थानीय पेज भी चलाता है `http://127.0.0.1:8070` जहाँ आप कुंजी सेट कर सकते हैं, स्रोत चालू या बंद कर सकते हैं और RTSP कैमरे जोड़ सकते हैं। इसे बंद करने के लिए `--no-ui` जोड़ें।

जब आपका OS पूछे, तो कनेक्टर शुरू करने वाले ऐप्लिकेशन या टर्मिनल को कैमरे तक पहुँचने की अनुमति दें। Linux पर, कनेक्टर शुरू करने वाले उपयोगकर्ता को कैमरे के कैप्चर डिवाइस को पढ़ने की अनुमति होनी चाहिए। सभी डिवाइस को लिखने योग्य बनाने के बजाय अपने सिस्टम की डिवाइस-एक्सेस नीति का उपयोग करें।

सेटअप डायलॉग पर लौटें और जाँचें कि कनेक्टर कनेक्ट है। अगर कोई कनेक्टर पहले से ऑनलाइन था, तो उससे नया कैमरा दिखाई देने पर डायलॉग इसकी पुष्टि करेगा। इसके कैमरे फिर स्रोत सूची में दिखाई देंगे। आगे बढ़ें: [स्रोत सेटअप](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/connect-a-source.md).

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-891a6980b60e4b2db8de7e19117ee9619ea1f59a%2Fcloud-streaming-shot02-connector-connected.png?alt=media" alt="Connector setup dialog with its API key redacted and a successful connection."><figcaption><p>कनेक्टर चलाएँ और कनेक्शन की पुष्टि होने तक प्रतीक्षा करें।</p></figcaption></figure>

### इसे चालू रखें

टर्मिनल बंद करने या कंप्यूटर के स्लीप मोड में जाने पर कनेक्टर रुक जाता है। इसे सिस्टम सेवा के रूप में या Docker के साथ चलाएँ, और एक समय में इसकी केवल एक कॉपी चलाएँ।

## Docker

रिलीज़ टैग पिन करें। इस उदाहरण में कनेक्टर की पहचान एक नामित वॉल्यूम में बनी रहती है:

```sh
docker run -d --name rfv-connector \
  --restart unless-stopped \
  -v rfv-connector-state:/state \
  repo.roboflow.com/rfv-connector:0.11.0 \
  --api-key "$ROBOFLOW_API_KEY"
```

कमांड चलाने से पहले `ROBOFLOW_API_KEY` सेट करें। फिर "Deployments" और उसके बाद "Cloud Streaming" पर लौटें, ताकि पुष्टि कर सकें कि कनेक्टर कनेक्ट है, और [कैमरे जोड़ें](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/connect-a-source.md#rtsp-and-onvif-cameras).

Docker के ब्रिज नेटवर्क पर ONVIF खोज आपके LAN को नहीं देख सकती: RTSP URL से कैमरे जोड़ें, या `--network host` Linux पर इसके साथ उपयोग करें `--ui-addr=127.0.0.1:8070`.

Linux USB कैमरों के लिए, डिवाइस पास करें (उदाहरण: `--device /dev/video0`). macOS पर Docker होस्ट वेबकैम का उपयोग नहीं कर सकता।

रखें `/state` स्थायी स्टोरेज पर। केवल `connector.json`डायरेक्टरी को माउंट करें, सिर्फ़ इसे नहीं। एक ही स्टेट वॉल्यूम को एक साथ चल रहे इंस्टॉलेशन के बीच साझा न करें।

## अपडेट करते समय स्टेट सुरक्षित रखें

इंस्टॉलेशन डायरेक्टरी में बाइनरी फ़ाइलें होती हैं। डेटा डायरेक्टरी में कॉन्फ़िगरेशन और पहचान की जानकारी अलग से रखी जाती है:

<table data-search="false"><thead><tr><th>इंस्टॉलेशन</th><th>डिफ़ॉल्ट डेटा डायरेक्टरी</th></tr></thead><tbody><tr><td>macOS</td><td>~/Library/Application Support/rf-video-connector</td></tr><tr><td>Linux</td><td>$XDG_STATE_HOME/rf-video-connector, या ~/.local/state/rf-video-connector</td></tr><tr><td>Windows</td><td>%LOCALAPPDATA%/rf-video-connector</td></tr><tr><td>Docker</td><td>/state</td></tr></tbody></table>

`--data-dir` इनको ओवरराइड करता है: `RFV_DATA_DIR` और डिफ़ॉल्ट को। `--config` अलग कॉन्फ़िगरेशन फ़ाइल का पथ दे सकता है। पूरी डेटा डायरेक्टरी और किसी भी अलग कॉन्फ़िगरेशन, दोनों का बैकअप लें। बैकअप को निजी रखें, क्योंकि उसमें कुंजियाँ और कैमरे के पासवर्ड हो सकते हैं।

1. अपग्रेड करने से पहले क्लाउड जॉब और पुराना कनेक्टर बंद करें।
2. उसकी डेटा डायरेक्टरी (या Docker `/state` वॉल्यूम) को सुरक्षित रखें। पुराने कंटेनर पहचान की जानकारी कॉन्फ़िगरेशन फ़ाइल के बाहर स्टोर कर सकते हैं, इसलिए कंटेनर बदलने से पहले जाँच लें।
3. नेटिव इंस्टॉलर को फिर से चलाएँ, सत्यापित Windows रिलीज़ को निकालें, या Docker का नया इम्यूटेबल वर्शन चुनें। स्थायी स्टेट को ओवरराइट या हटाएँ नहीं।
4. एक कनेक्टर शुरू करें और जाँचें कि आपके कैमरे अब भी उसी कनेक्टर के अंतर्गत दिखाई देते हैं।

पुराने Linux इंस्टॉलेशन USB स्रोतों के नाम इस तरह रखते हैं: `usb:videoN`। अपग्रेड करने से पहले चलाएँ `rfv-connector --list-usb` और कॉन्फ़िगरेशन में `usbSourceAliases` का उपयोग करके पुराने नामों को नई ID से मैप करें।

कनेक्टर हटाने के लिए, उसे बंद करें, फिर "Cloud Streaming" में उसके पेज पर "Remove connector" पर क्लिक करें। डेटा डायरेक्टरी तभी हटाएँ, जब आप नया कनेक्टर शुरू से बनाना चाहते हों।

## नेटवर्क आवश्यकताएँ

कनेक्टर Roboflow API और उसे असाइन किए गए मीडिया गंतव्य से आउटबाउंड कनेक्शन खोलता है। कैमरे तक पहुँचने के लिए इंटरनेट से इनबाउंड पोर्ट फ़ॉरवर्ड करने की ज़रूरत नहीं है। फिर भी, कनेक्टर चलाने वाली मशीन को कैमरे की RTSP या ONVIF सेवा तक स्थानीय पहुँच और HTTPS API के अतिरिक्त आउटबाउंड मीडिया पहुँच की आवश्यकता होती है।

नेटवर्क कैमरों का वीडियो RTSP पर TCP पोर्ट 8554 के ज़रिए फ़ॉरवर्ड किया जाता है। USB कैमरों और फ़ाइलों का वीडियो WebRTC (WHIP) पर UDP या TCP के ज़रिए भेजा जाता है। ONVIF डिस्कवरी में स्थानीय मल्टीकास्ट का उपयोग होता है, जो संभव है कि VLAN के पार न जा सके।

अगर कनेक्टर ऑनलाइन है, लेकिन कैमरा या वीडियो दिखाई नहीं दे रहा, तो देखें: [समस्या निवारण](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/troubleshooting.md).
