V2Ray 各平台安裝與設定

準備系統與連線資料

確認系統、架構與用戶端用途

先記下作業系統、處理器架構和目前帳戶的權限，再下載安裝檔。桌面平台使用 v2rayN，Android 使用 v2rayNG 或 v2flyNG。用戶端用來顯示伺服器清單、儲存訂閱、產生設定並管理代理入口；核心則負責協定連線與流量轉送。安裝好用戶端不代表已取得可用伺服器，伺服器資料需另外準備。也不要直接複製其他作業系統的程式資料夾，介面檔案、核心執行檔和授權方式可能不同。

請在系統資訊中確認處理器架構，不要依裝置外觀判斷。搭載 Apple 晶片的 Mac 請選 Apple Silicon，Intel Mac 請選 Intel；本頁的 Windows 下載項目適用 x64；Linux 則要同時確認架構與套件格式。多數 Android 裝置使用 arm64，但較舊的裝置仍應查明系統支援的架構。位元數或架構不符時，安裝失敗通常是套件選擇有誤，不必先修改網路、訂閱或伺服器參數。

整理訂閱與伺服器參數

準備服務提供者提供的訂閱網址，或一條完整的伺服器分享連結。訂閱網址用來取得伺服器清單，不是一般網頁網址，也不等同於帳戶管理頁面的登入網址。手動設定則需要伺服器位址、連接埠、協定、驗證資訊與傳輸參數；使用加密傳輸時，可能還需要伺服器名稱、路徑、公鑰或指紋等欄位。若缺少任何一項，請先查閱原始說明，不要用相似欄位代替，也別靠反覆切換核心來猜參數。

請將訂閱視為存取憑證。複製時避免選到前後空格、換行、通訊軟體附加的標點或說明文字。不要將完整網址貼到公開討論區，也別上傳含網址列的截圖。遷移裝置前請保留設定備份，並區分「用戶端設定備份」和「伺服器分享連結」：前者可能包含群組、路由和介面選項，後者通常只有單一連線。分享故障記錄前，也請檢查伺服器網域、帳戶識別資訊和訂閱參數。

建立可復原的初始設定

安裝前請確認未啟用代理時，系統仍能正常瀏覽常用網站，並記下目前網路介面的代理狀態。暫時關閉其他會修改系統代理或虛擬網卡的程式即可，不必刪除。工作或校園裝置的網路設定可能受到管理政策限制；遇到無法修改的選項時，請確認管理權限，不要把所有受限狀況都歸咎於用戶端。也請確認系統日期、時間和時區正確，憑證驗證及部分協定驗證都需要準確時間。

初次測試時，只保留一個用戶端、一台伺服器和一種流量接管方式。先用系統代理測試瀏覽器，再考慮 TUN。每次只修改一項，記錄修改前後的狀況；若同時更改連接埠、路由和 DNS，就很難判斷問題來源。結束測試前請還原代理設定，避免留下指向已關閉程式的本機連接埠。若之後安裝失敗，保留完整錯誤訊息和操作步驟，比只記下「不能用」更容易分辨下載、權限或連線問題。

安裝 Windows 版 v2rayN

選擇桌面版或傳統 WPF 版

前往Windows 下載區，先確認系統架構，再選擇桌面版或傳統 WPF 版。桌面版採用新一代跨平台介面，傳統 WPF 版則保留熟悉的 Windows 介面；兩者都可用來管理代理連線。介面差異不代表伺服器品質不同。初次安裝請先選定一個版本完成設定，只有確實遇到介面相容性問題時才更換；同時執行兩個執行個體容易爭用本機連接埠，也會讓系統代理的最後寫入來源難以判斷。

執行安裝程式時，請依提示選擇可寫入的位置。若系統顯示來源或權限警告，先確認檔案來源與發行者資訊，再決定是否繼續，不要關閉整體系統安全防護。啟動時若出現缺少執行環境的明確提示，請依該安裝檔要求補齊相應環境。若程式完全無法開啟，先排查安裝與執行環境；若程式能開啟但核心啟動失敗，再檢查記錄檔。這兩種狀況不能靠同一套網路設定解決。

匯入訂閱並選擇伺服器

