手動匯入 YAML 設定檔

什麼時候需要手動匯入

訂閱是一個 HTTP(S) 位址，用戶端定時去抓，把結果轉成本機設定。手動匯入是另一條路：你給用戶端一個檔案，它就跑這個檔案，不連網找任何東西。

• 別人傳來的完整設定。自建伺服器、公司內網的分流方案，多半是這個形式。
• 自己照範本寫的。就一兩台固定伺服器，犯不著搞訂閱。
• 從訂閱另存下來又改過的。這份從此和訂閱脫鉤，對面換 IP 它不會跟。

兩條路，挑一條走

1. 在設定檔頁面找新增入口，類型選「本機」或 Local，把檔案選進去。Clash Verge Rev 的入口在「訂閱」頁上方。
2. 或者繞過介面：用系統匣選單裡的「開啟設定資料夾」，把 .yaml 丟進去，別照別人的教學猜路徑。
3. 回用戶端點那張卡片，讓它成為目前設定。有的用戶端要按右鍵選「使用」。
4. 看記錄檔開頭十幾行。載入成功會印出節點數與規則條數，失敗的原因也在這裡。

副檔名 .yaml 和 .yml 都認，清單沒更新就重啟一次。另外，別人給的設定除了節點，還可能帶 rules、external-controller、secret，匯入前掃一眼比事後排查省事。

匯入了，但沒生效

解析失敗時用戶端多半給一行帶行號的提示，形如 yaml: line 42: 再跟一句英文。照那個行號去看。下面五種占了絕大多數。

• Tab 縮排。YAML 只認空格，而編輯器把 Tab 畫成一片空白，肉眼分不出來。打開「顯示空白字元」再看。
• 全形標點。從聊天軟體複製的片段常帶中文引號，name: "HK-01" 的引號是全形就解析不了。
• proxies 裡節點名稱重複。策略群組指過去走哪個說不準，有的核心直接拒絕載入。
• proxy-groups 引用了不存在的節點名稱。多一個空格、少一個 emoji 都算另一個名字，錯誤指向群組名而不是行號。
• 檔案帶 BOM。記事本另存 UTF-8 會在開頭塞三個位元組，核心讀到的第一個鍵就是壞的。換個編輯器存成不帶 BOM 的。

mixed-port: 7890
mode: rule
proxies:
  - name: my-node
    type: ss
    server: 203.0.113.10
    port: 8388
    cipher: aes-256-gcm
    password: change-me
proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - my-node
      - DIRECT
rules:
  - DOMAIN-SUFFIX,example.com,PROXY
  - MATCH,PROXY

卡住就先把設定換成上面這個骨架，確認它能載入，再一塊一塊把自己的東西加回去。

本機檔案不會自己更新

本機設定沒有來源位址，「更新」按鈕對它不起作用，有的用戶端直接把它變灰。在外部編輯器改完存檔，用戶端也不一定察覺——重新選一次設定或重啟核心才進得去。