zwift offline下载 - zwift offline源码下载

zwift offline

其他源码

zoffline for Zwift 1.0.136426

下载

佐离线

zoffline 通过充当 Zwift 服务器的部分实现来支持离线使用 Zwift。默认情况下，zoffline 仅适用于单个玩家。请参阅步骤 6：启用多人游戏，了解如何启用对多个用户/配置文件的支持。

zoffline 还提供对抗幽灵的骑行（您之前的骑行）。通过在 zoffline 启动器中选中“启用幽灵”来启用此功能。有关更多详细信息，请参阅幽灵和机器人。

此外，zoffline 的启动器允许选择要骑行的特定地图，而无需修改配置文件。

安装

设置 zoffline 需要两个主要步骤。首先，必须在运行 Zwift 之前在系统上安装并运行 zoffline（无论是在运行 Zwift 的系统上还是在另一个本地联网系统上）。其次，必须将 Zwift 配置为使用 zoffline 而不是官方 Zwift 服务器。

第1步：安装zoffline

根据您的平台，可以通过三种方式安装和运行 zoffline：

最简单（仅限 Windows）

要在 Windows 上安装 zoffline：

从 https://github.com/zoffline/zwift-offline/releases/latest 下载最新的 zoffline 版本
- 如果您需要RoboPacers，请下载源代码包并将pace_partners目录解压到zoffline所在的同一文件夹中。
如果您没有在运行 Zwift 的同一台 PC 上运行 zoffline：在storage目录中创建一个server-ip.txt文件，其中包含运行 zoffline 的 PC 的 IP 地址。
运行下载的 zoffline.exe
- 运行后，zoffline 将在其所在文件夹中创建一个storage目录来存储您的 Zwift 进度。
运行 zoffline.exe 启动 Zwift（完成步骤 2或从 https://github.com/oldnapalm/zoffline-helper/releases/latest 运行configure_client脚本后）
- zoffline 需要几秒钟才能启动。等待命令提示符中出现文本，然后再打开 Zwift。
使用 Zwift 完成后，在命令行中按 Ctrl+C 关闭 zoffline。

Linux、Windows 或 macOS（来自源代码）

要在 Linux、Windows 或 macOS 上安装 zoffline：

