> 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에서 서버 측 비디오 소스를 구성합니다.

비디오 워커를 실행하는 서버에서 비디오 워커를 구성합니다. 이 설정은 통합 스트림 관리자를 대상으로 하며, 관리형 Serverless Video Streaming API나 로컬 Python InferencePipeline의 제한을 설정하지 않습니다.

참조 [보안 구성 마이그레이션](/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 메모리 제한도 아닙니다.

## 서버 측 비디오 참조

이 섹션의 규칙은 다음의 보류 중인 런타임 강화 빌드에 적용됩니다: [마이그레이션 가이드](/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은 이 opt-in이 필요하지 않으며, 누락된 GStreamer 플러그인을 설치하지는 않습니다.

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

이러한 검사는 서버의 스트림 요청 스키마로 전송되는 참조에 적용됩니다. SDK로 로컬에서 연 파일의 이름을 바꾸지는 않으며 `VideoFileSource` 직접적인 로컬 Python 미디어 사용도 변경하지 않습니다.

참조 [Workflows를 사용한 비디오 처리](https://docs.roboflow.com/workflows/deploy/video-processing) 비디오를 열 위치를 선택하는 데 대한 [서버 보안](/deployment/ko/self-hosted/inference-server/configuration/security.md) 파이프라인을 관리할 수 있는 주체에 대한