Windows
優先推薦 Clash Plus，也可依使用習慣選擇 Clash Verge Rev、FlClash 或 Clash Nyanpasu。先查看系統資訊確認架構，再從下載頁選取對應安裝檔。若要從 Clash for Windows 移轉，重點在訂閱、規則與策略選擇，而不是直接覆蓋舊程式資料夾。啟動後請確認混合連接埠與系統代理位址一致。
前往下載FIELD REFERENCE
config.yaml 頂層欄位索引
用戶端負責匯入、切換與顯示設定，核心則依設定處理連線。請先分清監聽入口、解析方式與出站目標，再修改對應欄位。以下範例各自說明一項設定，請勿直接拼成完整訂閱；策略群組範例僅引用內建出站 DIRECT，實際代理節點須另外設定。
mixed-port:
HTTP 與 SOCKS 共用監聽連接埠
mixed-port 會在同一連接埠接收 HTTP 與 SOCKS 請求，適合瀏覽器、命令列工具及需要手動填入代理位址的應用程式。僅在本機使用時，位址通常設為迴圈位址，連接埠則須與執行中的設定一致。allow-lan 控制區域網路裝置能否連入，但也須一併確認監聽位址與系統防火牆設定。系統代理是用戶端寫入作業系統的設定，不代表所有應用程式都會經過該連接埠；若要接管其他流量，再依教學評估 TUN 模式。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infodns:
內建 DNS 與 Fake-IP 解析
dns.enable 控制內建解析服務，enhanced-mode 指定增強解析模式。Fake-IP 以虛擬位址保留網域名稱與連線的對應關係，方便依網域套用分流規則；nameserver 則列出上游解析伺服器。啟用內建 DNS 不代表系統請求會自動送到該服務，仍須確認 TUN 的 DNS 劫持或系統解析設定。排查 Clash DNS 洩漏時，應確認請求實際流向，而非只看開關狀態。若區域網路網域解析異常，再針對該網域設定過濾或解析策略。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-queryproxies:
代理節點與通訊協定參數
proxies 是節點定義清單，每個項目以 name 設定可供引用的名稱，並以 type 指定通訊協定。server、port 與驗證欄位須與伺服器端設定相符；不同通訊協定需要的參數各自獨立，不能用同一個密碼欄位取代。訂閱通常已包含節點資料，初次使用不必手動重寫。下方使用保留示例網域與教學用密碼，僅供說明結構，無法用來連線。通訊協定是否可用取決於目前核心的支援範圍；用戶端介面顯示名稱，不代表設定已通過核心檢查。
proxies:
- name: 範例節點
type: ss
server: proxy.example.com
port: 443
cipher: aes-128-gcm
password: "your-password"proxy-groups:
策略群組與出站名稱引用
proxy-groups 可將節點或其他策略群組組成出站目標。select 用於手動選擇，url-test 依測試結果自動選擇，fallback 則依可用性順序切換，三者用途不同，不能只看名稱就互換。規則引用的是群組名稱，而非介面上的排列位置。修改 name 後，請確認 rules 與其他群組中的引用也同步更新，並避免群組互相形成循環。範例先保留 DIRECT 作為有效引用；匯入實際訂閱後，再將訂閱中已有的節點名稱加入清單。
proxy-groups:
- name: 出站選擇
type: select
proxies:
- DIRECT
rules:
- MATCH,出站選擇rules:
由上而下套用的分流規則
rules 依清單順序比對，最先符合的規則會決定該連線的出站目標。DOMAIN 比對完整網域名稱，DOMAIN-SUFFIX 比對網域及其子網域，IP-CIDR 用於目標 IP 位址範圍，MATCH 通常放在最後，用來處理其餘連線。較明確的規則應排在較寬泛的規則之前，否則後續條件可能不會生效。修改後可在連線詳細資訊中查看命中規則與實際使用的策略群組。只有規則模式會依這份清單分流；切換至全域模式後，不應再用相同的規則命中預期判斷結果。
rules:
- DOMAIN,example.com,DIRECT
- DOMAIN-SUFFIX,example.org,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT
- MATCH,出站選擇profile:
策略選擇與 Fake-IP 狀態保存
profile 下的 store-selected 用於保存策略群組的選擇狀態，store-fake-ip 用於持續保存 Fake-IP 對應資料。這些設定管理執行狀態，不負責下載訂閱，也不會控制訂閱更新頻率。用戶端更新訂閱後，若群組名稱有所變更，舊的選擇紀錄可能無法對應；此時應重新檢查策略群組，而非反覆清除所有設定。修改訂閱內容前，請先確認用戶端是否支援覆寫或合併機制。直接編輯下載的檔案，可能在下次更新時被取代。
profile:
store-selected: true
store-fake-ip: true先確認執行中的設定，再定位欄位
用戶端儲存的訂閱原始內容、使用者覆寫檔案與核心最後載入的設定，可能不是同一個檔案。修改前請先確認目前啟用的訂閱，再查看用戶端提供的執行設定或合併結果，避免編輯到未使用的副本。
- 先備份現有設定。同一層級的欄位請對齊，子欄位以空格縮排，勿混用定位字元。
- 每次只修改一項設定。檢查策略群組、節點與規則中的名稱引用，並確認字串、布林值與清單等資料型別。
- 重新載入後查看記錄。若載入失敗，先排除欄位型別、縮排與引用錯誤，再測試網路連線。
- 確認訂閱更新後的設定保留方式。長期自訂規則應放在用戶端支援的覆寫或合併位置。
CLIENT / PLATFORM
依作業系統選擇 Clash 用戶端
先確認作業系統與處理器架構，再比較各用戶端的設定管理方式。桌面圖形介面適合管理訂閱與查看連線；伺服器和路由器可直接執行核心，但須自行處理設定路徑、服務啟動與網路權限。跨系統移轉時，可參考相同的 YAML 欄位；系統代理、TUN 權限與設定覆寫位置仍須分別調整。
macOS
先在「關於這台 Mac」確認裝置採用 Apple Silicon 或 Intel，再選擇對應安裝檔。優先推薦 Clash Plus，Clash Verge Rev 與 FlClash 也可作為其他介面選擇。首次啟用網路接管時，請依系統提示授予所需權限。選單列顯示程式正在執行，不代表系統代理已啟用；請搭配應用程式設定與連線記錄確認。
前往下載Android
優先推薦 Clash Plus，另可依設定格式選用 Clash Meta for Android、FlClash 或 Surfboard。確認裝置架構後安裝，首次連線時請同意系統 VPN 權限。應用程式分流與系統 VPN 設定會影響哪些應用程式透過代理連線。若連線初期正常、背景執行時卻中斷，請檢查電池管理與背景執行限制。
前往下載iOS
下載頁提供 Clash Plus 的 App Store 下載入口與官方網站 clashplus.io。安裝後匯入相容的訂閱，依系統授權提示允許加入 VPN 設定，再返回用戶端選擇策略群組。若無法連線，請先確認目前啟用的設定檔，並檢查是否同時啟用了其他網路延伸功能。
前往下載Linux
使用圖形桌面的 Linux 可選擇推薦的 Clash Verge Rev 或 FlClash，並依發行版選擇套件格式。系統代理通常仰賴桌面環境，終端機程式可能還需另外設定代理環境變數。沒有桌面環境的主機可參考下載頁的核心區，自行設定服務管理、工作目錄與權限；請勿直接將桌面用戶端的安裝步驟套用到路由器。
前往下載QUICK START / THREE STEPS
匯入訂閱、規則模式與連線測試
01 / IMPORT
匯入訂閱並啟用設定
向訂閱服務提供者取得適用於該用戶端的設定連結，在用戶端的訂閱或設定頁面新增遠端設定，下載完成後將其設為目前使用的設定。清單中出現項目只是第一步，還須確認核心已成功載入設定。連結可能含有存取憑證，排除問題時請遮蔽完整網址。若出現格式錯誤，先確認內容是 YAML 設定還是單一節點連結，不要只修改副檔名。
02 / ROUTE
選擇規則模式與出站策略
將執行模式設為規則模式，再開啟代理或策略群組頁面，為訂閱中需要手動選擇的群組指定出站目標。群組名稱由設定決定，不同訂閱可能各不相同。選擇節點不會自動讓系統流量進入用戶端；桌面版還須依需求啟用系統代理或 TUN，行動裝置則須完成系統 VPN 授權。首次測試請維持簡單設定，避免同時修改 DNS 與分流規則。
03 / VERIFY
查看連線詳細資訊，確認命中結果
開啟要測試的網頁，再查看用戶端連線清單中的目標網域、命中規則與出站策略。延遲測試成功只代表測試請求已完成，不能取代實際應用程式測試。連線清單沒有記錄時，先檢查流量入口；已有記錄但連線失敗時，再檢查規則目標、節點狀態與解析結果。確認連線正常後，可依需求設定訂閱更新頻率，並記下自訂覆寫的位置。
SOURCE / CORE / CONFIGURATION
Clash 生態系、mihomo 核心與原始碼入口
分清用戶端介面與代理核心
Clash 生態系以 YAML 設定、規則分流與圖形用戶端為基礎，發展出多種實作。早期專案的維護狀態有所變化，後續核心與用戶端也持續演進，因此「Clash」並不代表單一安裝套件。下載時請確認專案名稱、支援平台與維護狀態，不能只憑檔名含有 Clash，就認定它與現有設定完全相容。本網站提供文件與下載入口，不代表所有用戶端專案的開發者。
mihomo 是 Clash 生態系中的代理核心，負責通訊協定連線、規則比對與 DNS 等功能；Clash Verge Rev 等圖形用戶端則在其上提供設定管理與操作介面。介面選單通常不會與 YAML 欄位一一對應，某些開關會由用戶端產生或覆寫設定。排查問題時，先確認核心最後載入了哪些欄位，再檢查選單設定，可避免誤以為「檔案已修改，行為卻沒有改變」。
開源資訊與授權範圍
mihomo 的原始碼、授權條款、問題討論與發行紀錄都可在專案儲存庫查閱，該儲存庫採用 GPL-3.0 授權。不同開源專案的授權與打包方式須分別確認，不能將核心授權視為所有用戶端、訂閱服務或第三方設定的通用授權。若要重現問題，請記錄使用的用戶端、核心資訊與觸發條件；回報問題時只保留必要片段，並移除訂閱網址、密碼及其他存取憑證。
程式更新、訂閱更新與覆寫保留方式
更新用戶端程式、更新核心與重新整理訂閱是不同操作。程式更新會改變介面或整合功能；核心更新可能改變欄位支援與處理方式；訂閱更新則會替換遠端設定內容。若設定載入錯誤，請先查看錯誤位置與欄位型別，不要只靠頻繁更換程式來迴避問題。較新的設定欄位不一定能被較舊的用戶端識別，移轉前可先閱讀用戶端選擇指南。
長期維護的自訂規則，建議優先放在用戶端支援的覆寫或合併機制中，並確認合併發生於訂閱處理的哪個階段。清單可能會被取代，也可能依用戶端規則附加，不能只憑 YAML 層級判斷。每次更新後，請檢查重要策略群組名稱、末尾的 MATCH 與 DNS 設定是否符合預期。完整範例與適用範圍請參閱設定參考；若要檢視原始碼，請從專案儲存庫開始。
CONFIGURATION NOTES
近期設定文章
文章依不同操作情境說明：分享代理時先確認監聽入口，選擇節點時分辨測試結果與計費規則，轉換訂閱時檢查設定結構。通用欄位可對照設定參考，不必將單篇文章中的局部設定直接套用到現有設定。
Clash 區域網路代理分享：mixed-port 與 allow-lan 設定步驟
說明 mixed-port 混合連接埠與 allow-lan 的用途，並提供設定步驟，讓同一區域網路中的手機、電視與遊戲主機使用電腦代理，同時提醒防火牆設定注意事項。
閱讀設定說明 →如何挑選 Clash 節點：延遲測試、流量倍率與地區及協定的取捨
說明延遲測試數值的意義與限制、流量倍率對用量的影響，並依用途提供選擇地區與協定的建議，協助你從節點清單中做出判斷。
閱讀設定說明 →Clash YAML 訂閱與 Base64 節點連結：格式差異與轉換方式
比較 Clash YAML 訂閱、Base64 編碼連結與單一節點 URI 的結構，說明轉換時各欄位的對應方式，以及轉換後需要檢查的內容。
閱讀設定說明 →