> 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/enterprise/secure-gateway.md).

# Secure Gateway

Secure Gateway는 Roboflow 배포 서버에 필요한 라우트를 회사의 DMZ로 프록시하고, 모델 가중치와 컨테이너 이미지를 로컬에 캐시합니다.

Secure Gateway는 Roboflow Inference Server가 인터넷에 직접 연결되지 않도록 방화벽으로 차단할 때 Roboflow API와 모델 가중치를 위한 프록시입니다. 이는 [라이선스 서버](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/license-server.md) 의 후속 제품으로, 모델 가중치와 컨테이너 이미지를 로컬에 캐시하는 기능을 추가하여 여러 추론 서버가 하나의 제어된 외부 통신 지점을 공유할 수 있게 합니다.

{% hint style="info" %}
이 페이지에서는 필수 사항을 다룹니다. 전체 구성 및 운영 참조 자료는 [Secure Gateway 설명서](https://secure-gateway.roboflow.com/manual/).
{% endhint %}

## 사전 요구 사항

* Docker Engine 20.10 이상 또는 Kubernetes v1.24 이상
* api.roboflow\.com 및 repo.roboflow\.com에 액세스할 수 있는 호스트
* 사용 가능한 포트 80. TLS는 게이트웨이 앞의 로드 밸런서 또는 컨테이너 내부에서 종료되어야 합니다.
* 메모리 4GB 이상
* S3 버킷 또는 캐시용 로컬 디스크 50GB 이상

{% hint style="info" %}
Red Hat Enterprise Linux에 배포하시나요? [Podman을 사용하는 RHEL의 Secure Gateway](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/secure-gateway-podman.md) Docker나 Kubernetes가 없는 RHEL 호스트를 지원하며, [MicroShift의 Secure Gateway](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/secure-gateway-microshift.md) MicroShift를 실행하는 Red Hat Device Edge 호스트를 지원합니다. 두 솔루션 모두 동일한 에어갭 번들 모델을 사용하는 전용 설치 프로그램을 제공합니다.
{% endhint %}

## Secure Gateway 사용

다음 주소에 액세스할 수 있는 머신에서 `https://api.roboflow.com` 및 `https://repo.roboflow.com`, Secure Gateway 컨테이너를 가져옵니다:

```
docker pull repo.roboflow.com/roboflow-edge/secure-gateway:latest
```

해당 `latest` 태그는 가장 최근 릴리스를 가리킵니다. 프로덕션 환경, 특히 에어갭 배포에서는 업그레이드를 의도적이고 재현 가능하게 관리할 수 있도록 특정 버전을 고정하세요. 예를 들면 `repo.roboflow.com/roboflow-edge/secure-gateway:0.2.0`.

로컬 테스트용으로 로컬 디스크 캐시와 루프백 전용 HTTP 리스너를 사용하거나, 동일한 호스트에서 TLS 프록시를 사용해 실행하세요:

```
docker run -d --name secure-gateway -p 127.0.0.1:80:80 --restart unless-stopped \
    -v gateway-cache:/var/cache/secure-gateway \
    repo.roboflow.com/roboflow-edge/secure-gateway:latest
```

실행 중인지 확인합니다:

```
curl http://localhost/health
```

로컬 디스크 대신 S3에 캐시하려면 다음을 설정합니다: `CACHE_S3_BUCKET` 및 `CACHE_S3_REGION` 환경 변수. 인스턴스 역할 또는 IAM 역할을 사용하려면 자격 증명을 설정하지 않은 상태로 두세요.

## TLS 인증서

기본적으로 게이트웨이는 일반 HTTP를 수신하며, 게이트웨이 앞에 있는 로드 밸런서에서 TLS를 종료합니다. 게이트웨이 자체에서 HTTPS를 제공하려면 인증서와 개인 키를 컨테이너에 마운트하고 다음 두 항목을 모두 설정합니다: `TLS_CERT_FILE` 및 `TLS_KEY_FILE`. 그러면 게이트웨이는 구성된 포트에서 HTTPS를 제공합니다:

```
docker run -d --name secure-gateway -p 443:443 --restart unless-stopped \
    -e PORT=443 \
    -e TLS_CERT_FILE=/etc/ssl/certs/gateway.crt \
    -e TLS_KEY_FILE=/etc/ssl/private/gateway.key \
    -v /path/to/certs:/etc/ssl:ro \
    -v gateway-cache:/var/cache/secure-gateway \
    repo.roboflow.com/roboflow-edge/secure-gateway:latest
```

둘 다 `TLS_CERT_FILE` 및 `TLS_KEY_FILE` 은 인바운드 HTTPS를 활성화하는 데 필요하며, 각각 PEM 인코딩 파일을 가리킵니다.

게이트웨이의 아웃바운드 트래픽이 Zscaler와 같은 기업용 TLS 검사 프록시를 거치는 경우, `TLS_CA_BUNDLE` 을 해당 프록시의 CA 번들로 설정하면 게이트웨이가 api.roboflow\.com 및 repo.roboflow\.com에 대한 연결을 신뢰합니다.

```
-e TLS_CA_BUNDLE=/etc/ssl/certs/corporate-ca.pem
```

## 추론 서버 연결

각 Inference Server가 게이트웨이의 HTTPS 리스너 또는 TLS 프록시를 사용하도록 명시적인 `SECURE_GATEWAY` URL을 지정합니다. 서버는 해당 주소를 통해 Roboflow API 호출과 모델 다운로드를 처리합니다.

```bash
sudo docker run --rm -p 127.0.0.1:9001:9001 \
    --env SECURE_GATEWAY=https://gateway.example.com \
    roboflow/roboflow-inference-server-cpu:latest
```

443이 아닌 포트를 사용하는 경우 포트를 포함합니다. 예: `https://gateway.example.com:8443`. 인증서는 URL의 호스트 이름 또는 IP를 포함해야 하며, Inference Server 컨테이너는 인증서를 발급한 CA를 신뢰해야 합니다. 게이트웨이의 아웃바운드 `TLS_CA_BUNDLE` 을 설정해도 클라이언트에 신뢰할 CA가 설치되지는 않습니다.

해당 배포 환경을 사용하는 경우 [RHEL with Podman](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/secure-gateway-podman.md) 또는 [MicroShift](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/secure-gateway-microshift.md) 클라이언트 설치 안내를 따르세요.

### 레거시 주소 및 로컬 터널

버전에 관계없이 명시적인 HTTPS 스킴을 사용하세요. 현재 준비 중인 런타임 보안 강화 빌드에서는 스킴이 없는 주소가 HTTP에서 HTTPS로 전환되고, 원격 또는 LAN 게이트웨이에 대한 평문 연결이 거부됩니다. 자세한 내용은 [마이그레이션 범위](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security-migration.md#gateway-transport).

해당 빌드에서는 루프백 IP 또는 `localhost`에 대해서만 명시적인 HTTP를 허용합니다. 예: `SECURE_GATEWAY=http://127.0.0.1:8080`. 터널은 Inference Server 자체의 네트워크 네임스페이스에서 연결할 수 있어야 합니다. 브리지 컨테이너의 루프백은 호스트의 루프백과 다릅니다.

아웃바운드로 api.roboflow\.com 및 repo.roboflow\.com에 접근해야 하는 것은 게이트웨이뿐입니다. Inference Server가 시작된 후 모델을 실행하고 요청이 게이트웨이 액세스 로그에 표시되는지 확인하세요.

레거시 `LICENSE_SERVER` 변수는 여전히 `SECURE_GATEWAY`의 별칭으로 사용할 수 있으며, 전송 규칙도 동일합니다. 새 구성에는 `SECURE_GATEWAY` 을 사용하는 것이 좋습니다.

## 캐싱

Secure Gateway는 각 응답을 처음 다운로드할 때 캐시하며, 콘텐츠 변경 빈도에 따라 캐시 기간을 다르게 적용합니다. 콘텐츠 주소 지정 방식의 컨테이너 블롭과 모델 가중치는 가장 오래 보관하고, 변경될 수 있는 API 응답은 더 짧은 기간 동안 보관합니다. 이후 모든 Inference Server의 요청은 캐시에서 제공되므로 전체 서버군의 대역폭 사용량과 콜드 스타트가 줄어듭니다.
