Skip to content
Proyectos

Minireel/HGhub has 10,450 GitHub stars and 8,795 forks. GitHot measured +131 stars in 24 hours and +1,599 in 7 days. Last checked 2026-11-21 01:06 UTC. Last push 2026-11-18.

Cómo se miden estas cifras

Crecimiento de estrellas medido

in 24h
+131
in 7 days
+1599
in 15 days
Recopilando historial
in 1 month
Recopilando historial

Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.

Acerca de

Reproductor multimedia con plugins

Herramientas de desarrollo

README.md

Original

关于本项目:HGhub 只是我体验 Tuari2 移动端开发时做的小玩具,开源几天后不知为何收到了大量star。

意识到可能存在的潜在危险后,我立刻更换了开源协议为 PolyForm Noncommercial 1.0.0 ,并在 Readme 中写入了大量保护自己的文段。目前 HGhub收到的star实际上德不配位。

在之后的更新中,我不再会维护任何获取上游数据的工作,维护方向将偏重于 UI/UX 与使用体验,同时仍会低频率的响应 PR 与 Issues。如果版权方或其授权代表认为本项目涉及其合法权益,欢迎通过 GitHub 仓库留言联系。收到明确的权利方通知后,我会第一时间积极响应,并根据对方诉求立即归档项目或将仓库转为私有,停止公开访问。

HGhub

黄果短剧第三方客户端 · Rust + Tauri 2

Windows / macOS / Android 三端 · Fluent 设计 · 沉浸式竖屏播放

⚠️ 本项目仅供 学习与技术交流,不提供、不存储、不分发任何音视频内容。 所有内容均来自第三方站点,版权归原作者与上游站点所有。

使用须知

  • 以访客身份正常使用:像普通访客一样浏览就好,请勿滥用本项目。
  • 不要给上游增加压力:本项目本身不提供下载功能,请勿改动代码去做批量下载 / 批量抓取,也不要高频轮询、并发轰炸接口或挂机刷播放量;内置的封面与播放列表缓存请不要改小或关掉。
  • 尊重上游版权:不要去除水印与站点标识,不要把剧集搬运、转码、修改后二次分发到别处(网盘、资源站、其他 App 等),更不能改完拿出去出售。
  • 不要公开传播接口与直链:接口地址、播放直链、解密方式请勿公开张贴或打包成「资源站」——上游一旦封禁,所有人都没法再用。
  • 不要商业化:禁止打包出售、接入广告 / 会员 / 付费点播,或作为收费服务的一部分分发(详见 LICENSE)。
  • 合理使用:仅供个人学习、研究与自用;请在 24 小时内删除相关资源,并支持正版。
  • 遵守当地法律:使用者应自行判断并承担合规责任。

⚖️ 许可证自 v1.1.0 版本起改为 PolyForm Noncommercial 1.0.0:禁止任何商业用途—— 包括打包出售、接入付费/会员/广告变现、作为收费产品或服务的一部分分发。 个人学习、研究、自用与非营利使用不受限制,详见 LICENSE。

官方渠道与仿冒提醒

  • 唯一官方仓库:github.com/Minireel/HGhub
  • 唯一下载渠道:GitHub Releases。仓库源码页不放任何可执行文件, 其余网站、网盘、QQ 群、公众号、第三方下载站分发的「HGhub」安装包一律非官方,作者不保证其安全性与完整性。

🚫 已发现的恶意修改版:hichuv/HGhub

该仓库与本项目无关,是在旧版本源码基础上擅自加入卡密验证、VIP 付费解锁等变现功能的修改版, 代码改动不透明、安全性无法验证。请勿下载、勿注册、勿付费;如已安装,建议立即卸载,改用官方 Release 包安装。

本项目从未、也不会加入任何卡密 / VIP / 付费解锁 / 广告功能。如果你遇到的「HGhub」要求输入卡密或付费开通,那一定不是官方版本。

技术栈

层 选型
壳 Tauri 2(Rust 1.90+)
前端 React 19 + TypeScript + Vite 7 + Tailwind CSS 4
播放 hls.js(HLS / AES-128)
网络 reqwest + rustls

目录

.
├─ src/                      前端
│  ├─ api.ts                 接口封装 + 本地媒体协议 URL
│  ├─ store.tsx              全局状态(导航栈 / 用户 / 本地收藏 / 主题)
│  ├─ html.ts                吃瓜正文清洗与图片代理
│  ├─ components/            Feed(播放页)/ VideoSurface / PlayerControls / Panels / UI
│  └─ pages/                 Home / Search / Category / Profile / Posts
├─ src-tauri/                Rust 后端
│  └─ src/
│     ├─ net.rs              请求层(边缘信封 + 重试)
│     ├─ api.rs              业务命令
│     ├─ media.rs            封面解密 + HLS 代理 + 缓存
│     └─ session.rs          token 持久化
└─ docs/API.md               接口文档

开发 / 构建

pnpm install          # 首次安装
pnpm app:dev          # 桌面端热重载
pnpm app:build        # 打包:Windows → NSIS 安装程序;macOS → .app + .dmg

macOS 先装 Xcode Command Line Tools(xcode-select --install),打包目标写在 src-tauri/tauri.macos.conf.json(app + dmg,窗口用系统标题栏 Overlay)。

