首页
Xtream UIPro

帮助中心

常见问答

点数、套餐、线路、播放链接和设备如何运作,以及无法播放时该检查什么。

共 139 个问题,显示 139 个

无法播放? 大多数问题可通过“故障排查”中的检查清单解决,请从那里开始。 打开故障排查

如何使用本页

每个问题都有固定编号(例如LINE-07)。联系支持时请引用该编号,或复制该问题的链接。

菜单、按钮和字段名称与面板中显示的一致。用户是登录面板的账户(管理员、分销商);线路是观众的 IPTV 订阅。两者绝不混用。

  • 观众 分销商可以将此解答原样转发给观众
  • 管理员 适用于面板运营者

服务概述与职责划分

GEN
GEN-01 这项服务提供什么?

一套完整的 OTT / IPTV 系统:管理面板(dashboard)、供观众应用使用的 API 服务器、直播频道、电影、剧集和广播的分发,以及网页播放器。我们提供并维护系统;分销商使用它为客户提供观看权限(线路)。

#GEN-01
GEN-02 这项服务不做什么?
  • 不替您收款,也没有支付网关。向客户收取的价格、收款方式和开具发票由分销商自行负责(参见CON-01)。
  • 不联系分销商的观众。面板只向面板账户发送邮件,从不向线路发送。
  • 不保留已删除客户的个人数据,也没有恢复功能(参见DATA-01)。
#GEN-02
GEN-03 系统中各角色是谁?
角色是谁在哪里登录
管理员面板运营者dashboard
分销商销售线路;从管理员处获得点数dashboard、Reseller API
下级分销商在另一位分销商之下创建的分销商dashboard、Reseller API
线路订阅者,即最终观众IPTV 应用、机顶盒、网页播放器。绝不是 dashboard
#GEN-03
GEN-04 频道如何一步步送到观众面前?
  1. 管理员建立内容目录(频道、电影、剧集、广播),并将其分组为频道包(bouquet)。
  2. 管理员创建套餐:频道包 + 时长 + 连接数 + 以点数计的价格。
  3. 分销商花费点数出售套餐 → 系统创建一条线路。
  4. 客户在应用中输入线路信息;系统检查该线路(未过期、已启用、在限制范围内),并从合适的服务器播放。
#GEN-04
GEN-05 分销商对内容能做什么,不能做什么?

分销商可以查看频道、电影、剧集、广播、频道包和套餐的列表(前提是其分组有此权限),但不能添加、编辑或删除内容。内容和套餐由管理员管理。分销商通过选择套餐(以及在分组允许时选择频道包 —PKG-05)来决定每位客户可以观看什么。

#GEN-05
GEN-06 在哪里获得支持?

侧边栏的Support入口会打开独立的支持网站。面板本身没有工单系统。发送请求时请附上:线路的用户名(切勿附密码)、发生时间、应用 / 设备,以及(如果已尝试过)本页的问题编号。

#GEN-06
GEN-07 界面有哪些语言?

面板、网页播放器和本帮助页都有语言切换器,支持 27 种语言。英语和越南语是基准翻译;在其他语言中,新增的界面可能暂时保持英文。面板发送的邮件目前仅有英文。

#GEN-07

面板账户与登录

ACC
ACC-01 为什么我的客户不能登录 dashboard?

这是有意设计:线路不是面板账户。客户只在 IPTV 应用、机顶盒或网页播放器中使用线路信息。反过来,分销商账户也不能用来观看频道。

#ACC-01
ACC-02 我看到的菜单比本页描述的少,为什么?

菜单和操作取决于管理员给您的账户分配的分组。您的分组没有权限的页面不会显示在侧边栏中,也无法打开。请向管理员申请更多权限。

#ACC-02
ACC-03 在哪里修改我的面板密码?

在账户区域(个人资料 → 修改密码)。面板密码以哈希形式存储,任何人都无法读回 — 包括管理员。如果忘记,请让您的上级账户(上级分销商或管理员)设置新密码。

#ACC-03
ACC-04 为什么更换网络后我被退出登录?

面板可配置为在 IP 地址变化时结束会话,以免被盗的会话被重复使用。请重新登录。这是管理员的设置。

#ACC-04
ACC-05 多次输入错误的登录信息后会怎样?

面板会限制登录失败次数(由管理员配置)。超过限制后需要等待一段时间才能再次尝试。

#ACC-05
ACC-06 演示账户与真实账户有何不同?

演示账户只能查看界面:不能修改密码、编辑个人资料、创建激活码,也不能执行任何无法撤销的操作。

#ACC-06
ACC-07 我的账户显示“已禁用”。这是什么意思?

您的上级账户将其关闭:您无法登录面板,您的 API 密钥也会被拒绝。已售出的线路不会被删除。请联系您的上级账户。

#ACC-07
ACC-08 在哪里查看我和下级分销商做过的操作?

Logs → Reseller Logs(当分组可查看日志时):每条线路或设备的创建、编辑、续期、启用 / 禁用或删除,每个下级分销商的创建,以及每次点数转账 — 并附带扣除的点数。您只能看到自己及您之下账户的记录;日志无法删除(仅管理员可以)。点数账本(CRD)仍是核对余额的依据。

#ACC-08

点数

CRD
CRD-01 什么是点数?

