> 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/video-configuration.md).

# 비디오 구성

관리형 비디오 워커의 제한을 설정하고 자체 호스팅 Inference에서 서버 측 비디오 소스를 구성합니다.

비디오 워커를 실행하는 셀프 호스팅 서버에서 워커를 구성합니다. 이러한 설정은 통합 스트림 관리자에 적용되며, 다음에는 적용되지 않습니다. [클라우드 스트리밍](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming.md), 더 이상 사용되지 않는 [서버리스 비디오 스트리밍 API](https://docs.roboflow.com/deployment/ko/roboflow-cloud/serverless-api/serverless-video-streaming-api.md)또는 로컬 Python InferencePipeline. 관리형 클라우드 처리에 대해서는 [클라우드 스트리밍 요금 및 제한](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/pricing-and-limits.md) 을 참조하세요.

버전별 적용 범위는 [보안 구성 마이그레이션](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security-migration.md#release-status) 을 참조하세요.

## 관리형 파이프라인 제한

`STREAM_MANAGER_MAX_ACTIVE_PIPELINES` 의 기본값은 `8` 이며, 사용 중이거나 유휴 상태인 워커를 포함한 전체 관리형 파이프라인 프로세스 수를 제한합니다. 실제 제한값은 구성된 값과 `STREAM_API_PRELOADED_PROCESSES`중 큰 값이므로, 사전 로드된 워커 수보다 낮아질 수 없습니다.

<table data-search="false"><thead><tr><th>변수</th><th>기본값</th><th>동작</th></tr></thead><tbody><tr><td>STREAM_MANAGER_MAX_ACTIVE_PIPELINES</td><td>8</td><td>관리형 파이프라인 프로세스 수를 제한하며, 필요한 경우 사전 로드된 수까지 제한값이 높아집니다.</td></tr><tr><td>STREAM_API_PRELOADED_PROCESSES</td><td>코어 라이브러리에서는 0이며, 이미지에서 재정의할 수 있습니다.</td><td>대기 상태로 준비된 워커의 목표 수를 설정합니다.</td></tr><tr><td>STREAM_MANAGER_MAX_RAM_MB</td><td>설정되지 않음</td><td>측정 및 추정 RAM 사용량을 기준으로 새 파이프라인 할당을 선택적으로 거부합니다.</td></tr></tbody></table>

프로세스 제한에 도달하면 관리자는 유휴 워커를 재사용할 수 있지만, 새 프로세스를 생성하지는 않습니다. 백그라운드 웜 풀에도 같은 제한이 적용됩니다. 목표 유휴 워커 수에 도달하지 않았더라도 사용 중인 워커는 슬롯 하나를 차지합니다.

### 용량 설정

서버를 시작할 때 환경 파일을 통해 용량 설정을 전달합니다.

```dotenv
STREAM_MANAGER_MAX_ACTIVE_PIPELINES=16
STREAM_API_PRELOADED_PROCESSES=2
```

```bash
inference server start --env-file inference.env
```

모델과 하드웨어에 맞는 양수 제한값을 선택하고, 제한값을 높이기 전에 사용하지 않는 파이프라인을 종료하세요. 이는 프로세스 제한이지, 사용자별 할당량이나 요청 속도 제한 또는 RAM·GPU 메모리에 대한 엄격한 제한이 아닙니다.

## 서버 측 비디오 참조

이 섹션의 규칙은 [마이그레이션 가이드](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security-migration.md#video-source-validation)에 설명된 런타임 강화 빌드가 적용될 때 유효합니다. 표준 스트림 관리자 및 엔터프라이즈 스트림 요청 스키마는 제공된 미디어 참조를 비디오 백엔드에 전달하기 전에 검증합니다.

지원되는 입력은 다음과 같습니다.

* 다음과 같은 정수 카메라 인덱스: `0`, 다음과 같은 숫자 CSI 참조: `csi://0`.
* 다음과 같은 절대 경로 또는 명시적 상대 경로: `/video.mp4`, `./video.mp4`, `../video.mp4`또는 Windows 드라이브 경로.
* 다음 스킴을 사용하는 인코딩된 URL: `http`, `https`, `rtsp`, `rtsps`, `rtspt`, `rtspst`, `rtmp`, `rtmps`, `udp`, `srt`, `rtp`, `tcp` 또는 `file`.
* 요청 스키마에서 허용하는 경우 지원되는 참조의 목록.

선택한 이미지에는 해당 전송 방식에 맞는 디코더가 있어야 하며, 서버 컨테이너에서 경로를 읽을 수 있어야 합니다. 이 검증은 카메라의 네트워크 대상 주소를 제한하지 않습니다. 이미지 URL 제어에는 별도의 정책이 적용됩니다.

### 기존 참조 업데이트

파일  `video.mp4` 를 다음과 같이 작성하세요:  `./video.mp4`. URL의 공백과 따옴표는 인코딩하고, 다음 문자가 포함된 로컬 경로의 이름은 바꾸세요:  `!`, `=` 또는 따옴표. 지원되지 않는 스킴과 원시 GStreamer 설명은 기본적으로 거부됩니다.

### 원시 GStreamer 파이프라인 사용

원시 실행 구문이 필요한 신뢰할 수 있는 워크로드에서는 다음과 같이 설정하세요:

```dotenv
ALLOW_UNSAFE_GSTREAMER_PIPELINES=True
```

이 설정은 미디어 참조 검증을 우회하고, 설치된 플러그인의 기능을 포함하여 원시 파이프라인 해석을 복원합니다. 지원되는 RTSP 및 RTMP URL에는 이 설정이 필요하지 않으며, 이 설정으로 누락된 GStreamer 플러그인이 설치되지는 않습니다.

### 클라이언트 측 비디오 소스

이 검사는 서버의 스트림 요청 스키마로 전송되는 참조에 적용됩니다. SDK의  `VideoFileSource` 에서 로컬로 여는 파일의 이름을 바꾸거나 Python에서 로컬 미디어를 직접 사용하는 방식을 변경하지는 않습니다.

비디오를 여는 위치를 선택하려면  [Workflows를 사용한 비디오 처리](https://docs.roboflow.com/workflows/deploy/video-processing) 를, 파이프라인을 관리할 수 있는 사용자를 알아보려면  [서버 보안](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security.md) 을 참조하세요.
