訂閱更新失敗：先分辨下載、解析與節點連線問題
FlClash 更新訂閱時，會先連線至訂閱網址取得設定內容，再進行解析並儲存。節點連線則是另一個流程。因此，「訂閱更新失敗」和「節點測速逾時」需要分開處理：舊設定中的節點仍可使用，不代表訂閱網址仍然有效；訂閱更新成功，也不代表其中每個節點都能連線。
排查前，請先保留目前可用的設定。記下錯誤發生時間、錯誤訊息，以及當時使用的網路。暫時不要刪除舊訂閱，也不要同時修改 DNS、TUN 和規則模式。一次只變更一個條件，才能找出是哪個步驟造成影響。
| 錯誤或現象 | 優先檢查 | 下一步 |
|---|---|---|
401、403 |
權杖、帳戶權限、伺服器存取限制 | 登入訂閱來源平台，重新複製用戶端專用連結 |
404、410 |
舊版介面、連結路徑或已撤銷的網址 | 確認提供者是否更換訂閱入口 |
429 |
請求頻率限制 | 停止連續更新，依伺服器提示稍候再試 |
timeout、連線逾時 |
網路路徑、代理出口、伺服器回應 | 切換網路路徑後，手動更新一次 |
YAML、解析失敗 |
回應內容、訂閱格式、核心支援狀況 | 確認取得的是 Clash / mihomo 設定 |
錯誤碼只是線索，不能單憑它下結論。例如，403 可能代表訂閱權限失效，也可能是網站的存取防護所致；200 只表示 HTTP 請求收到回應，內容仍可能是登入頁面。
手動更新位置：從設定項目確認更新結果
常見操作路徑為「設定」→ 找到對應的遠端設定 → 點選該項目的更新圖示，或開啟項目選單並選擇「更新」。不同平台與發行版本可能將操作放在卡片右側或更多選單中；請針對實際訂閱項目操作，而不是只重新啟動首頁的連線開關。
- 確認設定類型。透過連結新增的遠端設定，才有可重新發送請求的訂閱網址。若是從本機檔案匯入，請重新匯入檔案，或另外新增遠端連結。
- 一次只更新一個項目。訂閱項目較多時，先單獨更新出錯的項目，避免大量請求讓錯誤訊息混在一起。
- 等候這次請求完成。查看成功提示、錯誤詳情和更新時間；連續點擊無法修復失效連結，還可能觸發頻率限制。
- 確認目前選取的項目。更新了設定 A，卻仍選取設定 B 時，代理群組和節點清單不一定會有變化。
連結失效與權限問題：重新取得正確的訂閱入口
分辨訂閱連結、管理頁面與分享連結
FlClash 需要能直接回傳設定內容的網址。帳戶面板網址、必須登入才能瀏覽的下載頁面，以及一般節點分享連結，都不是完整的 Clash 訂閱。請前往提供者的訂閱區，選擇標示為 Clash、Clash Meta 或 mihomo 的入口；若入口依用戶端分類，請優先選擇明確支援 FlClash 的項目。
複製後請檢查網址是否遭通訊軟體截斷，末尾是否多出空格、換行或中文標點。查詢參數中的權杖必須保持原樣；不要自行刪除看似多餘的參數，也不要反覆解碼或編碼特殊字元。
依回應狀態處理權限與流量限制
- 401 或 403：檢查帳戶狀態、訂閱權限，以及權杖是否已重設。若瀏覽器顯示驗證碼或存取驗證，通常無法透過用戶端完成網頁互動驗證，請向提供者索取用戶端可用的入口。
- 404 或 410：確認舊訂閱介面是否已移轉。請從管理面板重新複製連結，不要只嘗試修改舊網址的網域。
- 429：暫停手動更新，並避免其他裝置密集發送請求。若回應提供
Retry-After，請依指示等候後再試。 - 500、502 或 503：訂閱服務或上游可能暫時異常。請保留舊設定，稍後再試；若持續發生，再聯絡提供者。
請求逾時與憑證錯誤：檢查實際連線路徑
訂閱請求不一定使用與瀏覽器相同的出口。瀏覽器可能透過系統代理連線，但用戶端下載設定時可能採用自己的請求策略；啟用 TUN 後，流量路徑也可能改變。因此，瀏覽器能開啟訂閱網址，只能證明其中一條路徑可連線，不能直接證明 FlClash 的更新請求也能連線。
透過兩組對照縮小範圍
- 本機網路對照：先記錄 Wi-Fi 下的錯誤，再切換至手機熱點或其他可信任的網路，手動更新同一個訂閱項目。若只有某一條網路失敗，請優先檢查該網路的 DNS、入口網站驗證或存取限制。
- 出口路徑對照：保留舊設定。若目前版本提供訂閱更新代理選項，可分別測試直連和已可用的代理；若沒有此選項，不要把「切換至全域模式」視為必定會改變訂閱下載路徑。
若出現 no such host 等錯誤，請先檢查網域拼字和 DNS 解析。若出現 connection refused，請確認連線目標是否為已停止監聽的本機代理連接埠。若錯誤指向 127.0.0.1:7890，此處的 7890 只是該次請求使用的連接埠，請與用戶端實際設定核對，不可直接視為所有安裝環境的預設值。
若出現憑證錯誤，請先檢查系統日期、時區和自動校時。certificate has expired 可能是伺服器憑證過期，也可能是裝置時間不正確；若憑證網域不符，請核對訂閱網域和重新導向目標。不要透過關閉憑證驗證來掩蓋問題，訂閱權杖需要 HTTPS 保護。
若首次匯入的網址只能透過代理存取，而用戶端尚無可用設定，請向提供者詢問可直連的訂閱入口或本機設定匯入方式。反覆更新同一個無法連線的網址，無法建立最初的連線路徑。
格式解析失敗：確認回傳的是 Clash / mihomo 設定
Clash 系列用戶端通常使用 YAML 設定。其他用戶端使用的 JSON 設定或編碼後的節點 URI 清單，不能只靠更改副檔名轉成可用的 Clash 設定。FlClash 使用的 mihomo 核心與原版 Clash 在功能支援上也有差異，訂閱內容必須符合實際用戶端的能力。
檢查檔案內容，而不只看副檔名
- 內容以
<!DOCTYPE html>或登入表單開頭：取得的是網頁，請優先處理登入、重新導向或存取驗證問題。 - 內容主要是
vmess://、ss://等連結：可能選到節點清單訂閱，請改用提供者提供的 Clash / mihomo 輸出入口。 - 錯誤指出行號和欄號：檢查該位置及上一行的縮排、引號和冒號。YAML 縮排請使用空格，不要混用 Tab。
- 提示代理類型或欄位不支援：核對設定需求與目前用戶端、核心版本，再決定是否更新用戶端或改用相容格式。
以下僅展示 YAML 的層級與規則結構，不含節點，也不是可用於代理連線的完整訂閱。實際遠端設定可能使用 proxies，也可能透過 proxy-providers 引用節點來源，不能只因缺少某個欄位就判定檔案無效。
proxy-groups:
- name: 出站選擇
type: select
proxies:
- DIRECT
rules:
- MATCH,出站選擇若設定本身已成功下載，但某個 proxy-providers 或 rule-providers 更新失敗，請繼續檢查對應資源的網址和錯誤訊息。這是設定內部資源的下載問題，與主要訂閱網址無法下載屬於不同層次。
部分服務會依據請求的 User-Agent 回傳不同格式。瀏覽器下載的內容可能與用戶端取得的內容不同；遇到這種情況，請向提供者確認適用於 FlClash 的入口，不要任意修改請求標頭，也不要將私人訂閱交給來路不明的線上轉換服務。
自動更新間隔：在遠端設定的編輯選項中設定
請先完成一次手動更新，再設定自動更新。常見路徑為「設定」→ 對應遠端設定的更多選單 →「編輯」→ 找到自動更新開關和更新間隔。實際欄位名稱、可選單位及入口位置依安裝版本而異；本機檔案設定通常沒有相同的訂閱更新選項。
先確認單位，再輸入數值
自動更新間隔是兩次排程更新之間的時間，不是請求逾時時間，也不是節點測速週期。例如，1 小時等於 60 分鐘或 3600 秒；24 小時等於 1440 分鐘或 86400 秒。若介面使用分鐘，輸入 60 才代表每小時更新一次，不能把秒數直接填入分鐘欄位。
| 使用情境 | 建議間隔 | 設定依據 |
|---|---|---|
| 設定與節點相對穩定 | 24 小時 | 減少重複請求，有需要時再手動更新 |
| 提供者經常調整節點 | 6 小時 | 兼顧取得最新變更與控制請求頻率 |
| 提供者要求較短的更新週期 | 依提供者說明設定 | 同時遵守介面流量限制 |
表格中的間隔是建議值，並非 FlClash 的預設值。不要假設填入 0 就代表停用：不同版本對零值的處理方式可能不同。若要停用自動更新，請優先使用明確的開關，儲存後再重新開啟編輯頁，確認設定已保留。
自動更新未如期執行時的檢查項目
自動更新通常需要用戶端保持執行，並仰賴系統排程。桌面端結束程式、電腦進入睡眠，或手機限制背景活動，都可能延後更新。尤其要檢查 Android 的電池最佳化和背景網路權限；調整前請先了解對耗電量的影響，不必一次放寬所有背景限制。
儲存設定後，記下最近一次成功更新的時間，讓用戶端保持執行，等設定週期過後再檢查。若期間曾休眠或斷網，恢復後請先手動更新，確認連結仍可使用。自動更新無法修復過期權杖、錯誤格式或伺服器流量限制，也不是精準到秒的系統排程。
恢復後的檢查順序與回報資訊
- 確認訂閱請求成功。查看對應設定的成功提示和更新時間，不要只看首頁的連線狀態。
- 確認已選取正確設定。核對代理群組、規則和節點來源是否屬於剛更新的設定。
- 單獨測試節點連線。若更新成功但仍無法連線，再檢查節點、規則比對結果、系統代理和 TUN，不要繼續反覆更換訂閱網址。
- 最後設定合理的更新週期。避免多個用戶端同時以過短的間隔請求同一個訂閱。
若持續更新失敗，可整理作業系統類型、FlClash 版本、核心版本、失敗時間、網路類型和已遮蔽敏感資訊的錯誤訊息。再補充「切換網路後是否成功」、「舊設定是否仍可使用」及「失敗的是主要訂閱還是內部資源」三項資訊，通常比只顯示「更新失敗」的截圖更有助於判斷。