V2Ray 全平台安裝與設定指南

通用準備：先釐清設定層級

用戶端、核心與連線參數

V2Ray 設定可分成三個層級。用戶端負責圖形介面、訂閱管理與系統整合；核心負責讀取設定、建立連線及執行路由；伺服器參數則描述遠端位址、連接埠、驗證與傳輸方式。安裝好用戶端，只代表本機管理工具已就緒，不會自動取得可用連線。開始前，請備妥合法取得的訂閱網址或單一分享連結，並確認服務仍在有效期限內。

v2rayN 適用於桌面系統；v2rayNG 是 Android 上常見的 Xray 核心用戶端；v2flyNG 則提供 V2Fly 核心選項。Project V、V2Fly 與 Xray 屬於相關技術生態，但不代表所有設定都能互通。協定或傳輸功能是否可用，取決於用戶端產生設定的能力、實際啟用的核心，以及伺服器端的要求。先選擇相符的組合，比反覆切換選項更有效。

記下裝置資訊與原有網路設定

下載前先確認作業系統類型與處理器架構。桌面系統分為 x64 和 arm64；macOS 還要確認是 Apple Silicon 或 Intel。Linux 除了架構，也要確認發行版使用 deb 或 rpm 套件。不要只憑裝置外觀判斷，也別把相容層當成預設安裝方式。請至下載頁面確認平台需求；不確定介面版本時，可參閱用戶端比較。

接著記下目前是否啟用其他代理工具、企業 VPN、自訂 DNS 或網路過濾軟體。第一次測試時，盡量只保留一個接管流量的程式，避免兩個程式爭用系統代理或虛擬網卡。先確認一般網路能正常連線至常用網站，再匯入設定。如果基礎網路已中斷，訂閱更新和遠端連線都會失敗；這時繼續修改協定參數，只會增加變數。

訂閱網址與分享連結是不同類型的輸入

以 https:// 開頭的網址可能是訂閱入口，也可能只是一般網頁，請以服務提供者的說明為準。以 vmess://、vless:// 等開頭的通常是單一分享連結，應從剪貼簿或相應的匯入功能讀取。不要將分享連結貼到訂閱 URL 欄位，也不要把介紹頁面當成訂閱網址。QR Code 只是一種承載方式，掃描後仍須確認其中實際包含哪類內容。

確認系統日期、時區及自動校時設定。時間明顯不準可能影響 TLS 憑證驗證，也可能導致依賴時間的驗證失敗。接著為設定取一個容易辨識的名稱，方便日後查閱記錄。訂閱網址通常含有個人識別資訊或存取權杖，截圖或尋求協助前請遮蔽完整網址；不要貼到陌生的解析網站，也不要公開含驗證資訊的 QR Code。

第一次連線的最精簡測試順序

建議依序匯入設定、選擇目前使用的伺服器、啟用一種代理入口，再開啟目標應用程式測試。桌面平台先試系統代理；Android 先透過系統 VPN 授權建立連線。只有確認應用程式不讀取系統代理時，再研究 TUN。每完成一步就確認結果，不要同時修改路由、DNS 和核心。結束測試時也要檢查系統代理是否已還原，避免殘留設定被誤認為基礎網路故障。

Windows：安裝 v2rayN

依介面與執行需求選擇安裝檔

前往Windows 下載頁面，先確認頁面列出的系統需求。v2rayN 桌面版採用跨平台介面；經典 WPF 版則保留 Windows 桌面操作體驗。兩者不是不同的連線服務，不必為了連線而同時安裝。初次使用可依下載頁面的建議選擇；已有使用習慣時，則可依介面、系統支援和執行需求決定。詳細差異請參閱桌面版與 WPF 版說明。

本頁提供的 Windows 下載項目為 x64 套件，請先在系統「關於」確認裝置架構。安裝程式依照精靈指示完成安裝；如果下載的是壓縮檔，請先完整解壓縮，再從解壓縮後的資料夾啟動，不要直接在壓縮軟體的預覽視窗中執行。使用可寫入的資料夾有助於保存記錄與設定，但不要任意搬移已在使用的程式資料夾。若啟動時提示缺少執行元件，請依提示安裝相應架構的相依元件，不要反覆下載來源不明的執行環境套件。