開啟主視窗，在「訂閱群組」中進入「訂閱群組設定」，新增群組、填寫備註與網址後儲存。初次設定時，請讓篩選關鍵字保持空白，避免篩掉所有伺服器。回到主畫面後執行「更新訂閱（不透過代理）」。若訂閱服務明確要求透過代理存取，而且已有可用連線，再執行「更新訂閱（透過代理）」。透過代理更新需要現成的連線，不能依賴尚未成功匯入的伺服器來建立自身通路。

更新後確認群組中已出現伺服器，再將目標項目設為活動伺服器。選單位置可能因介面版本而異，請依實際顯示的「設為活動伺服器」操作。測試結果只反映當下的測試條件，不代表網頁、影片和下載都能正常使用。先開啟常用的加密網頁，再查看用戶端記錄檔是否出現相應連線。遇到驗證失敗時，請檢查原始資料；遇到逾時則要分辨伺服器無法連線、本機防火牆或路由選擇問題。

設定系統代理，再評估 TUN

在系統匣選單中選擇「自動設定系統代理」，讓遵循 Windows 系統代理設定的應用程式使用用戶端的本機入口。選擇「清除系統代理」會移除該入口；選擇「不變更系統代理」則會保留目前狀態，不會清除舊網址。修改後可前往「設定 → 網路和網際網路 → Proxy」核對，特別留意是否仍指向已關閉的程式。瀏覽器擴充功能、應用程式內建代理和機構管理政策都可能覆寫系統設定，請分別檢查。

若要涵蓋不讀取系統代理設定的應用程式，再啟用「TUN 模式」。請依用戶端提示完成提權或安裝相關元件，不要只因出現權限視窗就認定操作失敗。啟用前請關閉其他虛擬網路接管工具，並保留管理員授權提示中的完整錯誤訊息。若啟用後所有網路都中斷，先關閉 TUN 並確認系統恢復，再檢查虛擬網卡、路由和 DNS。不要在 TUN 故障期間不斷修改瀏覽器代理，這會讓兩種不同的故障路徑互相干擾。

排除連接埠占用與退出後的殘留設定

若出現「位址已被使用」之類的啟動錯誤，先關閉重複執行的程式，再查看本機監聽連接埠。以下指令僅用於查找處理程序編號，請將連接埠替換成用戶端設定中的實際值。找到處理程序後，請在工作管理員確認程式名稱；不要直接結束不明的系統處理程序。也可以在用戶端改用未被占用的連接埠，但必須同步更新依賴舊連接埠的應用程式設定。

netstat -ano | findstr :10808

正常結束前，先關閉 TUN，再清除本次設定的系統代理。若程式異常關閉後瀏覽器無法連線，請優先檢查系統代理是否仍指向回送位址，而不是立刻重新安裝用戶端。升級前請儲存訂閱和必要設定；升級後先測試舊設定能否載入，再逐項還原自訂路由。若安全軟體攔截程式，請查看具體事件和檔案路徑；不要將整個磁碟加入排除清單，也不要反覆移動安裝資料夾來掩蓋原因。

安裝 macOS 版 v2rayN

依晶片選擇安裝檔

開啟 Apple 選單中的「關於這台 Mac」，查看「晶片」或「處理器」。若顯示 Apple 晶片，請選 Apple Silicon；若顯示 Intel，請選 Intel。前往macOS 下載區下載相符的磁碟映像檔，開啟後依安裝畫面提示將應用程式移至「應用程式」資料夾。複製完成後退出磁碟映像檔，再從「應用程式」啟動。若一直從映像檔內執行，應用程式的位置會不固定，也容易混淆後續授權所對應的程式副本。

初次啟動若遭系統安全機制阻止，請先仔細閱讀提示。確認來源後，可前往「系統設定 → 隱私權與安全性」，查看是否提供針對此應用程式的開啟選項，再依系統流程核准。只有系統明確允許繼續時才執行，不要大量移除其他檔案的安全屬性。出現「應用程式已損毀」也不能直接推斷是代理設定錯誤；請先重新下載符合架構的安裝檔，確認複製完整並檢查系統相容性要求。

新增訂閱並確認選單列選項

