> 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.md).

# 자체 호스팅 서버 보안

기본적으로 자체 호스팅 Inference를 로컬로 유지하고, 누가 워크플로를 실행할 수 있는지 선택하며, 모델, 미디어, 전송 제어를 구성합니다.

자체 호스팅 추론은 로컬 개발을 제한 없이 사용할 수 있도록 합니다. 사용자 지정 Python은 기본적으로 로컬에서 실행되며, 인증을 설정하지 않는 한 서버에 API 키가 필요하지 않습니다. CLI는 기본적으로 서버를 다음 주소에 공개합니다. `127.0.0.1` 아래 예외를 제외하면 외부에서 공개된 포트에 접근할 수 없습니다.

업그레이드 동작과 버전 범위는 다음을 참조하세요. [보안 구성 마이그레이션](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security-migration.md).

## 네트워크 액세스 제한

Workflow 기능의 사용 가능 범위를 변경하기 전에 클라이언트가 서버에 접속하는 방식을 선택하세요.

<table data-search="false"><thead><tr><th>실행 방식</th><th>기본 네트워크 액세스</th><th>구성</th></tr></thead><tbody><tr><td>CPU 또는 GPU 호스트에서 Inference CLI 사용</td><td>호스트 루프백, 127.0.0.1:9001</td><td>--bind-address 또는 -b를 사용하여 다른 호스트 주소를 선택합니다.</td></tr><tr><td>Jetson 이미지에서 Inference CLI 사용</td><td>모든 호스트 인터페이스, 0.0.0.0:9001</td><td>로컬 전용 액세스에는 --bind-address 127.0.0.1을 사용합니다.</td></tr><tr><td>macOS 및 Windows 데스크톱 번들</td><td>127.0.0.1</td><td>다른 인터페이스를 선택하려면 HOST를 명시적으로 설정합니다.</td></tr><tr><td>수동 Docker 또는 Compose 구성</td><td>포트 매핑에 따라 결정</td><td>로컬 전용 액세스에는 127.0.0.1:9001:9001을 사용합니다.</td></tr><tr><td>--tunnel을 사용한 Inference CLI</td><td>터널이 연결될 수 있도록 CLI가 0.0.0.0에서 포트를 공개합니다.</td><td>LAN 및 터널 액세스를 모두 검토하세요.</td></tr></tbody></table>

### CLI로 서버 시작

`inference server start` 포트 9001을 다음 주소에 공개합니다. `127.0.0.1`따라서 이런 방식으로 시작한 서버는 서버를 시작한 컴퓨터의 프로세스에만 응답합니다. 이는 로컬 개발에 적합한 기본 설정이며, 이 페이지의 제한이 느슨한 기본값을 안전하게 사용할 수 있는 유일한 구성입니다. CLI는 루프백이 아닌 주소에서 포트를 공개하면 경고합니다.

```bash
# 기본값: 이 컴퓨터에서만 접근 가능
inference server start

# 의도적인 LAN 액세스: 이 호스트에 라우팅할 수 있는 모든 컴퓨터에서 접근 가능 - 먼저 보안을 설정하세요
inference server start --bind-address 0.0.0.0 --env-file inference.env
```

{% hint style="warning" %}
**NVIDIA Jetson은 예외입니다.** Jetson 이미지는 대개 다른 컴퓨터에서 제어하는 헤드리스 엣지 장치이므로, `inference server start` 다음 주소에 공개합니다. `0.0.0.0` - 장치에 라우팅할 수 있는 모든 곳에서 접근 가능하며, 장치가 연결된 Wi-Fi 네트워크의 다른 기기도 포함됩니다. 아래 제어 기능을 적용하거나 다음 명령으로 접근을 제한하세요. `inference server start --bind-address 127.0.0.1`.
{% endhint %}

### 다음 명령으로 서버 시작 `docker run`