匯入訂閱並確認目前使用的伺服器

開啟 v2rayN，在「訂閱分組設定」中新增分組，輸入容易辨識的名稱，並將完整訂閱網址貼到「地址(URL)」欄位。確認已啟用分組並儲存，再更新訂閱。首次尚未建立連線時，可先試用「不透過代理」更新；若服務提供者明確要求特定網路路徑，則依照其說明操作。更新完成後，請確認是否確實產生設定，不要只看提示視窗是否已關閉。

在已匯入的設定中選取準備使用的伺服器，並設為目前使用項目。啟用訂閱分組、選取伺服器與開啟系統代理是三個不同步驟；缺少任何一步，都可能出現「已匯入但無法使用」的情況。如果清單是空的，請回到訂閱管理章節檢查回應內容與格式；不要急著手動填入猜測的連接埠、識別碼或 TLS 參數，以免覆蓋原本完整的設定。

先使用系統代理，再判斷是否需要 TUN

在「系統代理」中選擇「自動設定系統代理」，接著關閉並重新開啟測試用的應用程式。系統代理只是為支援此設定的應用程式提供本機代理入口，不會強制所有處理程序使用代理。如果瀏覽器可用，但某個獨立程式仍無法連線，先確認該程式是否有自己的代理設定。不要因為單一程式沒有使用代理，就認定伺服器無法使用；也別把「清除系統代理」誤解為清除訂閱。

需要接管不讀取系統代理的應用程式時，再試著「啟用 Tun 模式」。此功能通常會用到虛擬網路介面、路由及較高權限，請依目前用戶端的提示授權。啟用後先查看記錄，確認是否成功啟動，再測試目標程式；開關顯示已啟用，不代表網路連線一定建立。若啟用失敗，先關閉 TUN，還原基本狀態，再檢查權限、元件及其他 VPN 是否衝突。不要長期以提高權限作為所有問題的通用解法。

Windows 常見注意事項

若出現連接埠被占用的提示，先關閉重複執行的用戶端，再檢查其他代理程式。不要一味更換連接埠，卻忘記同步修改應用程式設定。防火牆提示請依實際使用範圍授權，通常不必允許程式在公用網路接受連入連線；只有確實需要共用時才開啟「允許來自區域網路的連線」。詳細安裝問題可參閱Windows 設定常見問題；每次調整後都用同一個應用程式重新測試，確保比較條件一致。

macOS：晶片、權限與代理

先確認處理器，再安裝應用程式

開啟系統的「關於這台 Mac」，確認顯示的是 Apple 晶片還是 Intel 處理器，再到macOS 下載頁面選擇相符的 v2rayN 桌面版。Apple Silicon 對應 arm64，Intel 對應 x64。不要只依作業系統名稱或購買年份判斷架構；即使某個套件能透過相容方式啟動，也不代表它是最合適的選擇。優先使用與硬體相符的安裝檔，後續排查權限與元件問題也會更清楚。

開啟下載的磁碟映像檔，依視窗提示將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動。不要長期直接從已掛載的映像檔執行，以免升級、路徑記錄和權限授權變得混亂。若系統阻止開啟，先確認檔案來自預期的下載頁面，再查看「隱私權與安全性」中的具體提示。只對已確認來源的應用程式執行系統提供的允許操作，不建議為了方便而關閉整套系統安全檢查。

完成訂閱設定，區分結束應用程式與關閉視窗

進入訂閱分組設定，新增名稱與網址，儲存後更新訂閱。若網址來自網頁按鈕，複製後請檢查開頭或結尾是否夾帶空格或換行，尤其不要連按鈕文字一起複製。更新成功後，選取目前使用的伺服器，再測試代理。關閉視窗後，應用程式可能仍在選單列執行；真正結束前，請確認是否需要還原系統代理，不要只因桌面上看不到視窗，就認定用戶端已停止。

