PML 2

安裝

本文將介紹如何安裝 PML 2。

Windows 安裝

  1. 從官網/發佈頁下載安裝程式: x64 為 pml2 setup <版本> AOT.exe, ARM64 為 pml2_setup_arm64_<版本>.exe。
  2. 雙擊執行, 依精靈完成安裝 (預設安裝到 %LOCALAPPDATA%\PML 2)。
  3. 安裝完成後從桌面/開始功能表啟動 PML 2。
    下載安裝程式時瀏覽器或 Windows Defender 可能會提示您下載的檔案不安全, 這是正常的, 因為安裝程式沒有數位簽章。此時選擇信任即可。
安裝器支援靜默安裝參數: /silent /sp- /nocancel (AOT 與 Common 版本參數一致)。

Linux 安裝

下載 pml2-<版本>-linux-x64-aot.deb (ARM64 為 ...-linux-arm64-aot.deb; 同時提供 .rpm); 安裝路徑固定為 /opt/pml-2, 可從應用程式選單啟動。
本部分假設您知道如何在 Linux 桌面端中開啟終端機, 並有一定的自主問題解決能力和 Linux 基礎。

開啟終端機,輸入以下指令:

# 需要先安裝 wget
sudo apt install wget

bash <(curl -sSL https://api.rycb.tech/api/pml2/install)

跟隨提示完成安裝即可。

MacOS 安裝

由於 MacOS 的安全機制,安裝後需要執行以下步驟才能正常使用 PML 2。
本部分假設您知道如何在 MacOS 中開啟終端機, 並有一定的自主問題解決能力和 MacOS 基礎。
下載 pml2-<版本>-macos-x64-aot.dmg (Apple Silicon 為 ...-macos-arm64-aot.dmg), 雙擊掛載後把應用程式拖入「應用程式」。
應用程式套件已宣告 pml2:// URL 類型 (TPCA 通用連結啟動隧道), 可直接從瀏覽器/其他應用程式拉起; Windows / Linux 由應用程式在首次啟動時自動註冊 (目前使用者層級, 無需系統管理員), 詳見故障排查指南「連結啟動隧道」。

首次使用: mefrpc 客戶端

啟動第一條隧道時, 應用程式會自動下載 mefrpc 客戶端到 bin/ 目錄 (Windows 為 mefrpc.exe, Linux/macOS 為 mefrpc.tar), 下載完成後自動解壓縮/校驗並啟動隧道。

首次拉取失敗

場景表現處理
下載失敗下載對話方塊報錯/關閉, 隧道未啟動在「設定」頁切換下載來源 (TPCA ↔ 官方) 後重新啟動隧道
校驗失敗提示客戶端檔案校驗不通過刪除 bin 下殘留的 mefrpc*.tmp 與損毀檔案後重試
下載中斷下載對話方塊顯示進度停止/取消重新啟動隧道即可續傳重試 (下載器內建 5 次重試)

下載來源設定 DownloadSource (預設 TPCA) 同時作用於 mefrpc 客戶端與應用程式更新套件, 詳見 使用者指南「下載來源」。

首次使用: 憑證助手 lego 元件

安裝套件不內建 lego (ACME 客戶端)。首次在「設定 → 隧道設定 → 憑證助手」中申請憑證時, 會依目前平台下載對應版本 (約 20 MB, 校驗官方 checksums.txt 的 SHA-256) 並解壓縮到 Tools/lego/<rid>/。

場景表現處理
下載失敗停留在「正在準備 lego…」或提示無法準備 lego檢查網路/代理後重試 (應用程式會依序嘗試 GitHub 主來源與備用鏡像)
校驗失敗同上 (應用程式會拒絕使用未通過校驗的二進位檔)重試即可; 持續失敗需檢查網路是否被中間人代理改寫
需離線或內網使用無法完成下載目前需能存取 GitHub 或其鏡像; 詳見故障排查指南「憑證申請失敗」

應用程式內更新

更新入口在「更新」頁: 檢查更新 → 下載並安裝。失敗路徑 (取得失敗、下載失敗、校驗失敗、切換來源重試) 見 故障排查指南「更新失敗」。

Copyright © RYCBStudio 2026, All Rights Reserved.