Profile、config.yaml 與執行設定

Profile 是用戶端管理的一份設定檔案。來源可以是本機 YAML 檔案，也可以是遠端訂閱網址。除了設定內容，檔案通常也會附帶名稱、來源、更新時間等管理資訊。切換 Profile，主要是切換設定來源與內容，並非重新安裝用戶端或變更作業系統的網路設定。

config.yaml 是常見的設定檔名稱，並非所有 Profile 共用的固定識別名稱。直接執行 Clash 或 mihomo 核心時，可以指定某個設定檔；使用 Clash Nyanpasu 時，用戶端可能會將訂閱內容、用戶端設定與覆寫處理組合成供核心載入的執行設定。因此，設定清單中的原始內容不一定與核心最後讀取的內容完全相同。

項目主要內容查看位置
Profile 檔案名稱、來源、設定內容與管理資訊用戶端的「設定檔」頁面
來源 YAML節點、策略群組、規則與其他設定欄位設定編輯器或匯出的來源檔案
執行設定經用戶端處理後交由核心載入的欄位執行設定的查看入口與核心記錄
用戶端設定系統代理開關、介面選項與用戶端管理參數用戶端的「設定」頁面

排查問題時，先確認修改的是哪一層。修改來源 YAML 後未生效，可能是尚未重新載入，也可能是同名欄位被用戶端設定或覆寫取代。修改暫時產生的執行檔，即使當下有效，下次切換、更新或重新啟動時也可能重新產生。

本機設定、遠端訂閱與覆寫各自的用途

本機設定：輸入固定，方便重現

本機設定適合測試規則、重現故障與離線留存。匯入後應確認用戶端是複製檔案內容，還是保留原檔案的參照；不要假設修改桌面上的原始檔案就會同步到用戶端。可以修改名稱、重新匯入並比對內容，確認用戶端如何管理檔案。

遠端訂閱：定期取得設定的來源

遠端 Profile 通常會儲存訂閱 URL，並在手動或定時更新時重新取得內容。若訂閱提供完整的 Clash YAML，就可能同時包含 proxies、proxy-groups 和 rules。只有節點 URI 的文字並不是完整的 Clash 設定檔，不能只把副檔名改成 .yaml 就完成轉換。

直接編輯遠端檔案中的節點或規則時，必須考慮下次更新。若更新會取代來源內容，手動修改也會一併被覆蓋。想長期保留個人規則，應放在獨立維護的覆寫層，或將訂閱另存為本機檔案後自行維護；採用後者就不會再自動取得原訂閱的更新。

覆寫腳本：保留個人設定差異

覆寫可在輸入設定上新增或調整欄位，例如加入區域網路直連規則、統一記錄等級。實際支援的合併方式、腳本介面、處理順序與適用範圍，會依用戶端版本而異。不要直接把其他用戶端的腳本當成 Clash Nyanpasu 通用介面，也不要假設清單欄位一定會以附加方式合併。

建立一份可驗證的本機 Profile

以下 YAML 可用來測試匯入、切換與規則載入，不含代理伺服器。請以 UTF-8 編碼儲存為 local-check.yaml，在「設定檔」頁面透過本機檔案匯入功能新增，再選取該檔案並確認載入狀態。功能名稱可能隨版本變動，請以目前介面中的檔案匯入操作為準。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

proxy-groups:
  - name: Local-Choice
    type: select
    proxies:
      - DIRECT
      - REJECT

rules:
  - DOMAIN,example.com,DIRECT
  - MATCH,Local-Choice
  • mixed-port: 7890 是本例指定的 HTTP 與 SOCKS 共用連接埠，不代表所有用戶端版本的預設連接埠。
  • allow-lan: false 用於限制區域網路連線，請勿將本例當成區域網路共用代理設定。
  • mode: rule 表示規則模式；若用戶端另行管理模式，請檢查介面目前的設定值與最終執行值。
  • Local-Choice 只包含直連與拒絕這兩個內建目標，成功匯入不代表已具備遠端代理功能。

載入後，請在策略群組頁面確認 Local-Choice 存在，並選取 DIRECT。若要測試本機 HTTP 代理連接埠，可以執行以下指令；此測試不受系統代理開關影響，也不代表瀏覽器的所有流量都已由代理接管。

curl --proxy http://127.0.0.1:7890 --head https://example.com

查看指令結果時，也請一併檢查連線記錄。example.com 應符合網域直連規則；若連接埠連線遭拒，請先檢查核心是否已啟動及實際監聽的連接埠，不要立刻歸因於訂閱。

多組設定的命名與切換步驟

依來源、用途與狀態區分檔案

名稱應清楚說明內容範圍。建議採用「來源－用途－狀態」格式，例如 訂閱A－日常－穩定、本機－規則驗證－測試、訂閱B－備用－待檢查。名稱不要包含完整訂閱 URL 或帳號權杖。日期可放在備份檔名中，避免設定清單每天都出現相似的新名稱。

  1. 記錄目前狀態。記下目前的檔案、策略群組所選節點、規則模式、實際連接埠，以及系統代理與 TUN 開關狀態。以 7890 為例，切換後若監聽連接埠改變，手動設定代理的應用程式也需要跟著調整。
  2. 檢查目標檔案。遠端檔案先更新一次，確認內容取得成功；本機檔案則檢查 YAML 縮排與規則目標，並確認所引用的策略群組確實存在。
  3. 切換設定。在「設定檔」頁面選取目標檔案，等待用戶端完成載入。檢查核心記錄是否出現解析失敗、不支援欄位或連接埠被占用等訊息。
  4. 重新確認策略群組。兩個 Profile 即使都有名為「代理」的策略群組，成員也可能不同。請查看目前選取的具體節點，不要只依群組名稱判斷。
  5. 建立新連線進行驗證。重新載入網頁，並檢查連線記錄中的規則、策略鏈與目標。只看到檔案卡片已選取，還不足以確認流量路徑正確。

