界面功能、DNS 與 TUN

從剪貼板導入分享鏈接

在非輸入框區域按 Ctrl+V，或使用剪貼板導入菜單。客戶端會嘗試 Base64 和明文解析。HTTPS 地址優先作爲訂閱處理，隨後識別標準協議鏈接、SIP008、WireGuard、內部分享格式、多條或單條 Xray / sing-box 配置，再嘗試 Clash / Hysteria 自定義配置。

無法解析時檢查完整內容、前綴和格式，避免把包含訂閱鏈接的網頁正文一起復制。若光標位於輸入框，Ctrl+V 只會把文本粘到該輸入框。

自定義配置與 Socks 端口

完整配置可能使用不同核心，客戶端不能可靠地推斷其 Socks 監聽端口。填寫“自定義配置的 Socks 端口”後，會額外啓動 Xray 或 sing-box 前置服務，先分流，再把流量轉發到這個端口。

若完整配置已負責入站和路由（如通常的 mihomo 配置），可不填此前置端口。此時客戶端更接近服務啓動器，系統代理與其他應用的代理端口必須和自定義文件一致，不能默認使用界面顯示的混合端口。

訂閱分組字段

分組可以單獨保存來源，也可以合併相同格式的內容。保存後需要執行更新，過濾和請求設置纔會應用到新獲取的內容。

更新訂閱時發生什麼

客戶端先檢查分組是否啓用更新，再獲取地址內容，必要時轉換或合併，然後解析配置。活動項屬於本組時會重新處理活動項，並整理已有流量統計；延遲和速度結果會清空。

更新失敗先看下載失敗還是解析失敗。前者檢查訪問路徑、代理節點和認證；後者檢查內容格式、過濾條件和 User Agent。保留一個獨立可用配置，避免訂閱暫時失敗後沒有可用代理。

混合監聽與關聯端口

本地混合端口同時接受 HTTP 與 SOCKS5。若修改基準端口，應同時確認偏移端口未被其他程序佔用，並同步修改手工配置代理的應用。

基礎連接設置

routeOnly 讓嗅探結果用於路由判斷，避免不適當地替換連接目標；sing-box 中強制啓用。REALITY、ECH 等可能使用不同於實際目標的 SNI，調整此項需結合當前配置。

Mux 僅對客戶端支持的 VLESS、VMess、Shadowsocks、Trojan 配置生效；sing-box 還需選擇複用協議。7.25.6 已在覈心設置界面提供 Mux 設置。

“日誌存到文件”把核心輸出保存到 guiLogs；未啓用時主要查看信息欄。分片在代理鏈下可能達不到預期。多網卡可綁定網口和本地出站地址，但雙核心 TUN 的自動路由可能影響地址綁定。

啓動、更新與證書來源

開機啓動需要 TUN 時，應按客戶端要求設置相應權限。僅普通代理使用不必爲此改變權限。托盤配置列表超過數量限制時會隱藏切換列表，並非節點丟失。

UDP 測試地址

UDP 測試僅說明節點到指定測試服務的連通情況，不等同於所有遊戲或視頻服務可用。測試目標不可達也會造成失敗，應換一個已知可達目標交叉驗證。

系統代理例外與協議

例外 / 忽略列表中的地址不會使用系統代理，多個條目用逗號分隔。留空會恢復客戶端默認值，不能用空字符串表示“沒有例外”。

Windows 高級代理協議選項用於特定應用的特殊需求；普通使用保持默認即可。應用有獨立代理設置時，應同時覈對該應用自己的配置。

TUN：協議棧、MTU 與排除路由

TUN 通過虛擬網絡接口接收流量，需要系統權限與可工作的核心。先確認普通代理可用，再開啓 TUN；避免同時運行多個修改默認路由的工具。

可選協議棧爲 system、gvisor、mixed；Wiki 記錄默認 gvisor，正常使用時可嘗試 mixed。Xray 僅支持 gvisor。MTU 默認 9000，屬於虛擬接口參數；嘗試更大值後出現連接異常，應降低並複測，不要與物理網卡 MTU 混淆。

啓用自動路由後，可在排除地址中填寫不進入 TUN 的 CIDR 網段，多個值用逗號分隔，例如 192.168.1.0/24。範圍應只包含需要保留直連的網絡。

TUN 的 ICMP 策略

