PML 2

配置文件

本文将介绍 PML 2 的配置文件。

配置文件内容

PML 2 的配置文件是一个 JSON 文件, 位于<安装目录>/Config/Settings.json。配置文件包含了 PML 2 的各种设置, 包括但不限于外观设置、启动设置、隧道设置等。您可以通过编辑配置文件来修改 PML 2 的设置。

在类 Unix 系统中, 配置文件路径大小写敏感。
{
    "PrivacyAgreed": true,              # 是否同意隐私政策
    "IsTelemetryEnabled": true,         # 是否启用遥测
    "Skin": "Mica",                     # 材质
    "KickWithoutDisable": true,         # 强制下线隧道后立即启用隧道
    "HideInsteadOfClose": true,         # 关闭时最小化到系统托盘, 而不是直接关闭
    "ParallelDownload": true,           # 启用多线程下载
    "ParallelCount": 16,                # 多线程下载的线程数
    "AutoStartup": false,               # 开机自启
    "AutoLaunch": false,                # 启动时自动启动某些隧道
    "AutoLaunchProxies": [],            # 启动时自动启动某些隧道的隧道列表
    "ExpireDays": 30,                   # 登录过期天数
    "DoNotShowSuccessMsg": true,        # 不显示成功的请求响应
    "Theme": "System",                  # 主题
    "AccentColor": "",                  # 主题色
    "CaptchaMode": "implicit",          # 验证方式
    "DownloadSource": "TPCA",           # ME Frp 客户端下载源
    "UpdateSettings": {                 # 更新设置
        "AutoCheck": true,              # 是否自动检查更新
        "Channel": "Preview",           # 更新频道
        "Method": "ds",                 # 更新方法
        "KeepProfile": true,            # 是否保留用户配置
        "CompileType": "AOT"            # 目标安装包的编译类型
    },
    "BackgroundSettings": {             # 背景设置
        "LayerOpacity": 0.6,            # 背景层不透明度
        "BackgroundImage": "",          # 背景图片(路径)
        "TileMode": null,               # 背景图片平铺模式(WIP)
        "Stretch": null,                # 背景图片拉伸模式
        "ShouldFillTitleBar": false     # 背景图片是否填充标题栏
    },
    "HomeSettings": {                   # 主页设置
        "ShowStatistics": true,         # 是否显示统计信息
        "ShowUserInfo": true,           # 是否显示用户信息
        "ShowSystemInfo": true,         # 是否显示系统信息
        "ShowSystemNotice": true,       # 是否显示系统公告
        "ShowSoftwareNotice": true      # 是否显示软件公告
    },
    "PMSettings": {                     # “隧道监控”悬浮窗设置
        "Position": "rt",               # 位置, 可选值: lt (左上), rt (右上), lb (左下), rb (右下), ct (中上), cb (中下)
        "Enabled": false,               # 是否启用
        "ClickThrough": false,          # 窗口穿透(悬浮窗不接收鼠标)
        "ShowChart": true,              # 显示实时流量折线图
        "Opacity": 0.92                 # 悬浮窗不透明度(0.5-1.0)
    },
    "CreateProxyDefaults": {            # 创建隧道表单默认值
        "LocalAddress": "127.0.0.1"     # 本地地址默认值
    },
    "ProxyTemplates": [],               # 创建隧道模板列表(重启后仍在)
    "TerminalEngineType": "Original",   # 终端引擎类型
    "TerminalCli": "",                  # 终端 CLI 可执行程序
    "AutoLogin": false,                 # 自动登录
    "AutoSign": false,                  # 自动签到
    "Language": "zh-CN",                # 界面语言
    "AnimationLevel": 2                 # 动画程度: 0=关闭动画 1=精简 2=标准
}

字段描述

PrivacyAgreed
bool
是否同意隐私政策。首次启动 PML 2 时会提示用户同意隐私政策, 同意后此字段将被设置为true
IsTelemetryEnabled
bool
是否启用遥测。启用遥测后, PML 2 将会收集一些使用数据, 以帮助我们改进产品。您可以随时在设置界面中启用或禁用遥测。 有关于遥测的更多信息, 请参阅遥测章节。
Skin
string
材质。PML 2 允许您选择不同的材质, 比如云母(Mica, 仅限于 Windows 11)、亚克力(Acrylic)、模糊(Blur)、透明(Transparent)和无(None)。选择不同的材质可以改变 PML 2 的外观和感觉。 默认值取决于操作系统: Windows 11 默认为Mica, MacOS 默认为Acrylic, 其他系统默认为None
KickWithoutDisable
bool
强制下线隧道后立即启用隧道。幻缘映射官网强制下线隧道时会同时禁用隧道, 我们可以在强制下线隧道时再启用隧道,避免您不知道隧道被强制下线后会被禁用。
HideInsteadOfClose
bool
关闭时最小化到系统托盘, 而不是直接关闭。启用此选项可以使软件运行在后台, 方便您快速重新打开软件。后台运行时, 隧道将不会断连。
ParallelDownload
bool
启用多线程下载。启用多线程下载可以提高下载速度。
ParallelCount
int
多线程下载的线程数。线程数过多可能会导致下载不稳定, 请根据您的网络状况和设备性能进行调整。
AutoStartup
bool
开机自启。启用后, PML 2 将会在开机时自动启动。 在 Linux 中, 软件将于用户每次登录时启动。 由于 MacOS 的限制, PML 2 无法在 MacOS 中实现开机自启
AutoLaunch
bool
启动时自动启动某些隧道。启用后, PML 2 将在启动时自动启动某些隧道。
AutoLaunchProxies
List<ALPConfig>
启动时自动启动某些隧道的隧道列表。您可以在这里配置需要在启动时自动启动的隧道。 列表中的每个元素包含以下字段:
  • Name: 隧道名称
  • Id: 隧道 ID
  • UseConfig: 是否使用自定义启动配置
  • Config: 自定义启动配置内容
