Zwift 私服接入说明

看完照着做就行,全程大概 15 分钟。有卡住的地方直接找群主。

配置需要的地址都已经写进 hosts.txt 里,你不用手抄任何东西, 按下面各节的步骤做即可。
开始之前先看这里:所有要下载的东西都在接入站 cfcc.houseclient.top 上,直接开浏览器就行,不用再找人要文件。
Windows 用户下 client-发给小伙伴.zip(里面带安装器), 安卓用户下两个补丁工具 apk + hosts.txt。详细清单见下面各节。

注意 Zwift 安装器只是安装器,首次启动还会下载几个 G 的游戏资源,这是正常的。
先说结论:Android 手机和电脑可以直接连。iPhone / iPad 目前连不了, 因为苹果不允许替换 App 内的证书文件,除非越狱 —— 官方也明确不做支持。用 iPhone 的话, 请改用电脑(Windows / macOS)加入。

一、Android 手机

为什么下载站上不给安卓游戏安装包:Zwift 安卓版由 Google Play 分发, 安装包是「APK 43 MB + 资源包 OBB 1.7 GB」的配对结构,光装 APK 跑不起来, 而 1.7 GB 的资源包也不适合在下载站上分发。

所以安卓的做法是:Zwift 本体自己在 Google Play 装,装完之后用工具在手机上就地打补丁。 需要从 cfcc.houseclient.top 下的是下面那两个补丁工具,都很小。

先确认你的手机满足条件:Android 9.0 以上、arm64 架构、3GB 以上内存、4GB 以上空闲空间。 装不了 Google Play 版 Zwift 的手机基本都是不兼容的机型。

需要准备的文件

文件从哪来
Zwift Google Play 搜索安装
装完先别打开
ZofflineObb-1.4.apk 接入站 cfcc.houseclient.top → 安卓区下载
VirtualHosts-2.1.0.apk 接入站 cfcc.houseclient.top → 安卓区下载
hosts.txt 接入站首页下载,里面已经填好了服务器 IP,不要改

操作步骤

  1. 从 Google Play 装 Zwift,装完不要打开。 如果你已经打开过了,去「设置 → 应用 → Zwift → 存储 → 清除数据」,或者卸载重装。
  2. 安装 ZofflineObb.apkVirtual-Hosts.apk(允许安装未知来源应用)。
  3. hosts.txt 放到手机里好找的位置,比如「下载」目录。
  4. 关闭私人 DNS:
    「设置 → 网络和互联网 → 私人 DNS → 关闭」(不同品牌路径略有差异, 或直接设置里搜索「私人 DNS」)。
  5. 打开 Virtual Hosts,选择刚才那个 hosts.txt,把开关拨到 ON。 如果它提示要联网验证,允许即可。
  6. 打开 ZofflineObb,允许访问存储,点开始。 它会花 5~10 分钟给 Zwift 打补丁,别中途退出。
  7. 打开 Zwift。用任意邮箱和密码注册一个新账号 —— 这个账号只存在于我们的私服里,跟 Zwift 官方没关系,随便填。
每次玩之前:确认 Virtual Hosts 的开关是 ON
Zwift 每次更新之后:要重新跑一次 ZofflineObb,否则会连不上。
Android 15 及以上的手机,ZofflineObb 打不了补丁 —— 官方给的绕过办法是在电脑上 给 OBB 打完补丁再传回手机(见上游 issue #505)。嫌麻烦的话,直接用电脑玩。

二、Windows 电脑

第 0 步:先装 Zwift,并让它把资源下完。 直接双击从接入站下的 ZwiftSetup.exe 安装(想装最新版也可以去 zwift.com/download 下)。装完正常启动一次, 等到它把游戏资源下载完、出现登录界面为止。这一步先不要动 hosts

为什么先在没配私服的状态下启动?首次安装要下好几个 G 的资源, 直连官方 CDN 比绕服务器中转快得多,也省服务器带宽。 如果你访问 zwift.com 实在太慢,可以跳过这步直接做第 1 步,资源会走私服回源,只是慢一些。
  1. 确认 Zwift 完全退出(右下角托盘图标右键 → 退出 Zwift)。
  2. 双击 configure_client.bat,弹 UAC 就点「是」。 它自动完成三件事:改 hosts、把证书装进系统信任区、把证书追加到 Zwift 的 cacert.pem
  3. 看到「请按任意键继续」就说明好了,按一下关掉窗口。
  4. 启动 Zwift,注册一个账号(同样随便填)。
脚本会自动找 Zwift 安装目录。如果它弹出一个选择文件夹的对话框, 就选 C:\Program Files (x86)\Zwift

三、macOS

和 Windows 一样,先从 zwift.com/download 装好客户端、正常启动一次 让资源下载完,再退出做下面的配置。

  1. 双击 cert-zwift-com.pem 导入「钥匙串访问」, 把它放进「系统」钥匙串,然后右键该证书 → 显示简介 → 信任 → 设为「始终信任」。
  2. 打开终端,cd 到存放证书和 hosts.txt 的目录,执行:
sed -n '29,53p' cert-zwift-com.pem >> ~/Library/Application\ Support/Zwift/data/cacert.pem
  1. 把这些域名重定向规则追加进 /etc/hosts(需要管理员权限)—— 规则内容就在下载的 hosts.txt 里:
sudo tee -a /etc/hosts < hosts.txt
  1. 启动 Zwift,注册账号。

四、连不上怎么办

现象怎么查
卡在登录界面 先确认 hosts 改对了(Android 看 Virtual Hosts 开关,PC 看 hosts 文件), 再确认手机/电脑和服务器之间网络通。
提示证书错误 / 一直转圈 证书没生效。Android 重跑 ZofflineObb;Windows 重跑 configure_client.bat
能登录但看不到其他人 想一起骑需要选同一张地图、同一路线。进游戏前在群里对一下。
Zwift 提示要更新 先别更新。等群主确认服务器跟上了新版本再动,否则连不上。

五、玩之前的两条约定