INSTALL / SUBSCRIPTION / ROUTING

V2Ray 全平台安裝與設定手冊

v2rayN 桌面部署與 v2rayNG Android 設定。依平台完成部署，再沿流量路徑排查問題。

這是一份方便查閱的手冊，不必從頭讀到尾。第一次連線可先依照快速入門教學的步驟操作；遇到安裝、權限、分流或 DNS 問題，再查看相應章節。教學帶你建立連線，本頁則說明各項設定會影響哪個環節。

通用準備：安裝套件、設定與接管範圍

先確認用戶端與裝置架構

桌面平台優先選用 v2rayN；Android 建議使用採用 Xray 核心的 v2rayNG，需要 V2Fly 核心時再考慮 v2flyNG。用戶端負責編輯設定、管理訂閱及啟動核心；核心則負責建立實際連線，兩者位於不同層級。更換用戶端可以改變操作介面與流量接管方式，卻無法自動修正伺服器設定錯誤。安裝前先記下裝置系統、處理器架構及需要代理的應用程式，選擇安裝套件時就不必猜測。

Windows 桌面版常見套件採用 x64 架構；macOS 須分辨 Apple Silicon 與 Intel；Linux 則須同時確認處理器架構及套件格式。Android 主流裝置通常選 arm64，不確定架構時再考慮通用版。64 位元作業系統不代表處理器必定屬於某種架構。請以系統資訊顯示的處理器類型為準，再前往下載中心選擇相應版本。不同平台的安裝套件不可只改檔名後混用。

備妥連線資料，範例位址不可用於連線

安裝用戶端後，仍須準備有效的訂閱網址、分享連結或手動設定資料。訂閱通常是網頁格式的網址，回傳節點清單；分享連結則通常以協定名稱開頭，用來描述單一設定。本網站介紹用戶端操作，連線資料須向有權使用的服務取得。伺服器位址、連接埠、使用者識別碼、傳輸方式及安全設定都是連線參數，少了任何一項，都可能出現匯入成功卻無法交握的情況。

儲存訂閱時，請用容易辨認的用途命名群組，例如「工作設定」或「測試設定」。群組名稱只是本機備註，不會改變連線方式。分享截圖時，請勿露出完整訂閱網址、使用者識別碼或 QR Code；這些資料可能直接授予連線權限。本文中的範例網域及欄位僅用來說明結構，並非可連線的服務。把教學範例填進用戶端後等待連線，只會白費工夫。

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

系統代理會在作業系統中登記本機代理位址，會讀取這項設定的應用程式便會將要求交給用戶端。但它無法強制所有程式遵循，尤其是使用獨立網路堆疊的程式、部分命令列工具，以及自行設定代理的應用程式。TUN 透過虛擬網路介面接收流量，通常能接管更大範圍，但需要相應權限，也較容易與其他虛擬網卡衝突。路由則是在流量進入核心後，決定要交由代理出站、直連出站，或是阻擋出站。

初次部署時，先使用系統代理確認瀏覽器能否連線，再決定是否啟用 TUN。請勿同時啟動兩個用戶端搶用相同的本機連接埠，也不要讓兩套接管工具同時修改預設路由。Android 的 VPN 接管方式與桌面系統代理不同，但排查思路相同：先確認流量能進入用戶端，再查看流量從哪個出口離開。即使路由模式設為全域，未進入核心的流量也不會憑空出現在日誌中。

建立可還原的測試基準

首次測試請選用已知有效的節點、保留預設傳輸參數，並暫時關閉 Mux。記下當時的路由模式、本機監聽連接埠及接管方式，每次只修改一項設定。裝置時間應保持準確，否則可能無法正確判斷憑證有效期。連線前先確認一般網路可用；若網路需要網頁登入驗證，應先完成驗證。基礎網路尚未連通時，訂閱與節點都可能逾時，這時不必急著調整路由。

安裝或升級前，請備份用戶端設定及訂閱群組，並存放在只有自己能存取的位置。備份也包含敏感連線資料，不適合放在公開文件中。遇到問題時，記下錯誤類型、發生時間和操作步驟，比只截取一個紅字視窗更有幫助。以下各平台章節都會依照相同流程說明：選擇套件、安裝、匯入、接管及退出還原。已有環境只需比對差異，不必重新初始化。

Windows：v2rayN 安裝與系統代理

如何選擇桌面版與傳統 WPF 版

下載中心提供 v2rayN 桌面版及傳統 WPF 版兩種選項。桌面版採用新一代跨平台介面；WPF 版則保留傳統桌面操作方式。首次安裝建議優先考慮桌面版；若已習慣 WPF 版，也可以繼續選用相應版本。兩個版本的選單位置可能不同，本章會依功能名稱說明，不會把特定按鈕位置當成通用步驟。請勿將一個版本的程式檔直接覆蓋到另一個版本的資料夾，以免設定和相依項目混在一起。

