HydroshieldMKII/Guardian

어떤 프로젝트인가요?

핵심 기능

• 01사용자별 예외 설정을 적용해 기기를 승인하거나 거부 또는 보류
• 02전체 및 사용자별 동시 스트림 한도
• 03IP 허용 목록, LAN/WAN 규칙 및 이용 시간 설정
• 04실시간 세션, 스트림 세부 정보 및 검색 가능한 기록
• 05이메일, Apprise 및 앱 내 알림
• 06기기를 확인하고 메모를 남길 수 있는 사용자 포털

활용 사례

• 가족 구성원이 스트리밍할 수 있는 시간과 장소를 제한하는 가정 관리자
• 공유 Plex 서버의 동시 스트림 수를 제한하는 홈랩 운영자
• 알 수 없는 기기나 홈 네트워크 외부에서의 접근 제한

빠른 시작

1. 1

   폴더를 만들고 해당 폴더로 이동합니다

   mkdir -p guardian && cd guardian
2. 2

   예제 Docker Compose 파일을 다운로드합니다

   curl -o docker-compose.yml https://raw.githubusercontent.com/HydroshieldMKII/Guardian/main/docker-compose.example.yml
3. 3

   Docker Compose로 Guardian을 시작한 다음 포트 3000에서 웹 UI를 엽니다

   docker compose up -d

사용 전 알아둘 점

• !연결 가능한 Plex Media Server와 Plex 토큰이 필요합니다.
• !PolyForm Noncommercial 1.0.0 라이선스에 따라 상업적 사용이 금지됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

Guardian은(는) 무엇인가요?

Plex Media Server의 접근 제어 계층으로, 기기를 승인하거나 차단하고 사용자별 이용 시간과 IP 규칙을 적용하며 스트림 수를 제한하고 규칙 위반 세션을 종료합니다. Guardian은 Plex Media Server와 함께 동작하며 세션 API를 주기적으로 조회합니다. 각 활성 스트림에 사용자별·기기별 정책을 적용하고, 규칙을 위반한 세션은 종료합니다.

Guardian은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Guardian은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Guardian은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Guardian의 마지막 커밋은 2026년 11월 3일입니다.

Guardian은(는) 어디에 사용할 수 있나요?

가족 구성원이 스트리밍할 수 있는 시간과 장소를 제한하는 가정 관리자 공유 Plex 서버의 동시 스트림 수를 제한하는 홈랩 운영자 알 수 없는 기기나 홈 네트워크 외부에서의 접근 제한

Guardian는 어떻게 설치하나요?

폴더를 만들고 해당 폴더로 이동합니다: mkdir -p guardian && cd guardian 예제 Docker Compose 파일을 다운로드합니다: curl -o docker-compose.yml https://raw.githubusercontent.com/HydroshieldMKII/Guardian/main/docker-compose.example.yml Docker Compose로 Guardian을 시작한 다음 포트 3000에서 웹 UI를 엽니다: docker compose up -d

Guardian은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/HydroshieldMKII/Guardian