Windows
適合常見桌面與筆記型電腦。安裝前先確認系統架構，完成安裝後從訂閱頁面匯入設定，再開啟系統代理。若核心無法啟動，可檢查安全軟體攔截、連接埠佔用與設定語法。
前往下載
核心設定
從訂閱匯入到穩定分流
每項設定都對應明確的網路範圍。先了解系統代理、TUN、規則模式與 DNS 的職責，再調整開關，比反覆更換節點更容易定位問題。
設定一
將訂閱網址轉換為可管理設定
訂閱匯入不只是簡單儲存一段網址。用戶端會請求遠端內容、解析代理節點與策略群組，再產生可選擇的本機設定。貼上網址後，應先確認請求成功，再選取剛匯入的設定，最後檢查策略群組是否出現。若清單為空，應優先核對網址是否完整、網路權限與訂閱服務狀態，而不是連續重複加入同一個網址。
Clash Nyanpasu 將設定管理、更新時間與啟用狀態集中在同一處，適合保留日常設定與排查用的備用設定。更新前可記錄目前的策略選擇，更新後再檢查規則群組名稱是否變更，避免新設定覆蓋原有選擇後誤判為連線故障。
- ×只完成匯入，卻沒有選取設定，代理清單仍不會切換到新內容。
- ✓依序確認匯入、啟用與選取策略群組，發生問題時才能判斷卡在哪個步驟。
匯入訂閱
設定管理
https://example.com/subscription
日常規則設定
已選取，可手動更新
設定二
使用 TUN 模式接管更多應用程式流量
系統代理主要影響主動讀取系統代理設定的程式，部分終端機指令、遊戲啟動器與獨立網路元件可能會繞過它。TUN 模式透過虛擬網路介面接管更廣泛的流量範圍，適合瀏覽器可以存取、終端機卻無法連線的情況。啟用前應儲存正在進行的網路工作，並留意系統是否要求授予網路延伸功能或管理員權限。
TUN 並非解決所有問題的通用開關。若規則本身有誤、DNS 回應異常或訂閱已失效，擴大接管範圍也無法修復根本原因。較穩妥的順序是先確認設定能啟動，再檢查系統代理，最後依應用程式範圍決定是否啟用 TUN，並在切換後重新測試目標程式。
- ×同時修改 TUN、DNS 與代理模式，發生異常後很難判斷是哪項設定造成的。
- ✓一次只切換一項網路層設定，並使用同一個網站或指令重複驗證結果。
網路接管
系統設定
系統代理瀏覽器與桌面應用程式
TUN 模式虛擬網路介面
區域網路連線依需求單獨開啟
設定三
讓不同請求進入對應策略群組
規則模式會依設定中的網域、IP、程序或規則集合逐一比對，並將請求交給指定的策略群組。它適合日常使用，因為本機服務、直連網站與需要代理的請求可以分別處理。全域模式則會把大部分請求交給同一個代理策略，更適合短時間驗證節點是否可用，不宜用來判斷規則設定是否正確。
排查分流時，先查看命中的規則，再檢查該規則指向哪個策略群組，最後確認策略群組目前的選擇。僅在代理清單中更換節點，無法修復請求被錯誤送入直連群組的問題。Clash Nyanpasu 的規則與策略入口彼此獨立，依「請求—規則—策略群組—節點」的順序檢查會更清楚。
- ×目標網站打不開時立刻切換全域模式，長期掩蓋規則命中錯誤。
- ✓先找出命中的規則與目標策略群組，再決定補充規則或調整群組內的選擇。
規則片段
規則模式
DOMAIN-SUFFIXexample.org代理GEOIPLAN直連MATCH其餘請求節點選擇
設定四
將網域解析納入同一排查流程
DNS 決定網域會先解析成哪個位址，規則則決定後續連線採用什麼策略。網頁提示網域無法解析、同一節點只有部分網站失敗，或關閉用戶端後解析仍異常時，都應單獨檢查 DNS。先確認用戶端核心正常運作，再比較系統 DNS 與設定內 DNS 的結果，避免把解析問題誤認為節點品質問題。
修改 DNS 後，需要考慮系統快取、瀏覽器快取與用戶端快取。測試時應關閉舊連線並重新發出請求，必要時清除系統解析快取。若設定啟用了增強模式，還要核對模式名稱、監聽連接埠，以及是否與其他本機 DNS 工具衝突；逐層縮小範圍，比頻繁更換整份設定更有效。
- ×看到連線逾時就認定節點失效，沒有先區分解析失敗與連線失敗。
- ✓分別驗證網域解析、規則命中與代理連線，保留每一步的明確結論。
DNS 設定
依設定啟用
啟用 DNS
增強模式fake-ip
設定來源目前訂閱
平台入口
依裝置選擇Clash 用戶端
首頁只提供平台導覽。進入下載頁後，可比較同一平台上的 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 等用戶端，再依處理器架構與系統類型選擇安裝套件。
macOS
下載時需區分 Apple 晶片與 Intel 處理器。首次啟動若出現系統安全提示，應在系統設定中確認應用程式權限；啟用 TUN 時也可能需要允許網路延伸功能，完成後重新測試連線。
前往下載Android
適合手機、平板與部分電視裝置。安裝後需要建立本機 VPN 連線，系統省電策略可能在背景停止用戶端，因此長期使用時應檢查背景執行權限與電池最佳化設定。
前往下載iOS
透過應用程式商店進入 Clash Plus 安裝頁面。首次連線時，系統會要求加入 VPN 設定，確認後再匯入訂閱；若切換網路後無法存取，可中斷舊連線並重新建立本機 VPN 工作階段。
前往下載Linux
提供圖形用戶端，以及面向伺服器、路由器環境的 Mihomo 核心入口。桌面使用者可優先選擇圖形介面；命令列部署則應先閱讀服務管理、設定路徑與檔案權限說明。
前往下載
開源生態系
用戶端、核心與設定的關係說明
判斷一個 Clash 用戶端是否適合長期使用，不能只看介面。更重要的是了解圖形用戶端如何呼叫核心、設定如何決定流量路徑，以及專案更新如何傳遞到本機安裝。
專案歷史與定位
Clash Nyanpasu 屬於 Clash 圖形用戶端生態系，主要負責設定匯入、策略選擇、系統代理控制、TUN 開關、日誌檢視與核心管理等工作。圖形介面降低了直接編輯設定檔的操作成本，但實際網路行為仍由所使用的核心與目前設定共同決定。因此，介面顯示「已連線」只代表用戶端程序正在運作，並不等同於訂閱、規則、DNS 與目標節點全部正常。
使用過程中，應將用戶端視為設定與核心的管理入口。遇到故障時，先確認用戶端是否啟動，再檢查核心日誌與設定載入結果，之後才檢查策略群組與節點連線。分層排查可以避免把訂閱失效、規則設定錯誤或本機連接埠衝突全部歸咎於用戶端本身。
開源協作與可審閱性
程式碼公開代表功能變更、問題回報與修復過程都能在專案儲存庫中追蹤。使用者可以查看提交記錄、發行說明與已知問題，維護者也能透過可重現的日誌與操作步驟定位問題。提交回饋時，建議說明作業系統、安裝方式、目前代理模式、問題發生前後的操作，以及經過處理的日誌片段，避免只寫「無法使用」這類難以重現的描述。
開源協作不代表每個問題都會由用戶端直接解決。訂閱內容由相關服務提供，節點狀態取決於線路，系統網路權限則由作業系統管理。清楚區分責任範圍，才能將問題提交到正確的位置，也能減少在多個設定頁面之間漫無目的地切換。
Mihomo 核心關係
Mihomo 負責讀取設定、建立代理連線、執行規則比對、處理 DNS，並向圖形用戶端提供運作狀態。Clash Nyanpasu 則將這些能力整理成可操作的介面。策略群組、規則集合、混合連接埠、TUN 與 DNS 增強模式等概念，本質上都來自核心設定；用戶端中的開關通常會轉換為對應的設定或啟動參數。
這也解釋了為什麼同一份設定在不同用戶端中的主要分流結果通常相近，而系統代理寫入方式、權限請求、系統匣操作與更新流程可能不同。遷移用戶端時，先備份訂閱網址與自訂設定，再逐項還原，不應直接假設所有介面開關名稱與預設行為完全一致。
更新與變更檢查
用戶端、核心與訂閱設定各有自己的更新週期。用戶端更新可能改變介面與系統整合方式，核心更新可能增加設定能力或調整相容行為，訂閱更新則可能改變節點、策略群組與規則。日常使用不必同時更新三者；較穩妥的做法是一次處理一層，並在變更後驗證啟動、訂閱、規則與目標網站。
更新前可記錄目前使用的策略群組與重要開關，更新後先查看發行說明，再執行一次基本連線測試。若發生問題，保留舊設定與明確的重現步驟，有助於判斷原因是本機設定、上游設定還是新功能變更。本網站下載頁負責整理平台入口，教學與故障排除頁則分別處理首次設定與異常定位。
專案儲存庫複製指令
git clone https://github.com/LibNyanpasu/clash-nyanpasu.git
常見問題精選
先確認問題發生在哪一層
多數連線問題可分為用戶端啟動、設定載入、系統接管、規則比對、DNS 解析與節點連線六個層次。先找出所在層級，再選擇對應的處理方法。
匯入訂閱後，為什麼代理清單仍然是空的？
瀏覽器可以存取，為什麼終端機指令沒有經過代理？
系統代理只對主動讀取系統設定的程式生效，部分終端機工具需要單獨設定代理環境變數，或透過 TUN 模式接管。排查時先確認終端機工具使用的協定與連接埠，再決定設定環境變數或啟用 TUN。不要在同一次測試中同時修改系統代理、環境變數與 DNS，否則很難判斷哪項設定真正生效。完整流程請參閱故障排除。
規則模式與全域模式應該如何選擇？
規則模式依據網域、IP 或規則集合決定直連與代理，適合日常使用；全域模式則將大部分請求交給同一個代理策略，適合短時間驗證節點連通性。若全域模式可以存取、規則模式卻失敗，應檢查目標請求命中的規則與策略群組，而不是長期停留在全域模式。關於 MATCH、GEOIP、策略群組等概念，可前往術語表繼續查閱。
啟用 TUN 後無法上網，應先關閉哪些設定？
先關閉 TUN，確認基本系統代理是否能恢復，再檢查管理員權限、虛擬網路介面、DNS 設定與其他 VPN 軟體是否衝突。不要直接刪除所有設定，因為設定內容可能沒有問題。恢復基本連線後，再單獨啟用 TUN 重新測試；若日誌提示介面建立失敗或權限不足，應先處理系統層面的問題。更多症狀對應步驟請見故障排除。
設定文章
近期的排查與進階說明
文章依具體症狀拆解檢查順序，重點說明應觀察什麼、如何縮小範圍，以及哪些設定不應同時修改。
Clash 速度很慢怎麼辦：節點、線路、本機設定三層排查清單
速度變化可能來自節點品質、線路壅塞、協定開銷、倍率設定、分流規則或本機 DNS。文章從可重複的測試著手，分開判斷節點問題與本機設定。
閱讀全文 →Clash 連接埠被佔用導致啟動失敗：找出佔用程序並修改混合連接埠
用戶端無法啟動核心時，先確認混合連接埠是否被其他程式佔用，再決定結束衝突程序或修改設定，避免不斷重新安裝卻持續遇到相同錯誤。
閱讀全文 →系統代理未生效排查：瀏覽器使用了代理，為什麼終端機沒有？
瀏覽器、終端機與獨立網路元件讀取代理設定的方式不同。文章分別檢查瀏覽器覆寫設定與終端機環境變數，並說明何時需要使用 TUN。
閱讀全文 →