# douduo **Repository Path**: remon8/douduo ## Basic Information - **Project Name**: douduo - **Description**: 非官方抖音客户端,适配 iPhone Duo / iPad。下载未签名IPA,用爱思助手→工具箱→IPA签名→Apple ID签名后安装;免费签名7天到期需重签。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 9 - **Forks**: 0 - **Created**: 2026-11-09 - **Last Updated**: 2026-11-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
原生 SwiftUI 的第三方抖音客户端,适配 iPhone Duo 折叠屏、iPad 与普通 iPhone。开源免费,非官方。
> ⭐ **点个 Star,再关注 [@81199000](https://github.com/81199000),避免走失。** 官网 **[oneduo.app](https://oneduo.app)** 是长期固定入口,以后仓库再搬家也能从官网找到。 官方抖音 App 在折叠屏内屏、iPad 上不适配,网页版又总是跳 App,所以有了它。界面和播放全部原生(SwiftUI + AVPlayer,VLC 兜底)。  示意图(自绘,非实机截图),画面内容为抽象插画,不含真实用户作品。 ## 功能 **看视频** - 推荐 / 关注 / 直播,整页上下滑;**秒开**(先播上次缓存的视频)+ 后台**预缓存**后面若干条 - 四种界面,「更多 → 设置 → 界面模式」切换:**默认 / 简洁 / 极简**(极简只剩视频,进度画在右侧圆形入口外圈),以及 iPhone Duo 可选的**经典**布局(iOS 27.1+,[说明](docs/classic-duo-layout.md))。四种界面共用同一套交互,维护规矩见 [docs/ui-modes.md](docs/ui-modes.md) - 横滑快进快退(带预览)、双击点赞、长按加速、倍速选档、自动连播、后台播放与锁屏控制 - 实时环境光:视频没铺满时四周跟随画面颜色,黑底,亮 / 中 / 暗 / 很暗 / 关五档 - 折叠屏:半折叠按折痕分屏(视频 / 评论)、横屏搜索左右分栏;自动铺满可关 - `#话题` 点击直接搜索;推荐页可按标签屏蔽不想看的内容 **互动**(需在 App 内登录抖音) - 点赞、收藏、评论 / 回复(表情、@ 用户、配图)、弹幕显示与发送 - 消息中心与私信、原生「分享给」好友 - 直播:原生播放(VLC 解 HEVC)、直播间聊天与发言、关注主播开播条、画质选档 **我的** - 搜索(联想词、热搜、历史)、喜欢 / 收藏 / 观看历史 / 稍后再看、作者主页与作品列表 - 保存视频 / 图集到相册 每个版本的改动见 [更新说明](docs/releases/) 或 [发行版](https://github.com/81199000/DouDuo/releases)(国内镜像 [Gitee](https://gitee.com/remon8/douduo/releases))。 ## 下载安装 支持 iOS / iPadOS **26.0 及以上**。DouDuo 未上架 App Store,安装包是**未签名 IPA**,需要签名后安装。两种方式: | | 方式一:一键签(推荐) | 方式二:全能签 + 软件源 | | --- | --- | --- | | 花钱吗 | 免费(用自己的 Apple ID) | 要买证书 | | 要电脑吗 | 要(Windows / Mac) | 不要,全程在手机上 | | 有效期 | 7 天,**自动续签** | 跟证书走,一般 1 年 | | 更新新版 | 自动装上 | 软件源里点一下,签名安装 | ### 方式一:一键签(免费,自动续签) 1. 到官网 **[oneduo.app](https://oneduo.app)** 下载 [一键签](https://oneduo.app/#download)(Windows / Mac) 2. 数据线连手机,在一键签里选 **DouDuo**,点 **一键安装** 3. 手机上 **设置 → 通用 → VPN 与设备管理** 信任你的 Apple ID 详细步骤见 [一键签使用教程](https://github.com/81199000/OneDuo#使用教程)。 > 更新也在一键签里完成:有新版会自动装上,登录状态和观看记录会保留。 ### 方式二:全能签 + DouDuo 软件源(手机上安装和更新) [全能签](https://sign.drnrt8.cn/sign/)是手机上的签名工具:导入证书后,在 App 里就能下载、签名、安装,**不用电脑**。 > **全能签本身免费,但必须有证书才能用。** 顺序是「先有证书 → 再装全能签」。 #### 1. 买证书 两种渠道:**全能签官网买兑换码**(证书和全能签一起装好,适合新手),或 **淘宝 / 闲鱼买证书**(便宜些,拿到 `.p12` + `.mobileprovision` + 密码)。 买之前先拿到手机的 **UDID**:用 **Safari** 打开 [全能签官网](https://sign.drnrt8.cn/sign/) 点「获取 UDID」,按提示安装描述文件。  图片来自[全能签官网](https://sign.drnrt8.cn/sign/)安装页教程。 #### 2. 安装全能签 - **兑换码**:在 [全能签官网](https://sign.drnrt8.cn/sign/) 输入兑换码 →「立即安装」。 - **自己的证书**:在官网点「我有证书 | 自助安装」,上传 `.p12` 和 `.mobileprovision`,填密码 →「签名安装」。 装好后在 **设置 → 通用 → VPN 与设备管理** 信任证书;再打开 **设置 → 隐私与安全性 → 开发者模式**,按提示重启。  图片来自[全能签官网](https://sign.drnrt8.cn/sign/)安装页教程。 #### 3. 把证书导入全能签 全能签 → **设置 → 导入文件**,选 `.p12` 和 `.mobileprovision`(或证书 zip 包),输入密码。在 **证书** 页看到状态有效即可。 #### 4. 添加软件源,签名安装 全能签 → **资源 → 软件源** → 右上角添加: | 软件源 | 地址 | | --- | --- | | 官方源(推荐) | `https://dl.oneduo.app/douduo/douduo.json` | | 备用(Gitee) | `https://gitee.com/remon8/douduo/raw/main/docs/source/douduo.json` | > 以前加过 Gitee 源的不用改,两个源内容一样;新加的请用官方源。 在源里点 DouDuo → 下载 → **资源 → App** 里点它 → **签名** → **安装**。以后有新版,在源里下拉刷新再装一次,会覆盖旧版,登录状态保留。 > ⚠️ 买来的证书可能被苹果吊销(「掉签」),掉签后 App 打不开,只能换证书重签。买之前问清楚掉签补不补。不要用网上流传的免费 / 共享证书。 ## 首次使用:登录抖音 没登录时点「我的」会自动弹出 App 内登录页(也可以在「我的」点「去登录」)。**只有一台手机请用「验证码登录」**:输入手机号 → 获取验证码 → 登录。「扫码登录」必须拿**另一台**已登录抖音的手机对着屏幕扫,截图后在抖音里从相册选图扫是不认的。登录后推荐流按你的账号个性化,点赞、收藏、评论、弹幕会同步到你的抖音账号。 不登录也能看推荐、搜索、直播。登录信息只保存在手机本地,不经过任何第三方服务器。 ## 常见问题 - **打开就闪退**:签名过期了。一键签:点「立即全部续签」;全能签:看证书是否失效(掉签),换证书重签。 - **提示「抖音拦截了请求」/ 一直加载**:点菜单 →「网页版 / 登录」,在网页里刷一下(必要时过一下滑块验证),返回后会自动重试。 - **视频黑屏或卡住**:App 会自动重试,并切换到 VLC 内核兜底;仍不行就下滑到下一条。 - **占用空间大**:「更多 → 设置 → 缓存」把预缓存数量调小或关闭,或者点「清除视频缓存」。用流量刷时建议关掉预缓存。 ## 已知限制 - **搜索只有第一页**:抖音网页接口翻第二页会被安全 SDK 拦下,目前没有办法翻页。 - **图文作品偶尔没有背景音乐**。 - **经典布局**只在 iOS 27.1 及以上显示,仅针对 iPhone Duo 适配;iPad、画中画尚未完整实测。 - 抖音风控时可能要去「网页版」过一下验证;抖音网页接口改版时需要跟着更新。 欢迎在 [GitHub](https://github.com/81199000/DouDuo/issues) 提 Issue / PR(国内也可以在 [Gitee](https://gitee.com/remon8/douduo/issues) 提)。 ## 原理 没有逆向抖音 App,也不需要任何密钥:App 里挂着一个**看不见的抖音网页**(电脑版 UA),所有接口请求都在这个页面里发出,由抖音网页自己的安全 SDK 自动补签名(`a_bogus` 等),所以签名算法跟着官方更新走。普通视频用 `AVPlayer`,起不来时自动切 VLC;直播流是 HEVC + MPEG‑TS,一律用 VLC。登录态和「网页版」共用 `WKWebsiteDataStore.default()`,只存在本机。 已接入的接口清单见 [docs/api-inventory.md](docs/api-inventory.md);维护者发版流程见 [docs/RELEASING.md](docs/RELEASING.md)。 ## 免责声明 > 本声明说明项目意图与边界,**不构成法律意见,也不能免除法律责任**;它不能替代权利人的授权。 - **非官方、无授权**:本项目是个人学习与技术研究用的第三方客户端,与抖音、北京微播视界科技有限公司及其关联公司**没有任何隶属、合作或授权关系**。「抖音」等名称、商标、图标归其权利人所有,本项目仅作描述性提及,不把官方标识当作自己的品牌,也不代表官方立场。 - **不提供、不存储、不分发内容**:App 只在你自己的设备上展示通过抖音网页接口获取的内容,不搭建内容服务、不缓存分发、不提供下载。视频、图片、音乐、评论、直播流的版权归原作者与平台所有。 - **账号与使用责任**:使用本项目需要你自己的抖音账号登录。请自行遵守《抖音用户服务协议》和所在地法律;**禁止**用于商业用途、批量抓取、刷量、绕过付费或权限、二次分发,以及其他侵害他人权益的行为。账号被限制、数据丢失、设备异常等后果由使用者自行承担。 - **不绕过付费与权限**:本项目不提供会员内容、付费内容、私密内容的解锁能力,也不修改平台返回的权限结果。 - **签名与分发**:仓库和软件源只提供**未签名 IPA**,由使用者用 [一键签](https://oneduo.app)(自己的 Apple ID)或自备证书签名安装。本项目**不出售、不提供任何证书**,与全能签及各证书卖家无合作关系;证书来源、掉签等风险由使用者自行判断。请勿分发已签名安装包。 - **无担保**:软件按「现状」提供,不保证可用性、稳定性、合规性或适用于特定目的;平台接口改版或风控可能导致功能随时失效。 - **侵权处理**:如权利人认为本项目侵犯其权益,请通过 Issue 或仓库公开的联系方式告知,核实后会删除相关内容或停止分发。 - **地区差异**:不同国家和地区对第三方客户端、逆向与接口调用的规定不同;如当地法律禁止,请不要使用或分发本项目。 ## License [MIT](LICENSE)