面板的预付单位。每次销售(创建线路、续期、创建激活码、创建下级分销商)都会按套餐价格或分组费用扣除点数。点数不是钱,面板也不做换算:一个点数值多少,由您与上级账户约定。

#CRD-01
CRD-02 如何充值点数?

点数自上而下流转:管理员向分销商发放点数,分销商向下级分销商转账。向上级账户付款在面板之外进行。

#CRD-02
CRD-03 扣的是谁的点数?

始终是执行该操作的账户的点数,即使线路分配给了下方的下级分销商。

#CRD-03
CRD-04 在哪里查看我的点数记录?

Credits页面:每次变动一行,含日期、金额、变动后的余额、原因和操作人。这是账本 — 您余额的权威来源。

#CRD-04
CRD-05 点数不足会怎样?

整个操作会被拒绝:不会创建线路,也不会扣除任何点数。余额绝不会变为负数。

#CRD-05
CRD-06 如果我点了两次保存或网络中断,会被重复扣费吗?

不会。每个销售请求都带有请求 ID(request_id);再次发送相同的 ID 会返回之前的结果。创建线路和扣除点数总是一起成功或一起取消。

#CRD-06
CRD-07 删除线路后会退还点数吗?

不会。删除线路不退还任何点数,即使还有剩余时间。唯一的例外:删除分销商创建的未使用的激活码会退还(CODE-08)。

#CRD-07
CRD-08 可以收回我转给下级分销商的点数吗?

可以:在下级分销商的编辑表单中,于点数转账字段输入负数。任何余额都不能低于 0。

#CRD-08
CRD-09 如何提前知道我能购买多少条线路?

线路表单的套餐选择器会显示您自己的价格。通过 API,pricing操作会返回您的余额、每个套餐的价格以及您能负担的数量。

#CRD-09

套餐、频道包与价格

PKG
PKG-01 频道包和套餐有什么区别?

频道包(bouquet)是内容列表(频道、电影、剧集)。套餐是您出售的产品:一个或多个频道包、时长、连接数、输出格式、锁定,以及以点数计的价格(正式价格和试用价格)。

#PKG-01
PKG-02 为什么我看不到某个套餐?

套餐只能由管理员为其选定的分组出售。不面向您分组的套餐不会出现在选择器中,通过 API 发送时也会被拒绝。

#PKG-02
PKG-03 我的价格与套餐价格不同,为什么?

管理员可以为每个分销商的每个套餐设置专属价格(0 = 免费)。专属价格适用于创建正式线路、续期和正式激活码;不适用于试用。

#PKG-03
PKG-04 管理员更改套餐的频道包后,已售出的线路也会随之改变吗?

不会。频道包在销售时被复制到线路中;之后编辑套餐不会影响已售出的线路。线路会在下一次续期 / 更换套餐时获得套餐的新频道包。(当频道包内部的内容变化时,持有该频道包的所有线路会立即看到。删除频道包会从所有线路和套餐中移除其 ID。更改全局频道包顺序时,只有勾选“apply to sold lines and packages”选项,才会改变已售线路上保存的顺序;线路的频道包集合不会改变。)

#PKG-04
PKG-05 可以只出售套餐的一部分吗?

仅当您的分组开启了Allow Bouquet Selection时:您勾选套餐中的部分频道包;什么都不勾 = 整个套餐;套餐之外的频道包会被丢弃。价格不变。

#PKG-05
PKG-06 线路的哪些属性由套餐决定?

到期日期(今天 + 套餐时长)、连接数、输出格式、restreamer、设备锁定、强制国家、强制服务器、ISP 锁定、频道包。分销商为这些字段输入的值会被忽略,但频道包(PKG-05)以及分组开启了Allow Line Restrictions时的 ISP 锁定除外。

#PKG-06
PKG-07 什么是“仅 MAG”/“仅 Enigma”套餐?

只能出售给该类机顶盒的套餐;不能出售给普通线路或另一种设备类型。反过来,套餐必须允许该设备类型,才能用于 Add MAG / Add Enigma 表单。

#PKG-07

线路:创建、编辑、续期、删除

LINE
LINE-01 创建线路需要什么?

您必须选择分组可出售的套餐,并且有足够的点数。用户名 / 密码:自己输入(分组允许时)或留空由系统生成。管理员创建线路时也可以将其中之一(或两者)留空:系统会生成 10 个字符并在保存后立即显示;而编辑表单仍需要用户名。

#LINE-01
LINE-02 为什么我不能自己选择用户名 / 密码?

您的分组关闭了Allow Username Change/Allow Password Change:新线路会使用生成的值。当您可以自己输入时,最小长度由分组设定(默认 8 个字符)。

#LINE-02
LINE-03 在哪里可以再次查看线路的密码?

在线路的编辑表单中,以及 Lines 列表的Generate play link对话框中。线路密码以可读形式保存,因为 IPTV 应用和播放列表链接需要它。生成的密码会在保存后立即显示。

#LINE-03
LINE-04 一条旧线路不显示密码,客户无法登录?

一些由早期版本面板创建的线路只保存了哈希密码。这样的线路无法登录,面板也不显示其密码。请在线路的编辑表单中设置新密码并发送给客户。

#LINE-04
LINE-05 销售之后分销商可以编辑线路的哪些内容?