從Windows 下載頁面取得套件後，依套件實際格式完成安裝或解壓縮。需要解壓縮的套件，務必完整解壓至獨立資料夾，不要直接執行壓縮檔內的主程式。資料夾路徑盡量簡短，並選擇目前使用者可寫入的位置。設定、日誌及核心執行都可能需要寫入檔案；受保護的資料夾、同步磁碟中的按需檔案及暫存資料夾，容易造成程式啟動後找不到資源，或結束時無法儲存設定。

首次啟動與執行環境檢查

啟動後先確認主視窗能否正常顯示，再查看日誌區是否出現核心啟動錯誤。程式視窗能開啟，只代表圖形介面已啟動，不表示核心也正常運作。若系統明確提示缺少 .NET 執行環境，請依安裝套件說明補齊相應執行環境；不要憑印象安裝名稱相似的元件。自包含套件與依賴系統執行階段的套件需求不同，先看清錯誤訊息再處理，比反覆重裝更有效率。

若安全軟體封鎖核心，請先確認遭封鎖的檔案來自剛安裝的用戶端套件，再查看系統防護記錄。不要為了碰運氣而關閉整套防護。如果介面一開啟就退出，請檢查解壓縮是否完整、資料夾是否可寫入，以及是否已有另一個執行個體；接著查看應用程式錯誤記錄。若要進一步排查啟動階段的問題，可參考v2rayN 閃退與啟動崩潰排查，暫時不必修改連線參數。

匯入訂閱並選擇使用中的節點

在「訂閱群組設定」中新增群組，填入群組名稱及訂閱網址並儲存；返回主視窗後，從「訂閱群組」選單執行「不透過代理更新訂閱」。首次使用且尚無可用節點時，不透過代理更新通常較容易建立基準。如果訂閱網站必須透過既有連線才能存取，再選擇「透過代理更新訂閱」；但前提是目前已有可用節點，不能指望空白清單替自己下載第一份設定。

更新完成後，請檢查節點清單及所屬群組，選擇其中一個節點並設為使用中的伺服器。某一列只是取得焦點，不一定代表已切換使用中的設定，請以用戶端顯示的使用狀態為準。分享連結請使用「從剪貼簿匯入分享連結」，不要貼進訂閱網址欄位。若匯入後欄位仍為空白，請檢查原始連結是否遭聊天工具截斷，特別留意尾端參數及百分比編碼，不要隨意刪除看似複雜的部分。

先使用系統代理，視需要再啟用 TUN

確認核心正常運作後，在「系統代理」中選擇「自動設定系統代理」。使用瀏覽器前往一個確定需要目前連線才能存取的網址，再查看用戶端日誌是否出現相應要求。若瀏覽器可用、其他程式卻不行，先確認該程式是否會讀取系統代理。有些應用程式設有獨立代理欄位，需要填入本機 HTTP 或 SOCKS 位址；連接埠請依用戶端的實際設定填寫，不要照抄其他教學的預設數字。

確實需要接管整台裝置的流量時，再啟用 TUN。通常需要管理員權限或初始化相應元件，請依用戶端提示操作。先關閉其他代理工具，確認沒有殘留虛擬網卡接管，再嘗試啟動。TUN 發生錯誤但系統代理正常，問題較可能出在權限、網卡或系統路由層，不宜直接更換伺服器。測試期間不要同時修改 DNS、路由規則及傳輸參數，否則無法判斷是哪一步讓連線恢復。

退出還原與平台常見問題

關閉主視窗可能只是將程式縮至系統匣。若要停止接管，請先在「系統代理」中選擇「清除系統代理」，關閉 TUN，再從系統匣結束程式。若程式異常結束，系統代理可能仍指向已停止的本機連接埠。此時請開啟 Windows 代理設定，檢查是否留有手動代理位址；清除後先確認直接連線恢復，再重新啟動用戶端。也要檢查瀏覽器的獨立代理擴充功能，它不一定會隨系統設定變更。

自動啟動優先使用用戶端提供的相關設定，並確認目前使用者登入後程式確實有執行。自動啟動介面設定成功但 TUN 未啟動，可能是權限不同所致，不應靠重複建立多個啟動項目補救。升級前先結束舊程序並備份設定；升級後重新檢查系統代理、使用中的伺服器及本機連接埠。若連接埠遭占用，請找出占用的程式或改用空閒連接埠，並同步更新應用程式設定，不要只改其中一端。

macOS：依晶片選擇套件、網路權限與流量接管

依晶片架構安裝 v2rayN

開啟系統「關於這台 Mac」，確認顯示的是晶片名稱還是 Intel 處理器。Apple Silicon 請選 arm64 版本，Intel 請選 x64 版本。執行套件取決於晶片架構，與系統介面語言或螢幕尺寸無關。從macOS 下載頁面取得相應磁碟映像檔，開啟後依視窗提示將應用程式移至「應用程式」資料夾。不要長期從磁碟映像檔或下載資料夾執行，以免更新、登入時啟動及路徑權限互相影響。