啟動 v2rayN，開啟主視窗，在「訂閱群組設定」中新增備註和訂閱網址。儲存後執行「更新訂閱（不透過代理）」，確認清單中已出現伺服器，再設為活動伺服器。只有在已有可用連線且直連更新失敗時，才嘗試「更新訂閱（透過代理）」。Mac 選單列圖示可用來顯示主視窗和切換代理選項；圖示存在只代表程式正在執行，不表示伺服器驗證或系統代理已設定完成。

在選單列圖示的選單中選擇「自動設定系統代理」。系統可能會要求授權修改網路設定，請依提示輸入具有相應權限的本機帳戶資訊；不要輸入訂閱服務的帳號密碼。接著前往「系統設定 → 網路」，選取目前使用的網路服務，再到「詳細資訊 → 代理」核對設定。無線和有線網路屬於不同服務，從一種連線切換到另一種後，請重新確認目前介面的代理狀態。

區分系統代理與 TUN 授權

系統代理主要影響會讀取系統設定的應用程式。某個終端機程式或獨立應用程式沒有走代理，不代表瀏覽器的系統代理失效。請先檢查該應用程式是否有個別代理選項，再決定是否使用 TUN。啟用「TUN 模式」時，用戶端可能需要額外的管理員權限來建立網路介面或修改路由。系統代理授權成功，不代表 TUN 所需權限也已準備妥當，兩者應分開確認。

核准要求前，請確認申請者確實是剛安裝的用戶端，並依提示完成必要步驟。若管理員密碼正確但仍失敗，請檢查目前帳戶是否受裝置管理政策限制，以及其他網路軟體是否正在接管流量。關閉 TUN 後若網路恢復，表示問題集中在流量接管路徑；此時可保留一般系統代理作為對照，不要同時修改伺服器驗證欄位。工作網路已有專用連線時，應先了解兩者的路由優先順序，再決定是否同時使用。

處理睡眠喚醒與網路切換

Mac 從睡眠喚醒、切換熱點或重新連線無線網路後，原有連線可能需要重建。先確認系統網路已取得位址，再嘗試重新選取伺服器或重新啟動用戶端連線功能。若只有某個應用程式失敗，請將它完全結束後重新開啟，避免沿用舊連線。若所有應用程式都失敗，請關閉 TUN 和系統代理進行直連測試。不要只因選單列圖示仍在，就略過確認底層網路是否恢復。

結束用戶端時，先關閉 TUN，再選擇「清除系統代理」，最後結束程式。「不變更系統代理」只會保留目前狀態，不會自動撤銷殘留入口。若異常結束後無法瀏覽網頁，請回到目前網路服務的代理設定頁面，檢查回送位址和連接埠。更換應用程式副本或升級後若再次出現授權提示，請確認目前執行檔的路徑，避免「下載項目」和「應用程式」資料夾各有一份，造成授權給舊副本、實際卻啟動新副本。

安裝 Linux 版 v2rayN

確認架構與套件格式

前往Linux 下載區前，先確認處理器架構和發行版的套件系統。x64 和 arm64 對應不同程式檔；deb 與 rpm 則適用不同套件管理方式，不能只因檔名都包含 Linux 就混用。常見的 Debian 系發行版請選 deb；使用 RPM 套件系統的發行版請選 rpm。若不確定，先在系統資訊或軟體管理工具中查看發行版名稱，再用下方指令確認機器架構。

uname -m
cat /etc/os-release

輸出中的 x86_64 通常對應 x64，aarch64 通常對應 arm64。其他架構不能直接使用本頁的安裝項目。桌面用戶端需要可用的圖形工作階段，只有命令列的伺服器環境不適用這裡的圖形安裝流程。遠端桌面、精簡桌面或容器中的圖形環境也可能缺少系統匣與權限服務；套件管理工具接受安裝檔，不代表桌面整合條件都已備妥。

透過軟體管理工具完成安裝

下載符合需求的套件後，優先使用發行版的軟體管理工具開啟，查看相依套件、安裝位置和授權提示，再進行安裝。若缺少相依套件，請保留套件管理工具的完整錯誤訊息，並依目前發行版的方式處理；不要從其他發行版複製共用程式庫，也不要把不同架構的程式庫用符號連結接在一起。安裝後從應用程式選單啟動用戶端，以一般使用者身分執行圖形介面；只有明確需要的網路操作才依提示提權。