启用 / 禁用、分销商备注、联系方式、分类模板、所有者(限于您自己的层级内);分组允许时可改用户名和密码;分组开启Allow Line Restrictions时可改限制(IP、user agent、ISP 锁定);分组允许时可在套餐范围内重新选择频道包。套餐、到期日期、连接数、试用标记、输出格式、设备锁定和国家不能直接编辑 — 它们只会通过续期 / 更换套餐改变。

#LINE-05
LINE-06 如何为线路续期?

两种方式,同一规则:

  • 列表中的Renew (charged)按钮:使用线路当前的套餐;
  • 编辑表单的Extend with package字段:选择您可出售的任意套餐(这也是更换套餐的方式)。

当您编辑线路并在同一次保存中选择续期时,两者是一个事务:如果续期被拒绝(点数不足、套餐不可出售),编辑也不会保存,也不会扣除点数。修正后再次保存即可。

#LINE-06
LINE-07 续期时会保留剩余时间吗?
  • 线路未过期且新套餐与旧套餐兼容→ 时间加到当前到期日期上。
  • 线路已过期,或两个套餐不兼容 → 从今天开始计算;剩余时间不保留。

仅当新套餐开启了兼容性检查选项时才会检查“兼容”:两个套餐必须具有相同的频道包、输出格式、连接数、restreamer 标记和设备锁定。选项关闭时始终视为兼容。新套餐默认开启该选项(管理员可以关闭);现有套餐保持其设置。MAG / Enigma 线路只能用允许该类机顶盒的套餐续期或更换。

#LINE-07
LINE-08 更换套餐(升级 / 降级)如何计费?

更换套餐 = 购买新套餐的一个正式周期:按新套餐的全价扣费(若有专属价格则用专属价格),未使用的部分不折算点数。线路会采用新套餐的所有属性。

#LINE-08
LINE-09 禁用和删除线路有什么区别?

禁用:客户无法登录或观看,正在进行的会话在约一分钟内关闭;订阅期继续计算;您可以随时重新启用。删除:永久,无法恢复,不退款(DATA-01)。对于暂停使用的客户,请禁用 — 不要删除。

#LINE-09
LINE-10 线路状态是什么意思?
状态含义谁可以解除
Active可用—
Disabled被分销商 / 所有者关闭分销商
Banned被管理员锁定仅管理员
Expired已超过到期日期续期
Trial试用线路,试用期结束前可用续期后成为正式线路
#LINE-10
LINE-11 线路到期后会怎样?

在线路续期之前客户会被拒绝(同时过期和被封禁的线路会看到“已过期”片段,因为先检查过期);正在进行的会话在约一分钟内关闭。线路不会自动删除:续期后它会以相同的用户名 / 密码重新工作。

#LINE-11
LINE-12 可以把线路交给下级分销商吗?

可以:选择您之下的账户作为所有者。所有者会在自己的列表中看到该线路。点数仍然由点击保存的人承担。

#LINE-12
LINE-13 我能看到谁的线路?

您自己的线路以及您之下每个账户的线路。您层级之外的线路对您来说不存在(返回“未找到”)。

#LINE-13
LINE-14 “Contact”和“Reseller notes”字段有什么用?

供您记住客户是谁(邮箱、电话号码、订单号)。订阅者永远看不到它们。删除线路时它们会被永久清除。

#LINE-14
LINE-15 我能看到线路正在观看什么、来自哪里吗?

当分组拥有权限时:Logs → Line Activity显示每条线路的观看历史,Logs → Live Connections显示您层级内线路的所有打开的连接(哪条线路、哪个频道、来自哪个地址),并带有关闭连接的按钮。仅当管理员为您的分组开启了查看客户连接历史的选项(分组表单中的client connection logs选项)时,Live Connections 才会打开;您永远看不到层级之外线路的连接。

#LINE-15
LINE-16 为什么 Lines 列表不显示激活码的线路?

属于激活码的线路默认从列表中隐藏,直到您对其进行筛选(CODE-02)。

#LINE-16
LINE-17 线路表单的到期日期包含时间吗? 管理员

包含。线路表单的Expires on字段是面板时区下的日期和时间,因此线路可以在特定的小时到期。打开表单后不改动此字段直接保存,会精确到秒保持到期时间 — 编辑备注或频道包不会给按小时计的试用线路额外时间。无法解析的值会在字段处直接报错,绝不会变成“永不过期”。批量编辑页面仍然只接受日期,按当天结束时间处理。

#LINE-17

试用

TRI
TRI-01 什么时候可以创建试用线路?

当以下条件全部满足时:管理员没有对分销商关闭试用;套餐有试用期;您的分组Allowed Trials> 0;您的点数 ≥ 分组的Minimum Trial Credits;并且您在统计窗口内创建的试用线路数量未达到配额。

#TRI-01
TRI-02 试用配额按什么时间窗口统计?

按分组设置:day= 最近 24 小时,month= 最近 30 天。例如配额为 5 / day:任意 24 小时内最多 5 条试用线路。较早的试用离开窗口后会释放其名额。

#TRI-02
TRI-03 试用会消耗点数吗?

恰好是套餐的试用价格(通常为 0)。分销商的专属价格不适用于试用。

#TRI-03
TRI-04 为什么试用选项被锁定?