macOS 的網路設定會依網路服務分別保存，Wi-Fi、有線網路及其他介面的代理狀態可能不同。若在家設定成功，換用另一種連線方式後卻失效，先檢查目前使用中的網路服務，不要重新匯入所有訂閱。啟用自動設定系統代理後，可在系統網路設定中確認實際寫入的值。對於內建獨立代理設定的應用程式，也要確認它是否設定為跟隨系統，而非繼續使用先前保存的位址。

系統代理與 TUN 的授權範圍

初次使用時先只啟用系統代理。確認瀏覽器可正常連線後，再判斷是否需要 TUN。TUN 可能需要系統授權、輔助元件或較高權限，實際方式請以目前用戶端的支援方式為準；若功能入口無法使用，先查閱該版本的說明，不要照搬其他平台的服務安裝方式。授權提示應與剛才執行的操作相符，來源不明的權限要求不要直接允許。

啟用 TUN 後，觀察網域名稱是否能正常解析、是否能存取區域網路裝置，以及電腦從睡眠喚醒後能否恢復連線。若喚醒後只有部分應用程式失敗，可先中斷並重新建立用戶端連線，再檢查網路服務是否已切換。不要一開始就刪除所有系統網路設定。如果同時使用公司 VPN 或網路延伸功能，請分別測試單獨啟用的結果；兩個工具都修改路由時，即使介面顯示已連線，流量路徑也可能不正確。

更新、移轉與恢復連線

更新前先結束正在執行的應用程式，備份必要設定，再替換應用程式檔案。備份位置請以用戶端提供的設定資料夾入口為準，不要猜測固定路徑。移轉至另一台 Mac 時，原裝置授予的系統權限未必會隨檔案一併移轉，新裝置仍須重新確認。若結束用戶端後網路異常，先檢查目前網路服務是否留下指向本機的代理；還原原值後，再逐項啟用用戶端功能，避免將舊狀態帶入新一輪測試。

Linux：套件與桌面環境

套件格式與處理器架構都要相符

在 Linux 上安裝前，先確認兩項資訊：發行版採用的套件系統，以及裝置的處理器架構。請在Linux 下載頁面確認：deb 和 rpm 是不同發行版使用的套件格式，x64 和 arm64 則代表不同架構。系統能下載某個檔案，不代表它就能直接安裝。可在系統「關於」頁面查看架構與發行版資訊；若仍不清楚，先查閱發行版的套件管理說明，不要接連嘗試不同格式碰運氣。

使用桌面軟體安裝程式開啟相符的套件，閱讀相依套件與權限提示後完成安裝。若缺少相依套件，請透過發行版正常的軟體來源處理；不要手動刪除套件管理器的鎖定檔，也不要從不明網站拼湊共用程式庫。安裝成功卻沒有出現在選單中時，可先重新登入桌面工作階段，再確認應用程式是否已列入軟體清單。本文以圖形介面用戶端為主，不需要將桌面程式改成背景系統服務。

匯入訂閱並確認本機代理入口

啟動 v2rayN，開啟訂閱分組設定，輸入名稱與訂閱 URL，儲存後更新。選取目前使用的伺服器後，先確認用戶端能否正常啟動核心，再設定桌面代理。Linux 桌面環境和應用程式框架各不相同，「自動設定系統代理」是否有效，須以目標程式實際讀取代理設定的方式為準。桌面設定面板顯示代理位址，不代表所有已啟動的處理程序都會立即套用變更。

需要手動設定應用程式代理時，先從用戶端介面確認目前的監聽位址、連接埠與入口類型，再填入應用程式。不要把 HTTP 入口當成 SOCKS，也不要把另一台電腦的連接埠當成本機預設值。若只供本機使用，監聽位址維持在迴路位址範圍較合適。若應用程式顯示連線遭拒，先確認核心是否正在執行、監聽連接埠是否變更，不要直接懷疑遠端驗證失敗。

桌面代理、環境變數與 TUN 不要混為一談

有些圖形介面應用程式會讀取桌面環境的代理設定，有些程式使用自己的設定，部分命令列程式則主要讀取環境變數。這些是不同的代理入口，不會自動同步。因此，瀏覽器能連線但終端機中的程式失敗，不足以證明路由規則有誤。先確認目標程式使用哪種代理機制，再設定正確入口；不要把所有網路狀況都歸因於「系統代理已啟用」。