sing-box 支持以下策略；Xray 對 ICMP 採用 reply，因此極低的 ping 延遲可能只是本地回覆，不能當成遠程代理延遲。當前說明中只有 WireGuard 支持 ICMP 轉發，其他代理協議會回退到 reply。

固定證書與獲取證書鏈

固定證書將驗證限定到指定證書，配置前應從可信來源確認指紋或證書鏈。Xray 的 SHA-256 指紋字段可用 ~ 分隔多個值；該界面字段在 sing-box 中會被忽略。完整證書鏈使用 PEM 內容，可包含多個證書。

“獲取證書 / 獲取證書鏈”會連接目標並驗證返回鏈。地址不可達、自簽證書、未知 CA 或本地信任問題都可能導致獲取失敗。不要把獲取失敗直接視爲需要關閉驗證；應先覈對地址、SNI、系統時間及預期證書。證書更新後，固定值也需按可信來源更新。

策略組與子配置項

Xray 支持最穩定、最低延遲、負載均衡和隨機；sing-box 支持最低延遲，並可在當前代理頁的 Selector 組手動選擇出口。“故障轉移”使用 5000ms 高容差的最低延遲策略，不是按列表逐個順序切換。

子配置項一按訂閱分組和別名正則選擇，更新訂閱時會自動刷新成員。子配置項二手工選擇配置，可嵌套其他組；訂閱節點更新時可能被移除，因此更適合自建、穩定的非訂閱配置。兩類成員會合並，所有成員必須被組使用的核心支持。

鏈式順序與 Core 類型

鏈式代理按實際流量方向排列：第一個節點是前置，最後一個是落地。設置 Core 類型時，當前配置項的選擇優先於全局 Core 類型；改變全局值後，已顯式指定核心的節點不會跟隨改變。

出現“不支持協議”時檢查整條鏈和策略組成員，不要只檢查當前顯示的主節點。

代理鏈操作步驟

路由設置與導入

首次啓動已生成默認規則集。“一鍵導入規則集”會新增默認規則，不會替換已有內容；適用於發佈說明要求更新默認規則的情況。規則也可從文件、剪貼板或可選訂閱 URL 導入。

規則按順序匹配；Domain、IP、進程名三類建議一條只填一類，再與 Port、Protocol、InboundTag、network 組合。域名解析策略與規則集配合，修改後用日誌確認結果。Windows 可給規則集指定 PNG 托盤圖標，該圖標會覆蓋系統代理狀態圖標。

完整路由用法

自定義 sing-box rule-set

rule-set 設置使用 JSON，可同時引用本地與遠程規則。tag 必須與路由引用一致；本地文件需要存在，遠程 URL 需要可訪問。優先使用當前規則集的自定義來源，其次尋找本地規則資源，再使用用戶設置的來源，最後使用默認來源。

下面是本地 SRS 文件示例，path 需要換成你實際保存的位置。JSON 中 Windows 路徑的反斜槓需要轉義。

JSON · local rule-set example複製

[
  {
    "tag": "example-rules",
    "type": "local",
    "format": "binary",
    "path": "/path/to/example-rules.srs"
  }
]

DNS 基礎設置

先區分“路由匹配需要的解析”和“實際出站目標的解析”。Xray 默認直連 / 遠程 DNS 主要服務於路由中的 IP 匹配；sing-box 還用它們解析節點或目標。填寫多個 DNS 地址時用逗號分隔。

Hosts、FakeIP 與 DNS 校驗

“使用系統 hosts”可合併 Windows 的 hosts 和 hosts.ics；“添加常用 DNS Hosts”提供常見 DNS 域名映射，作爲 Bootstrap 的補充。手工 DNS Hosts 每行寫域名及一個或多個 IP，優先於普通查詢。

FakeIP 僅在 sing-box 的 TUN 模式有效，用特定地址映射保留域名信息。“阻止 SVCB 和 HTTPS 查詢”也僅在該模式生效，會影響 ECH 和 HTTP/3 的服務發現。地區 IP 校驗用於判斷某類域名的結果是否位於期望 GEO 範圍；數據或規則不一致時可能導致解析失敗。

Hosts · documentation addresses複製

example.com 192.0.2.10 192.0.2.11
example.org 198.51.100.20
# A matching keyword can return NOERROR
keyword:blocked.example #0

自定義 DNS 配置

Xray 與 sing-box 使用各自獨立的 DNS 配置，不應把一種核心的 JSON 原樣放進另一種。沒有特殊需求時可導入對應核心的默認 DNS，再逐項修改。