TRI-01的某个条件未满足;表单会在该选项旁边说明原因。

#TRI-04
TRI-05 如何将试用线路转为正式线路?

用套餐为线路续期:线路获得正式周期,不再是试用。用户名和密码保持不变,客户无需重新设置。

#TRI-05
TRI-06 可以给现有线路再一次试用期吗?

不可以。试用只在创建线路时授予一次;现有线路只能用正式周期续期(TRI-05)。若要让客户再次试用,请创建新的试用线路(它计入试用配额)。

#TRI-06

播放链接、应用与格式

PLAY
PLAY-01 在哪里获取给客户的链接?

Lines → Generate play link:选择格式;链接由线路的用户名和密码生成。通过 API,get_line会直接返回现成的链接:m3u、m3u_hls、xmltv、player_api、web_player。

#PLAY-01
PLAY-02 客户可以使用哪些应用? 观众

任何支持Xtream Codes API的应用(IPTV Smarters、TiviMate、XCIPTV、GSE…):输入服务器地址 + 用户名 + 密码。只接受播放列表的应用请使用M3U链接。MAG机顶盒使用 portal,Enigma2机顶盒使用播放列表 / 插件。没有任何设备时,可在浏览器中使用网页播放器。

#PLAY-02
PLAY-03 MPEG-TS 还是 HLS?

MPEG-TS:换台快,适合 IPTV 应用和机顶盒。HLS:在浏览器、苹果设备和不稳定的网络上表现良好。线路只能使用其套餐允许的格式;不允许格式的链接会被拒绝。

#PLAY-03
PLAY-04 有哪些播放列表类型?

m3u_plus(含台标、分组、EPG ID — 推荐的默认选项)、普通m3u、适用于 Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive 的类型,以及简单列表类型。在 Generate play link 对话框中选择。

#PLAY-04
PLAY-05 节目指南(EPG)从哪里来? 观众

Xtream 应用会自行获取。对于 M3U 应用,请使用线路的XMLTV链接(m3u_plus播放列表已包含 EPG 地址)。

#PLAY-05
PLAY-06 有回看(catch-up)吗? 观众

有,在管理员开启了存档的频道上;应用会在这些频道上显示回看图标。

#PLAY-06
PLAY-07 网页播放器在哪里,如何登录? 观众

在 API 服务器的/player/(即web_player链接)。使用线路的用户名 / 密码或激活码登录。

#PLAY-07
PLAY-08 更改线路密码后,旧链接还能用吗?

不能。密码是链接的一部分,并保存在应用中;更改密码后客户必须重新输入 / 获取新链接。这也是您切断未经许可使用线路者的方法。

#PLAY-08
PLAY-09 可以为播放链接使用我自己的域名吗?

可以:在 API 密钥页面设置Your own play address(或使用set_play_baseAPI 操作)。您需要将域名的 DNS 指向面板的 API 服务器,并且运营者也要配置他们这边;使用前请告知管理员。该地址适用于 API 返回给您系统的链接。

#PLAY-09
PLAY-10 可以把一个链接给多个人吗?

从技术上讲,他们共用一条线路,因此共用其连接数(SEC-01),并可能触发第二 IP 规则(SEC-03)。每位客户都应该有自己的线路。

#PLAY-10

MAG / Enigma2 机顶盒

DEV
DEV-01 如何添加 MAG / Enigma 机顶盒?

Devices → Add MAG / Add Enigma:输入 MAC,选择套餐。系统一步完成出售新线路并绑定设备;设备通过其 MAC 登录,无需任何人输入用户名 / 密码。点数的扣除方式与普通线路完全相同。

#DEV-01
DEV-02 客户已有线路,想再加一台机顶盒?

在设备表单中,选择客户的现有线路而不是套餐:设备会与该线路配对,免费。客户继续在应用中使用该线路;机顶盒跟随线路的套餐、到期、频道包和状态。

#DEV-02
DEV-03 配对的应用和机顶盒如何计算连接数?

它们共用连接数限制:应用和机顶盒是同一个订阅者。

#DEV-03
DEV-04 如何为机顶盒续期?

为其线路续期(设备表单上有链接)。对于配对的设备,为客户的线路续期即可 — 机顶盒会自动跟随。

#DEV-04
DEV-05 客户把机顶盒换成了新的?

在设备上编辑 MAC。如果线路开启了设备锁定,请清除已记录的序列号 / 设备 ID,以便新机顶盒可以注册。

#DEV-05
DEV-06 删除设备会删除线路吗?

会。与旧面板一样,删除设备也会删除其线路(包括连接历史和待处理事件)。若要保留已付费的线路,请使用Convert to line按钮:设备被移除,线路变为普通线路。当您删除客户的线路时,配对的设备会带着其自己的线路继续独立存在。

#DEV-06
DEV-07 分销商可以远程控制机顶盒吗?

对自己的MAG机顶盒可以:向电视发送消息、播放频道、重新加载 portal、重启、关闭线路的连接(分组需要有查看客户连接日志的权限)、重置已记录的 ISP 以及重置 STB 锁定。Enigma机顶盒的 X-Plugin 命令和截图、封禁设备以及将设备移到另一条线路仅限管理员。启用 / 禁用分销商的设备会启用 / 禁用其线路;分销商不能解除设备的Banned状态。