首次啟動若出現安全確認，請先核對應用程式來源及檔案是否為剛下載的用戶端，再依系統提供的「隱私權與安全性」提示處理。不要為了啟動單一程式而關閉整體安全機制，也不要執行來源不明的解除限制指令碼。若啟動錯誤指出架構不相容，請返回下載頁重新選擇套件。是否能透過轉譯執行取決於實際版本，不能將轉譯功能視為選錯套件後必然可用的補救方式。

匯入訂閱並確認核心已啟動

進入「訂閱群組設定」，新增名稱與網址並儲存，再執行訂閱更新。尚無使用中的節點時，先嘗試不透過代理更新；已有節點且訂閱網址需要代理才能存取時，再選擇透過代理更新。取得清單後選擇使用中的伺服器，並留意核心日誌是否開始記錄啟動資訊。圖形視窗、取得訂閱及連線節點是三項不同操作，前兩項成功不代表第三項也成功。

手動匯入分享連結時，請使用「從剪貼簿匯入分享連結」功能；剪貼簿中只保留完整連結，不要混入說明文字或聊天引用符號。匯入後核對位址、連接埠、傳輸方式及 TLS 相關欄位。系統剪貼簿可能被密碼管理工具或其他應用程式自動清空，若無法辨識，請重新複製再匯入。不要因一次匯入失敗，就在訂閱群組中反覆新增相同網址；重複群組會讓後續更新難以辨認。

系統代理與目前使用的網路服務

先在 v2rayN 的「系統代理」功能中啟用自動設定，再用瀏覽器進行測試。macOS 代理設定會套用至特定網路服務；切換 Wi-Fi、有線網路或其他網路介面後，實際使用的服務可能隨之變更。若換網後連線失效，請前往系統「網路」設定檢查目前服務的代理項目，再讓用戶端重新套用設定。請查看目前正在使用的服務，不是清單中任意曾連線的介面。

應用程式也可能使用獨立的代理設定。一個瀏覽器正常、另一個應用程式失敗時，先確認後者是否讀取系統代理，再考慮明確設定本機 HTTP 或 SOCKS 入站。若需手動填寫，請使用用戶端實際監聽的位址及連接埠；本機位址通常是回環位址，不是遠端伺服器位址。將遠端節點連接埠填入應用程式的本機代理欄位，會略過用戶端的協定處理，通常只會一直等待連線。

TUN 權限與網路切換

TUN 用來接管不讀取系統代理的流量。啟用前先確認目前版本支援此功能，並完成用戶端要求的權限步驟。若需要授權提升權限的操作，請先閱讀提示中的作用範圍；不要將系統密碼寫進設定或指令碼。首次啟用時，維持已驗證的使用中節點及預設規則，只變更接管方式。若 TUN 無法啟動但系統代理可用，先繼續使用系統代理，再檢查虛擬介面初始化及權限記錄。

其他 VPN、網路過濾軟體及虛擬機器網路元件都可能影響路由。排查時先暫停其中一套接管工具，觀察問題是否消失，不要一次重新啟動所有工具。裝置從睡眠恢復或切換網路，都可能使舊連線及介面狀態失效。先停止並重新啟動用戶端連線，讓它重新建立工作階段；仍有問題時，再重新啟用 TUN，避免裝置一喚醒就刪除整份設定。

退出、升級與系統還原

退出前先清除系統代理、關閉 TUN，確認直接連線恢復後再結束應用程式。若異常退出後網路無法使用，請檢查目前網路服務是否仍指向已停止監聽的本機代理。系統代理位址若仍存在，其他應用程式就會繼續嘗試連線至本機連接埠，這不代表網路突然故障。清除殘留代理後仍無法存取，再檢查其他接管工具及系統 DNS 設定，逐層處理，不要把多個問題混成一次「大重設」。

升級時先備份群組及設定、結束正在執行的應用程式，再替換程式檔。若登入後無法自動啟動，請檢查系統「登入項目」與用戶端自動啟動設定是否衝突，並保留一種明確的啟動方式。刪除應用程式前先解除流量接管；只將應用程式拖至垃圾桶，不保證所有網路設定都會還原。清理設定資料夾前先匯出資料，尤其是手動建立的節點，無法透過更新訂閱重新產生。

Linux：套件部署、桌面代理與自動啟動

分別確認套件格式與處理器架構

Linux 桌面環境建議使用 v2rayN。Ubuntu、Debian 通常選 deb；Fedora、openSUSE 通常選 rpm。還要確認裝置採用 x64 或 arm64 架構；套件格式正確但架構不符，一樣無法執行。從Linux 下載頁面選擇相應套件，不可將 deb 改副檔名當成 rpm。安裝前要分別確認發行版名稱、套件格式及處理器架構，不要只看桌面主題猜測發行版。

