环境:甲骨文云 Ubuntu aarch64(4C/23G)+ Flutter x86_64 走 qemu 模拟构建
目标:从零搭一个可上架的短剧 App 骨架,内容源可插拔,对接苹果CMS 采集接口
结果:22 个 Dart 文件 / 约 4200 行,产出 APK;一路踩了 8 个坑(6 个构建 + 2 个真机),全部记录在案
源码:见文末「资源下载」(钻石会员专享,最新 v0.2.13)
缘起
手上有台甲骨文 ARM 服务器,上面跑着一套自建的苹果CMS。某天想把其中某个板块单独做成一个竖屏 App,方便在手机上看。
一开始想用现成的开源播放器改,但看了几个项目后发现都不太合适:要么是通用播放器、没有短剧这种「上下滑切集」的心智,要么是把数据源写死在某一个资源站上。于是决定自己搭一个骨架,核心诉求只有两条:
- 内容源可插拔:默认用内置样例数据就能跑,上线时换成自己的接口,UI 一行不改
- 能在 ARM 服务器上构建出 APK:本地 Windows 没装 Flutter,全靠远程
这篇把整个过程完整记下来。中间踩的坑比预想的多,尤其构建链路那段——同一个问题会换不同的面孔反复出现。
一、技术选型与工程骨架
Flutter 是明确的:一套代码、竖屏手势友好、视频播放生态成熟。数据层用抽象接口 + 多实现的方式组织,这是整个骨架的基石。
1. 内容源抽象
App 只依赖一个接口,换后端不动 UI:
abstract class DramaSource {
Future<Paged<Drama>> list({String? category, String? keyword, int page, int pageSize});
Future<Drama> detail(String id);
Future<PlayTicket> playTicket(String dramaId, int episodeNo);
Future<List<String>> categories();
}
三个实现:
| 实现 | 用途 | 切换方式 |
|---|---|---|
MockDramaSource |
内置 JSON 样例,离线可跑通全流程 | 默认 |
HttpDramaSource |
对接自建 REST 后端(含服务端票据) | SOURCE=http |
MacCmsDramaSource |
苹果CMS v10 标准采集接口 | SOURCE=maccms |
切换靠编译期注入,不写死代码:
flutter build apk --release
--dart-define=SOURCE=maccms
--dart-define=MACCMS_BASE=https://your-site.com
--dart-define=MACCMS_CATEGORY=短剧
2. 目录结构
lib/
core/ env.dart(编译期配置)、api_client.dart(dio 封装 + 统一错误文案)
models/ Drama / Episode / Paged / PlayTicket
data/ drama_source.dart(抽象)+ mock/http/maccms 三实现 + factory
state/ stores.dart(FeedStore 分页 / LibraryStore 本地持久化 / SessionStore 会话)
features/ gate / home / theater / search / follow / detail / player / profile
widgets/ drama_card.dart
3. 播放器
短剧 App 的核心体验是竖屏 + 上下滑切集。用 PageView 竖向滚动,每个页面持有一个 VideoPlayerController,只保留当前集和相邻集的控制器,滑远即释放:
void _evictFar(int current) {
final drop = <int>[];
_controllers.forEach((k, v) {
if ((k - current).abs() > 1) drop.add(k); // 只留相邻集
});
for (final k in drop) {
_controllers.remove(k)?.dispose();
}
}
同时做了自动预加载下一集、播完自动跳集、手势控制、选集面板、倍速切换,以及每 5 秒落一次本地进度。
二、接手一个中断的工程
骨架写到一半,上游模型服务报了个 400(reasoning_content must be passed back),会话直接中断在编辑 player_page.dart 的中间。接手后第一件事不是继续写,而是全面体检:
# 括号平衡扫描(字符串/注释干扰不大,够用)
for f in $(find lib -name '*.dart'); do
o=$(tr -cd '{' < "$f" | wc -c)
c=$(tr -cd '}' < "$f" | wc -c)
[ $((o-c)) -ne 0 ] && echo "UNBALANCED: $f"
done
扫出 player_page.dart 括号差一个:上游删 PopScope 包裹层时只删了一半,开头删了、结尾多留一个 )。23 个文件里只有这一处,其余都干净。
三、构建链路:六个坑,一个比一个隐蔽
本地 Windows 没装 Flutter,全部构建在甲骨文 ARM 服务器上做。服务器上的 /opt/flutter 是 x86_64 版本,靠 qemu-binfmt 模拟执行——这是后面一连串问题的总根源。
先说明一点:我试着装原生 ARM64 版 Flutter,翻了官方 releases 清单——Linux ARM64 压根没有发行包(所有渠道的 dart_sdk_arch 都是 x64)。所以只能忍受 qemu 模拟。
坑 1:代码里的隐藏错误
第一次构建在 Dart 编译阶段就挂了,四类问题:
| 位置 | 问题 | 修复 |
|---|---|---|
detail_page.dart:8 |
导入写成同目录的 player_page.dart,实际在 ../player/ |
改路径 |
api_client.dart:59/78 |
用了 Options(baseUrl:)——dio 里 baseUrl 只属于 BaseOptions |
删掉这段没人调用的死代码 |
api_client.dart:114 |
DioExceptionType switch 不穷尽(5.11 新增了枚举值) |
补分支 + default 兜底 |
| 全局 | NDK 版本提示 | 非致命,模板里 flutter.ndkVersion 本来就对 |
坑 2:gen_snapshot 找不到
Dart 编译过了,卡在 AOT:
Failed to find ".../android-arm64-release/linux-arm64/gen_snapshot"
原因很直接:qemu 里的 x86 Flutter 把宿主机判成了 arm64,去找 linux-arm64 目录,但缓存里 Android 各架构的产物只有 linux-x64 版。解决办法是把两套名字接起来:
cd /opt/flutter/bin/cache/artifacts/engine
for d in android-*profile android-*release android-*debug; do
[ -d "$d/linux-x64" ] && [ ! -e "$d/linux-arm64" ] && ln -s linux-x64 "$d/linux-arm64"
done
坑 3:font-subset 缺失
AOT 三个架构都过了,图标树摇又报 The font-subset utility is missing。这次不逐个补了,直接把 x64 目录里有、arm64 目录里缺的全部软链过去,一次修完:
for f in linux-x64/*; do
b=$(basename $f)
[ ! -e "linux-arm64/$b" ] && ln -s "../linux-x64/$b" "linux-arm64/$b"
done
坑 4:NDK clang 缺 libz
再往后挂在 CMake 编译原生胶水层:
clang: error while loading shared libraries: libz.so.1: cannot open shared object file
NDK 的 clang 是 x86_64 二进制,qemu 能执行,但系统里缺 x86_64 版的 zlib(ARM 机器上只有 aarch64 的)。最干净的做法是不动 dpkg 多架构配置,直接解一个 amd64 deb 进去:
cd /tmp
curl -sO http://archive.ubuntu.com/ubuntu/pool/main/z/zlib/zlib1g_1.2.11.dfsg-2ubuntu9.2_amd64.deb
dpkg-deb -x zlib1g_*.deb zlibroot
sudo cp -a zlibroot/lib/x86_64-linux-gnu/libz.so.1* /lib/x86_64-linux-gnu/
# 验证:clang -c t.c -o t.o 通过
apt install zlib1g:amd64 硬加架构,容易把系统包装态搞乱。解包塞库目录是侵入性最小的做法,回滚也简单。坑 5:并发构建自相踩踏
改代码重新构建时,我犯了两个错,凑成一场事故:
- 用
pkill -f 'build_apk.sh'清旧构建——把自己那条 ssh 命令也匹配上了,会话被杀,旧进程反而活着 - 新一轮构建和上一轮的孤儿 qemu-dart 进程同时抢 pub 锁,kernel 编译被无声杀掉,日志里只有一个空荡荡的
kernel_snapshot_program failed: Exception
最终解法:按 PID 精确清理,确认 ps | grep -c 归零后再启动,用独立日志文件,并用 < /dev/null + disown 彻底脱离 ssh 通道:
nohup bash scripts/build_apk.sh release
> ~/duanju_build.log 2>&1 < /dev/null &
disown
< /dev/null 断 stdin、> log 2>&1 接管输出、nohup+disown 脱离会话。少一个,ssh 断开就会连累任务。坑 6:qemu 构建慢得离谱
顺手清理了服务器上遗留的僵尸进程——其中一个 flutter pub get 已经挂了 44 天还没退出,就是 qemu 模拟拖出来的。清理后单次构建稳定在 5-8 分钟(Gradle 原生编译走 ARM Java,不慢;慢的是 Dart 那一段)。
四、对接苹果CMS 采集接口
构建跑通后拿到第一个 APK(24MB,离线样例版),接着对接采集接口。
1. 接口摸底
curl -s --compressed 'https://jp98.vip/api.php/provide/vod/?ac=list'
拿到关键信息:
| 项 | 值 |
|---|---|
| 总资源 | 2957 条,148 页 |
| 分类数 | 5 个 |
| 目标分类 | type_id=57(AI短剧),702 部 |
| 播放组 | jpm3u8(单组,直接是 m3u8 直链) |
2. 一个解析陷阱:取错了播放组
苹果CMS 的 vod_play_url 和 vod_play_from 是按 $$$ 一一对应的多个播放组。有的站第一组是网页分享页(形如 /share/xxx)而不是直链,真正的 m3u8 在后面的组里。所以解析时要按组名挑:
// 优先取名字带 m3u8 的组,其次取 URL 里真有 .m3u8 的组,兜底第一组
for (var i = 0; i < groups.length; i++) {
final name = i < names.length ? names[i] : '';
if (name.toLowerCase().contains('m3u8')) { picked = groups[i]; break; }
}
3. 第二个陷阱:t= 参数要 ID 不要名字
剧场页传的是分类名(如”AI短剧”),但苹果CMS 的 t= 参数只认 type_id。加了个名称→ID 的映射缓存,查不到就原样传。
4. 直链可用性验证
对接前先验证播放地址真能播——这一步很关键,能提前排掉”数据拿到了但放不出来”的情况:
curl -s -o /dev/null -w "%{http_code} %{content_type}n"
'https://c10.hs100.top/20261029/xxxx/index.m3u8'
# 200 application/vnd.apple.mpegurl ← 正确的 HLS 内容类型
五、加一道访问密码门
内容性质决定了它不该被随手打开,于是加了个启动密码门。
1. 密码不写死在源码里
用编译期注入,源码里搜不到密码:
flutter build apk --release
--dart-define=ACCESS_PASSWORD=xxxxxx
static const String accessPassword = String.fromEnvironment('ACCESS_PASSWORD');
static bool get hasGate => accessPassword.isNotEmpty;
入口处按需切换:
home: Env.hasGate ? const GatePage() : const RootPage(),
2. 本地校验 + 状态持久化
if (entered != Env.accessPassword) {
setState(() { _error = '密码不正确'; _input.clear(); });
return;
}
final prefs = await SharedPreferences.getInstance();
await prefs.setBool('gate_unlocked_v1', true); // 解锁一次,下次免输
未解锁时 RootPage 完全不被构建,所以不会发任何网络请求去拉数据——这一点在实现上是严格保证的。
strings libapp.so | grep 就能看到)。它挡住的是”随手打开手机的人”,挡不住”拿到 APK 后逆向的人”。如果需要更强的保护(内容加密、服务端鉴权),那是另一套方案,需要后端配合。六、真机排障:两个”调试正常、打包才炸”的坑
APK 装到手机上,第一次打开就遇到两个问题。它们有个共同点:本地 flutter run 完全测不出来,只有真实 release 包才会暴露。
问题 1:打开就提示”无法连接服务器”
先怀疑网络,但手机浏览器能正常打开接口地址,说明网络没问题。于是去查构建目录的清单文件,一眼看到问题:
grep -nE 'uses-permission|usesCleartextTraffic' android/app/src/main/AndroidManifest.xml
# 只有 android:usesCleartextTraffic="true",没有 INTERNET!
这是 Flutter 的一个经典坑:模板生成平台目录时,INTERNET 权限只写在 debug 和 profile 的清单里(方便开发时热重载联网),main 的清单里没有。而 release 包只合并 main,所以:
flutter run调试:用的是 debug 清单,有权限,一切正常- 打成 release 包:只剩 main 清单,没有权限,一联网就被系统拒绝
修复是往 main 清单加权限,并固化进构建脚本(防止以后重新生成平台目录又丢):
MANIFEST="android/app/src/main/AndroidManifest.xml"
if [ -f "$MANIFEST" ] && ! grep -q 'android.permission.INTERNET' "$MANIFEST"; then
sed -i 's|<manifest xmlns:android="http://schemas.android.com/apk/res/android">|<manifest xmlns:android="http://schemas.android.com/apk/res/android">n <uses-permission android:name="android.permission.INTERNET"/>|' "$MANIFEST"
fi
验证方式——直接读 APK 的二进制清单,而不是看源码:
aapt2 dump permissions app-release.apk
# uses-permission: name='android.permission.INTERNET' ← 确认到位
问题 2:能连上了,但首页显示”暂无内容”
权限修好后能联网了,但列表是空的。这时候要区分三种可能:接口没数据、数据解析失败、UI 没渲染。先用 curl 复现 App 的请求:
curl -s --compressed 'https://jp98.vip/api.php/provide/vod/?ac=detail&pg=1&t=57'
# {"code":1,"total":703,"list":[...]} ← 数据完全正常
接口没问题,数据也对,那问题在解析层。这时候我多看了一眼响应头——之前几十次 curl 都只看 body,从没看过 header:
curl -s --compressed -D - -o /dev/null 'https://jp98.vip/api.php/provide/vod/?ac=detail&pg=1&t=57' | grep -i content-type
# Content-Type: text/html;charset=utf-8 ← 关键!
text/html。而 dio 配的是 responseType: ResponseType.json——只有 Content-Type 是 application/json 时 dio 才自动解码;看到 text/html 就把响应体原样保留为字符串。于是 json['list'] 取不到东西,返回空列表,UI 显示”暂无内容”。浏览器能正常显示,是因为浏览器根本不看 Content-Type,直接把字节当文本渲染,人眼看到的就是 JSON。这也是为什么”浏览器能打开”不能证明”App 能解析”。
修复:统一用 ResponseType.plain 拿字符串,自己 jsonDecode,不管服务端声明什么 Content-Type 都能解析:
// BaseOptions 里
responseType: ResponseType.plain,
// _asMap 里
if (data is String) {
final s = data.trim();
if (s.isEmpty) return <String, dynamic>{};
try {
final decoded = jsonDecode(s);
if (decoded is Map<String, dynamic>) return decoded;
if (decoded is List) return <String, dynamic>{'list': decoded};
} catch (_) {
return <String, dynamic>{'raw': s}; // 不是 JSON(可能是 HTML 错误页)
}
}
顺带加固:分类映射失败时的静默空列表
排查过程中还发现一个隐患:苹果CMS 的 t= 参数只认 type_id(数字)。如果分类名映射失败、把中文名原样传过去,服务端不报错,而是静默返回空列表——又是一个”暂无内容”。改成查不到映射就退回不带分类:
if (cat.isNotEmpty) {
final types = await _loadTypes();
cat = types[cat] ?? ''; // 查不到就退回,宁可展示全部也不白屏
}
七、最终产物
dist/
duanju-jp98-gate-release.apk 23MB 正式版(资源站 + 访问密码门)
duanju-jp98-release.apk 23MB 资源站版(无密码门)
duanju-mock-release.apk 24MB 离线样例版(无需后端)
| 项 | 数据 |
|---|---|
| Dart 文件 | 22 个 / 约 4200 行 |
| 目标分类 | 703 部 |
| 构建耗时 | 约 5-8 分钟/次(qemu) |
| 总计构建次数 | 11 次(含多次失败定位) |
源码下载
完整源码(含构建脚本、参考后端、离线样例数据,已包含真机排障的全部修复):
源码统一放在文末「资源下载」区块(钻石会员专享,包含 v0.1 初版至 v0.2.13 的全部内容与历史)。
源码中不含任何密钥或站点地址——密码、接口地址全部通过 --dart-define 在构建时注入。这正是”内容源可插拔”设计的价值:仓库干净、可分享、换源零改动。
八、还留着的两个问题
1. 签名与包名
当前用 debug 签名、包名 com.duanju.duanju。自己装机测试没问题,上架前需要配正式 keystore 并改包名。
2. 内容分级
访问密码门只解决了”谁能打开 App”,没有解决”打开后看到什么”。如果 App 会分发给他人,建议再加一道开屏年龄确认(18+ 提示 + 确认才能进),这是合规层面的要求,代码改动很小。
九、复盘:这次真正学到什么
- 构建环境的坑会换面孔重复出现:gen_snapshot、font-subset、libz 表面是三个问题,根因都是”x86 工具链跑在 ARM 上”。识别出根因后,后面的修复就从”逐个试”变成了”批量补”。
- release 包必须真机验证:INTERNET 权限、Content-Type 解码这两个坑,本地
flutter run一个都测不出来。开发时跑通不等于打包后能用,release 包要单独走一遍真机流程。 - 验证接口不能只看 body:响应头(Content-Type / Content-Encoding / 状态码)同样要查。这次”暂无内容”的根因就藏在 Content-Type 里。
- 先验证数据链路,再写 UI:对接资源站时先 curl 接口、再 curl 直链,两步都通了才动代码。如果先写 UI 再调试,会分不清是代码问题还是数据问题。
- 远程长任务的纪律:pkill 匹配到自己、并发构建抢锁、ssh 断开带死任务——这三个都是操作层面的错,不是技术难题,但每一个都浪费了半小时以上。
- 可插拔设计的回报是滞后的:写接口抽象那天看不出价值,等到要换数据源、要出分级包、要开源分享时,才体现出来——源码里一个密钥都没有,可以直接给出去。
整个项目从接手中断的工程到出可用 APK,核心代码 4000 行左右。真正耗时的不是写代码,是构建环境和数据对接——这大概也是所有”看起来简单”的客户端项目的共同点。
十、2026-10-31 更新:v0.2.2 → v0.2.3 加工与最新接手文档
初版(v0.1)之后这个项目又加工了两轮,这里把最新源码和更新后的完整接手文档一并放上来。两轮加工的要点:
- v0.2.2:更新体系——应用内检查更新(多线路 update.json + 版本比对 + 强更)、正式包构建三件套脚本(
build_release.sh/bump_version.sh/make_update_json.py);域名全部改灰云直连,APK 下载实测 2.4~2.9 MB/s(走 Cloudflare 免费版只有 11 KB/s,因为不缓存 .apk 每次跨境回源)。 - v0.2.3(versionCode 5):多分类 + 应用内直接更新——剧场页可切换浏览站点全部分类(分类名运行期自动发现,改
MACCMS_CATEGORY_IDS即可换站);更新弹窗内直接下载 APK(实时进度、MD5 校验、失败自动切线路)后经 FileProvider 调起系统安装,不再跳浏览器。发版时把包送到 QQ 的那一步,见这篇实录。
最新源码下载(v0.2.13,含全部加工)
最新完整源码(versionCode 15,覆盖 v0.2.2 更新体系、v0.2.3 多分类与应用内更新,直至 v0.2.13 封面解密反代、三源代理与 CMS 分类推荐的全部加工,含构建脚本、参考后端与全部排障修复)已设置为钻石会员专享资源,请通过下方「资源下载」区块获取。
接手说明(v0.2.3,自包含,照做即可复现构建与发版)
面向:接手的 AI / 开发者。本文自包含,照着做即可复现构建、改配置、发版。 最后核实时间:2026-10-31 当前版本:v0.2.3(versionCode 5)
0. 概览
| 项 | 值 |
|---|---|
| 应用 | 竖屏短剧播放器,Flutter |
| 包名 | com.duanju.duanju |
| 应用名 | 短剧 |
| 内容源 | 苹果CMS v10 采集接口(jp98.vip) |
| 分发方式 | 应用内直接更新(弹窗内下载+调起安装);浏览器下载仅作兜底 |
| 源站 | 甲骨文 ARM 服务器 129.221.168.245 |
| 线上目录 | /www/wwwroot/duanju-release/ |
三条命令跑通构建(细节见 §3):
ssh oracle
cd /home/ubuntu/duanju_app
bash scripts/build_release.sh # 产物 dist/duanju-v0.2.3-release.apk
1. 原版存放位置
原始项目从未纳入 git,只有磁盘快照。按「原始程度」从旧到新:
| # | 位置 | 大小/版本 | 内容说明 |
|---|---|---|---|
| 1 | /home/ubuntu/duanju_app.tgz |
45K | 最原始骨架。仅 lib/ assets/ server/ scripts/ 等,不含 android/;首次构建靠 build_apk.sh 自动 flutter create 补齐 |
| 2 | /home/ubuntu/duanju_app_backup_20261030_163533/ |
version: 0.1.0+1 |
加工前完整快照(含 android/)。lib/core/ 只有 api_client.dart + env.dart,无 updater.dart |
| 3 | /home/ubuntu/duanju_app_v0.2.0_src.tar.gz |
120K | 第一轮加工版源码包 |
| 4 | /home/ubuntu/duanju_app_v0.2.1_src.tar.gz |
— | 第二轮加工版源码包 |
| 5 | duanju_app_v0.2.2_src.tar.gz |
2.1M | v0.2.2 源码包(本项目根目录一份,服务器 /tmp 一份) |
| 6 | /home/ubuntu/duanju_app_backup_20261031_pre_v023/ |
v0.2.2 源码 | v0.2.3 改动前快照(lib / android / scripts / pubspec / README),回滚用 |
| 7 | duanju_app_v0.2.3_src.tar.gz |
2.2M | 当前版本源码包(本项目根目录一份,服务器 /home/ubuntu 一份) |
原始文档与脚本未改动过,仍在项目内:
/home/ubuntu/duanju_app/README.md—— 原版设计文档(三种数据源、接口契约、待办)/home/ubuntu/duanju_app/scripts/build_apk.sh—— 原版构建脚本(保留,可继续用)/home/ubuntu/duanju_app/scripts/setup_oracle_arm.sh—— 原版环境检查脚本/home/ubuntu/duanju_app/server/—— 原版参考后端(Node/Express,联调用,生产未使用)
参考文章(项目由来):https://7998888.xyz/4330/
回滚建议:要退回原版,rsync 覆盖 duanju_app_backup_20261030_163533/ 到工作目录即可;但它没有 android/local.properties 里的 SDK 路径,需要重建(见 §3.1)。
2. 加工完的连接方式
2.1 服务器接入
# 本地 ~/.ssh/config 已有别名
ssh oracle
# 等价于:ssh -i ~/Downloads/ssh-key-2026-07-30.key ubuntu@129.221.168.245
| 项 | 值 |
|---|---|
| IP | 129.221.168.245(甲骨文 ARM 实例,hostname instance-20260730-1728) |
| 用户 | ubuntu(sudo 免密可用) |
| 项目目录 | /home/ubuntu/duanju_app |
| 另一台机器 | 161.118.252.183 是独立的 AMD 实例,与短剧项目无关,别改混 |
2.2 数据源接口(App → 苹果CMS)
App 只认这三个编译期参数,代码里没有硬编码站点地址。
| 参数 | 值 | 说明 |
|---|---|---|
SOURCE |
maccms |
数据源类型,固定 |
MACCMS_BASE |
https://jp98.vip |
站点根,不带 /api.php |
MACCMS_CATEGORY_IDS |
20,54,55,56,57 |
多分类模式:剧场页可切换的全部分类 ID |
MACCMS_TYPE_ID |
57 |
主分类 ID(排分类首位;只配它一个 = 单分类锁定模式) |
MACCMS_CATEGORY |
AI短剧 |
分类名,仅作展示兜底 |
接口路径(代码内拼接):${MACCMS_BASE}/api.php/provide/vod/
| 用途 | 请求 |
|---|---|
| 列表 | ?ac=detail&pg=1&t=57 |
| 详情 | ?ac=detail&ids=<id> |
| 分类 | ?ac=list(注意:该站不返回 class 表,所以必须用 type_id) |
实测数据(2026-10-31):站点共 5 个分类,全站 2994 部 / 150 页:
| type_id | 分类名 | 数量 | 页数 |
|---|---|---|---|
| 20 | 国产自拍 | 1119 | 56 |
| 54 | 主播 | 69 | 4 |
| 55 | 欧美 | 359 | 18 |
| 56 | 日本无码 | 739 | 37 |
| 57 | AI短剧(主分类) | 708 | 36 |
多分类行为(v0.2.3 起):首页推荐流与剧场页「全部」= 全站最新;剧场页分类条可切换任意分类;分类名运行期自动发现(class 表 → 各分类首页条目的 type_name → 「分类」兜底),换站无需改代码,改 MACCMS_CATEGORY_IDS 即可。注意该站 t= 不支持逗号多值(t=57,56 实际等于 57),全站列表只能靠不带 t 实现。
资源域名:播放直链 *.hs100.top(m3u8),封面 98jpg1.vip,均无 Referer 校验,可直接播。
播放解析规则(lib/data/maccms_source.dart):播放地址按 $$$ 分组 → 优先选 m3u8 组 → 每集按 标题$URL 拆分 → 按标题里的数字排序纠正乱序。
2.3 更新服务(App ↔︎ 客户端)
检查更新(App 内 Env.updateUrls,逗号分隔多候选,按序尝试):
1) https://7998888.xyz/duanju/update.json ← 直连源站,主线路
2) https://momo.7998888.xyz/duanju/update.json ← 备用(同一目录)
下载地址:https://7998888.xyz/duanju/duanju-v0.2.3-release.apk
应用内直接更新(v0.2.3 起):更新弹窗内直接下载 APK(实时进度条,可取消)→ MD5 校验(对比 update.json 的 apkMd5)→ 经 FileProvider 调起系统安装器。失败自动切下一条线路重试,全部失败后保留「浏览器下载」兜底。首次安装系统会跳「允许此来源安装」授权页,授权后回到 App 再点一次「安装」即可。
两条域名 2026-10-30 起全部改为灰云直连(不走 Cloudflare 代理):
| 项 | 值 |
|---|---|
| 主域名 | 7998888.xyz → 129.221.168.245(DNS only) |
| 证书 | /etc/letsencrypt/live/wild-7998888/,通配 *.7998888.xyz,certbot.timer 自动续期 |
| 直连实测 | 2.4–2.75 MB/s(24MB 约 9 秒) |
| 走 CF 时实测 | 11 KB/s(20 秒仅 231KB)—— CF 免费版不缓存 .apk,每次跨境回源 |
线上目录与 nginx:
| 项 | 值 |
|---|---|
| 文件目录 | /www/wwwroot/duanju-release/ |
| nginx 配置 | /etc/nginx/sites-enabled/7998888.xyz 的 location /duanju/ |
| 备用入口 | /etc/nginx/sites-enabled/momo.7998888.xyz 的 location /duanju/(alias 到同一目录,所以只需维护一份文件) |
| https 端口 | vhost 实际 listen 8443 ssl,公网 443 由 nginx.conf 的 stream SNI map 分流到 8443 |
| 断点续传 | 已验证 Range 返回 206 |
2.4 更新协议(update.json 字段约定)
{
"versionCode": 5,
"versionName": "0.2.3",
"title": "短剧 v0.2.3 · 分类浏览 + 应用内直接更新",
"updateContent": "• 剧场页支持全部分类切换浏览,「全部」= 全站 2994 部n• 应用内直接更新:弹窗内下载(实时进度)后自动调起安装,不用再跳浏览器n• 下载包 MD5 完整性校验,失败自动切换线路n• 首次安装如系统提示「允许安装未知应用」,授权后回到 App 再点一次「安装」",
"downloadUrl": "https://7998888.xyz/duanju/duanju-v0.2.3-release.apk",
"downloadUrls": [
"https://7998888.xyz/duanju/duanju-v0.2.3-release.apk",
"https://momo.7998888.xyz/duanju/duanju-v0.2.3-release.apk"
],
"apkUrl": "https://7998888.xyz/duanju/duanju-v0.2.3-release.apk",
"apkSize": 24356719,
"apkMd5": "fdaf30abbd512e6c73d12c40e7c118a6",
"minVersionCode": 0,
"forceUpdate": false,
"publishTime": "2026-10-31"
}
客户端判定逻辑(lib/core/updater.dart):
- 触发条件:
versionCode > Env.appVersionCode && downloadUrl 非空 force/forceUpdate为 true,或minVersionCode > 当前→ 强制更新(弹窗不可关)- 字段兼容:
version/versionName、downloadUrl/url/apkUrl/downloadUrls、changelog/notes/description/updateContent - 旧版客户端只读
downloadUrl;新版读downloadUrls并显示线路切换 - v0.2.3 起客户端下载完成后校验
apkMd5(不符视为失败并自动切线路);apkSize在服务端不给 Content-Length 时兜底显示进度
3. 加工完的构建方式
3.1 构建环境(服务器实测值)
| 组件 | 版本 / 路径 |
|---|---|
| Flutter | 3.32.5 stable,/opt/flutter/bin/flutter |
| Dart | 3.8.1 |
| Java | OpenJDK 17.0.20.1 |
| Android SDK | /home/ubuntu/android-sdk ← 实际生效(android/local.properties 写死) |
| Android Platform | android-36 |
| NDK | 27.0.12077973(同目录下还有 26.3 / 28.2) |
| 架构 | aarch64(甲骨文 ARM),产物含 arm64-v8a / armeabi-v7a / x86_64 |
⚠
/opt/android-sdk存在但没有ndk/目录,指过去会导致assembleRelease失败。build_release.sh已改为自动探测:/home/ubuntu/android-sdk/ndk存在则用它,否则回落/opt。
3.2 一键构建
ssh oracle
cd /home/ubuntu/duanju_app
bash scripts/build_release.sh
脚本行为:注入 --dart-define → flutter pub get → flutter build apk --release → 拷到 dist/ → 打印 MD5。
耗时:首次或依赖变动后约 8–10 分钟(Gradle assembleRelease 占大头),增量约 2–3 分钟。
3.3 编译期参数
全部有默认值,可用环境变量覆盖:
MACCMS_BASE=https://jp98.vip
MACCMS_CATEGORY_IDS=20,54,55,56,57
MACCMS_CATEGORY=AI短剧
MACCMS_TYPE_ID=57
UPDATE_URL="https://7998888.xyz/duanju/update.json,https://momo.7998888.xyz/duanju/update.json"
OUTPUT_NAME=duanju-v0.2.4-release.apk
bash scripts/build_release.sh
| 变量 | 默认值 | 作用 |
|---|---|---|
MACCMS_BASE |
https://jp98.vip |
采集站根地址 |
MACCMS_CATEGORY_IDS |
20,54,55,56,57 |
全部分类 ID,多分类模式(只留一个 = 单分类锁定) |
MACCMS_TYPE_ID |
57 |
主分类 ID,排分类首位 |
MACCMS_CATEGORY |
AI短剧 |
分类显示名兜底 |
UPDATE_URL |
直连 + CF 双地址 | 逗号分隔,按序回退 |
ACCESS_PASSWORD |
空 | 非空则启用启动密码门 |
OUTPUT_NAME |
duanju-v0.2.2-release.apk |
产物文件名 |
FLUTTER |
/opt/flutter/bin/flutter |
Flutter 可执行文件 |
ANDROID_HOME |
自动探测 | SDK 根目录 |
3.4 发版流程(完整 5 步)
# 1) 改版本号(一条命令同步 env.dart + pubspec.yaml)
ssh oracle 'cd /home/ubuntu/duanju_app && bash scripts/bump_version.sh 0.2.4 6'
# ↑ versionCode 必须严格递增,否则客户端不会提示更新
# 2) 构建
ssh oracle 'cd /home/ubuntu/duanju_app && OUTPUT_NAME=duanju-v0.2.4-release.apk bash scripts/build_release.sh'
# 3) 部署到线上目录
ssh oracle 'cp -f /home/ubuntu/duanju_app/dist/duanju-v0.2.4-release.apk /www/wwwroot/duanju-release/ &&
chmod 644 /www/wwwroot/duanju-release/*.apk'
# 4) 生成 update.json(版本号自动读 env.dart,size/md5 实算 apk)
ssh oracle 'cd /home/ubuntu/duanju_app &&
UPDATE_TITLE="短剧 v0.2.4"
UPDATE_CONTENT="• 改了 An• 修了 B"
python3 scripts/make_update_json.py duanju-v0.2.4-release.apk'
# 5) 验证(见 3.5)
make_update_json.py 会自动完成:读 env.dart 拿 versionName/versionCode → 实算 APK 的 size/md5 → 写入直连 + 备用双地址。不再需要手工填任何数字。
3.5 发版后验证清单
# 版本信息(需 aapt,在 /home/ubuntu/android-sdk/build-tools/36.0.0/aapt)
ssh oracle '/home/ubuntu/android-sdk/build-tools/36.0.0/aapt dump badging
/www/wwwroot/duanju-release/duanju-v0.2.3-release.apk | head -1'
# 期望:package: name='com.duanju.duanju' versionCode='5' versionName='0.2.3'
# update.json 可达 + 内容正确
curl -s https://7998888.xyz/duanju/update.json | head -20
# APK 可达 + 完整性(与 update.json 里的 apkMd5 对比)
curl -s -o /tmp/t.apk -w "code=%{http_code} bytes=%{size_download} speed=%{speed_download}n"
https://7998888.xyz/duanju/duanju-v0.2.3-release.apk
md5 /tmp/t.apk # macOS;Linux 用 md5sum
# 断点续传
curl -s -r 0-1023 -o /dev/null -D- https://7998888.xyz/duanju/duanju-v0.2.3-release.apk
| grep -i "content-range" # 期望 206
# 编译参数是否真注入进 APK(校验 dart-define 生效)
python3 -c "
import zipfile
d=zipfile.ZipFile('/tmp/t.apk').read('lib/arm64-v8a/libapp.so')
for p,l in [(b'https://7998888.xyz/duanju/update.json','直连更新URL'),
(b'https://jp98.vip','采集站'),
('AI短剧'.encode('utf-16-le'),'分类名')]:
print(l, '✓' if p in d else '✗ 缺失')"
4. 加工改动清单(原版 → v0.2.2)
| 文件 | 状态 | 改动 |
|---|---|---|
lib/core/updater.dart |
新增 | 应用内更新:多线路拉取、版本比对、渐变态弹窗、强制更新、线路切换 |
lib/widgets/app_image.dart |
新增 | 统一网络图组件:CachedNetworkImage + 内存缓存 + 骨架屏 + 失败占位 |
lib/core/env.dart |
改写 | 加 appVersion/appVersionCode/maccmsTypeId;updateUrls 多候选 + updateUrlList |
lib/data/maccms_source.dart |
重写 | 苹果CMS v10 真实对接;type_id 优先;pagecount 分页;$$$ 分组解析 m3u8;HTML 清洗 |
lib/models/models.dart |
改 | Drama 加 remark(显示「更新至03集」等采集站文案) |
lib/features/player/player_page.dart |
改 | 竖滑切集、相邻集预加载、长按 2.0x、30 集分段 Tab 选集、锁屏浮钮、5 秒落盘进度 |
lib/features/home/ theater/ |
改 | 下拉刷新 |
lib/features/profile/profile_page.dart |
改 | 清理缓存 / 检查更新 / 关于 |
lib/features/root_page.dart |
改 | 启动 2 秒后静默检查更新 |
android/app/src/main/AndroidManifest.xml |
改 | 中文应用名、queries(外部浏览器)、usesCleartextTraffic |
android/app/build.gradle.kts |
改 | ndkVersion = "27.0.12077973" |
scripts/build_release.sh |
新增 | 正式包构建(参数固化 + 自动探测 SDK + 输出 MD5) |
scripts/bump_version.sh |
新增 | 版本号同步:一条命令改 env.dart + pubspec.yaml |
scripts/make_update_json.py |
新增 | 生成 update.json:版本号自动读 env.dart,size/md5 实算 APK |
lib/core/apk_installer.dart |
v0.2.3 新增 | 下载目录解析(应用专属目录)+ MethodChannel 调起系统安装 |
lib/core/updater.dart |
v0.2.3 重写弹窗 | 弹窗内直接下载:进度条/取消/MD5 校验/失败自动切线路 → 调起安装;浏览器下载降级为失败兜底 |
lib/data/maccms_source.dart |
v0.2.3 改 | 多分类:MACCMS_CATEGORY_IDS;分类名运行期自动发现;「全部」与首页 = 全站;搜索改全站范围 |
lib/core/env.dart |
v0.2.3 改 | 加 maccmsCategoryIds |
MainActivity.kt |
v0.2.3 改 | duanju/installer 通道:FileProvider + ACTION_VIEW 调起安装器 |
AndroidManifest.xml |
v0.2.3 改 | 加 REQUEST_INSTALL_PACKAGES 权限 + FileProvider 声明 |
res/xml/file_paths.xml |
v0.2.3 新增 | FileProvider 授权路径 |
pubspec.yaml |
v0.2.3 改 | + path_provider、crypto |
scripts/build_release.sh |
v0.2.3 改 | 注入 MACCMS_CATEGORY_IDS |
README.md / build_apk.sh / server/ |
未动 | 保持原版 |
5. 已知坑
- SDK 路径:必须用
/home/ubuntu/android-sdk(带 NDK),/opt/android-sdk缺 NDK。 - 无 git:项目从未纳入版本管理,改动前自己先
cp -a备份,否则无法回滚。 - release 用 debug 签名(
build.gradle.kts里signingConfig = debug)。后果:换构建机产出的 APK 签名不同,覆盖安装会失败(需先卸载)。发正式版前应配置key.properties+ keystore。 update.json有 5 分钟缓存:nginx 里设了Cache-Control: max-age=300。发版后立刻验证可能读到旧内容,属正常;备用线路(momo)上的update.json是 CF DYNAMIC 不缓存,可用来交叉核对。- 本地 DNS 缓存:改了 DNS 后 macOS 上要
sudo killall -HUP mDNSResponder,否则 curl 还打旧 IP;排查解析一律用dig @1.1.1.1,别信系统缓存。 ac=list不返回分类表:这个采集站就是不给,所以type_id必须显式传,代码已强校验(缺失直接抛错,避免拉全站串类)。- 首次构建慢:甲骨文 ARM 上 Gradle
assembleRelease约 8–10 分钟,别以为是卡死。 - CF 不要碰
.apk:免费版不缓存大文件,走 CF 只有 ~11KB/s。域名已全部改灰云直连,别再开回橙云。 - 首次应用内安装要授权:系统会跳「允许安装未知应用」授权页,授权后回 App 再点一次「安装」;这是 Android 8+ 对
REQUEST_INSTALL_PACKAGES的标准流程,属于正常现象不是 bug。 - 「全部」= 全站的前提:站点全部内容都来自
MACCMS_CATEGORY_IDS所列分类时,不带t的全站列表才等价于这些分类合集(当前 2994 = 5 类之和 ✓)。换站或站点加新分类时要核对一遍,否则「全部」会混入未配置的内容。 - 多分类名称靠运行期发现:分类名取自各分类第 1 页条目的
type_name,某分类突然清空条目会显示成「分类」,不影响功能。
6. 常用运维速查
# 进服务器
ssh oracle
# 项目目录 / 线上目录
cd /home/ubuntu/duanju_app
ls -lh /www/wwwroot/duanju-release/
# 源码打包(交接用)
cd /home/ubuntu/duanju_app
tar --exclude=build --exclude=.dart_tool --exclude=.git
-czf /tmp/duanju_app_src.tar.gz lib android scripts pubspec.yaml
# nginx 改完必做
sudo nginx -t && sudo systemctl reload nginx
# ⚠ 不要在 vhost 里直接写 listen 443,443 被 nginx.conf 的 stream(SNI map) 占用
# 查看证书
sudo certbot certificates | grep -E "Name|Expiry"
静态检查(提交前跑一遍):
ssh oracle 'cd /home/ubuntu/duanju_app && /opt/flutter/bin/flutter analyze'
# 当前基线:3 条 info,0 error / 0 warning
十一、2026-10-31 二更:三源合一与免重启热切换(v0.2.4 → v0.2.7)
背景:CMS 采集站(jp98.vip)域名稳定性没保障,决定再接两个内容站分散风险
做法:黄果、黄桃两个站都没有公开列表 JSON,全部走 SSR 页面适配;随后三源合一并做运行时热切换
结果:两天迭代 4 个版本,v0.2.7 三源随切随用、跨源追剧不串剧;源码包已并入文末「资源下载」区块(钻石会员专享)
SSR 站点怎么适配
黄果(huangguoai.com)和黄桃(aihuangdou.com)是一家的两个站,但前端完全不同,且都不提供列表 JSON 接口。适配思路是「正则解析卡片 + 内嵌 JSON 抠数据」:
- 列表/搜索:SSR 卡片结构稳定(黄果
hg-drama-card__cover-link,黄桃article.drama-card,标题就藏在data-track-item-name里),正则按块截取;搜索走/search/video/<词>/<页>/。 - 详情:两个站都把核心数据嵌在页面里的
<script type="application/json">(黄果videoInitialData、黄桃ninePlayData),一次 jsonDecode 全拿到——标题、封面、简介、标签、每集时长。 - 播放:都是带
auth_key签名的 m3u8 直链,有时效。黄果从详情 JSON 的epPlaySrcs取;黄桃更省事,有现成 JSON 接口/videos/<id>/episodes/<n>/playback,一集一换。
踩的几个坑,都挺典型:
- 分页数解析:列表页到处是
/video/<id>/链接,宽松的页码正则会把视频 ID 11030 当成总页数,分页总量直接算出 26 万。最后只认分页跳转组件的data-pages属性才算数。 - 搜索翻页是假的:搜索接口忽略页码参数,任何页都返回第 1 页。客户端必须固定
hasMore=false,否则上拉加载会无限重复。 - 广告壳卡片:黄桃列表混着
pm-ssp-card广告位壳子,不跳过会多出幽灵条目。 - HTML 实体:标题里有
&#x…;、&,得自己写个两段式解码(数字/十六进制实体 + 命名实体)。
三源合一:id 前缀防串剧
三个源的剧集 ID 都是纯数字,而追剧、观看历史按 ID 存本地——跨源切换必然撞车。方案是源内统一加前缀(mc_ / hg_ / hd_),detail/playTicket 入口先 strip。旧版本存下的无前缀记录走兼容分支,不受影响。
免重启热切换
原来源是编译期 --dart-define 注入、main 里 build 一次就定死。改成 SourceController extends ChangeNotifier 持有当前 ApiClient + 数据源,切换时重建并通知;UI 层监听后给 RootPage 换一个 ValueKey 整体重建——四个标签页的 FeedStore 全部用新源重拉,效果等同重启但无感:
Future<void> switchTo(String newId) async {
if (newId == id || _switching) return;
_switching = true; notifyListeners();
try {
final newApi = apiFor(newId);
final newSource = buildSourceById(newId, newApi);
final oldSource = source;
id = newId; api = newApi; source = newSource;
await SourcePref.save(newId); // 记住选择,下次冷启动直接落这里
await oldSource.dispose();
notifyListeners();
} finally {
_switching = false; notifyListeners();
}
}
// app.dart:源一变就换 key,整棵页面树重建
AnimatedBuilder(
animation: controller,
builder: (_, __) => MultiProvider(
providers: [
Provider<ApiClient>.value(value: controller.api),
Provider<DramaSource>.value(value: controller.source),
],
child: KeyedSubtree(
key: ValueKey('source-${controller.id}'),
child: const RootPage(),
),
),
);
一个小坑:切换会立刻销毁当前页面树,「切换成功」的 toast 如果等 await 之后再取 ScaffoldMessenger.of(context),context 已经 unmounted。提前把 messenger 抓在手里再切。
追剧与历史在 LibraryStore 里按前缀 ID 本地持久化,切换过程零参与,天然不受影响。
产物
- v0.2.7(versionCode 9):APK 24.5MB,直链下载,应用内更新已推送
- 三源默认 CMS(jp98.vip),黄果/黄桃一键切换免重启;我的页实时显示当前源
- flutter analyze:0 error / 0 warning(info 级 lint 只剩探针脚本的 print)
十二、2026-11-01 三更:全源自建代理与封面解密(v0.2.8 → v0.2.13)
起因:三源上线后国内用户反馈两个问题——不挂梯子时黄果/黄桃/91 三个源整个用不了(页面、封面、播放全被墙);封面图大面积空白,只有苹果CMS 源正常。
结果:全部流量改走自建甲骨文服务器代理,四个源(CMS / 黄果 / 黄桃 / 91)国内免梯子直连可用;封面问题定位为图床 AES 加密,服务端解密后全站封面恢复。
说明:本节只写思路和踩坑,不附源码。
问题一:三个源整个被墙
加源本身不难,难的是「国内用户打开就能用」。实测手机直连 huangguoai.com / aihuangdou.com / 91crdjai.com 基本不可用,而服务器(甲骨文海外出口)直连它们毫无压力。于是决定:把 App 对这三个站的所有请求都改道自建服务器,手机只认 7998888.xyz 一个域名。
反代层:按职责拆成三种入口
- 页面抓取:
/hg/、/hd/、/crd/、/cms/—— SSR 列表/搜索/详情页与 CMS 采集接口 - 封面:
/dcover/—— 交给本机解密服务处理(见后半节) - 播放:
/hls/(清单)、/dts/(分片 + AES 密钥)、/cmshls/、/cmsts/
App 端只改了两个地方:各源的基地址换成 https://7998888.xyz/hg 这类形态;播放直链在运行时统一改写为代理路径。业务逻辑一行没动。
反代踩到的三个坑
- 中文搜索落到首页:
rewrite ... break会把 URI 按解码后的形态转发,中文关键词被站点规范化后进了首页兜底。改用proxy_pass带 URI 的写法,保留原始编码。 - 301 又把人带回被墙域名:站点会 301 到自己的绝对域名,代理若不改写 Location,App 跟着跳过去就是撞墙。用
proxy_redirect把绝对、相对两种形态都拉回自建域。 - m3u8 里全是绝对地址:清单里的分片和 AES 密钥都是被墙域名的完整 URL,原样透传等于没代理。用
sub_filter在响应侧实时改写(清单是纯文本,成本可忽略),分片本身走流式转发。
页面缓存:源站会抽风,也会反爬
黄果源站间歇性超时;压测时还触发了腾讯 EdgeOne 的 JS 挑战——直连和走代理都是十次十中,冷却几分钟才恢复。于是给 SSR 页面加了 3 分钟 proxy_cache + use_stale:源站挂了先回缓存页,同时把打向源站的请求压到「每个 URI 三分钟一次」,正常使用不会再触发反爬。
顺带踩了个很隐蔽的坑:缓存键里带变量,写配置时被 shell 提前展开成了空串,导致所有 URI 共用同一个缓存键——先到的页面把其它全部「投毒」成同一份内容。表现出来是列表正常、点进详情却是首页。修掉缓存键后立刻恢复。
通配中转:换域名不用更新 App
采集站的播放域名轮换是常态(hs100.top 就整个挂过一次,后又复活)。为了不再「换一次域名发一次版」,播放地址统一改写成 /hpx/<域名>/<路径>:nginx 按路径里的域名动态回源,并对域名做白名单校验(不在白名单直接 403,避免变成公开代理)。
效果:上游换播放域名,只需在服务器白名单里加一行并 reload,App 端永远不用更新。
问题二:封面全是灰的
先把 App 的封面请求改走自建反代,结果还是灰的。打开访问日志才看到关键证据:手机端的封面请求全部 200,每张 60~100KB,UA 正是 App 的运行时(Dart)——请求发出去了、响应也回来了,就是显示不出来。
把下载下来的字节丢给 file 一看——不是 JPEG/PNG,是一坨无法识别的二进制。换 Referer、换 UA、完全不带 Referer,收到的字节一模一样,防盗链的猜测可以排除。
顺藤摸瓜:站点自己的解密管线
翻站点前端:页面挂 drama-boot.js,它调用 plugins/lazyload 观察 img[data-src],真正的解密在 plugins/crypto-worker.js(193KB 的 Worker,内嵌 CryptoJS)。逻辑很直白:
- 算法:AES-128-CBC / NoPadding,尾部按填充字节剥离
- key 与 IV 不是明文,是一串下划线分隔的字符码(形如
102_53_100_…),逐位转字符后即得到 16 字节的密钥与 IV - CDN 下发的就是密文本身;Worker 把二进制转 base64 后解密,再按魔数判断是 JPEG / PNG / WebP
拿 openssl aes-128-cbc -d -nopad 配合解出来的 key/iv 一跑:97792 字节的「乱码」变成一张 720×1280 的 JPEG——到这里链路上每块拼图都对上了。
服务端解密:App 一行不用改
解密放在服务器最省事:写一个几十行的小服务(systemd 常驻,只监听 127.0.0.1),nginx 的 /dcover/ 反代到它。服务负责「拉取上游图片 → 解密 → 剥填充 → 回真图」;如果取回来的已经是明图(上游今后可能换策略),就原样透传。
这样做的最大好处是所有客户端一视同仁:已经装了旧版本的手机不必升级,封面立刻恢复。实测 91 源与黄果源封面都输出标准 JPEG(640×914 / 864×1152),App 内显示正常。
版本节奏
- v0.2.9(versionCode 11):封面首次改走自建反代;播放失败给出友好提示
- v0.2.10(12):三个源页面与播放全部改走自建代理,国内免梯子
- v0.2.11(13):CMS 源接入代理(接口 / 清单 / 分片 / 密钥)
- v0.2.12(14):播放地址通配中转
/hpx/+ 域名白名单,换域名不发版 - v0.2.13(15):CMS 源默认推荐改为「AI短剧」分类
目前四个源(苹果CMS / 黄果 / 黄桃 / 91成人短剧)在国内全部免梯子可用,列表、详情、封面、播放链路完整闭环。
复盘
- 先看证据再猜原因:封面这次如果止步于「请求都是 200」,永远发现不了加密;访问日志加字节层面的检查才是分水岭
- 代理不是「转发就完事」:编码、重定向、清单内的绝对地址、缓存键,任何一样都能让看起来通了的代理失效
- 能放服务端的就别发版:封面解密和域名白名单都放在服务器,客户端零改动,老版本用户同样受益
续篇:v0.4.0 —— 整体重写为 Tauri 客户端
Flutter 版迭代到 v0.3.0(界面也换成了 HG 同款沉浸式竖滑)之后,看到了 HGhub 这个项目:Tauri 2 + Rust 后端 + React 19 前端,Fluent 设计语言,竖屏信息流做得非常舒服。与其继续在 Flutter 里「模仿风格」,不如直接以它的代码为壳重做——反正在它的架构里,内容源本来就只是一个 Rust 模块的事。
于是有了 v0.4.0,三天内从零到发布到更新通道:
移植:Flutter 版五个内容源(苹果CMS / 黄果 / 黄桃 / 91短剧 / 自有后端)全部用 Rust 重新实现
升级链:包名与签名与 Flutter 版完全一致,旧用户覆盖安装即升级,之后走应用内自更新
源码:moran69/duanjuhub(duanjuhub_src_v0.4.2.tar.gz,343KB)
1. 源的移植:从 Dart 到 Rust
HGhub 的后端是深度绑定黄果接口的薄封装,我的源是另外五套完全不同的协议。做法是在 Rust 侧建了一个源注册表(enum 分发,免掉 dyn trait 的 async 麻烦),每个源实现 list / detail / play / categories 四个方法,输出统一归一成 HGhub 前端认识的 JSON 形状——这样前端一行不改就能吃所有源。
SSR 解析用 regex 1:1 翻译 Dart 的正则,HTML 实体解码、采集站播放组选择(vod_play_url 按 $$$ 分组、优先 m3u8 组)这些坑 Flutter 版都踩过一遍,照抄就行。写完在服务器上跑了四个源的真实数据冒烟测试(list → detail → play 全链路断言),比真机点来点去快得多。
2. 媒体链路:本地自定义协议
HGhub 的思路是把封面解密和 HLS 改写都收进 Rust,通过本地协议(Android 上是 http://dj.localhost)喂给 WebView:封面走 /img(密文按需 AES-128 解密,明文直通),m3u8 走 /hls(清单内的分片与 key 地址改写回本地 /seg,彻底绕开 CORS 和防盗链)。Flutter 版里那套「封面走 /dcover、分片走 /dts、其余通配 /hpx」的服务器反代照样用,只是这次是 Rust 去请求反代,WebView 只见本地协议。
3. 顺手修掉的服务器 bug:proxy_redirect 吞路径
联调黄果源时发现列表翻页和详情页一直被 301 回根页面。排查下来是 nginx 反代里这条配置:
proxy_redirect ~^/(.*)$ /hg/; # 把上游 301 的 Location 整个吞成 /hg/
上游对无尾斜杠路径返回 301 → Location 被这条正则改写成 /hg/,路径直接丢了。Flutter 版一直「看起来能用」纯属巧合:301 落到的根页面恰好也是最新列表。改成保留路径的标准写法 proxy_redirect / /hg/;,翻页、详情立刻恢复正常。教训和以前一样:代理不是转发就完事,重定向语义也得管。
4. 应用内自更新:update.json → JNI 装系统安装器
更新通道沿用 Flutter 版的格式(versionCode / 多候选下载地址 / MD5),Rust 侧流式下载带进度事件、MD5 校验。安装这步踩了个坑:Tauri 自带的 FileProvider 的 file_paths.xml 只有 external-path 和 cache-path,而 APK 下载在应用内部目录(app_data_dir),FileProvider 拿不到 content:// Uri,一调就炸。补上 files-path 之后,用 JNI 直接复刻旧版 MethodChannel 的那段逻辑(FileProvider 授权 → ACTION_VIEW package-archive → 唤起系统安装器),一次通过。首次安装系统若提示「允许安装未知应用」,授权后回 App 再点一次即可。
5. 换源即换内容
这次把「源切换」做成了一等公民:设置里切到哪个源,首页、分类、搜索三个页面整体重挂载,立刻只出所选源的内容;首页推荐流锁定「AI短剧」分类(黄果/黄桃锁 AI短剧,91短剧回落成人短剧,苹果CMS 锁主分类 57)。追剧与收藏用各源前缀 id(hg_ / hd_ / mc_ / crd),天然不串剧。
复盘
- 换壳比改壳快:Flutter 版想在视觉上追平 HGhub 是无穷无尽的对像素;直接以它的代码为壳,把「源」当插件塞进去,三天搞定
- 数据形状归一是换 UI 框架的前提:前端只认一套 JSON 形状,后端换语言、源再加几个都不用动 UI
- 真实数据冒烟测试非常值:四个源全链路断言一次跑完,发布前就抓住了字段和时效性问题,省掉好几轮真机往返
两个仓库:duanjuhub(v0.4.x Tauri 客户端,本篇续篇的主角)、duanju_app(Flutter 版 v0.3.0 及之前 + 服务器反代部署文件)。





暂无评论内容