ExpireDays
int
登录过期天数。登录过期天数是指登录后多少天内未使用软件将导致软件自动退出登录。 最高登录过期天数为 365 天,在修改后您需要重新登录。
DoNotShowSuccessMsg
bool
不显示成功的请求响应。不只有一个用户向我们反映成功的请求响应会干扰屏幕的阅读, 因此我们提供了这个选项来隐藏成功的请求响应, 以便您更专注于查看屏幕。
Theme
string
主题。PML 2 提供了多种主题供您选择, 包括浅色(Light)、深色(Dark)和系统(System) (根据系统设置自动切换) 。您可以根据自己的喜好选择一个主题。 默认值为System
AccentColor
string
主题色。您可以选择一个自定义的主题色, 以个性化您的 PML 2 界面。主题色应该是一个有效的 CSS 颜色值, 例如#ff358076。 默认值为空字符串, 表示使用内置的默认主题色。
CaptchaMode
string
验证方式。验证方式指软件登录时使用的人机验证方式。我们提供了两种验证方式, 您可以根据自己的需要选择:
  • 无感验证(implicit): 推荐。无需进行任何人机验证, 登录时将自动完成人机验证。
  • 浏览器验证(explicit): 需要在浏览器中进行人机验证, 验证完成后您需要手动粘贴验证结果并完成登录。
DownloadSource
string
ME Frp 客户端下载源。您可以选择一个 ME Frp 客户端下载源, 以获得更快的下载速度和更稳定的下载体验。我们提供了以下下载源:
  • TPCA源: 由我们提供的下载源, 速度稳定, 但可能存在无法下载的问题。
  • OFFICIAL源: 官方提供的下载源, 位于中国大陆, 速度较快。 此配置同时作用于 mefrpc 客户端与应用更新包。
UpdateSettings
MEFrpLauncherX.Core.UpdateSettings
更新设置。更新设置允许您配置 PML 2 的更新选项。
  • UpdateSettings.AutoCheck
    bool
    是否自动检查更新。启用自动检查更新后, PML 2 将会自动检查更新。 默认情况下, PML 2 将会检查更新。
  • UpdateSettings.Channel
    string
    更新频道。更新频道指您希望接收的更新类型。我们提供了以下更新频道:
    • 稳定版(Stable): 仅接收经过充分测试的稳定版本
    • 预览版(Preview): 仅接收经过充分测试的预览版本
  • UpdateSettings.Method
    string
    更新方法。更新方法指 PML 2 使用的更新机制。我们提供了以下更新方法:
    • ds: Directly Silent - 下载后直接安装。
    • dd: Direct Download - 直接下载,手动安装。
    • md: Manual Download - 手动下载,手动安装。
      我也不知道为什么我当时要写这么反人类的东西, 反正就是三种不同的更新机制, 你可以随便选一个。
  • UpdateSettings.KeepProfile
    bool
    是否保留用户配置。启用后, 在更新 PML 2 时将会保留用户配置。
    保留配置文件可能有些问题, 请自行判断。
  • UpdateSettings.CompileType
    string
    目标安装包的编译类型。用于在更新时选择与当前构建一致的安装包, 可选值:
    • AOT: 使用 Native AOT 编译的安装包
    • Common: 使用常规方式编译的安装包 默认值取决于当前构建的编译类型。