本章以圖形安裝程式為主：下載套件後開啟，確認應用程式名稱、相依項目提示及安裝位置，並依系統提示授權。安裝程式提示缺少相依項目時，請使用該發行版的軟體管理工具補齊；不要將其他發行版的共用程式庫複製到系統資料夾。若已有舊版，安裝更新前先結束程序。應用程式圖示出現在選單中，只代表桌面捷徑已建立，仍須另外確認能否啟動。

首次啟動與資料夾權限

從應用程式選單啟動 v2rayN，檢查主介面及核心日誌。圖形應用程式應以一般使用者身分執行，不要為了避開單一權限錯誤，就長期改用管理員帳號執行整個用戶端。設定、快取及日誌都屬於目前使用者的資料，變更執行身分會建立另一套資料夾，之後可能誤以為「節點全不見了」或「設定存不起來」。請先確認使用者資料夾可寫入，再判斷是否為應用程式本身的問題。

若點選圖示後沒有視窗，請檢查桌面啟動器是否指向正確程式、安裝過程是否漏了相依項目，並查看系統的應用程式錯誤資訊。缺少圖形元件、動態程式庫或顯示環境時，代理參數尚未參與執行，不必修改訂閱。沒有桌面工作階段的伺服器，也不屬於本章所說的 Linux 桌面環境；圖形用戶端需要相應的桌面條件，不能直接照搬桌面安裝流程到只有終端機的電腦。

匯入設定與系統代理的適用範圍

啟動正常後，在「訂閱群組設定」中儲存網址，執行不透過代理的訂閱更新，再選擇使用中的伺服器。訂閱更新與連線測試應分開判斷：清單出現只代表設定已成功取得，實際連線仍須核對傳輸方式及安全欄位。匯入單一分享連結時，請使用剪貼簿匯入功能，並保留原始連結以便檢查。若多次更新後出現同名節點，請優先透過群組及伺服器欄位辨認，不要只憑顯示名稱判斷是否重複。

啟用「自動設定系統代理」後，先用桌面瀏覽器測試。不同桌面環境讀取系統代理的方式並不相同，有些應用程式依賴桌面設定，有些只讀取環境變數或自己的代理欄位。瀏覽器可連線、終端機程式卻不行，很可能只是使用了不同入口。此時不必立刻啟用 TUN，也不要以為路由設為「全域」就會自動涵蓋所有應用程式。先確認需要接管的程式實際讀取哪種代理設定。

需要手動填寫代理時，請在應用程式設定中輸入用戶端的本機監聽位址及相應連接埠，並分清 HTTP 與 SOCKS 協定。用戶端更換連接埠後，應用程式端也要同步更新；不要將舊連接埠留在多個設定檔中。可以在系統或應用程式的環境設定中檢查環境變數。結束用戶端後，仍指向本機代理的環境設定會繼續影響程式，必須另外還原；桌面上的「清除系統代理」不一定會修改這些自訂內容。

TUN、權限與發行版差異

TUN 涉及虛擬介面及系統路由，通常需要額外權限或用戶端提供的輔助機制。請依目前版本的提示完成初始化，不要把來源不明的權限指令當成必做步驟。啟用時若出現權限錯誤，先確認授權流程是否完成，再檢查發行版的安全政策及日誌。某些系統的安全模組可能會阻擋特定操作；應找出遭拒絕的行為，不要先關閉整套安全政策。

防火牆、其他 VPN 及虛擬機器網路元件都可能影響 TUN。測試前先退出另一套接管工具，並確認本機入站連接埠未遭其他程序占用。換網後若直接連線正常、TUN 卻失效，先重新啟動流量接管以更新路由。若節點透過系統代理可連線，請優先檢查虛擬介面及路由，不要重複匯入相同訂閱。每次只變更一個項目；Linux 錯誤訊息通常足夠具體，值得仔細讀完。

登入時自動啟動與解除安裝

桌面自動啟動是指目前使用者登入圖形工作階段後執行，不代表電腦一開機就能連線。優先使用用戶端提供的自動啟動選項，或桌面環境中的「啟動應用程式」設定，兩者擇一即可。若應用程式已自動啟動但 TUN 未啟動，請檢查權限初始化及工作階段環境，不要再新增第二個啟動項目。多個執行個體可能搶用連接埠，讓原本穩定的設定變成間歇性故障。

解除安裝或升級前，先關閉 TUN、清除系統代理並結束程序，再使用發行版的軟體管理工具處理套件。設定資料夾可能與程式套件分開保留，因此解除安裝程式不代表連線資料也會刪除。準備遷移時先匯出設定，準備清理時再確認資料範圍。解除安裝後若網路仍有異常，請檢查應用程式的代理設定、環境設定及其他接管工具，不要只盯著已刪除的程式檔。

Android：v2rayNG 匯入設定與 VPN 接管

依架構選擇並安裝 v2rayNG

