> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/verkada-cameras/ko/video-streaming-and-sharing/live-streaming/local-streaming-on-verkada-cameras.md).

# Verkada 카메라의 로컬 스트리밍

로컬 스트리밍이 무엇이며 어떻게 작동하는지 알아보세요

로컬 스트리밍은 Verkada 카메라의 피드가 클라우드에서 접근되는 대신 접근하는 장치로 직접 전달되는 것을 의미합니다.

이 기능은 인터넷으로 송수신되는 트래픽의 양을 줄여 줍니다. 카메라의 스트림을 볼 때 카메라는 자동으로 로컬 스트림 모드로 전환을 시도합니다.

{% hint style="warning" %}
원격으로 카메라의 실시간 영상을 액세스할 때(로컬 스트리밍이 불가능한 경우), 비디오는 클라우드를 통해 프록시 처리되고 검색 및 재생 속도를 높이기 위해 캐시됩니다. 이 방식은 로컬 네트워크(LAN) 대역폭에 부정적인 영향을 주지 않으면서 많은 수의 동시 시청자를 지원합니다.
{% endhint %}

***

## 로컬 스트리밍 요구 사항

* 접근하는 장치는 카메라의 사설 IP에 도달할 수 있어야 합니다.
* 포트 4100의 TCP/UDP가 클라이언트와 카메라 사이에서 양방향으로 열려 있어야 합니다.
* 클라이언트와 카메라 사이에 프록시가 없어야 합니다.
* 참조 [카메라에 필요한 네트워크 설정](/command/ko/need-help/required-network-settings.md) 허용 목록에 있는 도메인용.

{% hint style="warning" %}
카메라가 H.265로 구성되어 있지만 최종 사용자가 지원되지 않는 H.265 브라우저 및/또는 장치를 사용하는 경우, 카메라는 SQ 로컬 스트림은 가능하지만 HQ 로컬 스트림은 불가능합니다. 자세한 내용은 [**카메라 고효율 비디오 인코딩(HEVC)**](/verkada-cameras/ko/video-streaming-and-sharing/live-streaming/camera-high-efficiency-video-encoding-hevc.md)**.**
{% endhint %}

***

### 장치가 로컬 스트리밍 중인지 확인하기

|                         |                                                                                                                                                                                                                                                                            |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **보기**                  | **예시**                                                                                                                                                                                                                                                                     |
| 웹 또는 모바일 브라우저에서의 로컬 스트림 | <img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-8d2f6f6578c80fa7ce2bb32a85ab4a1f5f8f7015%2F030d89e888717259b60f41845861c4b5a6f232bd.png?alt=media" alt="" data-size="original"> |
| Command 모바일 앱에서의 로컬 스트림 | ![](https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2F5AvC0Cw3xT2H8XVCN1u9%2FScreenshot%202026-04-23%20at%2010.25.37%E2%80%AFAM.png?alt=media\&token=303b3b3e-ab43-4291-b709-ebca0a7d1c8e)           |
| Command 모바일 앱에서의 원격 스트림 | ![](https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FGPKlafcsMW1qU8jiQ6sq%2FFile%20\(8\).jpg?alt=media\&token=2dea712b-aaa2-4523-b55e-eec0450d34c2)                                                 |

## 로컬 스트리밍의 작동 방식