若應用程式選單已出現入口，但點擊後沒有視窗，先確認程式是否縮到系統匣，再檢查目前桌面環境是否顯示系統匣圖示。有些桌面環境預設不顯示這類圖示，需透過桌面設定或相容元件處理；不要因為看不到圖示就重複啟動多個程序。若要從終端機查看啟動錯誤，請使用實際安裝的執行檔路徑，不要憑其他發行版的目錄猜測。記錄檔中的圖形函式庫錯誤與訂閱更新錯誤屬於不同階段。

匯入訂閱並確認桌面代理範圍

在「訂閱群組設定」中新增網址，儲存後更新訂閱並設定活動伺服器。先不要加入伺服器篩選條件，確認原始訂閱能正常解析。接著嘗試「自動設定系統代理」，並在桌面網路設定中確認代理入口。不同 Linux 桌面環境儲存及讀取代理設定的方式不同；有些應用程式只讀取自身設定，有些命令列程式只讀取環境變數，因此「桌面代理已設定」不代表「所有程式都已接管」。

若瀏覽器可以使用，但軟體管理工具無法連線，先確認該工具是否需要個別設定代理，以及背景服務是否繼承使用者工作階段的設定。不要為了解決本機應用程式問題，就把本機監聽位址改成對所有網路介面開放；這可能擴大存取範圍，卻無法改變應用程式是否使用代理。若確實需要命令列代理，請依應用程式支援的協定設定，並在同一個終端機工作階段中測試。關閉終端機或移除變數後，影響範圍也會隨之改變。

設定 TUN 並處理權限問題

需要接管更多流量時，再於用戶端啟用 TUN，並依目前發行版和用戶端提示完成權限設定。建立虛擬網路介面、修改路由和 DNS 通常需要額外權限，不能靠長期以管理員身分執行整個桌面工作階段來取代。若啟用失敗，先查看記錄檔是否明確指出權限不足、介面建立失敗或輔助元件無法使用，再選擇相應的處理方式。只有錯誤訊息有需要時，才檢查核心提供的 TUN 裝置。

成功啟用後，請用同一個網站和同一個應用程式進行前後比較。若無法存取區域網路，請檢查路由是否誤接管本機網段；若只有網域名稱無法解析，請檢查系統解析服務與用戶端 DNS 的配合。若已有工作網路、容器網路或虛擬機器橋接介面，請先儲存現有路由資訊。結束前關閉 TUN 並還原桌面代理；升級時保留使用者設定備份，避免混用舊執行檔和新安裝目錄中的元件。

安裝 Android 用戶端

選擇 v2rayNG 或 v2flyNG

前往Android 下載區，建議優先選用採用 Xray 核心的 v2rayNG。已有針對 V2Fly 的設定，或需要比對其行為時，再考慮 v2flyNG。兩款應用程式採用的核心不同，不代表所有設定都能直接互換。尤其是 REALITY、XTLS Vision 等仰賴特定核心功能的連線，請先確認用戶端支援情況；分享連結成功匯入，不代表底層參數都已完整辨識。

通常先選 arm64 安裝檔；若不確定裝置架構，或安裝時提示不相容，再確認裝置資訊並評估通用版。使用系統檔案管理工具開啟安裝檔，依提示允許本次從目前來源安裝。安裝完成後可撤銷該來源的安裝權限，避免長期保留臨時設定。若系統提示簽章衝突，請先確認是否已有從其他來源安裝的同名應用程式，儲存原有設定後再處理，不要直接解除安裝，以免訂閱和路由設定一併遺失。

匯入資料並更新訂閱

開啟用戶端，透過「訂閱群組設定」或目前介面中的訂閱管理入口，新增備註和完整訂閱網址，再執行更新。若只有單一分享連結，可使用從剪貼簿匯入的功能；透過 QR Code 匯入需要相機權限，僅在使用該功能時核准。訂閱取得失敗時，先檢查網址是否被輸入法插入空格、是否複製成網頁標題，以及連結是否已過期。切換無線網路與行動網路，有助於判斷訂閱網址能否直接連線。