BackgroundSettings
MEFrpLauncherX.Core.BackgroundSettings
  • BackgroundSettings.BackgroundImage
    string
    背景图片。您可以选择一个背景图片来个性化您的 PML 2 界面。支持的图片格式包括但不限于 PNG、JPG 和 BMP。您可以选择一个本地图片文件。 此字段存储的是图片的路径。
  • BackgroundSettings.LayerOpacity
    double
    背景层不透明度。您可以调整背景层的不透明度, 以获得更好的视觉效果。取值范围为 0.0 (完全透明) 到 1.0 (完全不透明) 。
  • BackgroundSettings.TileMode
    string
    **(WIP)**背景图片平铺模式。您可以选择背景图片的平铺模式, 以获得更好的视觉效果。
  • BackgroundSettings.Stretch
    string
    背景图片拉伸模式。您可以选择背景图片的拉伸模式, 以获得更好的视觉效果。PML 2 提供了多种拉伸模式供您选择, 包括但不限于:
    • 无(None): 不拉伸图片, 图片可能会超出背景区域。
    • 拉伸(Stretch): 拉伸图片以填充背景区域, 但可能导致图片变形。
    • 均匀(Uniform): 拉伸图片以适应背景区域, 保持图片的宽高比, 可能会导致背景区域有空白。
    • 均匀填充(UniformToFill): 拉伸图片以适应背景区域, 保持图片的宽高比, 可能会导致图片被裁剪。
  • BackgroundSettings.ShouldFillTitleBar
    bool
    是否填充标题栏。启用后, 背景图片将会填充标题栏, 以获得更好的视觉效果。启用此选项后, 背景图片将会覆盖整个窗口, 包括标题栏。
HomeSettings
MEFrpLauncherX.Core.HomeConfig
  • HomeSettings.ShowStatistics
    bool
    是否在主页中显示统计信息。
  • HomeSettings.ShowUserInfo
    bool
    是否在主页中显示用户信息。
  • HomeSettings.ShowSystemInfo
    bool
    是否在主页中显示系统信息。
  • HomeSettings.ShowSystemNotice
    bool
    是否在主页中显示系统公告。
  • HomeSettings.ShowSoftwareNotice
    bool
    是否在主页中显示软件公告。
PMSettings
MEFrpLauncherX.Core.PFSConfig
“隧道监控”悬浮窗设置。
  • PMSettings.Position
    string
    “隧道监控”栏位置。您可以选择“隧道监控”栏的位置, 以获得更好的视觉效果。可选值包括:
    • 左上(lt)
    • 右上(rt)
    • 左下(lb)
    • 右下(rb)
    • 中上(ct)
    • 中下(cb)
  • PMSettings.Enabled
    bool
    是否启用“隧道监控”栏。启用后, “隧道监控”栏将会置顶显示在屏幕上, 以便您更方便地监控隧道的状态。
  • PMSettings.ClickThrough
    bool
    窗口穿透。启用后, 悬浮窗将不接收鼠标事件, 鼠标可以直接穿透悬浮窗点击到下层窗口。移入悬浮窗时会自动取消穿透, 移出后恢复。
  • PMSettings.ShowChart
    bool
    是否在悬浮窗中显示实时流量折线图。默认启用。
  • PMSettings.Opacity
    double
    悬浮窗不透明度。取值范围为 0.5 到 1.0, 默认值为 0.92。
CreateProxyDefaults
MEFrpLauncherX.Core.Models.CreateProxyDefaults
创建隧道表单的默认值。
  • CreateProxyDefaults.LocalAddress
    string
    创建隧道表单中“本地地址”的默认值。默认值为127.0.0.1
ProxyTemplates
List<MEFrpLauncherX.Core.Models.ProxyTemplate>
创建隧道模板列表。您可以在创建隧道时将常用参数保存为模板, 之后在创建隧道表单一键套用。模板持久化于此配置中, 重启后仍然存在。 列表中的每个元素包含以下字段:
  • Name: 模板名称(唯一标识)
  • LocalAddress: 本地地址
  • LocalPort: 本地端口
  • Protocol: 协议类型(tcp/udp/http/https), 为空表示沿用当前所选
  • RemotePort: 远程端口(仅 tcp/udp 有效), 为空表示不预填
  • UseEncryption: 是否启用加密
  • UseCompression: 是否启用压缩
TerminalEngineType
string
终端引擎类型。PML 2 内置了多种终端引擎, 您可以根据需要选择:
  • Original: 默认终端引擎。
  • XTerm: XTerm 风格终端引擎。
TerminalCli
string
终端 CLI 可执行程序。当终端引擎需要调用外部 Shell 时, 此字段指定使用的 Shell。可选值包括 powershellpwshcmdbashzsh。 不同平台可用的 Shell 不同, 默认值为空, 表示使用平台默认 Shell。
AutoLogin
bool
自动登录。启用后, PML 2 将在启动时使用上次登录的账号自动登录。
AutoSign
bool
自动签到。启用后, PML 2 将在登录后自动完成每日签到。
Language
string
界面语言。PML 2 支持多语言, 可选值包括:
  • zh-CN: 简体中文
  • en-US: 英语
  • zh-Hant: 繁體中文 默认值为空, 表示跟随系统语言。
AnimationLevel
int
动画程度。您可以调整 PML 2 的动画强度, 以获得更好的视觉体验或更流畅的性能:
  • 0: 关闭动画
  • 1: 精简动画
  • 2: 标准动画 默认值为2
Copyright © RYCBStudio 2026, All Rights Reserved.