绿豆BOX接口管理插件使用说明

1. 插件介绍

绿豆BOX接口管理插件是一款专为TVBOX设计的管理工具，用于集中配置和维护TVBOX的各类资源与功能。

文档特点：

每日更新，改动栏目标注“new”标识
支持关键词搜索配置（如查询“套餐”可找到会员分组相关设置）
仅支持本站二次开发的TVBOX，不兼容其他版本

2. 主要功能

在线管理TVBOX仓库
在线管理TVBOX解析接口
在线管理TVBOX首页配置
批量添加会员并导出
批量生成卡密并导出

直播列表管理与加密
TVBOX在线升级
代理提卡功能
会员套餐与权限管理
收款与订单管理

3. 后台安装

后台仅支持lvdoubox，安装后需优先修改收款码（默认二维码为示例，不支持实际收款）。

3.1 环境要求

PHP >= 7.4

Mysql >= 5.5.0 且 <= 5.7（支持innodb引擎，建议5.6）

Apache 或 Nginx

3.2 安装步骤（以宝塔为例）

步骤1：添加站点

新建站点，数据库选择MySQL，记录数据库名、用户名和密码。

图1：宝塔添加站点示例

步骤2：验证站点

访问新建站点域名，出现默认页面后再上传源码（确保站点可正常访问）。

图2：站点访问验证页面

步骤3：准备目录

进入站点根目录，删除默认文件（index.html、404.html、.htaccess）。

图3：清理默认文件

步骤4：上传与配置源码

下载后台源码（路径：/index/ldshop/mysite.html），解压后上传至站点根目录
导入数据库文件（lvdoubox_xxxxx.sql）到新建的MySQL数据库
修改数据库配置（路径：application/database.php），填写数据库信息

图4：数据库配置文件位置

步骤5：站点设置

配置运行目录（通常为public）和伪静态规则（参考下图）。

图5：设置运行目录

图6：伪静态规则配置

3.3 进入后台

默认入口：域名/rJDBWLFeXV.php
修改入口：重命名public/rJDBWLFeXV.php，新入口为“域名/新文件名.php”
默认账号密码：admin / 12345678

注意： 手机访问提示“未登录”时，编辑application/config.php，将281行附近的loginip_check设为false；重置密码可修改数据库fa_admin表，password设为c13f62012fd6a8fdf06b3452a94430e5，salt设为rpR6Bv，重置后密码为123456。

4. 客户端编译

编译需APPID和应用密钥（可使用默认或新增），提交后服务器自动编译（5-10分钟），完成后可下载安装包。首次编译需在“商城—我的商品—编译”提交，后续可在后台“APP管理”操作。

4.1 构建入口与参数

图7：客户端构建入口

4.2 对接方式（二选一）

方式1：直连

编译时“对接地址”直接填写后台搭建地址（如http://你的域名）。

方式2：中间件

创建data.json文件，内容如下：

{
    "urls": [
        {
            "url": "你的后台地址",
            "name": "服务器1"
        },
        {
            "url": "备用地址（可选）",
            "name": "服务器2"
        }
    ]
}
                

将文件上传至可访问路径（如域名/data.json）
编译时“对接地址”填写“域名/data.json”（不含协议头）
授权对接地址设置为“域名/data.json”

4.3 关键参数说明

编译版本：默认选择master版本
广告模块：base为必选（支持图片广告），手机版可选其他SDK
内核架构：
- TV设备推荐：JavaArmeabi_v7a
- 手机/主流设备：JavaArm64_v8a
- 模拟器：JavaX86
应用包名：格式参考com.lvdou.android.tv，不可包含数字、中文或特殊字符

常见问题：打包失败（提示“未找到产物”）可能是因logo/启动图格式错误、包名不规范或RSA公钥问题，可尝试留空logo和公钥测试。

5. 客户端管理

用于管理客户端应用信息，配置仓库、解析接口等功能时需绑定应用（可多选）。

添加应用

图8：添加应用界面

版本管理

可配置客户端版本信息及扩展参数（如隐藏视频、默认直播模式等）。

{
  "proxy": "-1",                  // 代理（需订阅ui5）
  "home_ui": "0",                 // 默认UI版本
  "video_hide": "四平警事,猫和老鼠", // 隐藏视频列表
  "default_live": "0",            // 1=启动直接进入直播
  "exit_ad_img_url": "/uploads/xxx.png" // 退出弹窗广告
}
                

配置客户端首页展示内容，手机版显示为幻灯片，TV版显示在对应区域。

图9：添加首页配置

扩展参数示例

web===https://wap.baidu.com      // 内部浏览器打开链接
webs===https://wap.baidu.com     // 外部浏览器打开链接
南瓜|1===122341                  // 播放指定视频（参数通过长按获取）
live===1008611                   // 进入直播
                

管理TVBOX的资源仓库，需绑定应用才能生效。

图10：仓库配置示例

仓库加密与管理

extend/depot目录下的仓库文件会自动加密，外部无法直接访问
外部仓库不加密，需加密可下载至extend/depot目录
仓库JSON文件不可含注释，否则会输出空仓库

对接苹果CMS示例

{
  "key": "lvdou",
  "name": "测试仓库",
  "type": 3,
  "api": "csp_AppYsV2",
  "searchable": 1,
  "quickSearch": 1,
  "filterable": 1,
  "ext": "你的苹果CMS地址/api.php/app/"  // 需以/结尾
}
                

管理视频解析接口，支持普通接口和会员专属接口。

图11：解析接口配置示例

关键选项说明

仅会员可用：开启后仅会员可见，需保留至少一个公共接口
中转模式：接口不直接返回给客户端，通过后台中转（加密）
超级解析：用于蜂蜜自带的超级解析功能，不建议删除

管理会员组、卡密和账户，支持批量生成与导出。

添加会员组

图12：会员组配置示例

批量添加账户

生成未激活状态的账户，用户首次登录自动激活并开始计算时长。

图13：批量添加账户示例

6. 权限管理

管理员管理：添加多个管理员账号，分配不同权限
角色组：自定义角色权限（如仅管理卡密、仅管理仓库等）
插件管理：配置微信支付宝整合、会员邀请、签到等插件

图14：插件管理界面

7. 高级配置

在“插件管理—绿豆BOX接口插件—其他”中配置，支持和风天气或图片广告。

和风天气配置

注册和风天气账号（https://console.qweather.com），创建项目获取KEY
免费版接口：https://devapi.qweather.com/v7/weather/7d?key=你的KEY&location=101010100

通过JSON配置遮挡视频中的广告，文件路径：public/uploads/tvbox/canvas.json。

[
  {
    "width": "200",           // 宽度（像素或MATCH_PARENT）
    "height": "200",          // 高度
    "gravity": ["1", "3"],    // 位置（1=顶部，3=左侧）
    "colour": "#FF0000",      // 颜色或图片路径
    "flag": "ldm3u8"          // 应用线路标识（ALL=全部）
  }
]
                

后台更新至241025后支持，可添加、导入直播源，支持加密输出。

图15：直播列表配置示例

8. 常见问题

客户端提示base64错误：在extend下创建depot文件夹，添加api.json仓库文件
易支付不回调：在易支付后台尝试补单，根据提示排查原因
版本更新提示异常：客户端版本号需与后台版本管理完全一致
配置不生效：检查是否绑定应用，尝试清理缓存并重启客户端
支付金额与套餐不符：系统优先抵扣用户余额，仅需支付差额

绿豆BOX接口管理插件使用说明文档