TUN 通常需要存取虛擬網路裝置並修改路由，一般使用者權限可能不足。若用戶端提示權限錯誤，請依該版本提供的整合方式處理，避免長期以較高權限執行整個圖形桌面。沙盒安裝方式或受限制的工作階段也可能影響網路裝置存取。啟用失敗時，先保留記錄中的第一個明確錯誤，再檢查權限、系統元件和現有 VPN；反覆點擊開關通常無法補足缺少的條件。

處理桌面整合與網路還原

若看不到系統匣圖示，先確認桌面環境是否支援相應的系統匣擴充功能，不要直接把「沒有圖示」當成核心已停止。切換網路後若 DNS 失效，請檢查目前的網路管理元件是否覆寫原設定，再依用戶端支援的方式還原。不要一次手動修改多個解析設定檔，因為部分檔案由系統動態產生，下次連線時可能會被改寫，造成看似隨機的故障。

更新應用程式前先保存設定並結束用戶端，再使用相同的套件管理方式升級，避免不同來源的安裝互相覆蓋。解除安裝前，先清除用戶端設定的系統代理並關閉 TUN；移除應用程式檔案不一定會清除桌面環境保存的代理值。若重新啟動後仍無法上網，先還原原有網路設定，再重新安裝和測試。保留一份可正常使用的基本設定，通常比繼續疊加複雜規則更省時間。

Android：匯入設定與 VPN 授權

選擇用戶端與安裝檔架構

前往Android 下載頁面，優先考慮使用 Xray 核心的 v2rayNG；明確需要 V2Fly 核心時，再選擇 v2flyNG。兩款用戶端的介面與功能支援不盡相同，不要只因名稱相近，就預期所有參數都能原樣移轉。多數較新的手機使用 arm64，但仍應以系統架構為準；無法確認時可參閱下載頁面的通用套件說明，不能用螢幕尺寸判斷架構。

開啟安裝檔時，系統可能要求允許目前使用的瀏覽器或檔案管理員安裝未知來源的應用程式。授權對象是發起安裝的應用程式，而非整個系統；安裝完成後，可視需要收回該權限。若安裝失敗，先確認套件架構、剩餘儲存空間，以及同名應用程式原本的安裝來源。遇到升級衝突不要馬上解除安裝，因為這可能會清除訂閱與本機設定；請先使用用戶端支援的方式備份必要資料。

從訂閱、剪貼簿或 QR Code 匯入

新增訂閱時，開啟訂閱分組或訂閱設定，輸入名稱與 URL，儲存後更新。不同介面可能會將更新功能放在選單中，但主要步驟都是「先保存訂閱入口，再取得設定」。如果只有單一分享連結，請使用「從剪貼簿匯入」之類的功能；收到 QR Code 時，掃描後確認匯入項目的類型。不要將含有 QR Code 的截圖上傳到公開辨識網站，其中可能直接包含完整驗證資訊。

匯入後選擇一台伺服器，再點選連線按鈕。第一次建立連線時，Android 會顯示系統 VPN 授權提示，請確認要求來自剛才操作的用戶端。授權後，用戶端才能透過系統提供的虛擬網路介面接管流量。此處的 VPN 指系統介面類別，不代表已選擇任何特定遠端協定；實際連線仍由目前設定中的協定、傳輸方式與驗證參數決定。

了解行動裝置的流量接管方式

行動裝置不必照搬桌面平台的「自動設定系統代理」方式。常見連線模式會透過 Android VPN 服務運作；是否限制特定應用程式、如何處理 DNS，以及是否略過區域網路，須視目前用戶端提供的選項而定。初次測試建議使用預設接管範圍，確認基本連線正常後，再設定分應用程式規則。否則，很容易把某個應用程式未納入接管範圍，誤判為伺服器故障。