清單更新後選取一台伺服器，再啟動連線。延遲測試與實際上網狀況應分開檢查：有些測試依賴目前活動連線，有些只測試伺服器連接埠，結果不能互相取代。先開啟常用網頁，再測試日常使用的應用程式。若一款用戶端正常、另一款失敗，請比較核心支援、傳輸參數和路由設定，而不只是伺服器備註。備註相同的項目也可能使用不同連接埠、不同協定，或套用不同訂閱篩選結果。

核准網路接管並設定應用程式範圍

Android 首次建立連線時，通常會顯示 VPN 連線要求，這是系統授權應用程式接管網路流量的流程。確認要求中的應用程式名稱後再核准，接著查看系統連線指示和用戶端記錄檔。這不是桌面系統中的「自動設定系統代理」選單，也不需要另外將手機無線網路的手動代理指向桌面連接埠。若已有其他應用程式使用系統 VPN 通道，通常無法同時維持兩條這類連線，請先停止衝突的應用程式。

需要設定應用程式分流時，先確認介面中名單的意義：選取應用程式可能表示「這些應用程式使用代理」，也可能在啟用略過選項後表示「這些應用程式不使用代理」。設定後，分別測試一個明確列在名單中的應用程式和一個未列入的應用程式。不要同時修改應用程式名單和網域路由，否則很難判斷是哪一層決定流量出口。瀏覽器內的加密 DNS、應用程式內建代理和系統網路設定也可能形成額外路徑，請分開記錄。

處理背景限制與網路切換

若連線剛建立時正常，鎖定螢幕後就失效，先查看系統是否限制背景活動。依裝置設定允許用戶端維持必要的背景執行，並保留連線通知；各廠牌的電池管理選項名稱不同，請依目前系統說明操作。無須一次放寬所有應用程式的背景權限。若啟用「永遠開啟的 VPN」或「無 VPN 連線時封鎖網路」等選項，請先了解其效果：用戶端停止後，系統可能會主動封鎖其他網路連線，而非伺服器突然失效。

從無線網路切換到行動網路後，請等候系統網路就緒，再重新建立用戶端連線。若只有行動網路無法使用，請比較目前網路的網域名稱解析和伺服器連接埠是否可連線；若所有網路都失敗，請優先檢查訂閱狀態與驗證資訊。結束時請使用用戶端的停止按鈕，確認系統連線指示已消失。遷移到新裝置時，需重新核准系統授權，不要複製舊裝置的權限狀態；若涉及核心差異，可參考Xray 與 V2Fly 核心差異逐項確認。

管理訂閱群組與設定遷移

分辨訂閱更新與伺服器連線

訂閱更新負責下載並解析伺服器清單；伺服器連線則負責將流量轉送到選定的遠端伺服器。兩者可能連線至完全不同的位址。更新成功只能證明清單可取得，不代表每台伺服器都能連線；某台伺服器仍可使用，也不代表訂閱網址尚未過期。排查時請分別保留「更新訂閱錯誤」和「連線伺服器錯誤」，避免把網頁回傳的錯誤文字誤當成協定驗證失敗，也別靠不斷重新整理訂閱來解決本機連接埠占用。

在「訂閱群組設定」中，為不同來源建立獨立群組，備註可填寫用途或來源簡稱，網址則保留原文。首次匯入時不要設定篩選關鍵字，確認清單完整後再縮小範圍。篩選規則的比對方式會依介面實作而異，使用前請查看欄位說明，不要預設一般文字就是正規表示式。更新後若清單為空，先移除篩選條件並重新更新，再確認服務端是否真的回傳空清單；不要立刻刪除整個群組。

選擇更新通道與更新時機

若訂閱服務可直接連線，請使用「更新訂閱（不透過代理）」。若直連取得失敗，但目前代理仍可正常使用，則可使用「更新訂閱（透過代理）」。新安裝的裝置若沒有任何活動伺服器，通常無法靠代理更新自行建立連線。此時請先確認服務提供者是否提供直連取得方式，或依照其說明匯入一條有效連線後再嘗試更新。不要從不明來源取得臨時資料來繞過這項前置條件。

自動更新間隔應依服務提供者的限制和實際變動頻率設定，頻繁請求不代表清單更可靠。若收到流量限制回應，請停止反覆點擊，等到服務允許的時間再重試。網址失效、帳戶停用或服務提供者更換訂閱格式時，必須回到帳戶頁面確認，修改 DNS 無法解決。更新成功後，請檢查目前的活動伺服器是否仍存在；若原伺服器已刪除或更名，需重新選取，不要只看狀態區域仍顯示舊備註就判定正常。