Android 首選 v2rayNG，使用 Xray 核心；v2flyNG 則是採用 V2Fly 核心的替代選項。是否選用替代版本，應依設定所需的核心功能判斷，而非圖示或名稱是否相似。Android 主流裝置通常選 arm64，不確定架構時可考慮通用版。從Android 下載頁面取得相應套件，依系統提示完成安裝。僅對實際用來下載或管理檔案的應用程式授予安裝權限，不再需要時可收回。

更新時若提示簽章不一致，請先確認原安裝套件與新套件是否來自相同用戶端及發行來源，不要立刻解除安裝。解除安裝可能同時清除本機節點及設定，應先備份。安裝失敗也可能是架構不符、儲存空間不足或系統相容性要求所致；原因不同，處理方式也不同。v2rayNG 與 v2flyNG 的應用程式資料彼此獨立，安裝另一個用戶端不會自動接管原有訂閱。

分開匯入訂閱與分享連結

在 v2rayNG 的「訂閱群組設定」中新增群組名稱及訂閱網址並儲存；返回主畫面後，從選單執行「更新訂閱」。更新完成後查看群組中的設定，點選要使用的節點。選單名稱及位置可能因版本而異，功能界線不變：群組負責儲存可更新的網址，節點清單則用來選擇實際連線設定。新增群組後若沒有立刻出現節點，通常是尚未執行更新，不代表儲存失敗。

單一分享連結請使用「從剪貼簿匯入」。複製時須保留完整連結，避免聊天應用程式只複製畫面上截斷的文字。透過 QR Code 匯入也屬於設定匯入，掃描結果應是可辨識的完整內容。若 QR Code 或連結含有敏感參數，請勿放進公開求助截圖。匯入成功後檢查設定欄位，尤其是傳輸類型、TLS 及伺服器名稱；畫面上出現一筆記錄，不代表欄位就與伺服器端一致。

授權 VPN 模式並選擇路由

使用 VPN 模式時，首次連線會出現系統授權提示。這是授權應用程式建立本機 VPN 介面，以接收裝置流量，不代表裝置已成功連上遠端。授權後返回用戶端，查看連線按鈕狀態及日誌，再實際測試連線。Android 通常無法讓兩個採用 VPN 接管的應用程式同時維持作用中；若系統提示連線已由另一個應用程式取代，請先決定要使用哪一款，不要讓兩套工具輪流爭奪接管權。

在「設定」中確認 VPN 模式及路由選項。日常分流可先使用「繞過區域網路及大陸位址」，需要比對測試時再暫時改為全域模式。路由只會改變已進入用戶端的流量方向，無法修正錯誤的伺服器位址。若某個應用程式被排除在接管範圍外，即使切換為全域模式，它的要求也不會自動進入核心。排查應用程式差異時，先查看應用程式分流設定，再檢查路由。

桌面教學中的「設定系統代理」步驟，不可直接套用至 Android VPN 模式。Android 通常透過系統 VPN 介面將流量交給核心；桌面系統代理則仰賴應用程式讀取相關設定。若要連線至同一服務，可以遷移設定資料；若要複製流量接管開關，則須依平台分別設定。有些網路要求先開啟網頁完成驗證，請在連線用戶端前先完成驗證，否則 VPN 及訂閱更新都可能逾時。

背景執行、電池管理與網路切換

連線一段時間後自動中斷，請先檢查系統是否結束了背景程序。不同裝置的電池管理名稱可能不同，可在應用程式資訊中查看電池最佳化、背景活動及自動啟動限制。只調整這款用戶端所需的權限，不必擴大到所有應用程式。通知及前景服務狀態有助維持連線，但看得到通知不代表遠端工作階段始終有效；切換網路後仍須實際測試。

從 Wi-Fi 切換至行動網路後，原有連線可能需要重新建立。先停止再重新啟動連線，觀察是否恢復；只有特定網路失敗時，再比較 DNS、伺服器連線能力及網路驗證條件。不要為了修復一次換網斷線就開啟所有進階選項。Mux 預設保持關閉較有利於建立基準，是否啟用嗅探也應視路由需求而定。進階開關不是開得越多越穩定，額外功能也會增加排查變數。

本機 DNS 與退出檢查

遇到網域存取問題時，請檢查「本機 DNS」等設定，並依目前路由及核心行為判斷解析路徑。不同核心及用戶端版本的選項可能不同，不要照搬舊截圖中的所有數值。解析伺服器必須能透過目前網路或代理路徑連線。若純 IP 位址可以存取、網域卻失敗，可優先檢查 DNS；但部分服務仰賴正確主機名稱及 TLS，不能單純以 IP 取代作為最終解法。

退出時先停止連線，再確認系統 VPN 已解除。若要切換至 v2flyNG，請先停止 v2rayNG，重新匯入相容設定並授權，不要假設原有設定已同步。解除安裝前先備份訂閱及手動節點；遷移後重新檢查路由與應用程式分流。常見安裝及連線問題可繼續查看常見問題；尋求協助時請提供系統版本、用戶端名稱及已去識別的錯誤資訊，不必公開完整訂閱網址。