若設定分應用程式代理，請確認目前模式是「僅限選取的應用程式」還是「略過選取的應用程式」，兩者意思相反。每次修改後都要重新建立連線，再開啟目標應用程式測試。系統通常只允許一項一般 VPN 服務處於啟用狀態，其他 VPN、廣告過濾或封包擷取工具可能會搶占入口。測試時先關閉這些工具，並確認系統是否將另一款用戶端設為一律啟用，避免連線剛建立就被取代。

背景執行限制、網路切換與連線恢復

如果螢幕亮起時正常、鎖定後中斷，先檢查電池最佳化、背景執行和裝置製造商的自動啟動管理。不同裝置的選項名稱可能不同，只需對確實需要維持連線的用戶端放寬限制，不必全面關閉省電功能。用戶端持續顯示通知也可能與背景服務有關，不要為了隱藏通知而停止必要服務。記錄若顯示處理程序遭到終止，與遠端交握失敗是不同問題，應分別處理。

切換 Wi-Fi 與行動網路後，原有連線可能需要重新建立，DNS 和網路存取條件也可能改變。先中斷再連線，確認目前網路能正常存取，再判斷是否為訂閱或伺服器問題。熱點是否會轉送用戶端接管的流量，取決於系統與裝置實作；手機本身能用，不代表連上熱點的裝置也能使用。結束前請檢查「一律開啟 VPN」和「封鎖未使用 VPN 的連線」等系統選項，避免停止用戶端後所有應用程式都無法連網。

訂閱管理：網址、更新與備份

先判斷輸入內容，再選擇匯入方式

訂閱網址讓用戶端取得一組設定，之後也能再次更新；分享連結通常描述單一連線。兩者都可能透過複製或 QR Code 傳送，但不能因此共用同一個輸入欄位。收到內容後，先辨別類型，再選擇訂閱設定或分享連結匯入功能。完整機制與操作方式請參閱分享連結與訂閱網址的差異。先確認輸入內容的類型，通常就能避免大多數解析錯誤。

建立訂閱分組時，名稱最好能反映來源或用途，不要只用一串難以辨識的數字。請保留服務提供者提供的完整路徑與查詢參數，不要自行刪除看似冗長的部分，也不要公開貼出網址。透過通訊軟體複製時，留意是否出現中文標點、隱藏換行或網址遭截斷。範例 https://example.com/your-sub 僅說明欄位格式，並非可取得設定的服務網址。

將訂閱更新失敗拆成取得與解析兩步排查

更新訂閱包含「向網址送出請求」和「讀取回應內容」兩個階段。請求逾時、無法解析網域名稱、TLS 錯誤屬於第一類；若已下載內容卻未產生設定，則須檢查內容格式與核心支援情況。即使狀態碼成功，也可能收到登入頁面、到期通知或其他文字，因此不能只看畫面是否顯示完成。若用戶端記錄提供回應類型或解析原因，應優先依此判斷，不要反覆切換無關的路由選項。

是否透過直連或現有代理更新，須依網址可連線的路徑決定。剛安裝時通常還沒有可用代理，可先試不透過代理更新；若網址只能透過已建立的連線存取，則應改用相反選項。兩種方式都失敗時，先檢查網路與網址是否有效。不要短時間內反覆更新，也不要為了測試而將完整訂閱網址交給第三方。更多排查步驟請參閱訂閱更新失敗與解析結果為空的排查方法。

區分訂閱更新與本機修改

訂閱中的設定可能會在下次更新時重新產生，直接修改其中的伺服器位址、名稱或進階參數，不一定能長期保留。需要進行對照測試時，先複製成獨立的本機設定，並記下修改目的；不要繼續把測試設定當成訂閱原始項目。更新後還要確認目前使用的項目是否仍存在，因為服務提供者可能刪除、重新命名或調整設定，先前選取的項目不一定會自動對應到新項目。

自動更新適合已確認能正常取得的訂閱，但首次使用前應先手動測試。若用戶端支援設定更新間隔，請依實際需求調整，不必靠頻繁更新來解決連線問題。更新只能取得服務提供者目前提供的設定，無法修復本機連接埠衝突，也不會自動取消錯誤的系統代理。即使畫面顯示更新成功，仍要檢查目前使用的伺服器、代理入口與目標應用程式；「訂閱已更新」不等於連線成功。