#DEV-07

激活码

CODE
CODE-01 激活码有什么用?

以代码形式出售观看权限(刮刮卡、通过消息发送的代码):客户在应用或网页播放器中输入代码即可观看,无需用户名 / 密码。周期仅在客户首次激活代码时才开始计算。

#CODE-01
CODE-02 如何创建激活码,费用是多少?

Active Codes → New:选择套餐、数量(每批 1–500)、代码长度(6–24)、仅数字选项(用电视遥控器容易输入)、试用选项。点数在创建时扣除 = 套餐价格 × 代码数量。每个代码都配有一条自己的线路,在激活前处于锁定状态。

#CODE-02
CODE-03 代码包含哪些字符?

大写字母和数字,不含容易混淆的字符(0、O、1、I);或仅数字。客户输入小写仍会被接受。

#CODE-03
CODE-04 一个代码可以在多少台设备上使用? 观众

一台。代码与第一台激活它的设备绑定;另一台设备输入同一代码会被拒绝。该设备可以随意多次输入该代码,线路的登录信息不会改变。

#CODE-04
CODE-05 客户更换设备怎么办?

对该代码执行Reset device;新设备随后即可激活。不会增加周期的时间。

#CODE-05
CODE-06 客户输入代码时出现错误。这是什么意思? 观众
消息含义处理方法
INVALID_CODE代码错误 / 代码不存在检查每个字符;不要输入短横线
DEVICE_MISMATCH代码已与另一台设备绑定分销商重置设备(CODE-05)
DISABLED代码已被关闭分销商重新启用
EXPIRED周期已结束购买新代码 / 续期

连续输入多个不同的错误代码,会导致该 IP 地址被封锁一段时间(SEC-08)。

#CODE-06
CODE-07 如何为已激活的代码延期?

在Active Codes页面勾选该代码,选择Extend (days)操作并输入天数。只有已激活的代码才能增加天数(未使用的代码周期尚未开始);仍然有效的代码从当前到期日期开始延长,已过期的从现在开始。此操作不扣除点数。通过 API:extend_active_code。

#CODE-07
CODE-08 删除代码后会退还点数吗?

分销商创建的未使用代码:全额退还,并在点数账本中记录一行。已激活的代码:不退款。

#CODE-08
CODE-09 如何一次管理大量代码?

Batches页面显示每个批次的总数 / 就绪 / 已激活 / 已禁用,并可导出 TXT 文件(每行一个代码)。批量操作:启用、禁用、重置设备、删除。

#CODE-09
CODE-10 激活码的线路遵循套餐的限制吗?

遵循,与使用该套餐售出的每条线路一样:连接数、输出格式、频道包、设备锁定、restreamer,以及套餐的强制国家(SEC-07)。客户在允许列表之外的国家激活代码时,可以激活,但播放时会被拒绝。

#CODE-10

连接数限制与保护线路的锁定

SEC
SEC-01 “Max connections”如何计算?

它是同一条线路同时观看的设备数量。0 = 不限。在同一设备上再次打开您已在观看的频道,不算另一个连接。

#SEC-01
SEC-02 超过限制时谁会被断开? 观众

默认情况下:新连接进入,最旧的连接被关闭(优先选择来自同一设备的连接,其次是来自同一 IP 的)。被关闭的播放器在大约 30 秒内停止。管理员可以改为拒绝新连接,而不是关闭旧连接。

#SEC-02
SEC-03 什么是“第二 IP”规则?

管理员开启后:当一条线路正从某个 IP 观看时,来自另一个 IP 的直播连接会被拒绝。该规则可以限定于连接数较少的线路(例如 1 个连接的线路;连接数不限的线路仅在阈值为 0 时才受限)。开启Match The Address By Network后,同一 /24 网段(IPv6:/64)的地址视为一位观众。这是防止账号共享的工具。

#SEC-03
SEC-04 可以将线路限制在特定 IP 或应用吗?

当分组开启Allow Line Restrictions时:Allowed IPs字段(IP、CIDR 范围或域名,每行一个;域名在连接时解析,所以动态 IP 也可用)和Allowed User-Agents。留空 = 全部允许。注意:这些限制在播放时拦截;应用仍然可以登录并显示频道列表。

#SEC-04
SEC-05 什么是 ISP 锁定?

线路会记住其首次连接的网络运营商,并拒绝来自其他运营商的使用。客户更换运营商时,请先关闭再重新开启 ISP 锁定以记录新的运营商。不适用于 MAG 机顶盒。

#SEC-05
SEC-06 什么是设备锁定?

它将线路绑定到第一台登录的机顶盒(序列号、设备 ID);其他机顶盒会被拒绝。由套餐决定。

#SEC-06
SEC-07 国家限制如何运作?

线路只能从其强制国家连接(ALL= 任何地方)。为空时,适用面板的通用允许国家列表。出国旅行或使用 VPN 的客户可能因此被拒绝。

#SEC-07
SEC-08 为什么某个 IP 地址被封锁? 观众
  • 自动:同一 IP 在短时间内用许多不同的用户名 / 激活码登录失败,或发送大量请求。自动封锁会在管理员配置的时间后自行解除(默认 60 分钟)。
  • 手动:管理员封锁了该 IP / IP 范围;不会过期。

