> 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/security-migration.md). # 보안 구성 마이그레이션 릴리스 범위를 확인하고 localhost 바인딩, 모델 인증, 비디오 제한, 런타임 강화에 대한 자체 호스팅 Inference 설정을 업데이트합니다. 이 가이드는 자체 호스팅 Inference Server, CLI 또는 이미지를 업그레이드할 때 사용합니다. 네트워크 노출 변경과 명시적 기능 opt-in이 필요한 변경을 구분합니다. ## 릴리스 상태 이 문서는 2026년 9월 11일 기준으로 원본과 대조되었습니다. 원본에 병합되었다고 해서 변경 사항이 어느 게시된 패키지나 이미지에 포함되는지는 알 수 없습니다.
변경원본 상태릴리스 범위
로컬호스트 게시 및 데스크톱 바인딩, PR #2943병합됨설치된 CLI와 데스크톱 번들을 확인하세요. 최초 릴리스 버전은 여기서 검증되지 않았습니다.
관리형 파이프라인 프로세스 상한 및 RAM 가드, PR #2944병합됨변경 사항이 포함된 서버 이미지를 필요로 합니다. 최초 릴리스 버전은 여기서 검증되지 않았습니다.
로컬 모델 권한 가드, PR #2956병합됨변경 사항이 포함된 서버 빌드를 필요로 합니다. 최초 릴리스 버전은 여기서 검증되지 않았습니다.
모델, 미디어, TLS, 게이트웨이, 오프라인 실행 및 OPC UA 강화, PR #2952보류 중, 커밋 54a663f1d에서 검토됨릴리스된 이미지에 대한 주장이 아닙니다. 아래 섹션은 제안된 런타임 강화 빌드를 설명합니다.
배포하는 패키지와 이미지 버전을 고정한 다음, 해당 버전에 관련 변경 사항이 포함되어 있는지 확인하세요. 기존 컨테이너는 원본이나 이미지 기본값이 변경된다고 해서 이러한 변경 사항을 자동으로 얻지 않습니다. ## 로컬호스트 게시 CLI는 다음에 게시합니다 `127.0.0.1` 일반 CPU 및 GPU 실행 시 모든 호스트 인터페이스 대신. 원격 클라이언트는 다음과 같은 명시적으로 노출된 주소를 사용해야 합니다 `inference server start --bind-address 0.0.0.0`, 접근은 신뢰할 수 있는 클라이언트로 제한됩니다. Jetson CLI 실행은 다음을 유지합니다 `0.0.0.0`, 그리고 `--tunnel` 또한 다음에 게시합니다 `0.0.0.0` 그래서 터널이 연결할 수 있습니다. 데스크톱 번들은 기본값이 다음입니다 `127.0.0.1` 이며 다음을 준수합니다 `HOST`; 수동 Docker 매핑은 계속 운영자의 선택입니다. ### 기능 및 관찰 가능성 기본값 로컬 실행과 함께 사용자 정의 Python은 기본적으로 계속 활성화되어 있습니다. 2026년 6월 19일 기본값 전환에 대한 이전 공지는 더 이상 적용되지 않습니다. Stream API 활성화와 Workspace 인증은 기존 동작을 유지하며, 새 스트림 관리 토큰은 없습니다. 건강 상태, 문서 및 메트릭 엔드포인트는 기존 API 키 예외를 유지합니다. 다음을 참조하세요 [서버 보안](/deployment/ko/self-hosted/inference-server/configuration/security.md) 네트워크 경계와 엔드포인트 목록에 대해. ## 파이프라인 용량 새 프로세스 할당은 다음에서 중지됩니다 `STREAM_MANAGER_MAX_ACTIVE_PIPELINES`, 기본값 `8`, 유효 상한은 미리 로드 수보다 높으면 그 수까지 올려집니다. 기존 유휴 워커는 여전히 상한에서 할당될 수 있으며, 웜 풀 보충은 이를 초과할 수 없습니다. 더 많은 워커가 필요한 배포는 용량을 확인한 후 더 높은 상한을 선택해야 합니다. RAM 가드는 초기화 중 실패하는 대신 샘플이 없는 워커도 처리합니다. 다음을 참조하세요 [비디오 구성](/deployment/ko/self-hosted/inference-server/configuration/video-configuration.md#managed-pipeline-limits). ## 로컬 모델 권한 부여 온라인 서버는 다음을 거부합니다 `MODELS_CACHE_AUTH_ENABLED=True` 다음과 결합된 `ALLOW_INFERENCE_MODELS_DIRECTLY_ACCESS_LOCAL_PACKAGES=True`. 모델별 API 키 검사가 필요하면 로컬 로드를 비활성화하고, 로컬 패키지 호출자를 의도적으로 신뢰하는 경우에만 모델 권한 부여를 비활성화하세요. 오프라인 배포는 명시적인 `ALLOW_OFFLINE_MODEL_CACHE_AUTH_BYPASS` 요구 사항을 유지합니다. 다음을 참조하세요 [모델 패키지 보안](/deployment/ko/self-hosted/inference-server/configuration/model-security.md). ## 비디오 소스 검증 보류 중인 런타임 강화 빌드에서는 원시 GStreamer 설명이 기본적으로 거부되며, 다음과 같은 단순 파일 이름은 `video.mp4` 다음이 되어야 합니다 `./video.mp4`참조 `ALLOW_UNSAFE_GSTREAMER_PIPELINES=True` 원시 파이프라인 해석이 필요하고 신뢰되는 워크로드에서만. 다음 [지원되는 참조 형식](/deployment/ko/self-hosted/inference-server/configuration/video-configuration.md#server-side-video-references) 에는 해당 opt-in 없이 일반 RTSP 및 RTMP URL이 포함됩니다. 직접 로컬 Python 미디어 사용과 SDK 클라이언트에서 연 파일은 변경되지 않습니다. ## 모델 패키지 신뢰 보류 중인 런타임 강화 빌드에서 JetPack 5.1.1, 6.2.0 및 7.2.0 이미지는 다음을 전환합니다 `ALLOW_INFERENCE_MODELS_UNTRUSTED_PACKAGES` 에서 `True` 를 `False`해당 `inference-models-speed` 벤치마크도 CLI, 어댑터 및 Python 헬퍼 기본값을 신뢰할 수 없는 패키지를 거부하도록 전환합니다. 이미지 설정 또는 벤치마크의 `--allow-untrusted-packages` 플래그로 명시적으로 opt-in하세요. 실행 파일 패키지를 신뢰하는 경우에만 사용하세요. 다음을 참조하세요 [모델 패키지 보안](/deployment/ko/self-hosted/inference-server/configuration/model-security.md#package-trust-defaults); 직접 로컬 패키지 액세스는 별도의 설정입니다. 이전에 게시된 JetPack 6.0 이미지는 이 변경 사항으로 업데이트되지 않으며, 검토된 소스에는 더 이상 해당 Dockerfile이 없습니다. 해당 배포를 별도로 파악하세요. ## TLS 클라이언트 인증서 보류 중인 런타임 강화 빌드에서는 Python Uvicorn, 셸 Uvicorn 및 병렬 Gunicorn 실행기가 둘 다 `ENABLE_HTTPS=True` 와 `SSL_CA_CERTS` 구성된 경우 유효한 클라이언트 인증서를 요구합니다. 업그레이드하기 전에 애플리케이션 및 상태 또는 메트릭 확인에 대한 클라이언트 인증서를 준비하세요. 클라이언트 CA 없는 HTTPS는 서버 전용 TLS를 유지하며, HTTPS가 비활성화되면 HTTP가 기본값입니다. 다음을 참조하세요 [HTTPS로 Inference 제공](/deployment/ko/self-hosted/inference-server/configuration/https.md#mutual-tls). ### 암호화된 키 병렬 Gunicorn 실행기는 다음을 거부합니다 `SSL_KEYFILE_PASSWORD` 해당 옵션을 지원하지 않기 때문입니다. 암호화된 키에는 Uvicorn 실행기를 사용하세요. Python 및 셸 Uvicorn 모두 암호를 지원합니다. ## 게이트웨이 전송 보류 중인 런타임 강화 빌드에서는 단순한 `SECURE_GATEWAY=host:port` 은 HTTP에서 HTTPS로 전환되며 마이그레이션 경고를 표시합니다. 업그레이드하기 전에 명시적인 `https://` URL을 사용하고 게이트웨이 인증서 신뢰를 구성하세요. 평문 HTTP는 명시적으로 구성된 루프백 IP 또는 다음에만 허용됩니다 `localhost`, 예를 들어 `http://127.0.0.1:8080`; 원격 및 LAN 게이트웨이는 HTTPS를 제공해야 합니다. 지원되지 않는 스킴, 포함된 자격 증명, 쿼리, 조각, 공백은 Inference와 별도로 설치된 `inference-models` 패키지 모두에서 구성 가져오기에 실패합니다. 루프백 터널은 서버 자체 네트워크 네임스페이스에서 도달 가능해야 합니다. 다음을 따르세요 [Inference Server 연결](/deployment/ko/self-hosted/enterprise/secure-gateway.md#connecting-inference-servers) 게이트웨이 설정을 위해, 레거시 `LICENSE_SERVER` 별칭을 포함하여. ## 오프라인 사용자 정의 Python 보류 중인 런타임 강화 빌드에서는, `OFFLINE_MODE=True` 와 함께 `WORKFLOWS_CUSTOM_PYTHON_EXECUTION_MODE=modal` 는 코드를 로컬에서 조용히 실행하는 대신 시작에 실패합니다. 신뢰할 수 있는 코드에 대해 로컬 실행을 허용하려면 명시적으로 `로컬` 를 선택하거나 Modal에 대한 온라인 연결을 유지하세요. 실행 모드는 다음을 허용합니다 `로컬` 와 `modal`, 대소문자와 주변 공백은 무시하며 알 수 없는 값은 시작에 실패합니다. 이는 일반적인 로컬 사용자 정의 Python을 비활성화하지 않습니다. ## OPC UA 자격 증명 보류 중인 런타임 강화 빌드에서는 풀링된 OPC UA 세션이 엔드포인트, 사용자 이름 및 비밀번호별로 격리됩니다. 잘못되었거나 비어 있거나 생략된 비밀번호가 있는 요청은 다른 비밀번호로 인증된 세션을 재사용할 수 없으며, 자격 증명 회전은 별도의 연결을 만듭니다. 워크플로 작성자는 동일한 자격 증명 필드를 계속 사용합니다. 연결 관리자에 직접 호출하는 통합은 원래 비밀번호를 다음에 전달해야 합니다 `release_connection` 와 `invalidate_connection`, 포함하여 명시적인 `None` 익명 세션에 대해. ## 기타 수정 사항 보류 중인 런타임 강화 빌드는 메모리 내 큐가 가득 찼을 때 사용량 수집기 정지를 수정합니다. 사용량 수집을 비활성화하거나 모니터링 opt-in을 변경하지 않습니다. CI 셸 입력 검증 및 검토 도구 설치 변경에는 배포 구성 변경이 필요하지 않습니다.