“使用系統 hosts”控制是否合併系統映射；Outbound 域名解析地址用於本機解析節點域名，Outbound 解析策略控制 IPv4 / IPv6 等選擇。若使用域名形式的 DNS 服務器，應保證 Bootstrap 不依賴尚未建立的代理連接。

修改後分別驗證節點域名、直連網站和代理網站，出現問題回退到備份的默認配置。

完整配置模板

客戶端先正常生成配置，再依據模板重寫配置，儘量保留模板自身設計。啓用模板後，部分界面裏的路由、入站、DNS 等設置可能不再決定最終配置，應檢查實際生成結果。

“不添加非代理協議出站”開啓後，需要在模板中自行提供 direct、block 等出站。設置“上游代理 tag”時，客戶端會給沒有前置的節點引用該 tag；對應上游出站也必須由你定義。不存在的 tag 會導致配置失敗或行爲不符。

Windows UWP 迴環訪問

部分 UWP 應用處於沙盒中，默認不能訪問本機迴環地址，因此無法直接連接 127.0.0.1 的代理。“解除迴環代理限制”用於對需要的應用開放這一訪問。

運行該功能需要相應系統權限。若工具報錯，先確認 Windows 版本、應用是否安裝完整和權限提示；排查時記錄原始錯誤，不要通過關閉整個系統防火牆代替應用級配置。

清除服務統計

該操作清除配置項記錄的上傳與下載流量，不清除延遲或速度測試結果，也不代表重置服務提供方的用量計費。

希望對比一段時間的本地流量時，可先記錄舊值，再清除並觀察新連接；訂閱更新後的節點變化也可能影響統計的呈現。

區域預置與資源來源

默認 GEO、rule-set 和路由資源面向中國區域的常見使用方式。其他區域可先調整區域預置或自定義來源，再執行資源更新。

更換來源後確認分類名稱仍與現有規則一致；新數據缺少舊分類時，應同步修改規則，而不是隻重複下載文件。

備份和還原

備份對象是整個 guiConfigs 文件夾，包含客戶端設置、配置數據庫與自定義配置。使用“備份和還原”保存 ZIP；非 Windows 系統要明確填寫 zip 擴展名，還原對話框只接受 ZIP。

還原會替換相應配置並重啓客戶端，操作前先備份當前狀態。自動重啓失敗時手動啓動。備份包含訂閱 URL 和憑據，保存在自己控制的位置；遷移後檢查本地文件路徑和核心可執行文件是否在新設備存在。

打開存儲位置

便攜版數據通常隨解壓目錄保存；安裝版運行目錄與數據目錄可能不同。“打開存儲所在的位置”能直接定位實際數據，便於備份、檢查 guiLogs 和查找配置。

手工編輯 guiNConfig.json 之前必須退出客戶端，避免退出保存覆蓋你的改動。guiNDB.db 是數據庫，不要用文本編輯器修改。

配置文件與參數

檢查更新與更新失敗

檢查更新可更新客戶端、核心和規則資源。7.25.6 提供通過代理檢查更新的選項；失敗時先確認當前節點能訪問下載源，再嘗試其他可用訪問方式。GitHub API 有頻率限制，短時間反覆檢查可能暫時受限。

更新窗口關閉後任務可能繼續在後臺運行。客戶端自更新需要另一個進程完成替換，非 Windows 平臺未顯示進度時應留出完成時間，未重啓再手動啓動。Wiki 標註 6.10–7.23.2 自更新存在歷史安全問題，仍使用這些版本時優先下載當前官方包並校驗後遷移。

下載校驗更新日誌

關閉窗口與退出進程

Windows 的部分關閉操作只隱藏主窗口到托盤，代理核心仍在運行。非 Windows 平臺的窗口關閉行爲受設置控制，可隱藏或最小化；明確退出會結束應用與核心。

判斷是否退出應查看托盤 / 進程和網絡狀態，不要僅根據窗口消失判斷。停止使用時先清除系統代理，再通過退出命令結束。

列表排序與信息過濾

點擊列表列名可切換正反排序；無效的延遲和速度數據始終排在後面。拖動列可調整順序和寬度，正常退出時保存佈局。配置列表的過濾是模糊查詢，不支持正則表達式。

信息欄過濾支持正則，但只對設置過濾器之後產生的信息生效。複雜日誌分析可先複製相關內容到文本工具；公開分享前隱藏訂閱、密碼與標識信息。