IP 被封锁期间,没有任何线路可以从该 IP 连接。反复输错同一个用户名不会导致封锁。

#SEC-08
SEC-09 连接还可能因哪些其他原因被阻止?

管理员可以按User-Agent(应用)、网络运营商(ISP)和ASN(例如托管 / VPN 地址段)进行封锁。管理员为其开启了“bypass UA”的线路会跳过应用封锁列表。

#SEC-09
SEC-10 什么是 restreamer?

为拉取流并转发的合作伙伴准备的线路。它不受连接数限制、第二 IP 规则、长会话自动结束和 ASN 封锁的约束。由套餐 / 管理员决定;不适用于普通观众。

#SEC-10
SEC-11 持续时间很长的会话会被切断吗? 观众

管理员可以设置持续会话的最长时长;超过后会话被关闭,客户按播放键即可继续。信号中断约 90 秒的会话也视为已关闭。

#SEC-11
SEC-12 如何发现被共享或被盗用的线路?
  • Theft Detection页面(当分组有权限时):按 1 小时 / 24 小时 / 7 天内观看的不同电影 / 剧集数量对线路排名,并显示不同 IP 的数量 — 异常偏高的线路值得怀疑。
  • 线路的活动页面:显示正在使用的 IP 和设备。
  • 处理方法:更改线路密码(PLAY-08)、开启 IP 限制 / ISP 锁定,或禁用线路。
#SEC-12

下级分销商

SUB
SUB-01 我可以创建下级分销商吗?

当您的分组开启了Can Create Sub-Resellers,且Groups for sub-resellers中至少有一个分组时。每次创建都会扣除分组设定的创建费用(点数)。分销商层级最多 5 层。

#SUB-01
SUB-02 下级分销商属于哪个分组,可以做什么?

您从管理员允许的列表中选择一个分组;该分组决定下级分销商的权限、可出售的套餐和试用配额。

#SUB-02
SUB-03 我可以对下级分销商管理什么?

邮箱、姓名、密码、状态、分组(从列表中选择)、备注、转入 / 收回点数,以及其名下的所有线路。您不能更改其角色或所有者。

#SUB-03
SUB-04 下级分销商能看到我的哪些内容?

什么都看不到:每个账户只能看到自己之下的内容,看不到上层或其他分支。

#SUB-04
SUB-05 删除下级分销商时,其线路和点数去哪里?

分组需要开启Can Delete Users。剩余的点数、线路和子账户会转移给执行删除的账户。客户的线路继续正常工作。被删除账户的个人数据(用户名、邮箱、姓名、密码、API 密钥、备注)会被清除;该用户名和邮箱可以再次使用。

#SUB-05
SUB-06 新的下级分销商会收到邮件吗?

当管理员启用了欢迎邮件时:新账户会收到其登录名和登录链接。邮件绝不包含密码 — 密码由您自己发送给他们。

#SUB-06

分类模板

CAT
CAT-01 分类模板有什么用?

用于重新排序、重命名或隐藏客户在应用中看到的分类(直播、电影、剧集、广播)— 按线路生效,不影响面板自身的分类。

#CAT-01
CAT-02 隐藏分类时会发生什么?

该分类的所有内容也会从使用该模板的线路的应用和播放列表中隐藏。

#CAT-02
CAT-03 编辑模板时,使用它的线路会改变吗?

会,对分配了该模板的每条线路立即生效。删除模板时,其线路会恢复为默认布局。

#CAT-03
CAT-04 我可以查看和编辑哪些模板?

查看:您自己的、您之下账户的、系统模板,以及上级共享的模板。编辑:仅限您自己的和您之下的。要调整系统模板,请复制它并编辑副本。

#CAT-04
CAT-05 有哪些值得了解的限制?

自定义分类顺序不适用于 M3U 播放列表中的电影 / 剧集部分(名称和隐藏仍然适用)。使用 Xtream API 的应用会获得全部内容。

#CAT-05

Reseller API、API 密钥、webhook

API
API-01 Reseller API 有什么用?

供您自己的系统(网店、计费、机器人)出售和管理线路 / 下级分销商,而无需打开 dashboard。地址:{API}/reseller/v1,通过X-API-Key请求头认证。完整文档位于 API 服务器的/docs/。

#API-01
API-02 在哪里获取 API 密钥?

API Key页面。密钥只在创建时显示一次— 请立即复制。如果丢失,请创建新密钥(旧密钥将失效)。

#API-02
API-03 所有系统应该共用一个密钥吗?

最好不要。为每个系统创建一个额外密钥:为其命名,限制可使用它的 IP / CIDR,可选择设为只读(仅列表和查看),并且可以单独吊销而不影响其他密钥。

#API-03
API-04 API 能做什么?
需求操作
余额、价格、可购买数量、用户名 / 试用规则user_info、pricing、packages
线路get_lines、get_line、create_line、renew_line、change_package、edit_line、enable_line、disable_line、delete_line
下级分销商get_users、get_user、create_user、edit_user、adjust_credits、enable_user、disable_user、delete_user
激活码创建、列表、启用 / 禁用、重置设备、删除
Webhook、自有播放地址、API 调用日志create_webhook…、set_play_base、api_logs

dashboard 的每条规则(分组、专属价格、试用配额、层级范围)通过 API 以完全相同的方式生效。