Android(需 Android SDK + NDK,并配置 ANDROID_HOME / NDK_HOME):

pnpm android:init     # 首次生成 android 工程
pnpm android:dev      # 真机 / 模拟器调试
pnpm android:build    # 产出 APK

iOS(需 Xcode、xcodegen、CocoaPods 与 Apple 开发者账号;自行签名安装到自己的设备):

export APPLE_DEVELOPMENT_TEAM=<你的 Team ID>
pnpm tauri ios init --ci                          # 首次生成 Xcode 工程(src-tauri/gen/apple)
pnpm tauri ios build --export-method debugging    # 产出 src-tauri/gen/apple/build/arm64/HGhub.ipa
xcrun devicectl device install app --device <UDID> <解压后的 Payload/HGhub.app>

最低系统版本写在 src-tauri/tauri.ios.conf.json(iOS 15)。iOS 复用安卓的触屏界面;自定义协议与 macOS 相同,为 hg://localhost。

环境注意

  • 工程若放在 exFAT 盘(不支持符号链接),需保留 .npmrc 中的 node-linker=hoisted。
  • pnpm 10 靠 package.json 的 pnpm.onlyBuiltDependencies 放行 esbuild,否则 vite build 缺少二进制; pnpm 11 起该字段失效,白名单改在 pnpm-workspace.yaml 的 allowBuilds(两处都保留)。

实现要点

「设置 → 播放 → 启动时静音」默认开启,每次启动应用均静音,播放时可手动开启声音。关闭此选项后,下次启动恢复上次的静音状态;音量仍会记忆。

安全加固后的正文处理、FakeIP/内网限制、账号线路隔离及本地回归方法,见 客户端内容与网络安全。镜像线路仅支持游客浏览,跨站点切换和首次升级后需要重新登录。

Mihomo 与 sing-box 分流规则、已知域名统计及导入方法,见 网络分流规则。

  1. 统一边缘信封:站点把 /api/** 收敛为 POST /api/edge/request(method/path/body(base64)/content_type + Authorization: Bearer),本项目只对接这一个入口,无需处理 Cookie。
  2. 封面解密:封面为 AES-128-CBC 密文,Rust 侧解密后经自定义协议输出,前端 <img> 直接使用。
  3. HLS 代理:m3u8 与分片经自定义协议转发并改写 #EXT-X-KEY / 分片地址,绕开 WebView 的 CORS 与防盗链。
  4. 自定义协议:Windows / Android 为 http://hg.localhost/*,macOS 为 hg://localhost/*(Tauri 的平台差异)。 Rust 侧 lib.rs 与前端 api.ts 各自按平台生成一次基址,两处必须一致,否则封面与视频全部加载失败。
  5. 不做签名逆向:只复用浏览器同源行为,接口字段均有文档与实测样本。

免责声明

  • 本项目与内容提供方无任何关联,作者不参与内容的制作、上传与分发。
  • 本项目仅在上述官方渠道发布;任何第三方修改版(尤其是加卡密、VIP 变现的版本)均与作者无关,请自行甄别。
  • 使用者应自行遵守所在地法律法规;因使用本项目产生的任何后果由使用者自行承担。
  • 若相关权利方认为本项目存在侵权,请通过 Issue 联系,我们会及时处理。

License

PolyForm Noncommercial License 1.0.0 —— 仅限非商业用途。

  • 允许:个人学习、研究、自用、爱好项目,以及在非营利组织内部使用;可以自由修改、二次开发。
  • 禁止:任何商业用途。包括但不限于打包出售、接入付费/会员/广告变现、作为收费服务或商业产品的一部分分发。
  • 保留声明:分发本项目或其修改版时,必须附带本许可证全文(或上面的链接)以及 Required Notice 声明行。
  • 商业授权请通过 Issue 联系作者单独洽谈。

历史说明:v1.0.1 及更早版本以 MIT 发布,已发出的副本继续按 MIT 授权;自 v1.1.0 起的新版本一律适用 PolyForm Noncommercial 1.0.0。

常见问题

1. pnpm install 报 ERR_PNPM_EISDIR ... symlink

工程放在 exFAT / FAT32 盘时无法创建符号链接,保留 .npmrc 里的 node-linker=hoisted 即可。

2. tauri android build 报 Failed to create a symbolic link ... jniLibs

同样是 exFAT 不支持符号链接。可手动把 Rust 产物拷进 jniLibs,再直接跑 Gradle:

cp src-tauri/target/aarch64-linux-android/debug/libhuangguo_client_lib.so \
   src-tauri/gen/android/app/src/main/jniLibs/arm64-v8a/

cd src-tauri/gen/android
./gradlew assembleDebug        # Windows: gradlew.bat assembleDebug

产物在 src-tauri/gen/android/app/build/outputs/apk/。

3. Android 构建提示找不到 SDK / NDK

需要设置 ANDROID_HOME(Android SDK 根目录)、NDK_HOME($ANDROID_HOME/ndk/<版本>)与 JAVA_HOME(JDK 17)。

4. macOS 打开时提示「已损坏」或「无法验证开发者」

Release 里的 dmg 没有用 Apple 开发者证书签名和公证,从网上下载后会被 Gatekeeper 拦下。 把 HGhub 拖进「应用程序」后,在终端执行一次:

xattr -cr /Applications/HGhub.app

LinuxDO

https://linux.do/