備份內容與隱私注意事項

備份前先確認匯出功能包含哪些內容：有些功能只匯出連線設定，有些也會包含訂閱網址與偏好設定；系統授權通常無法一併移轉。備份檔請存放在可信任的本機位置，分享給他人前請刪除網址、使用者識別資訊與驗證欄位。更換裝置後先匯入一項設定並測試，再還原分流及其他自訂設定。若懷疑訂閱已外洩，請聯絡服務提供者更換入口或憑證；只刪除本機分組，無法讓已外洩的網址失效。

代理與分流：入口不等於出口

系統代理、TUN 與路由各司其職

系統代理會告訴支援此功能的應用程式，將請求交給本機監聽連接埠；TUN 透過虛擬網路介面接收符合接管範圍的流量；路由規則則決定這些請求使用哪個出站。三者位於不同層級，不能互相取代。啟用 TUN 不代表所有請求都會經過遠端；選擇全域路由，也不會強迫完全未進入用戶端的應用程式使用代理。排查前先確認「請求有沒有進入」，再確認「進入後送往哪裡」。

第一次設定時，建議先使用用戶端提供的路由預設值。例如「繞過中國大陸（Whitelist）」會依本機規則資料與實際設定進行比對，不應理解為能準確判斷每個網域的地理位置。規則檔、DNS 結果和核心行為都會影響最後的路徑。先測試預設值，再加入少量明確需求；直接合併不同來源的規則，容易造成順序覆蓋或標籤不相符。

規則依序比對，出站標籤必須存在

路由通常依規則順序比對，較前面的廣泛規則可能先攔截原本要由後續規則處理的流量。撰寫規則前，先確認要依網域、目標位址、連接埠還是應用程式範圍進行區分。以下是 Xray/V2Ray 格式的路由片段，用來說明如何將符合條件的網域交給名為 direct 的出站；這不是完整設定，必須放入既有路由架構中，而且本機必須已有相應的出站與規則資料。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      }
    ]
  }
}

geosite:cn 會參照本機 geosite 資料中的網域集合；缺少相應資料時，不會自動生效。outboundTag 是對既有出站的參照，不是填入某個英文詞就會自動建立功能。用戶端產生的標籤可能與範例不同，請以實際設定為準。使用圖形化路由編輯器時，優先從編輯器中選取既有出站，避免混用其他工具匯出的欄位結構。

DNS 與規則比對要一起檢查

依網域比對與依 IP 位址比對的前提不同。如果用戶端只取得目標 IP，某些網域規則可能無法參與比對；若先解析網域再比對位址集合，DNS 結果又會影響規則是否命中。不要反覆更換 DNS 伺服器來取代規則檢查。先確認目標請求進入用戶端時帶有哪些資訊，再查看目前的網域策略與解析路徑，才能釐清為何同一個網站的不同請求會使用不同出站。

區域網路存取也需要另外考量。印表機、家用儲存設備和路由器管理頁面通常不必經過遠端，但相關流量仍可能先進入 TUN。請使用用戶端提供的區域網路略過設定或明確規則，不要因此關閉所有分流。公司內部網域也可能需要專用 DNS，改用公用解析器反而會造成連線失敗。遇到內網問題時，先還原原有解析設定，確認名稱能正確解析後，再調整代理路徑。

以小範圍測試取代整套替換

每次只新增一條規則，並記下目標、預期出站與測試結果。測試前重新建立連線，必要時重新啟動目標應用程式，因為既有連線不一定會依新規則重新選擇路徑。記錄中的規則命中資訊比網頁是否開啟更能反映路由行為；網頁可用，也可能只是走了其他路徑。確認新規則有效後，再保存為正式設定，不要把整個測試過程都留在正式規則中。

若修改規則後整體無法使用，先切回原本的預設值，確認連線仍可建立，再逐項比較新增內容。特別檢查 JSON 逗號、陣列結構、資料名稱與標籤參照，不要同時更換核心和訂閱。需要了解術語時可參閱名詞解釋；只想完成第一次連線，則返回入門指南。進階規則的用途，是依需求分配已可使用的連線，而不是取代基礎網路、正確驗證和有效訂閱。