訂閱與遷移：網址、清單及本機修改

訂閱網址不是節點位址

訂閱是取得設定清單的入口，節點則是清單中實際用來連線的項目。前者可能是一般網頁網址，後者包含協定、伺服器、連接埠及驗證參數。更新訂閱是下載並解析清單，不是測試每一台伺服器；因此「更新成功」與「節點可用」必須分別確認。分享連結通常描述單一節點，適合臨時匯入，但不像訂閱網址可持續更新；服務端變更後，通常須重新取得連結。

訂閱網址中的查詢參數可能用於授權，不能只保留網域及路徑。複製時若漏掉尾端參數，伺服器可能回傳錯誤頁面、登入頁面或空白內容。瀏覽器能開啟網址，也不代表用戶端就能解析：網頁介面與訂閱資料是不同的輸出格式。請使用服務提供的用戶端訂閱網址，而非帳戶頁面網址。想了解如何辨認完整連結，可搭配閱讀分享連結與訂閱的差異。

透過代理與不透過代理更新

不透過代理更新時，用戶端通常會透過目前的基礎網路取得訂閱；透過代理更新則會使用已建立的本機代理連線。首次使用且尚無節點時，優先嘗試前者。前者失敗但已有可用連線時，再試後者。兩種方式取得的都是同一份清單，選擇依據是訂閱網站是否可連線，而非哪種方式一定比較快。若現有連線本身不穩，透過代理更新還可能把一個問題變成兩個問題。

更新失敗時，先確認錯誤發生在哪個步驟：網域解析、建立連線、TLS 交握、伺服器回應，還是內容解析。解析錯誤常見於回傳內容不是訂閱格式；連線錯誤則須檢查網址及存取路徑。系統時間不正確也可能造成安全連線失敗。重複新增相同群組不會改變這些條件，只會留下更多重複記錄。請保留原群組，記下一次完整錯誤，再分別檢查網路路徑及回傳內容。

群組命名與更新後的變化

建議依來源或用途建立群組，備註只要容易辨認即可。更新後節點數量、名稱及排序可能改變，也可能需要重新確認用戶端目前選用的項目。顯示名稱只是備註，並非固定識別資料；同名節點可能有不同位址及連接埠，不同名稱也可能指向同一服務。選擇時請查看協定及伺服器欄位，不要把清單順序當成固定保證。自動測試結果只能作為目前環境的參考，最後仍須透過實際應用程式確認。

用戶端對訂閱節點所做的本機修改，可能在下次更新時被覆蓋。需要長期保留的特殊設定，應複製至獨立的手動設定區，並註明修改目的；不要直接修改訂閱節點後忘記原始來源。伺服器位址或驗證資訊變更時，複製出的設定也不會自動更新，必須自行維護。訂閱可減少手動更新工作，手動設定則適合保留個別調整；兩者各有適用範圍，無法同時保證完全自動又永不覆蓋。

跨平台遷移時應保留哪些資料

從桌面平台遷移至 Android 時，建議重新新增訂閱網址，讓目標用戶端依自身格式產生設定。單一節點也可以透過分享連結遷移。不要將某平台匯出的所有應用程式設定直接搬到另一平台，因為本機連接埠、路徑、系統代理及接管方式並不通用。真正通用的是協定參數及服務資料；平台專屬部分則包括權限、介面、背景管理及應用程式分流，須在目標裝置重新確認。

完整設定匯入適合熟悉核心格式的使用者。Xray 與 V2Fly 有共通的設定概念，但支援的欄位及功能仍有差異。用戶端支援某個協定名稱，不代表支援所有相關傳輸組合。遷移後若出現未知欄位或不支援安全方式的提示，請先確認目標核心的功能，不要盲目刪除報錯欄位。刪除欄位後，檔案或許能啟動，但連線設定的意義可能已改變，錯誤只會從啟動階段延後到交握階段。

備份與去識別的實用做法

備份至少應包含訂閱群組、手動節點及重要路由設定。請存放在自己能掌控的位置，註明來源用戶端及備份時間，避免將不同平台的檔案混放在同一個資料夾。還原前先確認目標用戶端是否支援該備份格式，再匯入。需要排查問題時，請複製一份用於去識別，不要直接修改唯一的備份。訂閱遺失後還能重新新增，但未備份的手動參數不一定能從介面歷史記錄找回。

定期更新訂閱前後都要檢查使用中的節點，尤其是服務提供方調整名稱或清單結構後。自動更新不是連線修復工具，更新時間也不能證明節點正常。若某個訂閱長期回傳無法辨識的內容，請先向提供方確認適用的用戶端格式，再判斷是否需要更換匯入方式。排查完成後刪除重複的測試群組，只保留來源及用途明確的設定，日後升級時更容易判斷問題所在。

