用户指南
设置
一般设置
PML 2 的设置界面可以通过点击主界面左侧的齿轮图标 进入。在设置界面中,您可以配置 PML 2 的各种选项。若您想要修改配置文件, 请参阅配置文件章节。
外观
在这里,您可以选择 PML 2 的外观。
主题
PML 2 提供了多种主题供您选择,包括浅色、深色和系统 (根据系统设置自动切换) 。您可以根据自己的喜好选择一个主题。
材质
PML 2 允许您选择不同的材质, 比如云母(Mica, 仅限于 Windows 11)、亚克力(Acrylic)、透明(Transparent)和无(None)。选择不同的材质可以改变 PML 2 的外观和感觉。
背景 (已迁移至下方的"自定义"选项中)
您可以选择一个背景图片来个性化您的 PML 2 界面。您可以从本机图片中选择一个图片作为背景, 也可以选择不使用背景。
背景设置
在这里您可以设置背景图片的拉伸模式。PML 2 提供了多种拉伸模式供您选择,包括但不限于:
- 均匀: 拉伸图片以适应背景区域,保持图片的宽高比,可能会导致背景区域有空白。
- 填充: 拉伸图片以填充背景区域, 但可能导致图片变形。
- 均匀填充: 拉伸图片以适应背景区域,保持图片的宽高比。
- 无: 不拉伸图片,图片可能会超出背景区域。
自定义
在这里,您可以自定义 PML 2 的其他设置。
背景
您可以在这里选择一个背景图片来个性化您的 PML 2 界面。近期使用的背景图片将会显示在这里, 方便您快速切换背景图片。
背景不透明度
您可以在这里调整背景图片的不透明度。调整背景图片的不透明度可以帮助您获得更好的视觉效果, 使界面元素更容易辨认。
背景填充模式 (WIP)
在这里,您可以选择背景图片的填充模式。您可以选择仅填充主窗口还是包括标题栏。
主题色
在这里,您可以选择 PML 2 的主题色。您目前可以仅选择自定义主题色。若您想要还原默认主题色, 请点击"还原"按钮。
自定义主页
在这里您可以选择显示或隐藏主页上的某些控件。
启动设置
在这里,您可以配置 PML 2 的启动设置。
开机自启
在这里,您可以选择是否开机自启 PML 2。
软件启动时自动启动某些隧道
在这里,您可以选择是否在软件启动时自动启动某些隧道。
关闭时最小化到系统托盘, 而不是直接关闭
在这里,您可以选择是否在软件关闭时最小化到系统托盘, 而不是直接关闭。启用此选项可以使软件运行在后台, 方便您快速重新打开软件。后台运行时, 隧道将不会断连。
隧道设置
在这里,您可以配置 PML 2 的隧道设置。
强制下线隧道后立即启用隧道
幻缘映射官网强制下线隧道时会同时禁用隧道,我们可以在强制下线隧道时再启用隧道,避免您不知道隧道被强制下线后会被禁用。
“隧道监控”栏 BETA
“隧道监控”是我们推出的一项新功能,可以监视启动隧道的出入流量信息。
下载设置
在这里, 您可以配置 PML 2 的下载选项。
启用多线程下载
启用多线程下载可以提高下载速度。
多线程下载线程数
设置多线程下载的线程数。线程数过多可能会导致下载不稳定, 请根据您的网络状况和设备性能进行调整。
ME Frp 客户端下载源
设置ME Frp 客户端的下载源, 以获得更快的下载速度。我们提供了多个下载源供您选择, 包括但不限于:
- 官方下载源: 直接从官方服务器下载。
- TPCA 下载源: 从 TPCA 服务器下载。
默认情况下, PML 2 使用 TPCA 下载源。若出现无法下载客户端的错误, 请尝试使用官方下载源,这通常能解决 98%的下载问题。
账户设置
在这里,您可以配置 PML 2 的账户设置。
登录过期天数
在这里,您可以选择登录过期天数。登录过期天数是指登录后多少天内未使用软件将导致软件自动退出登录。
验证方式
在这里,您可以选择验证方式。验证方式指软件登录时使用的人机验证方式。我们提供了两种验证方式, 您可以根据自己的需要选择:
- 无感验证: 推荐。无需进行任何人机验证, 登录时将自动完成人机验证。
- 浏览器验证: 需要在浏览器中进行人机验证, 验证完成后您需要手动粘贴验证结果并完成登录。
默认情况下, PML 2 使用无感验证。若您在登录时遇到人机验证失败的错误, 请尝试切换到浏览器验证。
原本浏览器验证是为了解决 Arm 设备的性能问题, 但我们发现无感验证在 Arm 设备上也能正常工作, 因此我们将无感验证设置为默认验证方式。
其他设置
不显示成功的请求响应
不只有一个用户向我们反映成功的请求响应会干扰屏幕的阅读, 因此我们提供了这个选项来隐藏成功的请求响应, 以便您更专注于查看屏幕。
更新设置
更新设置可以在软件左侧栏“ 更新”中找到。
在这里,您可以配置 PML 2 的更新设置。
更新模式
在这里,您可以选择更新模式。更新模式指软件更新时使用的方式。我们提供了三种更新模式, 您可以根据自己的需要选择:
- 自动检查更新并安装: 推荐。软件将自动检查更新并安装。
- 自动检查更新并下载: 软件将自动检查更新并下载最新的安装包, 但不会安装。
- 手动检查更新: 您需要手动检查更新并安装。
保留配置
在这里,您可以选择是否保留配置。保留配置是指软件更新时是否保留您的配置。
更新渠道
控制应用的更新目标版本。版本的发行节奏和稳定程度因更新通道而异,部分通道可能包含不稳定的功能,请谨慎使用。 目前我们提供以下更新通道:
- 稳定: 接收应用稳定版的更新,包含较新且稳定的特性和改进。
- 发布预览通道: 提前预览下一个版本中应用的功能,包含较新的特性和改进,可能存在少量缺陷。
隧道管理
节点延迟与连通性
隧道管理页的每张隧道卡片会显示其所在节点的连通状态。点击顶部工具栏的「刷新测速」可批量探测当前列表中所有隧道所在节点的延迟 (TCP 连通性, 探测 节点地址:隧道远程端口)。
- 探测并发受控 (最多 6 路同时进行), 不阻塞界面; 探测过程中可点「取消测速」中止。
- 状态含义:
| 显示 | 含义 |
|---|---|
123 ms | 节点可连通, 数值为本次 TCP 握手延迟 |
| 探测中 | 正在对该隧道所在节点发起探测 |
| 超时 | 4 秒内未收到节点响应 (节点过载、网络波动或端口不可达) |
| 失败 | 连接被拒绝、域名无法解析或网络不可用 |
| 不可探测 | 该隧道缺少节点地址信息或远程端口无效, 跳过探测 |
- 探测目标与隧道卡片上显示的访问地址 (
节点地址:端口) 一致, 反映的是该隧道实际可用性。
创建隧道
本地地址预填
创建隧道表单的「本地地址」默认预填 127.0.0.1 (本机回环地址, 覆盖绝大多数本地服务场景)。该默认值可在 Config/Settings.json 的 CreateProxyDefaults.LocalAddress 中修改, 重启后生效。
常用端口快捷项
「本地端口」输入框旁提供常用端口快捷按钮: 80 (HTTP)、443 (HTTPS)、22 (SSH)、25565 (Minecraft Java 版)。点击后自动填入本地端口, 可在此基础上手动微调。
模板 (套用 / 存为 / 删除)
创建页底部「模板」区域用于保存常用隧道参数, 避免重复填写:
- 存为模板: 在「存为当前为模板」输入框填写模板名称, 点击「存为当前为模板」按钮, 即可将当前表单的本地地址、本地端口、协议类型、远程端口 (TCP/UDP)、加密/压缩开关保存为模板。
- 套用模板: 在「套用模板」下拉框中选择一个已保存的模板, 点击「套用模板」按钮, 模板中的参数会自动填入表单 (未保存的参数保持当前值)。套用后仍可继续编辑, 并走原有的字段校验。
- 删除模板: 选中模板后点击「删除模板」按钮即可移除。
模板持久化在 Config/Settings.json 的 ProxyTemplates 中, 重启应用后仍然保留; 同名模板保存时会覆盖旧值。
隧道状态与失败原因
隧道管理页的每张隧道卡片会显示当前运行状态徽标 (颜色 + 文案), 随启动/停止/运行实时更新:
| 状态 | 颜色 | 含义 |
|---|---|---|
| 启动中 | 蓝 | 正在拉起 mefrpc 进程并等待服务端确认 |
| 运行中 | 绿 | mefrpc 已启动且服务端确认在线 |
| 重连中 | 橙 | 已启动但服务端暂未确认在线 (允许短暂延迟) |
| 已停止 | 深灰 | 已手动停止 |
| 失败 | 红 | 启动失败或运行异常退出, 卡片同时显示失败原因 |
| (无徽标) | — | 空闲, 尚未启动 |
失败原因与复制
启动失败时 (认证失败、端口占用、节点不可达、进程崩溃等), 隧道卡片会以红色显示映射后的失败原因 (可读文案而非原始日志), 并出现「复制错误信息」按钮:
- 点击「复制错误信息」会把 应用版本 + mefrpc 版本 + 失败原因摘要 复制到剪贴板, 便于在反馈/工单中直接粘贴。
- 若启动后 30 秒内始终无法得到服务端在线确认, 将判定为「节点不可达」(超时)。
- 状态为「失败」时, 「停止」操作会立即将状态置回「已停止」。
各类失败的具体排查路径见 故障排查指南。
更新
检查与下载
「更新」页展示当前版本、云端最新版本与更新日志:
- 检查更新: 点击「检查更新」获取最新版本信息; 有新版时显示版本号与更新日志, 并出现「下载并安装」按钮。
- 下载更新: 点击「下载并安装」按系统下载对应安装包 (Windows 为 exe 安装程序, macOS 为 dmg, Linux 为 deb), 进度条与实时速度可见; 下载完成后按「更新模式」设置自动安装或打开所在目录。
失败与重试
更新过程的失败不会静默发生, 界面会给出明确提示与下一步:
| 场景 | 界面表现 | 下一步 |
|---|---|---|
| 获取更新信息失败 | 状态区显示「获取更新失败」, 悬停可见原因提示 | 检查网络后再次点击「检查更新」 |
| 下载失败 (网络/源不可用) | 状态区显示失败原因, 出现「重试下载」按钮 | 点击「重试下载」; 若持续失败, 见下方「下载源」 |
| 下载文件校验失败 | 提示文件可能损坏, 出现「重试下载」按钮 | 点击「重试下载」重新下载 |
下载源
「设置」页可切换下载源 (DownloadSource, 默认 TPCA):
- TPCA: 默认源, 覆盖应用更新包与 mefrpc 客户端的下载。
- 官方: 备用源; 当默认源不可用时 (下载持续失败、提示切换下载源), 切到「官方」后重试。
当前应用更新包仅提供默认源 (无自动备源); 下载失败时会提示切换下载源后重试。mefrpc 客户端下载已内置双源与重试。
桌面集成
macOS 原生菜单
macOS 上应用菜单栏提供原生菜单 (命令与主界面完全同源):
- PML 2 (应用菜单): 关于 (⌘ 附近的「关于」入口)、设置 (
Ctrl+,)、退出 (Ctrl+Q)。 - 隧道 (菜单): 管理隧道 (
Ctrl+M)、创建隧道 (Ctrl+D)、显示主窗口、全部停止隧道。
关窗与退出的区别: macOS 点红灯 (关窗) 默认等于退出应用; 若在「设置」中开启「关闭时最小化到托盘」(HideInsteadOfClose), 关窗后应用保留在托盘/菜单栏, 退出请走菜单或 Ctrl+Q。
系统托盘
Windows / Linux / macOS 均提供系统托盘图标, 右键菜单包含:
- 打开主界面: 显示并激活主窗口 (未登录时提示先登录)。
- 打开终端: 切换到终端页。
- 全部停止隧道: 向所有终端发送
Ctrl+C, 停止全部隧道。 - 退出: 先停止全部隧道再退出应用。
托盘操作与主界面状态实时一致 (隧道在终端页停止/启动, 托盘菜单不持有独立状态)。
流量悬浮窗
在「设置 → 悬浮窗」中开启「流量悬浮窗」(PMSettings.Enabled) 后, 屏幕角落显示半透明流量监控条 (默认右上角):
- 隧道状态: 列出当前运行中的隧道 (彩色圆点 + 名称), 与主界面启停实时同步——启动显示「启动中」(蓝)、服务端确认在线后变「运行中」(绿)、失败显示「失败」(红, 悬停可见失败原因); 隧道停止 (管理页停止按钮 / 终端 Ctrl+C / 全部停止) 后对应项自动移除, 与关闭终端标签页行为一致。
- 实时流量: 显示上传/下载瞬时速度; 下方折线图绘制最近 1 分钟 (30 个采样点) 的速率曲线 (绿=下载、蓝=上传)。
- 窗口穿透 (默认关闭): 开启后鼠标点击可穿透悬浮窗, 不影响操作其下方的窗口; 穿透模式下鼠标移入悬浮窗时自动临时取消穿透, 便于操作菜单。
点击监控条上的 ⋯ 菜单:
- 刷新流量: 重新获取网络接口并重置流量统计基准 (曲线同步清空重绘)。
- 设置: 打开悬浮窗设置 (窗口位置、窗口穿透、显示流量图表、不透明度, 均实时生效并持久化于
PMSettings)。 - 关闭悬浮窗: 只关闭悬浮窗, 不退出应用 (应用退出时悬浮窗自动销毁, 无残留置顶窗)。
悬浮窗仅展示流量与提供上述快捷操作, 不含完整隧道管理 (请使用主界面)。
开机自启与恢复隧道
「设置」页提供两个独立开关, 默认均关闭:
| 开关 | 配置键 | 说明 | 支持平台 |
|---|---|---|---|
| 开机自启动 | AutoStartup | 登录系统时自动启动 PML 2 | Windows (注册表 Run 键)、macOS (LaunchAgent)、Linux (~/.config/autostart) |
| 恢复上次隧道 | AutoLaunch | 启动后自动拉起 AutoLaunchProxies 中配置的隧道 (在自启动队列中勾选) | 全平台 |
- 只有显式开启「恢复上次隧道」并配置了自启动队列, 启动时才会自动拉隧道。
- 自启/恢复失败会写入日志, 并在界面给出提示, 不会静默失败。
- 风险提示: 开启自启后应用会在登录时自动运行; 恢复隧道会消耗本地端口与流量, 请按需配置。