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 個位元組。
```
 [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。