切換 Profile 通常只會對後續連線生效，既有連線不一定會立即切換。若要嚴格驗證，可先關閉測試中的應用程式再重新開啟，或使用用戶端提供的關閉連線功能。關閉連線會中斷下載、會議與長時間連線，請先儲存工作。

多個 Profile、節點與 TUN 的差異

同一份 Profile 可以包含多個節點，並透過 select、url-test 等策略群組管理。若只是從節點 A 切換到節點 B，通常不必建立新的 Profile；需要更換整套規則、DNS 設定或訂閱來源時，再考慮切換檔案。

一般桌面用戶端執行個體通常只會向目前的核心提供一份最終執行設定。清單中同時有三份 Profile，不表示三份規則會自動並行疊加。若要組合多個來源，應使用明確支援的設定組合機制，並檢查節點名稱、策略群組名稱與規則目標是否衝突。

流量接管與選擇設定是兩回事

  • 系統代理：影響遵循作業系統代理設定的應用程式。部分程式使用自己的代理設定，或完全不讀取系統代理。
  • TUN 模式：透過虛擬網路介面與相關路由接管流量，並需要作業系統權限及正確的 DNS、路由設定。
  • Profile：提供核心處理連線時使用的節點、規則與相關參數，與上述流量接管開關並不相同。

切換 Profile 後，若某個應用程式仍然直連，請先確認該應用程式是否出現在核心連線記錄中。若沒有記錄，優先檢查流量接管方式；若有記錄但連線走錯目標，再檢查模式、規則順序與策略群組選擇。不要只為了解決規則比對問題，就反覆開啟或關閉 TUN。

覆寫的最小變更與相容性檢查

長期使用的覆寫應保持範圍精簡、目標明確。例如只新增一條內網直連規則，而不是複製整份訂閱再逐項取代。規則目標應盡量引用已確認存在的群組名稱；若不同 Profile 的群組名稱不一致，就應分別設定，或在處理邏輯中明確確認目標是否存在。

# 插入到 rules 清單前方，而不是 MATCH 後方
- IP-CIDR,192.168.50.0/24,DIRECT,no-resolve

這是一段規則片段，並非可單獨匯入的完整 Profile。它只涵蓋範例網段 192.168.50.0/24；若實際區域網路使用 192.168.1.0/24，請依路由表調整。no-resolve 表示不為比對這條 IP 規則而主動觸發網域解析，並非關閉所有 DNS 查詢。

  1. 先在穩定檔案的副本上測試，保留原檔案作為復原選項。
  2. 每次只修改一類欄位，例如先改規則，再改 DNS；不要同時調整連接埠與 TUN。
  3. 檢查最終執行設定，確認欄位值、清單順序與規則目標都符合預期。
  4. 執行一次訂閱更新後再次檢查，確認個人變更仍能透過覆寫穩定產生。

Clash、Clash Meta（mihomo）與各版本支援的欄位並不完全相同。出現「未知欄位」或不支援規則類型時，請先記下目前的核心名稱與版本，再參閱 YAML 手冊檢查相容性。單純更改 Profile 檔名，無法解決核心功能差異。

設定備份與復原順序

備份內容不只有一份 YAML

一份可供復原的備份，應包含設定內容、覆寫內容與必要的用戶端設定紀錄。遠端 URL 也應保存，但請另外加密存放。只備份訂閱連結，無法保留訂閱服務日後移除的節點；只備份來源 YAML，也可能漏掉實際生效的個人覆寫。

  • 來源設定：匯出穩定檔案，例如 local-check-2026-09-27.yaml。
  • 覆寫與關聯：保存腳本、規則片段，以及它們適用於哪些 Profile 的說明。
  • 環境紀錄：記下用戶端版本、核心版本、監聽連接埠，以及系統代理與 TUN 狀態。
  • 敏感資訊：檢查訂閱權杖、節點密碼、控制介面金鑰與憑證資料，避免上傳至公開儲存庫。

復原時，先匯入來源設定並確認能正常解析；接著還原覆寫並檢查最終欄位；最後再視需要啟用系統代理或 TUN。移轉至其他電腦時，不要照搬舊電腦的網卡名稱、絕對路徑與區域網路位址。若規則集或代理提供者需要從遠端下載，也要確認新電腦能取得相關內容。

常見異常的排查順序

現象優先檢查項目處理方式
切換後看起來仍是舊設定載入記錄、目前執行規則、既有連線確認載入成功，再以新連線測試
訂閱更新後規則消失是否直接修改遠端來源內容將個人設定差異移至覆寫或本機檔案
提示策略群組不存在規則目標與群組名稱是否完全一致檢查大小寫、空格及訂閱更新後的群組名稱
核心無法啟動第一個解析錯誤、欄位相容性、連接埠占用還原穩定檔案，再逐項恢復修改
只有部分應用程式未生效連線是否進入核心、應用程式自身代理設定先確認流量接管路徑，再檢查規則比對

穩定的管理方式是保留一份可供復原的檔案，將訂閱來源與個人修改分開，並在切換後確認執行狀態。設定檔負責描述流量處理方式，用戶端負責管理與載入，系統代理或 TUN 則負責將流量送進核心。依這三個層次排查，比反覆重新匯入訂閱更容易找出問題。