如何搭建Zwift Offline？完整离线部署指南（2023版）

Zwift Offline是一款开源项目，能够让用户在没有互联网连接的情况下也能使用Zwift进行骑行训练。它通过模拟Zwift服务器，允许用户在本地环境中运行Zwift，实现离线使用。本文将手把手教你如何搭建本地服务器，完成免联网配置，让你随时随地享受骑行乐趣。

一、核心价值：为什么选择Zwift Offline？

1.1 突破网络限制，训练不中断

无论你身处网络信号差的地方，还是想节省流量，Zwift Offline都能让你随时开启训练。它将Zwift的核心功能本地化，无需依赖官方服务器。

1.2 保护隐私数据，安全有保障

你的训练数据无需上传至云端，全部存储在本地设备，有效保护个人隐私和数据安全。

1.3 自定义训练环境，个性化体验

你可以根据自己的需求调整训练参数，创建专属的骑行场景，提升训练的趣味性和针对性。

核心价值流程图

二、技术解析：Zwift Offline背后的秘密

2.1 Python：服务器功能的实现者

Python作为主要编程语言，负责模拟Zwift服务器的各种功能，包括用户认证、数据处理、游戏逻辑等。它的简洁易用和丰富的库支持，为项目的快速开发和稳定运行提供了保障。

2.2 Docker：容器化部署的利器

Docker就像一个专用工具箱，将Zwift Offline及其依赖的组件打包成一个独立的容器。这使得安装和配置过程变得极其简单，你无需担心不同系统环境带来的兼容性问题。

Docker工作流程图

2.3 SSL/TLS：加密通信的守护者

为什么需要SSL加密？因为它能确保客户端与本地服务器之间的通信安全，防止数据在传输过程中被窃取或篡改，就像给你的数据穿上了一层安全的外衣。

2.4 Flask：轻量级Web框架的代表

Flask是一个轻量级的Python Web框架，用于处理HTTP请求和响应。在Zwift Offline中，它负责搭建用户界面和处理各种API请求，让你可以通过浏览器与本地服务器进行交互。

2.5 Protobuf：高效数据传输的使者

Protobuf用于序列化和反序列化数据，提高数据传输效率。它就像一种高效的语言翻译器，让不同的组件之间能够快速、准确地交换信息。

三、分步实施：三种安装方法任你选

3.1 安装方法对比

安装方法	适用场景	复杂度	耗时
Windows简易安装	Windows系统用户，追求简单快捷	低	5分钟
从源代码安装	熟悉命令行操作，希望自定义配置	中	15分钟
Docker安装	跨平台使用，注重环境隔离	低	10分钟

3.2 准备阶段：10分钟完成环境检查

在开始安装之前，请确保你的系统满足以下要求：

• 操作系统：支持Windows、Linux和macOS。
• Python 3：如果选择从源代码安装，需要确保系统中已安装Python 3。
• Docker：如果选择Docker安装，需要安装Docker。

3.3 方法一：Windows简易安装（5分钟完成一键部署）

🔧 步骤1：下载最新版本 访问项目仓库，下载最新的zoffline发布版本。

🔧 步骤2：运行zoffline.exe 双击下载的zoffline.exe文件，启动zoffline。 预期结果：你将看到一个命令行窗口，显示服务器启动信息。

🔧 步骤3：启动Zwift 在zoffline启动后，正常启动Zwift应用程序。 预期结果：Zwift将连接到本地服务器，你可以开始离线使用。

3.4 方法二：从源代码安装（15分钟完成手动配置）

🔧 步骤1：安装Python 3 确保系统中已安装Python 3，如果没有，请从Python官方网站下载并安装。 预期结果：在命令行中输入python --version或python3 --version，能显示Python的版本信息。

🔧 步骤2：克隆项目 使用以下命令克隆项目：

git clone https://gitcode.com/gh_mirrors/zw/zwift-offline
cd zwift-offline

预期结果：项目文件将被下载到本地，并进入项目目录。

🔧 步骤3：安装依赖

