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
是否啟用遙測。預設為 false, 僅在首次啟動同意隱私權政策時被設為 true; 修改後需重新啟動應用程式才會生效。啟用後 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。可選值包括 powershell、pwsh、cmd、bash、zsh。 不同平台可用的 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.