路由與 DNS：從入口到出口逐層排查

先確認流量是否進入核心

路由只會處理已進入核心的要求。桌面應用程式未讀取系統代理、Android 應用程式被排除接管，或 TUN 未成功啟動時，再精確的路由規則也沒有機會執行。排查前先查看要求日誌，確認目標應用程式的存取是否有記錄。若完全沒有記錄，請回頭檢查系統代理或接管設定；若有記錄但出口不如預期，再檢查路由。依照這個順序排查，才能避免將入口故障誤判為分流規則問題。

全域模式通常會將已接收的流量交由代理出站；繞過模式則依規則將部分目的地交給直連出站。系統代理開關與路由模式並非同一件事：一個負責讓流量進入，另一個決定流量走哪條路徑。用戶端介面中的模式名稱會對應至實際規則，了解原理後仍須檢查產生的設定。更完整的層級對照請參閱系統代理與路由模式說明。

規則順序與出站標籤

常見路由規則會依序比對，先符合的規則決定處理方式。針對特定網域的精確規則應放在較廣泛的規則之前，否則後面的例外可能永遠不會生效。出站標籤是設定內的參照名稱，不是協定名稱；規則使用 outboundTag 時，必須存在同名出站。標籤拼錯可能造成啟動錯誤或行為不符預期；檢查時不能只看網域清單，也要確認出口定義。

以下是可合併至 Xray 或 V2Fly 用戶端設定的路由片段，假設完整設定中已有名為 direct 的直連出站。此片段會將回環位址及私有位址交由直連處理，其他要求則依完整設定的預設出站處理。片段未提供遠端服務資料，也不是可獨立使用的連線設定。私有位址規則適合保留本機網路存取，但實際部署時仍須檢查本機網路是否使用其他特殊位址範圍。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": [
          "127.0.0.0/8",
          "10.0.0.0/8",
          "172.16.0.0/12",
          "192.168.0.0/16",
          "::1/128",
          "fc00::/7",
          "fe80::/10"
        ],
        "outboundTag": "direct"
      }
    ]
  }
}

domainStrategy 與網域比對

AsIs 主要依現有網域資訊進行比對；IPIfNonMatch 會在網域規則未符合時嘗試解析，再檢查 IP 規則；IPOnDemand 則會在比對過程需要 IP 資訊時進行解析。這些選項說明的是路由比對階段的行為，並不等同於系統 DNS 設定。即使欄位名稱相似，出站連線階段與路由階段的解析策略也不能混為一談。修改後應觀察實際比對結果，而不只是確認網域能否開啟。

網域規則中的 full: 用於比對完整網域，domain: 用於比對指定網域及其子網域；一般字串的比對行為不同，不要將所有寫法視為相同。使用規則資料檔時，也要確認核心能找到相應資料，並辨識所用分類。初次部署時，用戶端內建路由通常比手動編寫整份清單更合適；先建立基準，再逐項加入必要例外。

DNS 解析位置與錯誤路徑

DNS 負責將網域名稱解析為位址。解析要求可能來自應用程式、作業系統、核心或流量接管機制，實際位置取決於設定。應用程式若先將網域解析為 IP，再交給代理，核心可能就收不到原始網域；此時 IP 規則可能正常，網域規則卻不會命中。嗅探可在部分協定流量中補充網域資訊，但無法從所有流量擷取網域，不應視為萬用的網域還原開關。

解析伺服器必須能透過選定路徑連線。若將無法直接連線的解析服務設為直連路徑，就可能出現「節點正常，網域逾時」；若解析依賴尚未建立的代理，也可能形成啟動相依問題。請先區分伺服器位址解析與目標網站解析，再檢查是否有循環相依。測試 DNS 時記下使用的網路、接管方式及快取狀態；換網後的舊快取可能掩蓋實際結果，必要時重新啟動相關應用程式再測試。

嗅探、Mux 與驗證方式

嗅探通常用於協助網域路由，Mux 則用於連線多工，兩者解決的問題不同。啟用 Mux 無法修正驗證失敗，也不保證所有傳輸組合都會更穩定。初次部署時保留預設設定並關閉多工，連線穩定後再依需求嘗試。若只在啟用某項功能後發生中斷，請關閉該功能並重新測試。進階功能必須有實際需求支撐，不應以「所有開關都開啟」作為設定完成的標準。

編輯 JSON 時請留意逗號、引號及陣列結構，設定中不能加入隨手撰寫的註解。先保留原始檔案，再修改副本；若啟動失敗，立即還原。用戶端產生的設定可能在切換節點後重寫，長期使用的規則應儲存在用戶端提供的路由設定中，不要反覆修改暫存輸出。欄位層級的說明可參閱設定檔結構解析，分別理解入站、出站及路由。

常見設定問題：依故障階段排查

介面無法開啟，與節點連線無關