• 在Linux/macOS上：

  pip3 install -r requirements.txt
  

• 在Windows上：

  pip install -r requirements.txt
  

预期结果：项目所需的Python依赖包将被自动安装。

🔧 步骤4：运行zoffline

• 在Linux/macOS上：

  sudo python3 standalone.py
  

• 在Windows上：

  python standalone.py
  

预期结果：本地服务器启动，命令行窗口显示相关日志信息。

🔧 步骤5：启动Zwift 在zoffline启动后，启动Zwift应用程序。 预期结果：Zwift成功连接到本地服务器，实现离线运行。

3.5 方法三：Docker安装（10分钟完成容器化部署）

🔧 步骤1：安装Docker 确保系统中已安装Docker，如果没有，请从Docker官方网站下载并安装。 预期结果：在命令行中输入docker --version，能显示Docker的版本信息。

🔧 步骤2：创建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 </path/to/host/storage>:/usr/src/app/zwift-offline/storage -e TZ=<timezone> zoffline/zoffline

注意：将</path/to/host/storage>替换为你本地的存储路径，<timezone>替换为你的时区，如Asia/Shanghai。 预期结果：Docker容器将被创建，但尚未启动。

🔧 步骤3：启动Docker容器 使用以下命令启动Docker容器：

docker start zwift-offline

预期结果：Docker容器启动，你可以通过docker ps命令查看容器运行状态。

🔧 步骤4：启动Zwift 在Docker容器启动后，启动Zwift应用程序。 预期结果：Zwift连接到Docker容器中的本地服务器，开始离线使用。

3.6 验证阶段：5分钟确认安装成功

启动Zwift后，尝试登录并创建一个训练 session。如果一切正常，你将能够在没有网络连接的情况下进行骑行训练，这表明Zwift Offline已成功安装并配置。

安装验证流程图

四、常见问题：排错指南助你解决难题

4.1 问题一：服务器启动失败

症状：运行启动命令后，命令行窗口闪现或显示错误信息后退出。 解决方案：

1. 检查Python版本是否符合要求，确保安装了Python 3。
2. 对于从源代码安装的用户，检查依赖包是否安装完整，可以重新运行pip install -r requirements.txt。
3. 查看日志文件，通常位于项目目录的logs文件夹下，根据日志中的错误信息进行排查。

4.2 问题二：Zwift无法连接到本地服务器

症状：Zwift启动后提示无法连接到服务器。 解决方案：

1. 确保Zwift Offline服务器已成功启动。
2. 检查防火墙设置，确保Zwift和Zwift Offline所需的端口未被阻止。
3. 尝试重启Zwift和Zwift Offline服务器。

4.3 问题三：数据无法保存

症状：训练结束后，数据没有被保存。 解决方案：

1. 检查存储路径是否正确，对于Docker安装用户，确保本地存储路径已正确映射到容器中。
2. 检查存储路径的权限，确保Zwift Offline有写入权限。
3. 查看日志文件，查找相关的错误信息。

五、项目扩展：让你的Zwift Offline更强大

5.1 如何实现数据持久化

默认情况下，Zwift Offline的数据存储在本地。为了确保数据不会丢失，你可以定期备份存储目录。对于Docker用户，可以通过映射本地目录到容器来实现数据持久化，这样即使容器被删除，数据也会保留在本地。

5.2 自定义训练场景

你可以修改项目中的相关配置文件，添加自定义的训练场景和路线。具体方法可以参考项目的文档或源代码中的说明。

5.3 与其他设备同步

虽然Zwift Offline是离线使用，但你仍然可以通过一些工具将训练数据导出，然后手动同步到其他健身平台。例如，可以使用项目中的upload_activity.py脚本将数据上传到相关平台。

通过本文的指南，你已经成功搭建了Zwift Offline本地服务器，现在可以随时随地享受离线骑行的乐趣了。如果在使用过程中遇到其他问题，可以查阅项目的文档或向社区寻求帮助。祝你训练愉快！