保留手動伺服器與必要備份

請分開管理手動新增的連線和訂閱產生的連線。不要長期直接修改訂閱項目的位址、連接埠或備註來儲存自訂內容，因為下次更新可能會覆寫。若確實需要暫時調整，請複製到獨立的手動群組，並記錄修改原因。伺服器名稱不是固定識別資訊，同名項目也可能有不同傳輸參數；遷移時請以完整欄位為準，不要依名稱批次合併。刪除群組前，先確認其中是否還有唯一保留的手動資料。

升級或更換裝置前，請儲存訂閱網址、手動連線、路由規則和必要的用戶端設定。備份通常含有驗證資料，應存放在受保護的位置，不要放進公開同步資料夾。跨系統遷移時，先搬移可通用的伺服器資料，再重新設定系統代理和 TUN 授權。不要覆蓋新系統中的執行檔路徑、網卡名稱或提權設定。還原後先只啟用一條連線，確認正常，再逐項恢復自動更新、應用程式分流和其他個人化選項。

限制敏感資訊的散布範圍

訂閱截圖盡量只保留錯誤類型、時間和操作名稱。分享連結可能將驗證內容編碼在整段文字中，即使看起來不像密碼，也應妥善保密。尋求協助前，請檢查匯出檔案、記錄檔和 QR Code，不要直接將完整設定貼到討論區。若資料已外洩，請依服務提供者的方式更新訂閱憑證；刪除公開訊息無法撤銷已被複製的網址。需要整理多個來源時，可參考多訂閱群組與伺服器篩選實務，再逐步增加篩選條件。

設定系統代理、路由與 TUN

先確認流量是否已進入用戶端

系統代理決定應用程式將請求交給哪個本機入口；路由則決定進入核心後的連線要送往哪個出口。這是前後相接的兩個階段。若應用程式未使用系統代理，修改路由規則通常不會改變其行為；若流量已進入核心，卻被規則分流至直連，反覆啟用系統代理也不會讓流量自動改走遠端。先查看記錄檔確認請求是否到達用戶端，再檢查目標網域、符合的規則和出口，可減少在不相關選項間反覆測試。

「清除系統代理」用來移除系統代理入口；「自動設定系統代理」用來寫入目前用戶端的入口；「不變更系統代理」則是保留現有設定。最後一項不會自動還原，也不是另一種全域模式。結束程式後，若系統仍指向本機連接埠，遵循系統代理設定的應用程式可能會無法連線。若需長期搭配其他網路工具使用，請明確指定由哪個程式負責寫入和還原設定，不要讓兩個程式輪流修改同一組系統設定。

了解預設策略與規則比對順序

系統匣路由選單中的「繞過中國大陸」、「黑名單」、「全域」可用來切換預設策略。實際涵蓋哪些目標取決於目前的規則內容，不應只根據策略名稱推斷。全域策略通常表示進入該代理路徑的流量會使用代理出口，並不會強制所有應用程式都連入用戶端。若要保留區域網路裝置的存取，請檢查私有網段和本地域名的處理方式；在工作網路中，也要考慮內部網域解析和專用位址範圍，不要直接照抄公用規則。

路由通常依規則順序尋找符合項目，較寬泛的條件若排在前面，可能會遮蔽後續的精確條件。以下是路由物件片段，示範網域與私有位址的分流方式；這不是完整用戶端設定，也不應直接貼入只接受規則陣列的輸入欄位。合併前請確認目前核心的語法、編輯入口的要求，以及完整設定中是否已定義同名出口。不存在的出口標籤會使規則無效，或造成設定啟動失敗。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "proxy"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

範例中的 domain 用來比對網域，ip 用來比對位址或位址集合，outboundTag 則指向已定義的出口。domain:example.com 是教學用網域條件；geoip:private 需要核心能讀取相應的規則資料。AsIs 不會為了每次路由比對而主動解析所有網域，因此只有位址規則時，未必能符合仍以網域形式傳入的目標。不要為了符合單一規則就直接替換全部 DNS 策略。

