Clash NyanpasuWindows
適合需要系統代理、設定檔編輯與服務模式的桌面使用者。下載前請開啟系統設定中的「系統 → 系統資訊」，確認處理器架構，再選擇對應的安裝檔。首次啟動時先匯入可用的設定檔，確認連接埠未被占用後再開啟系統代理；需要使用 TUN 時，再處理服務權限。
從 Clash for Windows 移轉時，請保留原始設定檔及自訂規則備份。新用戶端的設定檔目錄、覆寫入口與核心欄位支援可能不同，建議逐項移轉，不要直接覆蓋整個應用程式資料夾。
前往下載 Windows 用戶端FIG 1 / CONFIGURATION WORKSPACE
設定檔結構與分流功能
訂閱提供設定檔，用戶端負責整理設定檔，核心則負責執行規則。釐清三者的分工後，再調整覆寫、策略組與網路接管方式。
Clash Nyanpasu 著重於桌面設定檔管理。匯入遠端訂閱後，先確認設定檔能否載入，再檢查代理組與規則目標。以下範例用於說明欄位關係，不包含可直接連線的代理服務；範例中的 DIRECT 代表直接連線。行動裝置的用戶端選擇請見下方平台入口。
遠端訂閱與本機修改分層管理
Profile 是用戶端管理的一份設定檔，可以來自本機 YAML，也可以來自遠端訂閱。直接編輯訂閱內容，下一次更新時可能會遺失修改。若要長期保留連接埠、DNS 與自訂規則，建議放在獨立的覆寫中，並檢查最後產生的設定檔。不同用戶端處理清單欄位的替換、追加與腳本方式各有不同，不能一概視為單純合併。切換 Profile 前請保留可用的備份；載入後查看記錄，確認覆寫欄位位於預期層級。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info規則目標需與策略組一致
策略組將規則目標與實際出口分開管理。規則引用組名，組內再選擇可用出口；調整出口時，就不必逐條修改網域規則。select 類型可供手動選擇；其他組別類型的行為請參考核心文件。組名必須與 rules 中的目標完全一致，大小寫、空格或重新命名都可能影響引用。以下以 DIRECT 示範最精簡的結構，僅供說明語法。移轉舊設定時，先確認組別是否引用已刪除的成員，再檢查組別之間有無循環引用，最後確認兜底規則指向有效目標。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT從具體條件到最後的兜底規則
規則模式會依序檢查條件，通常由第一條符合的規則決定流向。因此，精確網域與局部例外應排在較廣泛的條件之前，並將 MATCH 作為最後的兜底規則。規則寫法正確但結果不符時，應一併檢查目前模式、目標策略組，以及前面的規則是否已先命中。GEOIP 等規則也仰賴相應的資料資源，不能只看單行文字判斷結果。以下範例中的 PROXY 必須先定義為有效策略組；若其中只有 DIRECT，符合該組的連線仍會直接連線，不會憑空產生代理出口。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY分別檢查網路接管方式與網域解析
系統代理主要供遵循系統代理設定的應用程式使用；TUN 則透過虛擬網路介面接管更多連線。啟用 TUN 前，請先在一般代理模式下確認設定檔可正常使用，再依用戶端提示安裝服務或授予權限。DNS 設定負責網域解析，fake-ip 是其中一種處理方式，不等同於啟用 TUN。若網域連線異常，先檢查解析路徑、系統中的其他網路軟體與核心記錄，避免同時更動多個開關。以下片段僅展示開關所在層級，完整使用仍須配合系統路由、權限與 DNS 設定。
tun:
enable: true
auto-route: true
dns:
enable: true
enhanced-mode: fake-ipFIG 2 / PLATFORM SELECTOR
Clash 用戶端平台入口
桌面與行動裝置請分別選擇。
安裝檔、處理器架構與系統需求請至下載頁查看。
選擇時請區分 Clash Nyanpasu 的桌面定位與 Clash 生態系的多平台用戶端。Windows、macOS、Linux 使用者可依桌面環境與設定習慣選擇圖形用戶端；Android 與 iOS 使用者則應選擇對應系統的 App，不要嘗試安裝桌面程式。此處提供五個平台的下載入口，實際用戶端請以下載頁清單為準。已有訂閱也需確認輸出格式，不同 App 支援的欄位可能有所差異。
macOS
先在「關於這台 Mac」確認是 Apple Silicon 或 Intel，再選擇安裝檔。安裝後依系統提示完成啟動授權；是否需要背景服務或網路相關權限，取決於所選用戶端與接管方式。先確認一般系統代理可正常使用，再逐步啟用其他網路功能，方便找出權限或設定問題。
切換用戶端前，先結束舊 App 並關閉其系統代理。若瀏覽器仍使用舊的代理位址，請檢查系統網路設定，而不是反覆匯入訂閱。
前往下載 macOS 用戶端Android
選擇符合裝置架構的 Android 用戶端，安裝後匯入相容的訂閱設定檔。首次建立連線時，系統通常會要求授權 VPN 連線；這是 App 建立本機網路接管通道的系統步驟，不代表訂閱已可正常使用，仍須檢查設定檔載入狀況與規則目標。
背景執行會受到系統電池策略影響。切換 App 後若連線中斷，先檢查電池最佳化與背景執行限制，再排查設定檔。若已有其他 VPN App 正在執行，也請先確認系統中的連線占用情況。
前往下載 Android 用戶端iOS
iPhone 與 iPad 使用者可從下載頁前往 Clash Plus 的 App Store 頁面。安裝後依 App 流程匯入設定檔，並在系統提示時允許新增 VPN 設定。訂閱連結應來自可信任的來源；請勿在截圖或公開討論中貼出包含存取憑證的完整網址。
桌面版設定檔可供移轉時參考，但不能因此假設所有腳本與覆寫功能都能照常使用。匯入後先檢查 App 支援的欄位與策略組，再進行自訂調整。
前往下載 iOS 用戶端Linux
桌面使用者請依發行版的套件格式選擇圖形用戶端，並確認桌面工作階段所需的相依套件。伺服器或路由器用途可查看下載頁的 mihomo 核心區；核心本身不提供完整的桌面設定管理介面，必須自行管理設定檔路徑、啟動參數與服務生命週期。
系統代理在不同桌面環境與命令列工具中的適用範圍各有不同。某個 App 未使用代理時，先確認它是否會讀取系統設定，再決定使用 App 層級的代理參數或其他接管方式。
前往下載 Linux 用戶端FIG 3 / SOURCE & RUNTIME
開源專案與核心的關係
GUI / PROFILE / CORE
用戶端與 Clash 生態系
Clash Nyanpasu 是 Clash 生態系中的開源桌面圖形用戶端。Clash 有時指早期專案，也常用來泛指相容的設定格式與相關用戶端。閱讀教學時，應區分專案名稱與設定語法，不能將某個舊用戶端的介面路徑直接套用到所有 App。選擇 Clash for Windows 替代方案時，應著重比較設定檔移轉、核心支援與服務權限，而不只是名稱是否相近。
圖形介面與 mihomo 的分工
用戶端負責訂閱記錄、介面操作、產生設定檔與系統整合；mihomo 則負責讀取設定檔，執行協定處理、規則比對與 DNS 等工作。介面顯示某個開關，不代表核心已成功載入對應設定。排查設定問題時，應交叉比對產生的內容與啟動記錄；解析錯誤時先修正 YAML 層級，引用錯誤時檢查組名，監聽失敗時檢查連接埠是否被占用，避免混淆不同層面的問題。
原始碼、授權條款與問題回報
可在 Clash Nyanpasu 開源儲存庫查看專案原始碼；專案採用 GPL-3.0 授權條款。原始碼、發布說明與問題記錄可分別用來了解實作、確認變更及找出已知行為。回報問題時，請註明作業系統、操作步驟、預期結果與相關記錄，並移除訂閱網址、驗證資訊及私人網域。能重現問題的最小設定檔，比包含大量無關欄位的完整設定檔更容易排查。
用戶端更新與設定檔更新
App 更新、核心更新與訂閱更新是三種不同操作。App 更新可能改變介面或設定檔處理方式；核心更新可能調整欄位支援；訂閱更新則會替換遠端內容。更新前請備份本機覆寫與可用設定檔，更新後先確認原有基本功能正常，再嘗試新增欄位。排查時不要同時更換用戶端、修改 DNS 和重寫規則，否則難以判斷是哪項變更造成影響。
取得專案原始碼
需要安裝本機 Git。複製儲存庫只會取得原始碼，建置方式請依儲存庫文件操作；日常使用請下載安裝檔。
git clone https://github.com/LibNyanpasu/clash-nyanpasu.gitREADING / RECENT NOTES
設定檔與平台文章
部落格文章會逐篇說明單一操作主題。規則文章協助理解比對順序，平台文章說明系統權限，設定檔文章則整理多份 Profile 的管理方式。若正在排查問題，先固定一份可用設定檔並保留原始記錄，再依文章內容逐次調整單一變數；不要混用不同系統的權限路徑與用戶端操作步驟。
Clash 自訂規則怎麼寫？rules 語法、比對順序與優先順序詳解
整理 DOMAIN-SUFFIX、IP-CIDR、GEOIP、RULE-SET、MATCH 等規則類型的寫法，說明由上而下比對、首條符合規則生效的機制與規則排序原則。
閱讀文章 →macOS 安裝 Clash Nyanpasu：網路擴充功能授權與鑰匙圈提示處理
針對 macOS 上的「無法開啟」、服務模式授權、允許網路擴充功能，以及鑰匙圈反覆跳出提示等問題，依照系統設定路徑逐項提供處理步驟。
閱讀文章 →Clash Profile 是什麼？設定檔基礎概念與多設定檔切換管理
從 Profile 與 config.yaml 的關係談起，說明本機設定、遠端訂閱與覆寫腳本的分工，以及多份設定檔並存時的命名、切換與備份方式。
閱讀文章 →