{% stepper %}
{% step %}
**카메라의 도메인 이름 시스템(DNS)** [**기록이 등록되어 있어야 합니다**](#h_2fa97bf9bd)**.**
{% endstep %}

{% step %}
**Verkada Command는 스트리밍 장치가 다음을 설정하도록 시도하라고 지시합니다.** [**카메라와의 로컬 스트림**](#h_ffd43b346e)**.**
{% endstep %}

{% step %}
**스트리밍 장치는 다음을 요청합니다.** [**카메라의 DNS 기록**](#h_071100bc92)**.**
{% endstep %}

{% step %}
**스트리밍 장치는** [**카메라와 보안 연결을 설정합니다**](#h_a9ef69580b)**.**
{% endstep %}

{% step %}
**카메라의 피드가** [**스트리밍 장치로 직접 전송됩니다**](#h_97ccafdecb)**.**
{% endstep %}
{% endstepper %}

### 1단계: 카메라의 DNS 기록 등록

카메라가 Command에 연결되면 사설 IPv4 주소를 포함한 메타데이터를 공유합니다. Verkada는 이 데이터를 사용하여 카메라의 사설 IP 주소에 대한 공개형 A DNS 기록을 프로비저닝합니다. 이제 로컬 DNS 서버가 카메라의 정규화된 도메인 이름(FQDN)에 대한 요청을 확인할 수 있습니다. 이 DNS 기록은 로컬 스트리밍에 사용됩니다.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-41a4200782bf69b08e745541cea87e80a729beec%2Fa703aea1c9d82932c1f1c69641b0166b3b0f24c8.png?alt=media" alt=""></div>

### **카메라의 FQDN 가져오기**

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 카메라 > 카메라의 실시간 스트림으로 이동합니다.**
{% endstep %}

{% step %}
**아무 곳이나 마우스 오른쪽 버튼으로 클릭하고 검사(Inspect)를 클릭한 다음 네트워크 탭을 찾습니다.**
{% endstep %}

{% step %}
**결과 필터링 `ping` 을 클릭한 다음 페이지를 새로 고칩니다.**

ping 트래픽에는 보고 있는 카메라의 FQDN이 포함되어 있습니다.

{% embed url="<https://player.vimeo.com/video/691052916>" %}
카메라의 FQDN 가져오기
{% endembed %}
{% endstep %}
{% endstepper %}

### 2단계: 로컬 스트리밍으로 전환

카메라의 실시간 스트림에 액세스하면 스트리밍 장치는 로컬 스트리밍으로 전환하려고 시도합니다. 카메라의 사설 IP 주소에 장치에서 접근할 수 있고 필요한 도메인이 네트워크에서 허용되어 있으면, 스트리밍 장치는 카메라와 HTTPS 연결을 설정하여 실시간 피드를 직접 수신합니다.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-03feb0e8015d3256b1a183133b2cde23e1070608%2F7ef831bbd616c5d19d5a9c3333005d989d362356.png?alt=media" alt=""></div>

### 3단계: 스트리밍 장치가 카메라의 DNS 기록을 요청함

{% stepper %}
{% step %}
**카메라 피드에 액세스하면 Command는 스트리밍 장치가 카메라의 FQDN에 연결하도록 지시합니다.**
{% endstep %}

{% step %}
**접근하는 장치는 카메라의 FQDN에 대해 표준 DNS 요청(UDP 포트 53)을 보냅니다.**
{% endstep %}

{% step %}
**DNS는 FQDN을 확인하여 카메라의 사설 IP 주소를 접근하는 장치에 제공합니다.**

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-cff06b5cd790d0995bc1d4e0d59c3e9c14465dcd%2Fa28d1cec86da3289e811f357cf6ccfb30b01219e.png?alt=media" alt=""></div>
{% endstep %}

{% step %}
**장치는 포트 4100을 통해 HTTPS 세션을 설정하려고 시도합니다. 장치가 카메라의 사설 IP 주소에 도달할 수 없으면 이 과정은 여기서 종료되며 스트림은 로컬로 전환되지 않습니다.**

{% hint style="info" %}
카메라의 IP 주소는 다음에서 찾을 수 있습니다. [카메라 설정 페이지](/verkada-cameras/ko/configuration/view-and-edit-camera-settings.md).
{% endhint %}
{% endstep %}
{% endstepper %}

### 4단계: 스트리밍 장치가 카메라와 보안 연결을 설정함

카메라의 사설 IP 주소에 도달할 수 있으면 TCP 세션이 시작됩니다. SSL 핸드셰이크(TLS 1.2)가 발생하고 HTTPS 세션이 설정됩니다. 이를 통해 트래픽이 암호화되어 안전하게 유지됩니다. 이 연결을 통해 카메라의 SQ 실시간 피드에 액세스합니다.\
​​\
포트 4100에서 카메라의 사설 IP에 대한 TCP 핸드셰이크를 보여 주는 패킷 캡처:

<div align="left" data-with-frame="true"><figure><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FKUmvFkREfGlkZ0eZn26l%2FScreenshot%202026-04-23%20at%2010.32.09%E2%80%AFAM.png?alt=media&amp;token=b6c7da37-60c1-4d5a-8e0e-65c42de7ee52" alt=""><figcaption></figcaption></figure></div>

카메라가 제시한 공개 서명 인증서를 보여 주는 TLS 키 교환:

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-b57304f29034bc2d429258e689a66875f7d51960%2F78bd2c5d0cf907bee66f35b371739d5b8de55666.png?alt=media" alt=""></div>

### 5단계: 카메라의 피드가 스트리밍 장치로 직접 전송됨

보안 연결이 설정되면 카메라는 비디오를 클라이언트로 전송합니다:

<div data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-98b645c246fbd20cd57ff7e630652189acdb4766%2F5c1e84d6550ccaad9550a1fdac2c97a44b6040bf.png?alt=media" alt=""></div>

***

## 과거 재생

로컬 스트림을 통해 과거 영상을 볼 때는 [다중 카메라 재생 속도 제한이](/verkada-cameras/ko/video-streaming-and-sharing/view-historical-footage/add-cameras-to-a-multicamera-view.md#multi-camera-playback-speed-limits) 클라우드 스트리밍에서와 동일하게 적용됩니다. 다음을 참조하세요. [과거 영상 보기](/verkada-cameras/ko/video-streaming-and-sharing/view-historical-footage.md) 카메라 수에 따른 속도 제한은.

***

## 문제 해결

로컬 스트리밍에 문제가 있는 경우 다음을 시도해 보세요:

* 카메라가 온라인 상태이고 예상대로 스트리밍 중인지 확인합니다.
* 네트워크 구성을 확인합니다:
  * 스트리밍 장치가 동일한 로컬 네트워크에 있거나 카메라의 네트워크로 라우팅할 수 있습니다.
  * 포트 4100의 TCP/UDP가 스트리밍 장치와 카메라 사이에서 양방향으로 열려 있습니다.
  * 네트워크에 프록시가 없습니다.
* 스트리밍 장치를 확인합니다:
  * 최신 펌웨어 또는 소프트웨어 업데이트로 업데이트되어 있습니다.
  * 브라우저의 캐시와 쿠키를 지우거나 시크릿/비공개 브라우징 모드를 사용해 보세요.
  * 다른 장치에서 로컬 스트리밍을 테스트하여 문제가 특정 장치에만 해당하는지 확인합니다.
* 브라우저 설정에서 브라우저가 “로컬 네트워크 액세스”를 허용하는지 확인하세요. 브라우저는 기본적으로 로컬 네트워크 액세스를 차단할 수 있으며, 이로 인해 로컬 스트리밍이 되지 않을 수 있습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.verkada.com/verkada-cameras/ko/video-streaming-and-sharing/live-streaming/local-streaming-on-verkada-cameras.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.