分開檢查 DNS 與應用程式內設定

若網頁無法透過網域名稱連線，但其他連線正常，請檢查名稱解析；不過不要只更換一個公用 DNS 位址就結束排查。系統、瀏覽器、應用程式和核心都可能各自處理 DNS。瀏覽器啟用加密 DNS 後，請求路徑可能與系統不同；TUN 接管解析後，也可能改變網域與目標位址的對應關係。測試時請保留一條清楚的路徑，記錄請求是否進入用戶端，再決定要修改系統解析、應用程式選項或核心設定。

TUN 擴大的是流量接管範圍，無法修正錯誤的驗證資訊、過期訂閱或無法連線的遠端伺服器。啟用前請確認管理員權限，並關閉其他同類流量接管程式；啟用後分別測試網域存取、區域網路存取和不讀取系統代理的應用程式。發生問題時，先撤銷最近新增的設定，回到系統代理可正常運作的狀態，再逐層增加設定。請保留必要的區域網路例外，避免印表機、網路儲存裝置和工作服務因出口改變而失去連線。

排查常見設定問題

依故障階段縮小範圍

先判斷問題發生在安裝、啟動、更新訂閱還是瀏覽網頁。安裝失敗時檢查架構、系統相容性和權限；視窗無法開啟時檢查執行環境和圖形工作階段；核心啟動失敗時檢查設定語法、元件路徑和連接埠占用；訂閱更新失敗時檢查網址和取得通道。只有程式與核心都正常啟動後，才進一步排查網頁連線。將四個階段混在一起反覆重新安裝，既不能解決服務端問題，也可能遺失可供比對的原始設定。

若出現「已連線但無法開啟網頁」，先關閉 TUN 並清除系統代理，確認基本網路是否正常。直連也失敗時，優先處理無線網路、閘道、系統解析或登入驗證頁面。直連正常後，再啟動用戶端，只啟用系統代理並選擇一台資料完整且已知可用的伺服器。觀察錯誤是立即發生還是逾時、是否所有網站都無法連線，以及其他應用程式是否也受影響。每項結果都對應不同的下一步，不要只憑連線圖示下結論。

依記錄檔區分連接埠、驗證與逾時問題

本機監聽失敗通常發生在核心啟動階段，請優先檢查重複執行的程式和連接埠衝突；驗證遭拒通常與帳戶資料、協定參數或服務狀態有關；連線逾時則需進一步分辨位址解析、網路可達性和遠端回應。遇到憑證錯誤時，先檢查系統時間、伺服器名稱和傳輸參數，不要把關閉憑證驗證當成通用修復方式。保留完整錯誤訊息和發生時間，比只截取其中一個英文單字更有用，也方便比較修改前後的差異。

若同一份訂閱只有部分伺服器失敗，先比對其協定、傳輸方式、連接埠和出口地區，確認是否屬於同一類設定。若所有伺服器都失敗，而且核心沒有連線記錄，問題更可能出在應用程式入口或本機流量接管。若只有某個網站失敗，請檢查路由、網域解析和目標服務狀態，不要直接重設整個用戶端。請使用一致的網路和方法測試節點；不同測試方式的結果不能直接比較。詳細挑選順序請參考節點延遲、倍率、地區與協定比較。

還原可正常運作的基準設定

經過多次修改後，請先備份目前設定，再建立最精簡的配置：保留一個訂閱群組、一台伺服器、預設路由和一種流量接管方式。暫時關閉自訂規則、應用程式名單和自動切換。基準設定可正常使用後，每次只還原一項，並以同一個網頁和同一個應用程式重新測試。若還原某項後立即失敗，請保留前後設定的差異，不必重新安裝整個程式。重設不是第一步，而是在已儲存資料並明確掌握還原範圍後使用的排查方法。

準備求助資料時，請註明作業系統、架構、用戶端名稱、實際操作步驟、完整錯誤訊息和已完成的對照測試。記錄檔可提供連線階段資訊，但上傳前請移除訂閱網址、驗證欄位和可識別個人身分的資料。不要公開整份備份檔案。更完整的網頁存取排查流程請參考v2rayN 已連線卻無法上網排查清單；若初次設定時漏了步驟，請回到使用文件依序完成設定。