如果尚未安装，请安装 Python 3 (https://www.python.org/downloads/)
- 在 Windows 上，强烈建议通过 Microsoft Store 安装 Python！如果使用 Python 安装程序，请确保在第一个 Python 安装程序屏幕中选中“将 Python 3.x 添加到 PATH”。
克隆或下载此存储库
安装依赖项
- 例如，在 Linux/Mac 上： pip3 install -r requirements.txt
- 例如，在 Windows 上的命令提示符中： pip install -r requirements.txt
  - 您可能需要使用C:UsersAppDataLocalProgramsPythonPythonScriptspip.exe而不仅仅是pip
如果您没有在运行 Zwift 的同一台 PC 上运行 zoffline：在storage目录中创建一个server-ip.txt文件，其中包含运行 zoffline 的 PC 的 IP 地址。
在启动 Zwift 之前运行standalone.py
- 例如，在 Linux/Mac 上： sudo ./standalone.py
  - 需要 sudo 是因为我们要绑定到特权端口 80 和 443。
  - 如果 Python 3 不是您的系统默认运行sudo python3 standalone.py
- 例如，在 Windows 上的命令提示符中： python standalone.py
  - 您可能需要使用C:UsersAppDataLocalProgramsPythonPythonpython.exe而不仅仅是python
启动 Zwift 并运行standalone.py（完成步骤 2 后）
注意：升级zoffline时，一定要保留storage目录。它包含您的 Zwift 进度状态。

zoffline 可以安装在与 Zwift 相同的计算机上或另一台本地计算机上。

使用 Docker

安装 Docker
使用以下命令创建 docker 容器：
docker create --name zwift-offline -p 443:443 -p 80:80 -p 3024:3024/udp -p 3025:3025 -p 53:53/udp -v :/usr/src/app/zwift-offline/storage -e TZ= zoffline/zoffline
- 如果您不关心 Zwift 进度状态是否在 zoffline 更新中保留（不太可能），您可以选择排除-v :/usr/src/app/zwift-offline/storage
- 您传递给-v路径可能需要是全局可读和可写的。
- 可以在此处找到有效值（例如 America/New_York）的列表。
- 如果您有 Docker v1.9.0 或更高版本，添加--restart unless-stopped将使 zoffline 在启动时启动。
如果您没有在运行 Zwift 的同一台 PC 上运行 zoffline：在目录中创建一个server-ip.txt文件，其中包含运行 zoffline 的 PC 的 IP 地址。
启动 zoffline： docker start zwift-offline

使用 Docker 组合

安装 docker-compose

可以使用此存储库中的docker-compose.yml文件（该文件将从 Dockerfile 构建），也可以使用以下示例撰写文件：

 version: "3.3"
services:
   zoffline:
        image: zoffline/zoffline:latest
        container_name: zoffline
        environment:
           - TZ=Europe/London
        volumes:
           - ./storage/:/usr/src/app/zwift-offline/storage
        ports:
           - 80:80
           - 443:443
           - 3024:3024/udp
           - 3025:3025
        restart: unless-stopped

如果您没有在运行 Zwift 的同一台 PC 上运行 zoffline：在storage目录中创建一个server-ip.txt文件，其中包含运行 zoffline 的 PC 的 IP 地址。
启动 zoffline： docker-compose up -d

步骤 2：配置 Zwift 客户端以使用 zoffline

Windows 说明

安装 Zwift
- 如果您的 Zwift 版本是 1.0.136426，则一切就绪。
- 如果未安装 Zwift，请在安装 zoffline 之前安装它。
- 如果您的 Zwift 版本高于 1.0.136426 并且 zoffline 从源运行：将C:Program Files (x86)ZwiftZwift_ver_cur.xml复制到 zoffline 的cdn/gameassets/Zwift_Updates_Root/覆盖现有文件。
- 如果您的 Zwift 版本高于 1.0.136426 并且 zoffline 未从源运行：等待 zoffline 更新。
注意：您可以直接从 https://github.com/oldnapalm/zoffline-helper/releases/latest 运行configure_client脚本，而不是执行以下步骤
在运行 Zwift 的 Windows 计算机上，将此存储库中的以下文件复制到已知位置：
- ssl/cert-zwift-com.p12
- ssl/cert-zwift-com.pem
以管理员身份打开命令提示符，cd 到该位置并运行
- certutil.exe -importpfx Root cert-zwift-com.p12
- 如果系统提示您输入密码，请将其留空。没有密码。
以管理员身份打开记事本并打开C:Program Files (x86)Zwiftdatacacert.pem
- 将ssl/cert-zwift-com.pem的内容附加到 cacert.pem
以管理员身份打开记事本并打开C:WindowsSystem32Driversetchosts
- 附加此行： us-or-rly101.zwift.com secure.zwift.com cdn.zwift.com launcher.zwift.com
  （其中是运行 zoffline 的计算机的 IP 地址。如果它与 Zwift 在同一台计算机上运行，请使用127.0.0.1作为 IP。）
如果您希望保持hosts文件不变，除非专门使用 zoffline，您可以选择使用scripts目录中的launch.bat脚本来启动 zoffline，而不是使用普通的 Zwift 启动器。有关详细信息，请参阅#121。

原因：我们需要重定向 Zwift 以使用 zoffline，并说服 Windows 和 Zwift 接受 zoffline 对 Zwift 域名的自签名证书。请随意生成您自己的证书并执行相同的操作。

macOS 说明

安装 Zwift
- 如果您的 Zwift 版本是 1.0.136426，则一切就绪。
- 如果未安装 Zwift，请在安装 zoffline 之前安装它。
- 如果您的 Zwift 版本高于 1.0.136426：将~/Library/Application Support/Zwift/ZwiftMac_ver_cur.xml复制到 zoffline 的cdn/gameassets/Zwift_Updates_Root/覆盖现有文件。
在运行 Zwift 的 Mac 计算机上，将此存储库中的文件 ssl/cert-zwift-com.pem 复制到已知位置。
打开钥匙串访问，在“钥匙串”下选择“系统”，在“类别”下选择“证书”
- 单击“文件 - 导入项目...”并导入 cert-zwift-com.pem
- 右键单击“*.zwift.com”，选择“获取信息”，然后在“信任”下选择“使用此证书时：始终信任”。
从 cert-zwift-com.pem 位置运行sed -n '29,53p' cert-zwift-com.pem >> ~/Library/Application Support/Zwift/data/cacert.pem
使用文本编辑器（具有管理员权限）打开/etc/hosts
- 附加此行： us-or-rly101.zwift.com secure.zwift.com cdn.zwift.com launcher.zwift.com
  （其中是运行 zoffline 的计算机的 IP 地址。如果它与 Zwift 在同一台计算机上运行，请使用127.0.0.1作为 IP。）

原因：我们需要重定向 Zwift 以使用 zoffline，并说服 macOS 和 Zwift 接受 Zoffline 对 Zwift 域名的自签名证书。请随意生成您自己的证书并执行相同的操作。

Android（非 root 设备）

安装所需的应用程序：
- 从这里下载并安装ZofflineObb.apk
- 从这里下载并安装app-Github-release.apk
- 创建一个与应用程序一起使用的hosts.txt文件（您可以使用文本编辑器应用程序或使用此类在线工具在线创建它）。该文件必须如下所示（将替换为运行 zoffline 的计算机的 IP 地址）：
```
  us-or-rly101.zwift.com
 secure.zwift.com
 cdn.zwift.com
```
- 在 Android 设置中关闭“私人 DNS”
- 运行“虚拟主机”并选择创建的hosts.txt文件
- 或者，您可以在storage目录中创建一个fake-dns.txt文件，并将手机 Wi-Fi 连接的“DNS 1”设置为运行 zoffline 的 PC 的 IP 地址，而不是使用“虚拟主机”应用程序
- 注意：如果您知道自己在做什么并且拥有足够强大的路由器，则可以调整路由器来更改这些 DNS 记录，而不是使用“虚拟主机”应用程序或更改手机 DNS。
每次安装或更新后打补丁：
- 从 Google play 安装/更新 Zwift，但不要启动它。
  - 如果您已经启动，请转至Android Settings > Applications > Zwift并清除数据或卸载并重新安装该应用程序。
- 打开ZofflineObb应用程序并运行它（允许访问存储）
- 等待过程完成（5-10 分钟）
- 运行 Zwift，希望它能验证下载并运行
玩Zwift：
- 虚拟主机按钮必须打开
- 启动 Zwift 并使用任何电子邮件/密码登录或创建新用户（如果启用了多人游戏）。

原因：我们需要重定向 Zwift 以使用 zoffline（这是由虚拟主机应用程序完成的），并说服 Zwift 接受 zoffline 的 Zwift 域名自签名证书（这是由补丁工具 ZofflineObb 完成的）。

Android（已取得 root 权限的设备）

在设备上安装 Zwift
打开 Zwift 一次即可完成安装（即下载所有额外文件）。
将ssl/cert-zwift-com.pem的内容附加到设备上的/data/data/com.zwift.zwiftgame/dataES/cacert.pem
- 注意：此文件仅在首次运行 Zwift 后才会存在，因为它是在初始安装后下载的
- 如果您的设备没有文本编辑器，实现此目的的简单方法是：
  - adb push ssl/cert-zwift-com.pem /data/data/com.zwift.zwiftgame/dataES/
  - 在adb shell中： cd /data/data/com.zwift.zwiftgame/dataES/
  - 在adb shell中： cat cert-zwift-com.pem >> cacert.pem
  - 无论您如何操作，请确保文件的权限和所有权保持不变。
修改设备的/etc/hosts文件
- 附加此行： us-or-rly101.zwift.com secure.zwift.com cdn.zwift.com
  （其中是运行 zoffline 的计算机的 IP 地址。）
- 如果设备上没有文本编辑器，建议：
  - adb pull /etc/hosts
  - （PC端修改）
  - adb push hosts /etc/hosts
- 注意：如果您知道自己在做什么并且拥有足够强大的路由器，则可以调整路由器来更改这些 DNS 记录，而不是修改hosts文件。
启动 Zwift 并使用任何电子邮件/密码登录或创建新用户（如果启用了多人游戏）。

原因：我们需要重定向 Zwift 以使用 zoffline 并说服 Zwift 接受 Zoffline 的 Zwift 域名自签名证书。请随意生成您自己的证书并执行相同的操作。

启用/禁用 zoffline

要像平常一样在线使用 Zwift，请在启动 Zwift 之前注释掉或删除添加到hosts文件中的行。然后确保 Zwift 完全关闭（右键单击 Zwift 系统托盘图标并退出）并重新启动 Zwift。

步骤 3 [可选]：获取当前的 Zwift 配置文件

扩张

如果您在启用 zoffline 的情况下首次启动 Zwift 之前未获取当前的 Zwift 配置文件，系统将提示您创建新的配置文件（身高、体重、性别）。您的个人资料可以通过游戏菜单进一步定制和更改（例如姓名、国籍、体重变化等）。

要获取您当前的个人资料：

注意：您可以使用启动器窗口中的“设置 - Zwift”按钮（仅限 Windows 和 macOS），而不是执行以下步骤。
确保 zoffline 已禁用。
运行scripts/get_profile.py -u
- 或者，如果使用未安装 Python 的 Windows zoffline.exe 版本，您可以运行从 https://github.com/oldnapalm/zoffline-helper/releases/latest 获取的get_profile.exe代替scripts/get_profile.py
将生成的profile.bin 、 achievements.bin和economy_config.txt （保存在您运行 get_profile.py 的任何目录中）移动到storage/1目录中。
- 如果在 Windows 上使用 zoffline.exe，请在与 zoffline.exe 相同的文件夹中创建storage/1目录（如果该目录尚不存在）。
- 如果使用 Docker，目录1应位于您传递给-v路径中

第 4 步 [可选]：将活动上传到 Strava

扩张

从 https://www.strava.com/settings/api 获取 CLIENT_ID 和 CLIENT_SECRET
注意：您可以将 API 应用程序的授权回调域设置为launcher.zwift.com ，然后使用启动器窗口中的“设置 - Strava”按钮（仅限 Windows 和 macOS），而不是执行以下步骤。
运行scripts/strava_auth.py --client-id CLIENT_ID --client-secret CLIENT_SECRET
- 或者，如果使用未安装 Python 的 Windows zoffline.exe 版本，您可以运行从 https://github.com/oldnapalm/zoffline-helper/releases/latest 获取的strava_auth.exe来代替scripts/strava_auth.py
打开http://localhost:8000/并授权。
将生成的strava_token.txt （保存在运行strava_auth.py的任何目录中）移动到storage/1目录中。
如果测试，骑行至少300米，较短的活动将不会上传。
无法自动上传屏幕截图，请参阅#28 了解详细信息。

第 5 步 [可选]：将活动上传到 Garmin Connect

扩张

如果从源运行，请安装 garth： pip install garth
如果需要，请在包含域的storage目录中创建文件garmin_domain.txt
- 中国使用garmin.cn
注意：您可以使用启动器窗口中的“设置 - Garmin”按钮输入您的凭据（仅限 Windows 和 macOS），而不是执行以下步骤。
在storage/1目录中创建包含您的登录凭据的文件garmin_credentials.txt
```
 
```
- 注意：这并不安全。仅当您愿意将登录凭据存储在明文文件中时才执行此操作。
如果测试，骑行至少300米，较短的活动将不会上传。

第 6 步 [可选]：启用多人游戏

扩张

要启用对多个用户的支持，请执行以下步骤：

在storage目录中创建multiplayer.txt文件。
如果您没有在运行 Zwift 的同一台 PC 上运行 zoffline：在storage目录中创建一个server-ip.txt文件，其中包含运行 zoffline 的 PC 的 IP 地址。
- 如果远程运行，则需要在运行 zoffline 的 PC 上打开 TCP 端口 80、443、3025 和 UDP 端口 3024。
启动 Zwift 并创建一个帐户。
- 该帐户仅存在于您的 zoffline 服务器上，与您实际的 Zwift 帐户无关。

步骤 7 [可选]：安装 Zwift Companion 应用程序

Android（非 root 设备）

安装 apk-mitm (https://github.com/shroudedcode/apk-mitm)

打开apk-mitm/dist/tools/apktool.js （运行npm root -g找到它的位置）并像这样编辑它：

    decode ( inputPath , outputPath ) {
        return this . run ( [
            'decode' ,
            '-resm' , // add this
            'dummy' , // add this
            inputPath ,
            '--output' ,
            outputPath ,
            '--frame-path' ,
            this . options . frameworkPath ,
        ] , 'decoding' ) ;
    }

将此存储库中的文件 ssl/cert-zwift-com.pem 和 Zwift Companion apk（例如zca.apk ）复制到已知位置
打开命令提示符，cd 到该位置并运行
- apk-mitm --certificate cert-zwift-com.pem zca.apk
将zca-patched.apk复制到您的手机并安装
从这里下载并安装app-Github-release.apk
创建一个与应用程序一起使用的hosts.txt文件（您可以使用文本编辑器应用程序或使用此类在线工具在线创建它）。该文件必须如下所示（将替换为运行 zoffline 的计算机的 IP 地址）：
```
  us-or-rly101.zwift.com
 secure.zwift.com
```
- 重要提示：不要在hosts.txt中添加cdn.zwift.com ，Companion需要从官方服务器下载镜像
在 Android 设置中关闭“私人 DNS”
运行“虚拟主机”并选择创建的hosts.txt文件
或者，您可以在storage目录中创建一个fake-dns.txt文件，并将手机 Wi-Fi 连接的“DNS 1”设置为运行 zoffline 的 PC 的 IP 地址，而不是使用“虚拟主机”应用程序
注意：如果您知道自己在做什么并且拥有足够强大的路由器，则可以调整路由器来更改这些 DNS 记录，而不是使用“虚拟主机”应用程序或更改手机 DNS。

额外的可选步骤

扩张

要从 Zwift 服务器获取官方地图时间表和更新文件：在storage目录中创建cdn-proxy.txt文件。仅当您在与 Zwift 客户端不同的计算机上运行 zoffline 时，这才有效。
- 如果禁用此选项，zoffline 将尝试使用 Google 公共 DNS 进行代理来解析 Zwift 主机名，即使 zoffline 与 Zwift 客户端在同一台计算机上运行，这也应该可以工作。为了避免这种情况，请在storage目录中创建一个disable_proxy.txt文件。
要在启用多人游戏时启用密码重置功能：在storage目录中创建一个gmail_credentials.txt文件，其中包含 Gmail 帐户的登录凭据。您需要访问 https://security.google.com/settings/security/apppasswords 并创建应用程序密码以允许从服务器登录。
要启用 Discord 桥接机器人： pip3 install discord.py并在storage目录中创建一个包含以下内容的discord.cfg文件：
```
 [discord]
token = 
webhook = 
channel = 
welcome_message = 
help_message = 
```
如果 Zwift 客户端在连接到 Linux 服务器时遇到问题（“请求已中止：无法创建 SSL/TLS 安全通道。”或“底层连接已关闭：发送时发生意外错误。收到意外的 EOF 或传输流中的 0 个字节。")：将 /etc/ssl/openssl.cnf 中的 MinProtocol 更改为 TLSv1.0
```
 [system_default_sect]
MinProtocol = TLSv1.0
CipherString = DEFAULT@SECLEVEL=1
```

幽灵和机器人

扩张

鬼魂

通过在 zoffline 启动器中选中“启用幽灵”来启用此功能。
如果您在 Android 上运行 Zwift，请在storage文件夹中创建文件enable_ghosts.txt 。
- 如果启用了多人游戏，请访问https:///login/ ，选中“启用幽灵”并单击“启动 Zwift”以保存选项。
当您保存活动时，幽灵将被保存在storage//ghosts//中。下次你骑同样的路线时，幽灵就会被加载。
在聊天中输入.regroup来重新组合幽灵。
可以通过在storage文件夹内创建文件ghost_profile.txt来自定义设备。脚本find_equip.py可用于填充此文件。

机器人

在storage文件夹中创建一个文件enable_bots.txt将幽灵加载为机器人，无论您骑行的路线如何，它们都会继续骑行。
或者， enable_bots.txt可以包含一个乘数值（请注意，如果生成的机器人数量过高，可能会导致性能问题或根本无法工作）。
可以通过在storage文件夹内创建文件bot.txt来自定义姓名、国籍和设备。脚本get_pro_names.py和get_strava_names.py可用于填充此文件。
如果您想要一些随机机器人，请检查此存储库。

RoboPacers（以前称为 Pace Partners）

RoboPacer 是使用电力模拟器拯救的幽灵。
重影必须使用 1 秒的更新频率（默认为 3 秒）进行记录。
该活动必须以相同的位置和速度开始和结束，否则机器人将无法顺利循环。
该配置文件必须包含唯一的玩家 ID 和路线 ID，以便当您加入机器人时，您可以在交叉路口采取相同的转弯。
脚本bot_editor.py可用于修改profile.bin （设置名称、玩家ID和路线ID）和route.bin （剪掉超出的点以形成完美的循环）。
如果您想创建一个动态 RoboPacer（在爬升时增加功率并在下降时减少功率），您可以使用standalone_power.py（需要 2 个 ANT 棒、python-ant 和 PowerMeterTx.py）。

书签

扩张

当您完成一项活动时，您最后的位置将被保存为书签。
还可以在聊天中使用命令.bookmark 保存书签。
您可以通过在主屏幕上的“加入 Zwifter”中选择书签来启动新活动。
您可以使用操作栏上的传送图标传送到书签。

历史排行榜

扩张

要启用所有时间排行榜（覆盖 60 分钟实时结果和 90 天个人记录），请在storage目录中创建文件all_time_leaderboards.txt 。
球衣的有效期仍为 60 分钟，但只有在创造新的历史纪录时才会授予。

权利

扩张

要解锁权利（特殊设备），请在storage目录中创建文件unlock_entitlements.txt 。
要解锁所有设备，请创建文件unlock_all_equipment.txt 。

社区 Discord 服务器和 Strava 俱乐部

请加入社区支持的 Discord 服务器和 Strava 俱乐部。

依赖关系

码头工人

-或者-

Python 3（https://www.python.org/downloads/）
烧瓶 (https://flask.palletsprojects.com/)
python-protobuf (https://pypi.org/project/protobuf/)
pyJWT（https://pyjwt.readthedocs.io/）
Flask-登录 (https://flask-login.readthedocs.io/)
Flask-SQLAlchemy (https://flask-sqlalchemy.palletsprojects.com/)
gevent (http://www.gevent.org/)
pycryptodome（https://pypi.org/project/pycryptodome/）
dnspython (https://www.dnspython.org/)
fitdecode (https://pypi.org/project/fitdecode/)
stravalib (https://stravalib.readthedocs.io/)
可选：garth (https://pypi.org/project/garth/)
可选：discord.py (https://discordpy.readthedocs.io/)

笔记

未来的 Zwift 更新可能会中断 zoffline，直到更新为止。启用 zoffline 后，将不会安装 Zwift 更新。如果 zoffline 更新破坏了某些内容，请检查CHANGELOG以了解可能需要进行的更改。

不要将 zoffline 暴露在互联网上，它的设计并没有考虑到这一点。

如果 Zwift 官方客户端的 zoffline 已过时

如果 zoffline 落后于支持最新的 Zwift 客户端，则可以通过从 zwift-offline 存储库运行此脚本来更新（如果运行 Linux）以使用最新的 Zwift 版本运行：https://gist.github.com/zoffline /b874e93e24439f0f4fbd7b55f3876fd2

注意：不保证未经测试的 Zwift 更新能够与 zoffline 配合使用。然而，从历史上看，Zwift 更新很少会破坏 zoffline。