PML 2
安裝
本文將介紹如何安裝 PML 2。
Windows 安裝
- 從官網/發佈頁下載安裝程式: x64 為
pml2 setup <版本> AOT.exe, ARM64 為pml2_setup_arm64_<版本>.exe。 - 雙擊執行, 依精靈完成安裝 (預設安裝到
%LOCALAPPDATA%\PML 2)。 - 安裝完成後從桌面/開始功能表啟動 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)
# 需要先安裝 wget
sudo pacman -Syu wget
wget -O install.sh https://api.rycb.tech/api/pml2/install
sudo bash install.sh
# 需要先安裝 wget
sudo dnf install wget
wget -O install.sh https://api.rycb.tech/api/pml2/install
sudo bash install.sh
跟隨提示完成安裝即可。
MacOS 安裝
由於 MacOS 的安全機制,安裝後需要執行以下步驟才能正常使用 PML 2。
本部分假設您知道如何在 MacOS 中開啟終端機, 並有一定的自主問題解決能力和 MacOS 基礎。
下載
pml2-<版本>-macos-x64-aot.dmg (Apple Silicon 為 ...-macos-arm64-aot.dmg), 雙擊掛載後把應用程式拖入「應用程式」。依照正常方式透過 .dmg 檔案安裝。
或者前往「系統設定 → 隱私權與安全性」允許開啟, 亦可開啟終端機執行以下指令:
Terminal
xattr -d com.apple.quarantine /Applications/PML2.app
接著就可以正常使用 PML 2 了。
若無法正常啟動, 請嘗試按住 , 點擊 PML 2 圖示後點擊「打開」選單項目 (注意不要放開 )。
應用程式套件已宣告
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 或其鏡像; 詳見故障排查指南「憑證申請失敗」 |
應用程式內更新
更新入口在「更新」頁: 檢查更新 → 下載並安裝。失敗路徑 (取得失敗、下載失敗、校驗失敗、切換來源重試) 見 故障排查指南「更新失敗」。