#API-04
API-05 网络错误后重试,会被重复扣费吗?

不会,只要同一笔交易发送相同的request_id:系统会返回之前的结果。续期的request_id与该线路绑定:将其用于另一条线路会返回冲突错误(HTTP 409),另一条线路不会改变 — 请为每笔交易生成新的request_id。

#API-05
API-06 我的集成无法工作。如何自行检查?

API Key 页面有一个近期 API 调用表(30 天):操作、结果、错误代码、调用地址、连接器名称。参数从不记录。

#API-06
API-07 什么是 webhook,有哪些事件?

有事件发生时,面板会通知您的系统,因此您无需不断查询。事件:line.created、line.renewed、line.enabled、line.disabled、line.deleted、line.expiring(提前 3 天)、line.expired、credits.low(低于您设定的阈值)。接收地址必须是 https,并且可从互联网访问。

#API-07
API-08 如何确认 webhook 是真实的?

每条通知都带有签名X-Xtream-Signature: sha256=HMAC(secret, timestamp.body);密钥在创建端点时只显示一次。Webhook 绝不包含密码。

#API-08
API-09 Webhook 停止发送了?

每条通知会尝试 3 次;连续 20 次投递失败的端点会被关闭。请修复您这一侧的问题,使用Send test,如果端点被关闭,则重新创建该端点。

#API-09
API-10 API 会返回线路密码吗?

会,但仅返回给线路的所有者(您以及层级中您之上的账户)。不要将线路密码存入日志,也不要通过不安全的渠道发送。

#API-10
API-11 `edit_line` 可以为线路续期吗?

可以,当您同时发送package_id(旧名称package也被接受)时:除了编辑之外,该操作还会像change_package一样出售该套餐的一个正式周期 — 相同的价格、相同的request_id,响应中带有credits_charged。编辑和续期是一个事务:被拒绝时(点数不足、套餐无效、同时发送了trial)不会有任何改变。不带套餐的edit_line只编辑用户名、密码、联系方式和备注,不会触及套餐或到期日期。

#API-11
API-12 为旧(PHP)面板编写的脚本能用于此 API 吗?

不能原样使用。该 API 保留了熟悉的操作名称,但是一个新接口:地址为/reseller/v1,使用在本面板创建的 API 密钥,写操作通过 POST 发送,错误以 HTTP 状态加error字段返回,创建线路的结果位于data.line。请使用/docs/的文档或现成的连接器(CON-02)。

#API-12

商城 / 计费系统连接器

CON
CON-01 如何向我的客户收款?

使用您自己的系统和支付网关。面板不处理支付。连接器将您的商城系统与面板连接起来:客户在您那边付款 → 连接器调用 Reseller API 创建 / 续期线路。

#CON-01
CON-02 哪些平台有连接器?

WHMCS、Blesta、WISECP、HostBill、ClientExec、FOSSBilling、Paymenter、WordPress(WooCommerce / Easy Digital Downloads)、Odoo、PrestaShop、OpenCart、Magento、Dolibarr、ERPNext,以及面向 Shopify、Upmind 和 Invoice Ninja 的“webhook bridge”。

#CON-02
CON-03 在哪里下载和安装?

侧边栏Resources → All Connectors:每个连接器都有说明、连接信息、安装步骤、Download按钮以及用于校验文件的 SHA-256。

#CON-03
CON-04 连接器测试到什么程度?

每个连接器不同,各连接器的页面都有说明:有些在真实平台内运行过(例如 WordPress + WooCommerce、Odoo、FOSSBilling、Paymenter),另一些只测试了核心部分。请阅读“how it was tested”一行,并在正式销售前先在测试环境中试用。

#CON-04
CON-05 连接器安全吗,它会对面板做什么?

连接器只使用您的API 密钥调用 Reseller API — 它能做的恰好就是您能做的,不会更多。源代码公开,您可以阅读和检查。请为每个连接器提供一个带 IP 限制的专用密钥(API-03)。

#CON-05
CON-06 连接器可以出售什么?

线路(创建、续期、更换套餐、暂停、删除)以及带点数的下级分销商账户。

#CON-06
CON-07 我的平台还没有连接器?

请使用 Reseller API(API-01)和 webhook 自行集成,或通过支持渠道提交需求。

#CON-07

数据、删除与隐私

DATA
DATA-01 已删除的线路可以恢复吗?

不可以。删除即消失:线路的信息(用户名、密码、联系方式、备注)、连接历史(IP、设备、观看内容)、绑定到该线路的机顶盒及其激活码。没有回收站,也没有恢复功能或 API。客户回来时,请创建新线路。

#DATA-01
DATA-02 删除之后系统保留什么?

仅为运营者保留一份匿名的统计记录(新客户还是回头客、哪些套餐受欢迎)。其中不含任何可识别客户的信息,任何分销商、连接器或 API 都无法访问。

#DATA-02
DATA-03 备份可以找回已删除的线路吗?

不可以。数据库备份仅用于在事故后重建系统,由运营者保管;不用于撤销删除。旧备份会轮换淘汰,因此已删除的数据也会从中消失。

#DATA-03
DATA-04 为什么线路密码可读而面板密码不可读?

