这篇文章整理绿豆 UI6、UI7 的 TV 端、手机端和后台部署配置流程，重点放在本地测试、后台安装、客户端编译、配置文件管理和常见问题排查。
合规提醒：本文仅用于个人学习、合法授权项目部署和本地环境测试。请确认你拥有源码、素材、接口和内容资源的合法使用权限，不要用于侵权传播、盗版分发或违反平台规则的商业用途。
一、教程适合哪些人
- 已经拥有合法授权源码，想整理 TV 端、手机端和后台部署流程的人。
- 准备在测试服务器上搭建后台，并完成客户端对接的人。
- 想把原来零散的配置项整理成可复用文档的人。
- 需要排查启动失败、后台接口异常、配置文件不生效等问题的人。
二、开始前准备
- 一台测试服务器或本地开发环境，建议使用独立测试域名或内网地址。
- PHP 7.4 及以上环境，MySQL 5.6 左右版本更稳妥，并确保 InnoDB 可用。
- Apache 或 Nginx，能设置网站运行目录和伪静态规则。
- Android Studio，用于导入、修改和编译 TV 端或手机端源码。
- 已确认合法来源的后台源码、TV 端源码、手机端源码和必要素材。
三、后台安装流程
1. 创建站点和数据库
以常见面板环境为例，先创建一个测试站点，并新建对应数据库。数据库类型选择 MySQL，字符集建议使用 utf8mb4。站点创建完成后，先访问一次域名，确认服务器能正常响应，再上传后台源码。
2. 上传源码并设置运行目录
把后台源码上传到站点目录后解压，建议删除默认生成的 index.html、404.html 等占位文件。后台项目通常需要把运行目录设置为 public，否则可能出现首页空白、路由异常或安装页无法打开。
3. 配置伪静态规则
Nginx 环境可以参考下面的 ThinkPHP 常用伪静态写法。不同服务器面板的入口名称不一样，重点是禁止访问运行缓存和应用目录，并把不存在的请求交给 index.php。
location ~* (runtime|application)/ {
return 403;
}
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
break;
}
}保存规则后重新加载站点配置，再访问安装地址。如果页面仍然打不开，优先检查 PHP 版本、运行目录、伪静态规则和文件权限。
四、完成安装后的安全设置
后台安装完成后，通常会生成随机后台入口。建议把入口保存到自己的密码管理工具或本地文档中，不要在公开文章、评论区或聊天群里直接公开。
- 修改默认管理员密码，使用强密码并妥善保存。
- 删除安装包、压缩包和不再使用的临时文件。
- 确认网站目录权限，不给不必要的目录写入权限。
- 如果忘记后台入口，可在
public目录中检查入口文件，但不要把真实文件名公开。
五、客户端源码导入与编译
1. 导入 Android Studio
打开 Android Studio，选择 File → Open，导入对应客户端源码目录。首次导入需要等待 Gradle 同步完成，如果依赖下载失败，先检查网络、Gradle 版本和项目配置。
2. 修改后台对接配置
TV 端和手机端通常会在不同包路径下维护对接地址。请以源码中的注释为准，把测试后台地址填写到对应配置位置。下面只给出占位示例，不包含任何第三方地址。
{
"api_base": "https://your-domain.com",
"app_id": "10000",
"app_secret": "replace-with-your-own-secret"
}填写后重新构建 APK，再安装到测试设备验证。若启动失败，优先查看客户端日志和后台接口返回值。
3. 常见应用信息修改
- 应用图标：替换资源目录中的图标文件，并确认清单文件引用正确。
- 启动图：分别检查 TV 端和手机端的启动图资源路径。
- 应用名称：在
res/values/strings.xml中修改。 - 包名：同时检查
build.gradle、AndroidManifest.xml和项目包结构。 - 版本号：在
build.gradle中维护versionName和versionCode。
六、后台对接方式建议
新手建议先使用“客户端直接对接后台”的方式完成测试，等后台、客户端和配置文件都稳定后，再考虑多线路或备用地址方案。多线路配置建议放在自己可控的服务器或对象存储中，不要依赖公开第三方仓库作为生产入口。
{
"time": 0,
"urls": [
{
"url": "https://your-domain.com",
"name": "主线路"
},
{
"url": "https://backup.your-domain.com",
"name": "备用线路"
}
]
}time 表示缓存时间，urls 保存后台地址列表。正式使用前，请确保这些地址都属于你自己管理的服务，避免因第三方地址失效导致客户端无法启动。
七、首页与基础功能配置
首页配置通常会影响 TV 端和手机端的展示效果。修改配置后，建议先在测试环境重启客户端确认，再同步到正式环境。下面是精简后的配置示例，已移除外部图片、外部发布页和第三方接口。
{
"home_ui": "0",
"home_live": "开启",
"home_info": "开启",
"home_push": "开启",
"home_cover": "#CC44566E",
"home_hide_video": "示例标题一,示例标题二",
"custom_depot": "关闭",
"auto_logon": "开启",
"release_url": "https://your-domain.com/release",
"flag": "local,default",
"about": "本应用仅用于合法授权内容管理和学习测试。"
}home_ui：首页样式，可根据版本支持范围选择。home_live、home_info、home_push：控制入口是否展示。home_cover：首页遮罩颜色，前两位可表示透明度。custom_depot：是否允许自定义仓库，正式环境建议谨慎开启。about：关于页面说明，建议写清楚项目用途和合规边界。
八、仓库配置与内容接口
仓库配置建议只用于你有合法授权的内容接口或自有测试数据，不要直接接入不明来源接口。配置文件可以放在后台受控目录中，通过后台接口读取，避免把敏感地址暴露在公开页面。
{
"key": "local_demo",
"name": "本地测试源",
"type": 3,
"api": "csp_AppYsV2",
"searchable": 1,
"quickSearch": 1,
"filterable": 1,
"ext": "https://your-domain.com/api/"
}其中 key 和 name 可以自定义，但要保持唯一；ext 应填写你自己拥有或被授权使用的接口地址。
九、会员、卡密与权限管理
会员和卡密功能适合用来测试权限分组、体验时长和账号管理。正式使用前，请先确认业务模式、隐私政策、用户协议和支付合规要求，不要在没有规则说明的情况下开放充值或购买入口。
- 会员管理：用于查看和编辑指定用户权限。
- 会员分组：相当于套餐或权限组，不建议随意删除，可先修改名称和时长测试。
- 卡密列表：用于生成测试卡密，建议区分测试环境和正式环境。
- 充值记录：主要用于查看记录，不建议直接改订单状态。
- 批量创建：批量账号或卡密导出后要妥善保管，避免泄露。
十、常见问题排查
问题 1：安装页打不开
优先检查 PHP 版本是否满足要求、站点运行目录是否为 public、伪静态是否保存成功，以及源码是否完整上传。
问题 2：客户端启动后请求失败
检查客户端中填写的后台地址是否正确，后台接口是否能返回数据，SSL 证书是否正常，服务器是否限制了请求来源。
400：打包时填写的对接地址返回空数据
401：客户端请求后台失败
403：后台返回数据异常，可能是应用 ID、密钥或权限配置错误
405：多线路配置格式不正确问题 3：配置文件修改后不生效
检查配置文件名是否与应用 ID 对应，JSON 是否有多余逗号或中文标点，客户端是否有缓存。修改后可以清理应用缓存或重新安装测试。
问题 4：Android Studio 编译失败
先看 Gradle 控制台里的第一条错误。常见原因包括 JDK 版本不匹配、依赖下载失败、包名修改不完整、签名配置缺失和资源文件命名不规范。
十一、发布前检查清单
- 后台入口、数据库账号、密钥等敏感信息没有写在公开页面。
- 文章中没有演示地址、购买地址、外部下载地址和评论导流内容。
- 配置示例使用自己的域名占位，不引用不明第三方接口。
- 图片 alt 文本清楚，能说明截图内容。
- 每个代码块都可复制，命令和配置没有混在普通段落里。
- 教程只用于合法授权源码部署和学习测试，已加入合规提醒。
十二、总结
绿豆 UI6、UI7 的部署重点不是简单上传文件，而是把后台安装、客户端对接、配置文件、权限管理和排错流程串起来。完成基础部署后，建议先在测试环境验证首页、登录、会员权限、接口返回和客户端启动流程，再逐步同步到正式环境。