Windows
可選擇 Clash Plus、Clash Verge Rev 等用戶端。首次連線時先設定系統代理，再確認瀏覽器使用的連接埠是否相同；若要接管其他應用程式的流量，再設定 TUN 與服務權限。
前往下載01 / CLIENT DOWNLOADS
Clash 用戶端下載入口
桌面環境可選圖形介面用戶端；伺服器與路由器則依架構選擇 mihomo 核心。
用戶端負責訂閱管理、介面操作與系統整合，核心則負責連線與執行規則。先確認作業系統、處理器架構與安裝套件格式，再參考對應的安裝步驟。已有設定也應先備份，避免匯入時覆蓋本機規則。
macOS
依 Apple Silicon 或 Intel 選擇安裝套件。Clash macOS 下載入口列出圖形介面用戶端與封存專案；閱讀 ClashX Meta 下載說明時，請留意維護狀態及與目前系統的相容性。
前往下載Android
依裝置架構選擇 Android 安裝套件。首次啟動時須確認系統 VPN 授權，連線後再檢查背景執行限制。切換應用程式後若代理中斷，先查看電池最佳化與背景活動設定，不必反覆匯入訂閱。
前往下載iOS
前往下載頁查看 Clash Plus 的 App Store 入口與官方網站 clashplus.io。安裝後先匯入相容的設定，再依系統提示新增 VPN 設定；規則與策略群組是否可用，請以用戶端實際支援情況為準。
前往下載Linux
圖形桌面環境可選 Clash Verge Rev 或 FlClash。Debian 系與 RPM 系請選擇對應的套件格式；無桌面的伺服器可直接執行 mihomo。先使用 uname -m 確認架構，再設定目錄與服務。
安裝套件格式不等於處理器架構。發行版能安裝某種套件，仍須確認套件內的二進位檔適用於目前裝置。使用圖形介面用戶端時，也不要同時啟動獨立核心並占用相同的監聽連接埠。
查看所有用戶端02 / CONFIGURATION WORKSPACE
mihomo 設定與執行方式
從監聽入口到常駐服務，依需求逐步加入設定。
以下程式碼是欄位片段，並非完整訂閱。先讓本機代理連接埠正常運作，再設定流量接管與規則引用。每次只調整一類欄位，檢查記錄後再繼續，方便區分設定錯誤、權限問題與上游連線失敗。
mihomo 核心
mihomo 負責解析設定、監聽連接埠與執行分流；圖形介面用戶端則提供訂閱管理與系統整合。先設定 mixed-port，讓支援 HTTP 或 SOCKS 的應用程式明確連線至本機入口；再執行設定檢查命令，確認 YAML 可正常解析。相較於只依賴介面開關，直接維護檔案更適合伺服器與遠端終端機，但目錄、權限與記錄都須自行管理。控制介面應僅監聽本機，避免直接暴露於網路。
mixed-portmodeexternal-controller
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090先確認本機監聽位址。
TUN 透明代理
TUN 透過虛擬網路裝置接管流量，適合不讀取系統代理或環境變數的應用程式。與手動指定代理連接埠不同，TUN 涉及裝置權限、路由表與 DNS，因此應先確認一般代理測試正常，再啟用 TUN。在 Linux 上先確認 /dev/net/tun 是否存在，再依執行方式授予必要權限；啟用自動路由後，檢查是否能正常存取區域網路。若已使用 VPN、容器網橋或自訂策略路由，請先備份現有設定，避免兩個流量接管元件同時修改路由。
tun.enabletun.stackauto-route
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true接管路由前先檢查權限。
規則分流
規則模式會依序比對連線，第一條符合的規則決定流量去向。先加入明確的網域與區域網路例外，再加入規則集，最後以 MATCH 收尾；策略名稱必須與現有策略群組完全一致。與 Clash 全域模式將所有流量交由單一策略不同，規則模式可分別處理直連資源與代理連線。排查時查看記錄中的網域、目標位址與命中規則，不要只憑網頁能否開啟來判斷規則是否正確。遠端規則集也須確認下載成功、格式相符，且已在 rules 中引用。
rulesDOMAIN-SUFFIXMATCH
# 策略群組 Proxy 需在完整設定中定義
rules:
- DOMAIN-SUFFIX,example.org,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,Proxy依照由上而下的順序比對。
訂閱與 Provider
Provider 可將節點來源與本機策略分開管理，適合需要保留自訂規則的部署方式。proxy-providers 提供節點，rule-providers 提供規則，兩者不可互換。相較於以完整訂閱覆蓋設定，分開管理可獨立更新來源，降低本機修改遭覆蓋的機會。先確認回傳內容是相容的 YAML，再設定路徑、更新間隔與策略群組引用。訂閱網址通常含有存取憑證，應保存在本機；分享記錄或設定前，請先移除網址中的敏感參數。
proxy-providersrule-providersuse
proxy-providers:
local-nodes:
type: file
path: ./providers/nodes.yaml
proxy-groups:
- name: Proxy
type: select
use:
- local-nodes來源名稱與 use 引用必須一致。
systemd 常駐執行
systemd 可將終端機中的手動啟動改為可查詢、可重新啟動的服務。先建立使用者服務單元，指定二進位檔的絕對路徑與設定目錄，再執行設定檢查與啟動命令。相較於在背景追加符號啟動，服務單元能集中記錄日誌，並設定退出後的處理方式。使用者服務不等於系統服務；登出後是否繼續執行，還取決於 linger 設定。啟用服務也不會自動取得 TUN 權限。更新二進位檔後，應重新確認權限授予，再檢查服務與監聽狀態。
ExecStartsystemctl --userjournalctl
mihomo -t -d ~/.config/mihomo
systemctl --user daemon-reload
systemctl --user enable --now mihomo
systemctl --user status mihomo
journalctl --user -u mihomo -b先建立服務單元，再啟用服務。
欄位之間有引用關係：節點加入策略群組，策略群組再由規則引用；DNS 與路由則會影響流量能否依預期進入核心。設定檢查通過只代表檔案可被接受，仍須實際發出請求進行驗證。
查閱 config.yaml 設定參考03 / FIRST CONNECTION
Linux 快速入門三步驟
先建立可驗證的連線，再啟用透明代理。
圖形介面用戶端與直接執行核心的操作入口不同，但驗證順序相同。先確認設定來源，再確認核心已啟動，最後確認應用程式流量確實進入代理。不要把成功匯入訂閱當成網路連線正常。
STEP 01
選擇用戶端與設定目錄
桌面使用者可安裝圖形介面用戶端，依介面匯入設定；命令列部署則將檔案放入 ~/.config/mihomo/config.yaml。先備份現有檔案，再確認訂閱提供的是完整設定，還是僅含節點的 Provider。兩者的匯入入口不同，不能只改副檔名就直接互換。
設定網址由訂閱提供者提供；本站的下載入口只提供軟體，不附帶節點。遠端伺服器也須檢查目錄的擁有者，避免一般使用者無法讀取管理員建立的檔案。
STEP 02
檢查設定並啟動核心
命令列部署時，先執行設定檢查，確認縮排、欄位與策略引用都有效，再啟動核心。初次使用時保留 info 日誌，觀察監聽位址是否符合設定。若連接埠已被占用，先找出現有程序；不要一邊反覆更改連接埠，一邊讓應用程式沿用舊的代理位址。
mihomo -t -d ~/.config/mihomo
mihomo -d ~/.config/mihomo在圖形介面用戶端中，通常要啟用設定並啟動服務；實際按鈕位置請以用戶端介面為準。
STEP 03
驗證請求與規則命中
先透過明確指定的代理發出請求，確認應用程式能連線至本機連接埠，並在記錄中看到對應連線。接著再啟用系統代理並檢查瀏覽器；最後依需求啟用 TUN。每增加一層流量接管，就重複測試請求，才能判斷問題出在哪一層。
curl -I -x http://127.0.0.1:7890 https://example.org收到 HTTP 回應表示請求鏈路有收到回應，但不代表所有網域或規則都正常；仍應選擇實際需要使用的網站繼續驗證。
需要 Clash Verge Rev 教學時，先依圖形介面用戶端的流程完成匯入，再對照欄位參考了解底層運作方式。環境變數只會影響讀取它們的程序，系統代理也不等於接管所有連線；若終端機可用、瀏覽器卻無法連線，應分別檢查各自的代理入口，不要立刻更換訂閱。
查看完整教學04 / SOURCE & OPERATIONS
開源專案與部署範圍
了解軟體的專案來源，依執行記錄確認部署狀態。
Clash for Linux 整理用戶端下載與部署資料，並非所有用戶端的開發團隊。頁面中的命令呈現 Linux 常見用法，執行前仍須考量發行版、桌面環境與目前權限。開源授權、功能支援與維護狀態，應分別查閱各專案的說明。
Clash 生態系與 mihomo 的關係
Clash 生態系包含代理核心、圖形介面用戶端與周邊設定工具，名稱相近不代表屬於同一個專案。mihomo 延續 Clash.Meta 專案發展，保留 Clash 風格的設定組織方式，並擴充協定與執行能力。遷移舊設定時仍應逐段檢查，不要假設所有用戶端都支援相同欄位。遇到未知欄位時，先確認實際執行的核心，而不是只看視窗標題。
本站以 mihomo 的 Linux 部署為主軸，圖形介面用戶端章節則協助選擇下載入口。用戶端介面中的訂閱、覆寫與服務模式可能加入自己的設定層，最終交給核心的內容未必與匯入檔案完全相同。排查引用錯誤時，須區分原始訂閱、本機覆寫與執行中的設定。
原始碼與開源授權
mihomo 原始碼可在 MetaCubeX/mihomo 儲存庫查閱，專案採用 GPL-3.0 授權。閱讀原始碼、建置說明與問題紀錄，有助於確認特定欄位是否受支援，以及行為變化來自核心或用戶端整合。原始碼開放不代表下載後即可直接執行：複製下來的是專案檔案，編譯時仍須依上游說明準備工具鏈。
複製右側命令即可取得儲存庫，用來閱讀實作內容或準備自行建置。一般桌面使用者直接從下載頁選擇用戶端即可。第三方圖形介面用戶端各自維護發行時程，不能以單一核心專案的授權與更新紀錄取代所有用戶端的說明。
更新前先保留可還原的設定
核心、圖形介面用戶端、訂閱內容與規則集是不同的更新項目。升級軟體前，先保存正在使用的設定與服務單元，閱讀相關變更，再執行設定檢查。更新 Provider 只會替換來源資料，不等於升級核心；修改本機規則也不會自動同步至訂閱伺服器。確認每個檔案由誰管理，才能避免下次更新時覆蓋調整結果。
直接替換 Linux 二進位檔後，還須確認執行權限、服務路徑，以及 TUN 所需權限是否仍然有效。先在前景驗證啟動，再重新啟動常駐服務；若失敗，保留錯誤輸出，依序從設定、檔案存取與網路連線排查。
降低暴露風險並掌握執行狀態
單機使用時，讓代理入口與控制介面監聽回送位址，並維持 allow-lan: false。若要向區域網路提供服務，再明確設定監聽位址、防火牆範圍與存取控制。控制介面用來管理核心，不應只因代理可用就直接開放；訂閱網址也不應貼在公開的問題紀錄中。
使用 systemd 時，應以日誌作為首要排查依據。服務顯示執行中，仍可能發生訂閱讀取失敗或 DNS 設定問題；反之，某個網頁無法開啟也不一定代表服務已停止。搭配檢查監聽連接埠、發出一次明確的代理請求並查看相關日誌，通常比不斷切換模式更容易找出原因。
05 / DEPLOYMENT NOTES
設定解析與疑難排解
依實際部署問題延伸閱讀，不必在初次安裝流程中塞入所有參數。
完成初次連線後，再處理定時更新、欄位組織與行動裝置的背景執行策略。文章中的片段應搭配現有設定使用；複製前確認欄位所屬層級，修改後檢查執行中的設定，並以相同的請求比較調整前後的結果。
mihomo config.yaml 逐段解析：從 mixed-port 到 rules 的欄位順序與用途
依照設定檔的自然順序，逐段說明通用連接埠、執行模式、DNS、proxies、proxy-groups 與 rules 的寫法及各段引用關係，並為每一段附上可複製的範例。
閱讀文章Android 版 Clash Meta 耗電異常：背景常駐、電池最佳化白名單與 TUN 取捨
分析行動裝置上常駐代理耗電偏高的原因，涵蓋健康檢查頻率、日誌等級、各廠牌的背景執行限制與電池最佳化白名單設定，以及 VPN 模式下的省電調整方式。
閱讀文章Clash 訂閱更新失敗常見錯誤與 proxy-providers 定時重新整理設定
整理訂閱擷取逾時、憑證錯誤、UA 遭拒與格式不相容等錯誤訊息的含義，並說明如何透過 proxy-providers 的 interval 與健康檢查自動更新訂閱。
閱讀文章