线路密码需要输入到应用中,并且是播放列表链接的一部分,因此面板为线路所有者保留可读形式。面板账户密码只以哈希形式存储。

#DATA-04
DATA-05 谁可以看到我的线路和客户?

您、您层级中在您之上的账户,以及管理员。其他分销商和您之下的层级看不到。

#DATA-05
DATA-06 面板会向我的客户发送邮件 / 消息吗?

绝不会。线路的客户属于分销商;您通过自己的系统联系他们。

#DATA-06
DATA-07 线路到期前会通知我吗?

有两种方式:即将到期线路的每日汇总邮件(当管理员启用时;默认提前 3 天),以及发送到您系统的line.expiring/line.expiredwebhook。

#DATA-07

故障排查

FIX

请从上到下依次检查。大多数“无法观看”的问题出在前 5 行。

FIX-01 客户无法登录 / 无法观看 观众
#检查项现象处理方法
1用户名 / 密码应用提示信息错误与线路表单核对(区分大小写,无空格);重新发送Generate play link的链接
2到期应用提示Expired续期(LINE-06)
3状态Disabled/Banned重新启用;Banned请联系管理员
4服务器地址无法连接使用播放链接中准确的地址和端口,以及正确的http/https
5连接数别人开始观看时被踢出SEC-01、SEC-02
6IP 被封锁该网络下没有任何线路能进入SEC-08:等待封锁解除,或请管理员解除
7ISP 锁定 / 国家 / Allowed IPs仅在更换网络、使用移动数据、使用 VPN 或旅行时失败SEC-04、SEC-05、SEC-07
8格式HLS / TS 链接被拒绝使用套餐允许的格式(PLAY-03)
9被封锁的应用仅在某个应用中失败换一个应用试试;SEC-09
#FIX-01
FIX-02 可以登录,列表也显示,但某个频道无法播放 观众

通常是播放锁定之一(FIX-01的第 5–9 行):登录和频道列表不检查 IP / 应用,只有播放才检查。如果只有一个频道在所有线路上都失败 → 源频道有问题;请告诉管理员频道名称和时间。

#FIX-02
FIX-03 缺少频道或频道分组 观众

检查线路的频道包(PKG-04、PKG-05)以及分配给它的分类模板(CAT-02)。更改后,请让客户在应用中重新加载列表。管理员刚添加的频道大约半分钟后出现;如果频道在频道包中但没有任何线路能看到,可能是管理员将该频道下线了。

#FIX-03
FIX-04 卡顿、画面冻结 观众

依次尝试:换一个频道(是一个频道还是所有频道?)→ 换一个网络 → 换一种格式(用 HLS 代替 MPEG-TS)→ 换一个应用。所有频道在所有网络下都失败 → 请将用户名、时间和频道告诉支持。

#FIX-04
FIX-05 没有节目指南(EPG) 观众

M3U 应用需要添加 XMLTV 链接(PLAY-05)。源头没有 EPG 的频道不显示节目表。

#FIX-05
FIX-06 我无法创建线路

依次检查:未选择套餐 · 套餐不适用于您的分组(PKG-02)· 点数不足(CRD-05)· 用户名已被占用或短于最小长度(LINE-02)· 试用配额已用完(TRI-01)。

#FIX-06
FIX-07 下载播放列表返回 429 错误或 404 页面

429:该线路同时下载了过多的播放列表 / EPG 文件 — 请稍等后重试。404 页面:对于每一种拒绝(信息错误、已过期、被锁定、超出限制),系统都返回 404,以免向陌生人透露原因;请按FIX-01检查。

#FIX-07
FIX-08 我无法打开 dashboard 的某个页面

您的分组没有该页面的权限(ACC-02)。Live Connections还需要管理员为该分组开启查看客户连接的选项(LINE-15)。

#FIX-08
FIX-09 我没有收到面板的邮件

只有当管理员配置了邮件服务器并启用了该类消息时才会发送邮件;账户必须有真实的邮箱地址。请检查垃圾邮件文件夹。

#FIX-09

术语表

线路(Line)
一位观众的 IPTV 订阅:用户名、密码、到期时间、频道包、限制
用户(User)
登录面板的账户:管理员、分销商、下级分销商
分组(Group)
面板账户的权限分组;决定菜单、可出售的套餐、线路规则、试用
频道包(Bouquet)
内容列表(频道、电影、剧集)
套餐(Package)
出售的产品:频道包 + 时长 + 限制 + 以点数计的价格
点数(Credit)
用于购买套餐的预付单位
试用(Trial)
套餐的试用期
激活码(Activation code)
客户可凭此自行激活付费线路的代码
MAG / Enigma2
两类机顶盒;通过 MAC 地址登录
Xtream Codes API
大多数 IPTV 应用使用的协议(服务器 + 用户名 + 密码)
M3U / XMLTV
播放列表 / 节目指南的文件格式
MPEG-TS / HLS
两种流格式
EPG
节目指南
回看(Catch-up)
在节目播出之后观看
Restreamer
为拉取流并转发的合作伙伴准备的线路
连接器(Connector)
将分销商的商城系统与面板连接起来的软件
Webhook
发生事件时面板发送给分销商系统的通知

仍未解决?

请发送线路的用户名(切勿发送密码)、发生时间、所用应用或设备,以及您已尝试过的问题编号。