이미지에서 이 설정을 대신 선택할 수 없으므로, **명령줄에서 직접 설정해야 합니다.**. `HOST` 인터페이스를 선택합니다. *컨테이너* 내부에서 말입니다. 컨테이너에는 자체 네트워크 네임스페이스가 있습니다. 따라서 `HOST=127.0.0.1` 를 설정한 이미지는 컨테이너 자체의 루프백에 바인딩됩니다. 공개된 포트에서는 여기에 접근할 수 없으므로 호스트에서조차 서버에 연결할 수 없습니다. 이 때문에 모든 이미지는 `HOST=0.0.0.0`로 제공됩니다. 브리지 네트워크를 사용하는 컨테이너에서는 이 설정을 그대로 유지하고, 대신 호스트 측 포트 매핑에서 액세스를 제한하세요.

```bash
# 이 컴퓨터에서만 접근 가능
docker run --rm -p 127.0.0.1:9001:9001 roboflow/roboflow-inference-server-cpu:latest

# 이 호스트로 라우팅할 수 있는 모든 머신에서 접근 가능 - 먼저 보안을 설정하세요
docker run --rm -p 9001:9001 roboflow/roboflow-inference-server-cpu:latest
```

두 경우는 서로 다르게 동작합니다.

* **`--network host`** (Linux)는 포트 매핑을 완전히 제거하므로 컨테이너가 호스트 인터페이스에 직접 바인딩됩니다. 이 경우에는 `-e HOST=127.0.0.1` *가* 서버를 로컬에서만 사용할 수 있게 하는 방법입니다.
* **Kubernetes는** 각 Pod에 자체 네트워크 네임스페이스를 제공하므로, `HOST=0.0.0.0` 를 유지하고 바인드 주소가 아니라 Service 유형과 NetworkPolicy로 노출 범위를 제어하세요.

{% hint style="warning" %}
**`-p 9001:9001` 는 모든 인터페이스를 의미합니다.** 주소를 명시하지 않으면 Docker는 `0.0.0.0`를 포함해 호스트가 가진 모든 공인 IP에서 포트를 게시합니다. Linux에서는 대부분의 기본 설정에서 Docker 자체의 포워딩 규칙이 `ufw`/`firewalld` 규칙보다 먼저 평가되므로, 별도로 설정한 호스트 방화벽이 이를 차단하지 못할 수 있습니다. 실제로 어떤 프로세스가 수신 대기 중인지 확인하려면 `docker port <container>` 또는 `ss -tlnp | grep 9001`.
{% endhint %}

{% hint style="info" %}
Python 서버를 직접 실행하거나 호스트 네트워킹을 사용하거나 Docker 포트를 수동으로 게시하는 경우에는 각각 별도의 네트워크 구성이 필요합니다. CLI 기본값은 이러한 경로를 제한하지 않습니다.
{% endhint %}