啟動後立即退出、視窗未出現或系統提示缺少執行元件，都屬於應用程式啟動階段的問題。請先檢查安裝套件架構、安裝過程、資料夾權限及執行環境。此時核心可能尚未讀取連線設定，修改訂閱也無法改善問題。Windows 請留意執行環境及解壓縮資料夾；macOS 請檢查架構與系統安全提示；Linux 請確認圖形相依項目及使用者工作階段；Android 則要檢查安裝相容性要求及應用程式資料狀態。

介面能開啟但核心啟動失敗時，再檢查本機連接埠是否遭占用、設定格式及核心支援範圍。兩個用戶端同時執行可能搶用連接埠；舊程序殘留也可能導致新執行個體無法監聽。先停止多餘執行個體，確認監聽位址及連接埠，再重新嘗試。若錯誤指出某個欄位不受支援，請核對目前核心功能及匯入格式；不要刪光所有進階欄位後就認定問題已修好，連線行為可能因此完全改變。

訂閱已取得節點，但連線一直逾時

逾時代表某個階段未能在預期時間內完成，不代表驗證參數一定錯誤。先確認基礎網路正常、伺服器網域可解析，再檢查遠端位址及連接埠是否仍有效。只有一個節點逾時、其他節點正常時，優先檢查該服務或設定；若所有節點在同一網路都失敗、換網後恢復，則應比較網路環境及解析路徑。服務是否可用仍須由服務提供方確認，無法只憑用戶端的逾時訊息判定確切原因。

遇到 TLS 錯誤，請檢查裝置時間、伺服器名稱及憑證要求。連線位址與 TLS 伺服器名稱可以不同，各有用途；不能因位址是 IP，就把伺服器名稱也改成 IP。WebSocket 路徑、Host、gRPC 服務名稱及其他傳輸參數都必須與伺服器端相符。通常直接匯入分享連結比手動補填欄位可靠；確需手動設定時，請逐項核對原始資料，不要依賴介面預設值填入未知內容。

瀏覽器正常，其他應用程式卻失敗

遇到這類差異，優先檢查流量入口。應用程式可能忽略系統代理、使用獨立設定、被 Android 應用程式分流排除，或送出目前入站方式不支援的流量。先查看用戶端日誌，確認是否收到該應用程式的要求。沒有收到就調整應用程式代理或接管範圍；收到後再檢查路由及出站。TUN 可以擴大接管範圍，但也會增加權限及路由相關變數，應在系統代理驗證成功後再使用，不適合作為所有應用程式故障的第一個處理方式。

網站首頁能開啟，但部分資源載入失敗，可能與不同網域、快取連線或協定行為有關。記下無法載入的目標，再確認是否被另一條規則分流。瀏覽器的安全 DNS 及獨立代理擴充功能也可能改變連線路徑；測試時只保留一種明確設定。不要只憑長時間未重新整理的網頁判斷目前連線狀態；舊頁面及快取資源不能證明新要求成功，重新載入或使用新的瀏覽工作階段更有參考價值。

停止用戶端後，基礎網路也無法使用

最常見的檢查項目是殘留的系統代理。作業系統仍將要求交給本機位址，但用戶端已停止監聽，於是所有遵循系統代理的應用程式都會失敗。先清除系統代理，再檢查 TUN 是否已停止，以及是否仍有其他 VPN 接管流量。Android 使用者也要檢查系統 VPN 的封鎖選項。恢復直接連線後再啟動用戶端；若問題只在退出時發生，應修正退出還原流程，而不是更換節點。

應保留哪些日誌，以及測試時要修改什麼

日誌應保留發生時間、操作步驟、錯誤類型及相關欄位名稱。只截取最後一行可能漏掉真正原因，適度保留前後幾行更容易判斷。不過，伺服器授權參數、使用者識別碼及完整訂閱網址都必須去識別。暫時提高日誌詳細程度有助排查；測試完成後請還原日常等級，避免長期產生大量資料。日誌也可能包含存取目標，備份或分享時同樣要留意隱私。

建立一份簡單的對照表：同一節點在系統代理與 TUN 下是否一致、同一設定換網後是否一致，以及同一網路更換節點後是否一致。每次只變更一項並記錄結果；若同時更換節點、修改 DNS、啟用嗅探，即使恢復正常，也無法判斷哪個操作有必要。確認有效的修正方法後，撤回其他測試變更，只保留最精簡且可運作的設定。穩定來自設定清楚、原因可查，而不是輪流嘗試所有可能的選項。

若排查後仍無結果，請整理用戶端名稱、系統與架構、接管方式、故障階段及已去識別的日誌，再前往常見問題核對相應情況。需要重新建立連線時，回到快速入門教學依照最精簡的步驟驗證；需要升級或更換套件時，前往下載中心選擇正確平台。重裝應是最後考慮的環境處理方式，不能取代對錯誤參數及服務狀態的確認。