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

# Connector をインストール

macOS、Linux、Windows、または Docker で Roboflow Video Connector をインストールして実行します。

Roboflow Video Connector は、コンピューターまたはローカルネットワーク上のカメラを Cloud Streaming に接続します。カメラにアクセスでき、カメラの使用中にオンライン状態を維持できるマシンで実行してください。モデルの推論はコネクターではなく、Roboflow のクラウドで実行されます。

インストール後、 [ソースを接続します](https://docs.roboflow.com/deployment/ja/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 キーが含まれています。キーをチャット、ソース管理、スクリーンショットに貼り付けないでください。

ネイティブアーカイブは、x86-64 および ARM64 の macOS と Linux、ならびに x86-64 の Windows に対応しています。Linux では glibc 2.28 以降と GnuTLS（`libgnutls30` または `gnutls`).

）が必要です。コネクターは3つの OS すべてで 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では「プライバシーとセキュリティ」で「このまま開く」を、Windowsでは「詳細情報」をクリックしてから「実行」をクリックしてください。

### コネクターを起動して設定する

セットアップダイアログに表示されるコマンドを実行するか、ワークスペースキーを `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/ja/roboflow-cloud/cloud-streaming/connect-a-source.md).

<figure><img src="https://970637113-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として実行し、同時に起動するインスタンスは1つだけにしてください。

## Docker

リリースタグを固定します。この例では、名前付きボリュームにコネクターのIDを保存します。

```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/ja/roboflow-cloud/cloud-streaming/connect-a-source.md#rtsp-and-onvif-cameras).

Dockerのブリッジネットワークでは、ONVIFによる検出でLAN上のカメラを見つけられません。RTSP URLでカメラを追加するか、Linuxで `--network host` と `--ui-addr=127.0.0.1:8070`.

を指定してください。LinuxでUSBカメラを使用する場合は、デバイスを渡します（例： `--device /dev/video0`）。macOS上のDockerでは、ホストのWebカメラを使用できません。

保管してください `/state` などの永続ストレージに保存します。ディレクトリをマウントしてください。 `connector.json`だけをマウントしないでください。複数のインストールで同じ状態ボリュームを同時に使用しないでください。

## 更新時に状態を保持する

インストールディレクトリにはバイナリが含まれます。データディレクトリには設定とIDが別途保存されます。

<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, or ~/.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` ボリューム）を保持してください。古いコンテナでは、IDが設定ファイル以外に保存されている場合があるため、コンテナを置き換える前に確認してください。
3. ネイティブインストーラーを再実行するか、検証済みの Windows リリースを展開するか、新しい不変の Docker バージョンを選択してください。永続状態を上書きしたり破棄したりしないでください。
4. コネクタを1つ起動し、カメラが同じコネクタの下に引き続き表示されることを確認してください。

古い Linux インストールでは、USB ソースに `usb:videoN`という名前が付けられています。アップグレードの前に、 `rfv-connector --list-usb` を実行し、古い名前と新しいIDを `usbSourceAliases` を使って設定内で対応付けてください。

コネクタを削除するには、停止してから、「Cloud Streaming」のコネクタページで「コネクタを削除」をクリックします。新しいコネクタとして始めたい場合にのみ、データディレクトリを削除してください。

## ネットワーク要件

コネクタは、Roboflow APIおよび割り当てられたメディア送信先に向けてアウトバウンド接続を確立します。カメラに向けてインターネットからのインバウンドポートを転送する必要はありません。コネクタを実行するマシンは、カメラのRTSPまたはONVIFサービスへのローカルアクセスに加えて、HTTPS APIアクセスだけでなくメディア送信用のアウトバウンドアクセスも必要です。

ネットワークカメラの映像は、TCPポート8554のRTSP経由で転送されます。USBカメラとファイルは、UDPまたはTCP経由のWebRTC（WHIP）で送信されます。ONVIFの検出にはローカルマルチキャストを使用するため、VLANを越えられない場合があります。

コネクタはオンラインなのにカメラまたは映像が表示されない場合は、 [トラブルシューティング](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/troubleshooting.md).
