HydroshieldMKII/Guardian

这是什么？

核心功能

• 01对设备进行批准、拒绝或暂挂，并可按用户覆盖
• 02支持全局及按用户的并发流数量限制
• 03提供 IP 白名单、局域网/广域网规则和时间计划
• 04实时查看会话与流详情，历史记录可搜索
• 05支持邮件、Apprise 和应用内通知
• 06为 Plex 用户提供门户，可查看设备并添加备注

适用场景

• 家庭管理员限制家人观看的时间段和地点
• 家庭实验室运维者限制共享 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 打开网页界面

   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 打开网页界面: docker compose up -d

在哪里获取 Guardian？

源代码和安装说明在 GitHub 上：https://github.com/HydroshieldMKII/Guardian