设备管理
CASTOVIA 如何将物理设备连接到订阅——无需了解机型、无需固件更新，只需一个 MAC 地址。
支持的设备类型
MAG 机顶盒
MAG 250、254、322、324、420、424 等。
Formuler 机顶盒
Z8 Pro、Z10 Pro、Z11 Pro、GTV 等。
Android TV / STB
任何带有 IPTV 应用的 Android TV 盒子
Enigma2 / Linux STB
Dreambox、VU+ 及类似设备
MAC 匹配如何工作
整个流程非常简单。没有登录界面、没有凭据、没有盒子上的配置文件。具体如下：
读取 MAC 地址
每个机顶盒在出厂时都会在硬件中烧录一个唯一的 MAC 地址。你可以在设备底部或背面的贴纸上找到它（格式：00:1A:79:xx:xx:xx）。
MAC 地址是永久性的，无法更改。它可唯一标识这台特定的物理设备。
在管理后台注册
在 管理后台 → 设备 中，点击“添加设备”并输入 MAC 地址。将其分配给某条订阅线路（subscription）。你只需要这些——无需设备机型、无需固件版本、无需任何技术细节。
你也可以通过 CSV 批量导入 MAC，适用于大规模部署。
在盒子上设置 Portal URL
在盒子本身上，只需配置一项设置：Portal URL。输入你的域名（例如：http://tv.yourdomain.com）。这是盒子唯一需要的配置——一直如此。
许多运营商会在出货前预先为盒子配置好这一项，因此最终用户无需任何设置。
盒子自动连接
当盒子启动时，它会向 Portal URL 发送一个 HTTP 请求，并在请求中包含它的 MAC 地址。CASTOVIA 在数据库中查找该 MAC，找到匹配的订阅，然后提供频道列表、EPG 数据和 VOD 目录。
盒子并不知道自己的配置。它只是报告自己的 MAC，服务器负责匹配。
订阅用户观看电视
最终用户会看到他们的频道、EPG 指南和 VOD 库——并带有你的品牌标识。他们不会知道 CASTOVIA 在幕后存在。这是你的品牌，你的服务。
连接流程
盒子开机
读取其 MAC
连接 Portal URL
在请求中发送 MAC
服务器查询
查找匹配的订阅
提供内容
频道、EPG、VOD
为什么基于 MAC > 用户名/密码
像 XUI.ONE 这样的传统面板使用用户名/密码认证。以下是 MAC 管理对 STB 设备更优的原因：
无账号共享
一个 MAC = 一台物理设备。MAC 地址不像用户名/密码那样可以共享。
即时更换设备
订阅用户的盒子坏了？在面板中输入新盒子的 MAC，旧盒子会立即停用。10 秒完成。
终端用户零设置
订阅用户插上盒子、连接 WiFi——就这么简单。没有登录界面，也不用记密码。
自动停用
从面板中移除某个 MAC → 该盒子将无法再连接。无需远程擦除，也无需复杂的取消配置。
也支持用户名/密码
CASTOVIA 也支持传统的用户名/密码线路，适用于基于应用的订阅用户（Android、iOS、网页播放器）。基于 MAC 的管理专门用于 STB/MAG 类型设备，其中硬件身份取代了凭据。