루프백 이외의 주소에 바인딩하면 신뢰할 수 없는 클라이언트가 서버에 접근할 수 있습니다. 이 페이지에서 설명하는 기본 설정은 그러한 사용을 전제로 하지 않습니다. 먼저 [원격 클라이언트를 허용하기 전에](#before-allowing-remote-clients) 의 안내를 확인하세요.

## 인증 적용

추론, Workflow 및 통합 `WORKSPACES_WHITELISTED_FOR_LOCAL_DEPLOYMENT` 를 허용된 Workspace 슬러그로 설정하면 API 키를 요구할 수 있습니다. `/inference_pipelines/*` 요청에 대해 클라이언트는 키를 다음 위치에 전달할 수 있습니다. `Authorization: Bearer YOUR_API_KEY`, `api_key` 쿼리 매개변수 또는 지원되는 JSON 요청 본문에 키를 전달하면 서버가 Roboflow API를 통해 Workspace 소속 여부를 확인합니다.

예를 들어 CLI에 전달할 `inference.env` 파일에 다음 내용을 넣으세요.

```dotenv
WORKSPACES_WHITELISTED_FOR_LOCAL_DEPLOYMENT=your-workspace-url-slug
```

다른 ID 시스템을 사용하거나 Roboflow API에 연결하지 않고 인증해야 하는 경우, 서버 앞에 인증 프록시를 두고 클라이언트가 프록시를 우회하지 못하도록 하세요.

### 상태 확인 및 관측성

Workspace 확인을 사용하면 다음 경로에 계속 접근할 수 있습니다. `/`, `/docs`, `/redoc`, `/info`, `/healthz`, `/readiness`, `/metrics`, `/openapi.json`, 정적 에셋 및 선택적으로 활성화할 수 있는 `/secure-gateway/health` 엔드포인트는 API 키 없이 사용할 수 있습니다. 이를 통해 상태 확인과 [텔레메트리](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/telemetry.md)를 유지할 수 있습니다. 출력에 민감한 정보가 포함될 수 있으므로 네트워크 접근을 제한하세요. TLS 클라이언트 인증서 요구 사항을 활성화한 경우 이 엔드포인트에도 계속 적용됩니다.

## 신뢰할 수 있는 호출자가 커스텀 Python을 사용할 수 있도록 유지

`ALLOW_CUSTOM_PYTHON_EXECUTION_IN_WORKFLOWS=True` 와 `WORKFLOWS_CUSTOM_PYTHON_EXECUTION_MODE=local` 이 기본값으로 유지되므로, 로컬 사용자는 별도 설정 없이 커스텀 Python을 실행할 수 있습니다. 이 코드는 서버 프로세스의 권한으로 실행됩니다. 인증은 코드를 제출할 수 있는 사용자를 제한하지만, 인증된 호출자를 샌드박스에 격리하지는 않습니다. Workspace 인증 없이 로컬 커스텀 Python이 활성화된 경우 서버는 보안 알림을 로그에 기록합니다.

### 필요하지 않을 때는 로컬 실행 비활성화

다음을 설정하세요. `ALLOW_CUSTOM_PYTHON_EXECUTION_IN_WORKFLOWS=False` 로컬 커스텀 Python 실행을 거부합니다. Modal 실행은 별도의 모드이며 이 플래그로 비활성화되지 않습니다. 자세한 내용은 [커스텀 블록](https://docs.roboflow.com/workflows/blocks/blocks/custom-blocks) 및 [오프라인 마이그레이션 안내](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security-migration.md#offline-custom-python).

## 모델 접근 보호

[모델 패키지 보안](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/model-security.md) 에서는 Workspace 인증, 모델별 권한 부여, 실행 가능한 패키지를 로드할 권한을 구분합니다. 특히 온라인 모델별 권한 부여는 로컬 패키지 직접 로드와 함께 사용할 수 없습니다. 파일 시스템 경로에는 권한을 확인할 Roboflow 모델 ID가 없기 때문입니다.

## 비디오 워크로드 구성

[비디오 구성](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/video-configuration.md) 에서는 관리형 파이프라인 프로세스 한도, 웜 워커, 서버 측 미디어 참조를 다룹니다. 프로세스 한도는 리소스 사용량을 제한하지만, 호출자를 인증하거나 호출자의 코드를 격리하지는 않습니다.

## 네트워크 전송 보호

서버 또는 인증된 TLS 프록시에서 [HTTPS](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/https.md) 를 사용해 호스트 외부로 오가는 트래픽을 보호하세요. 아웃바운드 [Secure Gateway](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/secure-gateway.md#connecting-inference-servers) 연결에는 별도의 TLS 구성이 적용되며, 이는 서버의 수신 주소 설정과 다릅니다.

## 이미지 가져오기 제한

호출자가 제공한 이미지 URL을 이용하면 서버가 내부 서비스나 메타데이터 엔드포인트에 접속할 수 있습니다. [지원되는 입력 형식](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/input-formats.md#sending-urls-to-inference-images) 에서는 애플리케이션에 필요한 형식은 유지하면서 URL 입력을 비활성화하고, 대상 주소를 제한하고, 리디렉션을 검증하는 방법을 설명합니다. 이러한 이미지 가져오기 제어는 다른 Workflow 통합이나 비디오 전송에 대한 네트워크 제한을 대체하지 않습니다.

## Webhook Sink 대상 제한

Webhook Sink는 Workflow 데이터를 사설 네트워크의 서비스로 전송할 수 있습니다. 기존 팩토리 및 LAN 웹훅이 계속 작동하도록 Self-hosted Inference는 기본적으로 이러한 대상을 허용합니다.

호출자가 대상을 임의로 선택해도 신뢰할 수 없는 경우 `ALLOW_WEBHOOK_WORKFLOWS_SINK_TO_NON_GLOBAL_ADDRESSES=False` 로 설정하세요. 그러면 루프백, 사설, 링크 로컬(클라우드 메타데이터 포함), CGNAT, 예약 및 멀티캐스트 주소가 거부됩니다. 웹훅 요청은 호스트 이름을 한 번 확인한 후 검증된 주소에 연결합니다. 두 설정 모두에서 리디렉션과 HTTP(S) 프록시는 거부됩니다.

## 원격 클라이언트를 허용하기 전에

루프백 이외의 주소에 바인딩하면 신뢰할 수 없는 클라이언트가 서버에 접근할 수 있습니다. 이 페이지의 완화된 기본 설정은 그런 환경을 위한 것이 아닙니다. 포트를 외부에 공개하기 전에 최소한 다음을 수행하세요.

* 바인드 주소를 신중하게 선택하세요. `inference server start` 다음 옵션 없이 실행하거나 `--bind-address`또는 `-p 127.0.0.1:9001:9001` 다음 명령과 함께 사용하세요. `docker run`단, 원격 클라이언트가 필요한 경우는 예외입니다.
* 알려진 클라이언트로만 접근을 제한하세요. 프라이빗 네트워크나 VPC를 사용하고 공용 IP 대신 VPN, SSH 터널 또는 서비스 메시를 통해 서버에 접속하세요. 또한 호스트 및 클라우드 방화벽이나 보안 그룹을 사용하여 포트 `9001` 에 필요한 특정 클라이언트만 접근하도록 허용하세요.
* Workspace 인증 또는 프록시에서 자체 인증을 활성화하세요. 인증이 없으면 포트 `9001` 에 접근할 수 있는 사람은 누구나 사용자의 하드웨어에서 Roboflow 계정 할당량을 사용하여 모델과 Workflow를 실행할 수 있습니다.
* 신뢰할 수 없는 네트워크를 통과하는 트래픽에 TLS를 구성하세요.
* 서버 권한을 부여해도 신뢰할 수 있는 호출자만 Custom Python 및 실행 가능한 모델 패키지를 사용할 수 있도록 제한하세요. 접근 가능한 서버에서 로컬 Custom Python을 활성화된 상태로 두면 Workflow를 보낼 수 있는 누구나 원격으로 코드를 실행할 수 있습니다.
* URL 이미지 입력을 비활성화하거나, 다음 문서에 설명된 대로 대상 허용 목록과 리디렉션 검증을 적용하여 보안을 강화하세요: [허용되는 입력 형식](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/input-formats.md#sending-urls-to-inference-images).
* 다음과 같이 설정하세요: `ALLOW_WEBHOOK_WORKFLOWS_SINK_TO_NON_GLOBAL_ADDRESSES=False` 단, 호출자가 신뢰할 수 있는 프라이빗 또는 로컬 서비스에 웹훅을 보내야 하는 경우는 예외입니다.
* 서버를 더 넓은 범위에 노출해야 한다면 서버 앞에 역방향 프록시(nginx, Traefik, Caddy 또는 클라우드 로드 밸런서)를 배치하세요. 그러면 TLS, 속도 제한, 접근 로깅을 한곳에서 추가할 수 있습니다.
* 상태 확인과 메트릭 수집기가 계속 연결할 수 있는지 확인하세요.

인증과 TLS를 적용하지 않은 상태로 추론 포트를 공용 인터넷에 직접 노출하지 마세요.

재시도, 용량 및 모니터링에 대해서는 [프로덕션 준비 체크리스트](https://docs.roboflow.com/deployment/ko/production-checklist.md) 를 활용하세요.
