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": 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",
"UpdateSettings": {
"AutoCheck": true,
"Channel": "Preview",
"Method": "ds",
"KeepProfile": true,
"CompileType": "AOT"
},
"BackgroundSettings": {
"LayerOpacity": 0.6,
"BackgroundImage": "",
"TileMode": null,
"Stretch": null,
"ShouldFillTitleBar": false
},
"HomeSettings": {
"ShowStatistics": true,
"ShowUserInfo": true,
"ShowSystemInfo": true,
"ShowSystemNotice": true,
"ShowSoftwareNotice": true
},
"PMSettings": {
"Position": "rt",
"Enabled": false,
"ClickThrough": false,
"ShowChart": true,
"Opacity": 0.92
},
"CreateProxyDefaults": {
"LocalAddress": "127.0.0.1"
},
"ProxyTemplates": [],
"TerminalEngineType": "Original",
"TerminalCli": "",
"AutoLogin": false,
"AutoSign": false,
"Language": "zh-CN",
"AnimationLevel": 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: 隧道 IDUseConfig: 是否使用自訂啟動設定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.AutoCheckbool是否自動檢查更新。啟用自動檢查更新後, PML 2 將會自動檢查更新。 預設情況下, PML 2 將會檢查更新。
- UpdateSettings.Channelstring更新頻道。更新頻道指您希望接收的更新類型。我們提供了以下更新頻道:
- 穩定版(
Stable): 僅接收經過充分測試的穩定版本 - 預覽版(
Preview): 僅接收經過充分測試的預覽版本
- 穩定版(
- UpdateSettings.Methodstring更新方法。更新方法指 PML 2 使用的更新機制。我們提供了以下更新方法:
ds: Directly Silent - 下載後直接安裝。dd: Direct Download - 直接下載,手動安裝。md: Manual Download - 手動下載,手動安裝。我也不知道為什麼我當時要寫這麼反人類的東西, 反正就是三種不同的更新機制, 你可以隨便選一個。
- UpdateSettings.KeepProfilebool是否保留使用者設定。啟用後, 在更新 PML 2 時將會保留使用者設定。保留設定檔可能有些問題, 請自行判斷。
- UpdateSettings.CompileTypestring目標安裝套件的編譯類型。用於在更新時選擇與目前組建一致的安裝套件, 可選值:
AOT: 使用 Native AOT 編譯的安裝套件Common: 使用一般方式編譯的安裝套件 預設值取決於目前組建的編譯類型。
BackgroundSettings
MEFrpLauncherX.Core.BackgroundSettings
- BackgroundSettings.BackgroundImagestring背景圖片。您可以選擇一個背景圖片來個人化您的 PML 2 介面。支援的圖片格式包括但不限於 PNG、JPG 和 BMP。您可以選擇一個本機圖片檔案。 此欄位儲存的是圖片的路徑。
- BackgroundSettings.LayerOpacitydouble背景層不透明度。您可以調整背景層的不透明度, 以獲得更好的視覺效果。取值範圍為 0.0 (完全透明) 到 1.0 (完全不透明) 。
- BackgroundSettings.TileModestring(WIP) 背景圖片並排模式。您可以選擇背景圖片的並排模式, 以獲得更好的視覺效果。
- BackgroundSettings.Stretchstring背景圖片拉伸模式。您可以選擇背景圖片的拉伸模式, 以獲得更好的視覺效果。PML 2 提供了多種拉伸模式供您選擇, 包括但不限於:
- 無(
None): 不拉伸圖片, 圖片可能會超出背景區域。 - 拉伸(
Stretch): 拉伸圖片以填滿背景區域, 但可能導致圖片變形。 - 均勻(
Uniform): 拉伸圖片以配合背景區域, 保持圖片的長寬比, 可能會導致背景區域有空白。 - 均勻填滿(
UniformToFill): 拉伸圖片以配合背景區域, 保持圖片的長寬比, 可能會導致圖片被裁切。
- 無(
- BackgroundSettings.ShouldFillTitleBarbool是否填滿標題列。啟用後, 背景圖片將會填滿標題列, 以獲得更好的視覺效果。啟用此選項後, 背景圖片將會覆蓋整個視窗, 包括標題列。
HomeSettings
MEFrpLauncherX.Core.HomeConfig
- HomeSettings.ShowStatisticsbool是否在首頁中顯示統計資訊。
- HomeSettings.ShowUserInfobool是否在首頁中顯示使用者資訊。
- HomeSettings.ShowSystemInfobool是否在首頁中顯示系統資訊。
- HomeSettings.ShowSystemNoticebool是否在首頁中顯示系統公告。
- HomeSettings.ShowSoftwareNoticebool是否在首頁中顯示軟體公告。
PMSettings
MEFrpLauncherX.Core.PFSConfig
「隧道監控」懸浮視窗設定。
- PMSettings.Positionstring「隧道監控」列位置。您可以選擇「隧道監控」列的位置, 以獲得更好的視覺效果。可選值包括:
- 左上(
lt) - 右上(
rt) - 左下(
lb) - 右下(
rb) - 中上(
ct) - 中下(
cb)
- 左上(
- PMSettings.Enabledbool是否啟用「隧道監控」列。啟用後, 「隧道監控」列將會置頂顯示在螢幕上, 以便您更方便地監控隧道的狀態。
- PMSettings.ClickThroughbool視窗穿透。啟用後, 懸浮視窗將不接收滑鼠事件, 滑鼠可以直接穿透懸浮視窗點擊到下層視窗。移入懸浮視窗時會自動取消穿透, 移出後恢復。
- PMSettings.ShowChartbool是否在懸浮視窗中顯示即時流量折線圖。預設啟用。
- PMSettings.Opacitydouble懸浮視窗不透明度。取值範圍為 0.5 到 1.0, 預設值為 0.92。
CreateProxyDefaults
MEFrpLauncherX.Core.Models.CreateProxyDefaults
建立隧道表單的預設值。
- CreateProxyDefaults.LocalAddressstring建立隧道表單中「本機位址」的預設值。預設值為
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。