設定故障排除：依問題現象縮小範圍

先保留問題現場，再由近到遠逐步檢查

發生故障時，先記下觸發操作、目前網路、使用的設定和第一則明確錯誤訊息。不要立刻清除訂閱或重新安裝用戶端，以免失去排查線索。建議依序檢查基礎網路、系統時間、本機核心、監聽入口、目前使用的伺服器、遠端參數，最後再檢查複雜路由與 DNS。每次只修改一個變數，並保留前一步的結果，才能確認哪項修改真正有效。

用戶端介面雖然能開啟，但若核心未成功啟動，任何伺服器都無法透過本機入口運作。此時應檢查啟動錯誤，例如設定欄位不受支援、檔案存取受限或監聽連接埠已被占用。瀏覽器顯示本機代理連線失敗，與記錄中的遠端交握逾時不是同一層級的問題。先確認本機服務已正常監聽，再測試遠端連線，避免把所有狀況都統稱為「節點無法連線」。

如何分別排查交握失敗與連線逾時

若記錄指出驗證或交握失敗，請逐項核對伺服器端要求：協定類型、伺服器位址、連接埠、使用者識別碼、TLS、傳輸方式，以及必要的路徑與服務名稱。位址是連線目標；TLS 的伺服器名稱則用於驗證與交握，兩者可能不同，不要憑感覺互換。WebSocket 路徑和 gRPC 服務名稱也不能混填；大小寫、開頭斜線等細節應以原始設定為準。

若連線逾時，先確認目前網路能否連到目標路徑、是否只有某項設定失敗，以及切換網路後狀況是否改變。如果同一份訂閱中的所有設定都失敗，優先檢查本機入口與共用參數；若只有一項失敗，再確認該項服務狀態與傳輸需求。不要關閉憑證驗證來掩蓋 TLS 錯誤，應先檢查系統時間、網域名稱與設定來源。完整排查順序請參閱節點連線逾時逐項檢查。

已建立連線，但應用程式無法使用

「已連線」通常只代表某項服務或介面已啟動，不表示每個應用程式的請求都能成功。若瀏覽器可用但其他程式失敗，先檢查該程式的代理入口與接管範圍；若只有網域名稱無法連線、直接位址卻可用，再檢查 DNS。如果啟用 TUN 後一般網路也受到影響，先關閉 TUN，確認系統代理模式是否能恢復正常。這項對照有助於區分虛擬介面問題與遠端連線問題，不必一開始就重建所有設定。

網頁部分內容無法載入時，可能涉及多個網域、既有連線快取或不同的出站規則。先用全新的測試視窗重現問題，再查看記錄中失敗請求的目標，不要只針對網址列中的主網域修改規則。某些應用程式會保存自己的代理設定或維持長時間連線，切換用戶端設定後可能需要重新啟動。若啟用了分應用程式代理，也要確認目標應用程式是否被排除，以及排除模式是否與預期相反。

還原設定、尋求協助與後續維護

需要還原時，先停用新增規則與 TUN，再還原系統代理和 DNS，確認基礎網路正常。接著使用已保存的穩定設定重新建立連線，最後再逐項恢復自訂功能。升級用戶端前記錄目前可用的狀態並備份設定，升級後先測試基本連線；不要在同一次維護中同時移轉核心、訂閱和分流方案。分開處理雖然多一步，卻能保留清楚的回復路徑。

向他人尋求協助時，提供作業系統類型、用戶端名稱、實際使用的核心、錯誤發生環節及已遮蔽個人資訊的記錄即可。請遮蔽訂閱網址、使用者識別資訊、驗證參數與個人網路資料，但保留錯誤類型和相關設定名稱。若問題與選單位置有關，回到相應的平台章節查閱；與格式有關，可參閱訂閱管理；與連線路徑有關，則查閱代理與分流。先將問題範圍縮小到單一環節，再決定是否重新安裝，通常比整套重新設定更可靠。