HTTPS로 추론 제공

자체 호스팅 Roboflow 추론 서버를 자체 TLS 인증서, 사용자 지정 인증서 경로, 암호화된 키, 상호 TLS를 사용해 HTTPS로 제공합니다.

직접 제공한 TLS 인증서와 개인 키를 사용하면 Inference 서버가 HTTPS를 직접 제공할 수 있습니다. 이는 컨테이너 앞에 TLS 종료 리버스 프록시를 둘 수 없는 자체 호스팅 배포에 유용합니다.

HTTPS는 전적으로 환경 변수로 구성됩니다.

환경 변수

변수	설명	기본값
ENABLE_HTTPS	주요 스위치. 다음으로 설정 True, 1, 또는 예 HTTPS를 활성화하려면.	False
SSL_CERTFILE	PEM 인코딩된 인증서의 컨테이너 내부 경로.	/etc/inference/certs/server.crt
SSL_KEYFILE	PEM 인코딩된 개인 키의 컨테이너 내부 경로.	/etc/inference/certs/server.key
SSL_KEYFILE_PASSWORD	암호화된 개인 키의 암호 구문.	설정되지 않음
SSL_CA_CERTS	클라이언트 인증서(mTLS)를 검증하는 데 사용되는 CA 번들.	설정되지 않음

인증서와 키 경로의 기본값은 /etc/inference/certs/..., 따라서 가장 간단한 배포에서는 해당 경로에 인증서와 키를 마운트하고 다음을 설정하기만 하면 됩니다 ENABLE_HTTPS=true.

만약 ENABLE_HTTPS 설정되어 있지만 인증서 또는 키가 없으면, 서버는 읽으려 했던 경로를 나열하는 오류와 함께 시작을 거부합니다.

자가 서명 인증서로 빠르게 시작하기

아래 예시는 CPU 이미지를 다음에서 실행합니다 https://localhost:9001 자가 서명 인증서를 사용합니다. 프로덕션에서는 인증서 생성 단계를 자체 CA가 발급한 인증서로 바꾸세요.

# 1. localhost에서 유효한 자가 서명 인증서/키 쌍을 생성
mkdir -p /tmp/inference-certs
openssl req -x509 -newkey rsa:2048 -nodes \
  -keyout /tmp/inference-certs/server.key \
  -out /tmp/inference-certs/server.crt \
  -days 365 \
  -subj "/CN=localhost" \
  -addext "subjectAltName=DNS:localhost,IP:127.0.0.1"

# 2. HTTPS를 활성화한 상태로 추론 서버 실행
docker run --rm -p 9001:9001 \
  -e ENABLE_HTTPS=true \
  -v /tmp/inference-certs:/etc/inference/certs:ro \
  roboflow/roboflow-inference-server-cpu:latest

# 3. 다른 셸에서 확인
curl -sk https://localhost:9001/info

-k (또는 --insecure)는 인증서가 자가 서명되어 있기 때문에 필요한 것이며, CA를 신뢰하는 클라이언트는 필요하지 않습니다.

사용자 지정 인증서 경로

인증서가 기본 위치가 아닌 다른 곳에 있다면 경로를 명시적으로 설정하세요:

docker run --rm -p 9001:9001 \
  -e ENABLE_HTTPS=true \
  -e SSL_CERTFILE=/run/secrets/tls/fullchain.pem \
  -e SSL_KEYFILE=/run/secrets/tls/privkey.pem \
  -v /etc/letsencrypt/live/inference.example.com:/run/secrets/tls:ro \
  roboflow/roboflow-inference-server-cpu:latest

암호화된 개인 키

키 파일이 암호화되어 있으면, 다음을 통해 암호 구문을 제공하세요 SSL_KEYFILE_PASSWORD. 값을 이미지에 하드코딩하기보다 Docker secrets 또는 다른 비밀 저장소를 사용하세요.

상호 TLS(클라이언트 인증서)

설정 SSL_CA_CERTS 클라이언트 인증서를 검증하는 데 사용될 CA 번들로. 나열된 CA 중 하나가 서명한 인증서를 제시한 클라이언트만 허용됩니다.

TLS는 다음에서 다루는 다섯 가지 제어 항목 중 하나입니다 자가 호스팅 서버 보안 설정; 서버를 localhost 밖으로 노출하기 전에 나머지도 검토하세요.