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 或其镜像; 详见故障排查指南「证书申请失败」 |
应用内更新
更新入口在「更新」页: 检查更新 → 下载并安装。失败路径 (获取失败、下载失败、校验失败、切源重试) 见 故障排查指南「更新失败」。