跨平台安裝與設定

事前準備與設定範圍

釐清用戶端、核心與連線設定

v2rayN 是桌面圖形用戶端，負責儲存連線設定、啟動核心及調整代理相關選項。實際解析協定、連線至遠端伺服器與執行路由規則的是核心。Project V 是相關技術生態的背景，V2Fly 與 Xray 則是不同的核心發展分支。介面能開啟，不代表核心已啟動；核心正常運作，也不代表系統應用已將要求交給它。這三個層面需要分別確認。

桌面平台建議依本手冊使用 v2rayN。Android 可先選用採用 Xray 核心的 v2rayNG；若既有設定明確要求 V2Fly 行為，再考慮 v2flyNG。不要只因名稱相似就互換設定檔。協定支援、傳輸參數與擴充欄位取決於用戶端和實際使用的核心組合，應依服務提供者針對目前選擇的相容性說明操作。

確認架構、權限與網路條件

下載前先確認裝置的處理器架構，不要只看作業系統名稱。常見桌面處理器採用 x64，部分裝置使用 arm64；macOS 還需區分 Apple Silicon 與 Intel。Android 的處理器、系統位元數與可安裝的軟體架構也可能不同。套件格式同樣重要：安裝程式、磁碟映像檔與發行版套件各自適用不同的安裝流程，不能靠更改副檔名互相轉換。

準備一個有權使用且仍有效的訂閱網址，或完整的單一連線參數。用戶端本身不提供可用的遠端服務。連線通常需要伺服器位址、連接埠、身分憑證、協定與傳輸設定；啟用 TLS 或 REALITY 時，還可能需要伺服器名稱、公鑰等欄位。若缺少參數，請向設定提供者確認，不要自行猜測填入。

先確認裝置本身可以正常連上網路，系統日期、時間與時區也設定正確。時鐘明顯錯誤會影響憑證效期判斷，也可能導致部分協定驗證失敗。確認瀏覽器能開啟一般網頁後，再檢查是否有機構網路驗證頁、系統代理、其他正在執行的隧道工具或安全軟體規則。基礎網路不通時，反覆更新訂閱通常無法解決問題。

釐清系統代理與 TUN 的差異

系統代理透過作業系統提供的代理設定，讓遵循該設定的應用程式連線至本機監聽連接埠。這不代表所有應用程式都會轉送流量：有些程式有自己的代理設定，另一些則完全不理會系統代理。TUN 透過虛擬網路介面接管符合條件的流量，涵蓋範圍較廣，但也會增加路由、DNS 與權限等變數，建議先確認一般代理鏈路正常，再啟用 TUN。

在本機使用與分享給區域網路是兩種不同情境。本機連線通常只需要監聽回環位址；允許區域網路連線後，其他裝置才可能存取監聽連接埠，同時也必須考量防火牆、監聽位址與存取範圍。初次安裝時請關閉區域網路分享，不要為了排錯就開放所有網路存取。如有分享需求，可另行參閱區域網路代理分享說明。

建立可還原的操作流程

安裝或移轉前，先完全結束用戶端，再備份設定目錄。備份可能包含訂閱網址、身分憑證與使用記錄，應存放在妥善控管的位置。開始修改前，先記下目前的系統代理狀態、監聽連接埠與路由選擇。分享畫面時，請遮住完整訂閱連結、伺服器憑證與 QR code；這些資訊一旦外流，他人可能就能使用同一份服務設定。

建議依序進行安裝、匯入、啟動、明確指定代理測試、系統代理測試與 TUN 測試。每次只變更一個主要項目，並記錄變更前後的狀況。升級後若出現問題，先比對備份與記錄檔，不要立刻把所有設定都還原成未知狀態。若要回復，先結束新版用戶端，再還原相符的設定副本，避免兩個程序同時讀寫同一個目錄。

Windows 安裝與代理接管

選擇桌面版或經典 WPF 版

前往Windows 下載頁，先區分 v2rayN 桌面版與經典 WPF 版。桌面版採用跨平台介面，WPF 版則保留經典桌面操作方式。兩者並非連線協定的不同等級，也不應只憑外觀判斷效能。依裝置系統、使用習慣與所需功能選擇即可；完成設定不需要同時安裝兩種介面。

下載頁的 Windows 主要下載項目適用於 x64。若裝置採用其他架構，請先確認系統相容性，不要將 x64 檔案當成原生 arm64 套件。安裝時依安裝程式提示選擇目標目錄並設定必要元件。若系統提示缺少執行環境，請依錯誤內容安裝相符元件，不要從不明來源複製動態程式庫。即使安裝完成卻無法啟動，也請保留原始錯誤訊息。

首次啟動時，不要將設定目錄放在唯讀位置，也不要讓同步軟體同時修改該目錄。安裝目錄與使用者設定目錄不一定相同，請透過用戶端提供的目錄入口或記錄檔確認實際路徑。一般系統代理通常不需要長期以系統管理員身分執行；只有涉及虛擬介面、驅動程式或特權操作時，才依明確提示授權，不要把提高權限當成通用修復方式。

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

開啟訂閱群組設定，建立名稱清楚的群組，將完整訂閱網址貼到網址欄位，儲存後更新訂閱。更新成功後，從清單中選取一個設定作為目前使用項目。匯入只會將連線資料儲存到本機，無法證明遠端服務可用。若更新後清單為空，先查看更新結果，再確認網址回傳的是連線設定，而不是帳戶登入頁面。

選取設定後啟動或重新載入核心，查看記錄檔是否出現啟動失敗、連接埠遭占用或不支援欄位等錯誤。若某個設定依賴 Xray 擴充功能，所選核心也必須能解析相應參數。沒有明確說明時，不要一次切換所有核心設定。若有多個群組，請確認目前使用的項目屬於剛更新的群組，避免把舊設定的連線狀況誤當成新訂閱的狀態。

先測試本機代理，再設定系統代理

在參數設定中查看本機監聽連接埠。常見設定為 10808，但實際值應以本機介面顯示為準；這是電腦上的監聽連接埠，不是伺服器連接埠。確認監聽類型後，可讓支援手動代理的應用程式明確使用回環位址與該連接埠。明確指定代理測試成功後，再將系統代理設為自動設定，並確認瀏覽器是否採用新設定。

系統代理是否生效，也會受瀏覽器政策、擴充功能與應用程式內部設定影響。如果某個瀏覽器正常，但另一個應用程式失敗，先確認後者是否支援系統代理，不要直接更換遠端設定。若終端工具需要個別設定代理，只在對應程序中設定，並在完成後適時撤除。系統代理與終端環境變數是不同的設定入口，修改其中一項不一定會影響另一項。

啟用 TUN 並處理平台特有問題

需要接管不遵循系統代理的應用程式時，再嘗試啟用 TUN。依目前用戶端的提示完成必要授權，接著檢查虛擬介面、預設路由與 DNS 是否異常。首次測試時保留簡單路由，並暫時結束其他虛擬網路工具。若啟用後原本正常的直連也中斷，先關閉 TUN 恢復網路，再根據記錄檔與介面狀態排查，不要同時修改憑證、訂閱與防火牆。

Windows 防火牆提示應區分對外連線與允許其他裝置存取本機服務。只在本機使用代理時，不必為了消除提示而允許任意網路的連入連線。若連接埠遭占用，先結束重複執行的 v2rayN，並確認系統匣中是否還有舊程序。變更連接埠後，所有曾手動填入代理位址的應用程式也要同步更新，否則仍會連到舊連接埠。

結束前先清除系統代理，再正常關閉用戶端。若程式異常結束後所有瀏覽器都無法連線，請開啟系統代理設定，確認是否仍指向已停止的本機連接埠。手動執行穩定後再啟用自動啟動，並確認重新登入時只有一個執行個體。電腦從睡眠恢復後若連線失敗，先確認基礎網路已恢復，再重新載入核心，不要把尚未完成連線的狀態誤認為設定損壞。

升級前匯出必要設定並備份設定目錄，安裝完成後先比對監聽連接埠、目前使用的設定與路由選擇。不同介面之間移轉時，不保證每個視窗選項都能一一對應；先還原連線所需資料，再重新檢查平台設定。基本流程可參考使用指南中的代理設定步驟，移轉期間不要一次加入新的分流規則。

macOS 安裝與權限設定

依晶片選擇安裝套件

先在系統的「關於這台 Mac」查看晶片或處理器資訊。Apple Silicon 裝置選擇 arm64，Intel 裝置選擇 x64，再前往macOS 下載頁取得 v2rayN。不要只依電腦購買年份判斷架構，同一年也可能有不同晶片的機型。架構不符可能導致無法開啟、需要透過相容環境執行或產生額外問題，建議優先選擇符合裝置架構的套件。

開啟磁碟映像檔後，依套件內的安裝說明將應用程式複製到「應用程式」資料夾，再從該處啟動。不要長期直接從磁碟映像檔執行，映像檔退出、路徑變更或登入後未掛載，都可能影響後續啟動。也不要手動將設定檔放進應用程式套件內；更新時程式套件內容可能被替換，使用者資料應儲存在用戶端實際使用的設定位置。

若系統顯示安全性提示，先確認檔案來源與提示類型，再使用系統提供的「安全性與隱私權」授權流程。系統判定應用程式損壞、架構不相容與確認來源是不同問題，處理方式也不同。不要一開始就全面停用系統安全機制，也不要照抄來路不明的終端機指令來移除檔案屬性。若無法判斷，請保留完整提示並回到下載頁重新確認所選檔案。

匯入設定並確認代理連線

啟動後先建立訂閱群組、儲存網址，再更新訂閱。若從備忘錄或聊天軟體複製內容，請留意全形符號、換行與尾端空白。更新成功後選取目前使用的設定，啟動核心並查看記錄檔。macOS 的介面名稱可能與 Windows 略有不同，請依設定功能尋找，不必要求每個按鈕的位置完全相同；伺服器參數與本機監聽參數仍須分開理解。

先使用支援明確指定代理的應用程式測試回環位址與監聽連接埠。確認核心正常後，再啟用系統代理。macOS 的代理設定與網路服務相關，Wi-Fi、有線網路及其他網路服務可能各有自己的狀態。切換網路後若某個應用程式不再使用代理，應檢查目前網路服務的代理項目，而不是只看用戶端上次顯示的開關狀態。

部分應用程式會在啟動時讀取代理設定，因此修改系統代理後可能需要重新開啟應用程式。也有應用程式使用自己的網路設定，不能因為瀏覽器能連線，就認定它們也會跟隨系統代理。測試時請使用相同目標與相同接管方式，避免混用瀏覽器快取、既有連線與新連線。必要時關閉原有視窗後重新測試，確保觀察結果反映目前設定。

TUN 權限與網路切換

TUN 涉及虛擬網路介面與系統路由，實際授權方式取決於用戶端目前的實作。只有在應用程式明確要求時才授予所需權限，並確認授權後核心是否確實啟動。視窗中的開關顯示為開啟，不代表系統已建立有效介面。若出現權限不足、介面建立失敗或新增路由失敗，請依記錄檔逐項處理，不要反覆點擊開關期待問題自行消失。

同時使用企業網路工具、虛擬機器橋接網路或其他隧道服務時，可能發生路由與 DNS 衝突。先只執行 v2rayN 建立基準狀態，再逐一啟用其他工具。若必須共存，請明確規劃哪些位址要直連、哪些由另一套網路接管。不要為了讓網頁短暫恢復就刪除不熟悉的系統路由，否則可能影響遠端存取或機構網路資源。

電腦從睡眠恢復、由有線網路切換到無線網路，或連上需要網頁驗證的網路後，既有連線可能失效。先關閉代理接管並完成基礎網路驗證，再啟動核心並恢復代理。若每次喚醒都失敗，請記錄當時能否直接開啟一般網頁、本機是否仍有監聽，以及記錄檔是否顯示遠端重新連線；這些資訊比單說「網路卡住」更能協助判斷問題層級。

結束、更新與設定移轉

正常結束前先關閉系統代理與 TUN，並確認系統網路設定已還原。直接結束程序可能留下指向本機連接埠的代理設定；此時應用程式已停止監聽，瀏覽器便會持續連線失敗。恢復網路時先查看目前網路服務的代理項目，只清除與本次用戶端相關的設定。若裝置受組織政策管理，不要覆蓋管理員預先設定的代理。

移轉到另一台電腦時，先備份訂閱與必要設定，再安裝符合新晶片架構的程式。連線設定可以移轉，但原裝置的路徑、登入啟動項目與網路權限不能直接照搬。移轉後重新確認監聽位址、系統代理與 TUN，確認一切正常後再刪除舊備份。含有身分憑證的備份不宜長期存放在公開共用資料夾，匯入完成後請妥善保存。

Linux 安裝與桌面環境

辨別發行版套件格式與處理器架構

前往Linux 下載頁，依發行版選擇 deb 或 rpm，再確認處理器架構。Debian、Ubuntu 等通常使用 deb，Fedora 等通常使用 rpm；衍生發行版仍應以自身的套件管理說明為準。x64 與 arm64 是架構差異，不是套件格式差異。同一格式可能提供多種架構的套件，檔案能下載不代表系統一定能安裝。

可在系統設定中查看系統與處理器資訊；熟悉終端機的使用者也可執行下方唯讀指令輔助確認。常見輸出中，x86_64 對應 x64，aarch64 通常對應 arm64。發行版識別資訊可用來選擇安裝方式，不應只憑桌面外觀判斷。介面相似的系統，底層套件管理工具與相依套件仍可能不同。

uname -m
cat /etc/os-release

使用發行版的圖形化軟體安裝程式開啟下載的套件，並詳閱相依套件與權限提示。安裝失敗時，先區分架構不符、缺少相依套件，以及軟體管理工具正在使用套件資料庫這三種情況。不要忽略相依套件強行完成安裝，也不要在其他更新工作尚未結束時刪除套件管理鎖定檔。先修復系統套件狀態再重新安裝，比反覆覆寫應用程式目錄更穩妥。

以一般使用者啟動並確認設定目錄

安裝完成後，從應用程式選單以日常使用者身分啟動 v2rayN。不要為了方便長期以高權限執行整個圖形用戶端，否則可能建立屬於其他使用者的設定檔，導致下次以一般權限啟動時無法寫入。若儲存失敗，先確認實際設定路徑與檔案擁有者。應用程式顯示的設定目錄才是準據，不要假設所有發行版都將使用者資料放在相同位置。

建立訂閱群組、更新訂閱並選取目前使用的設定後，啟動核心並檢查記錄檔是否提示執行權限不足、連接埠遭占用或缺少核心檔案。即使套件安裝完整，程式仍可能因安全政策、掛載選項或檔案權限而無法呼叫核心。不要遞迴放寬整個使用者目錄的權限；先找出出錯的特定檔案，再依發行版的權限規則處理。

系統代理不是所有程式共用的設定入口

Linux 的系統代理會受桌面環境、應用程式工具組與程式本身的實作影響。在桌面設定中啟用代理後，部分瀏覽器能使用代理，終端程式卻可能仍採直連；這是設定入口不同，不一定代表用戶端異常。先在可手動指定代理的應用程式中測試本機監聽，確認核心連線正常後，再檢查桌面系統代理是否寫入目前工作階段實際讀取的位置。

圖形應用程式、終端機環境變數與背景服務通常不會自動同步代理設定。在終端機設定環境變數，不代表整個桌面工作階段的代理也已變更；背景服務也可能有獨立的執行環境。排錯時請記錄要求由哪個程式發出，以及該程式從何處讀取代理設定。避免同時保留多組互相衝突的代理位址，尤其是變更監聽連接埠或解除安裝用戶端之後。

若要在應用程式中手動設定 SOCKS 代理，請確認該應用程式如何解析網域名稱。有些實作會先在本機解析，再將位址交給代理；另一些則能將網域名稱交由代理端解析，因此 DNS 行為有所不同。不要只看到「SOCKS」就認定解析路徑相同，應搭配應用程式選項、用戶端記錄檔與實際檢測結果判斷。

TUN、特權操作與網路管理服務

TUN 通常需要裝置存取與網路管理權限，用戶端可能透過授權提示或輔助機制完成相關操作。先檢查錯誤訊息，再依目前應用程式的權限流程授權，不要任意為整個程式目錄增加廣泛權限。各系統使用的網路管理與解析服務不盡相同，寫入路由或 DNS 的方式也可能不同；跨發行版照搬修復指令，可能覆蓋原有網路管理設定。

啟用 TUN 後若無法解析網域名稱，先關閉 TUN 確認是否恢復，再檢查系統解析器狀態、用戶端 DNS 設定與既有虛擬介面。若區域網路位址也無法連線，應優先檢查私有位址路由與介面優先順序。虛擬機器、容器與企業隧道都可能使用額外網段，不要假設所有本機網段都只使用家用路由器的那段位址。

設定自動啟動前，先確認登入桌面後手動執行穩定正常。使用者工作階段啟動與系統啟動服務在權限、環境變數及設定路徑上都不同，不能把圖形用戶端直接當成背景常駐服務。結束或解除安裝前先還原系統代理、停用 TUN，再確認網路正常。若要移轉設定，請先停止程序、保留檔案擁有者資訊，並在新系統重新確認路徑與授權。

更新後若只有系統匣圖示消失，但視窗與核心仍能運作，先檢查桌面環境是否支援系統匣，不要重新匯入所有訂閱。若視窗無法顯示，則檢查圖形工作階段與啟動錯誤。分開記錄介面、核心與網路問題，可以減少無關變更；相關路由資料的維護方式可參閱規則檔更新教學。

Android 安裝與背景執行

選擇 v2rayNG 或 v2flyNG

前往Android 下載頁，優先選擇 v2rayNG；需要 V2Fly 核心相容行為時，再使用 v2flyNG。兩者是獨立應用程式，訂閱、目前使用的設定與背景設定都應分別確認，不要假設它們會自動共用。若安裝多個用戶端進行比較，每次只啟動一個 VPN 服務，避免把另一個應用程式遭系統停止誤判為連線故障。

大多數較新的手機可優先考慮 arm64，但仍應以系統支援的應用程式架構為準。若無法確認或遇到架構相關的安裝錯誤，可查看裝置資訊並考慮通用版。通用版包含更多架構的相容內容，不代表遠端連線能力更強。電視、模擬環境或舊裝置尤其需要另外確認，不要只根據處理器的宣傳名稱判斷系統實際支援的位元數。

安裝時，系統可能要求授予發起安裝的檔案管理器或瀏覽器「安裝未知應用程式」權限。只為本次確實需要的來源授權，完成後可依裝置管理習慣撤銷。更新安裝失敗時，應區分簽章不符、儲存空間不足、架構不符與系統限制。不要未備份就解除安裝舊應用程式，因為解除安裝通常也會刪除其中儲存的訂閱、連線設定與本機選項。

匯入訂閱並允許 VPN 連線

在訂閱群組中新增網址、儲存後更新，再選取一個設定作為目前使用項目。從剪貼簿匯入時，先確認複製的是連線資料或訂閱網址，而不是分享頁面的說明文字。使用 QR code 匯入時也要留意內容類型，單一連線 QR code 與訂閱 QR code 的用途可能不同。匯入後檢查設定類型與重要參數，不要只因清單出現一個項目就認定資料完整。

首次啟動 VPN 模式時，系統會顯示連線要求。確認要求來自剛安裝的用戶端後，再允許建立 VPN 連線。狀態列出現 VPN 圖示只代表系統層級存在該服務，無法證明遠端已連線。接著檢查用戶端記錄檔與實際存取結果。若服務立即停止，應先檢查權限、目前使用的設定與核心啟動錯誤，不要直接修改電池設定。

Android 通常只允許同一使用者或設定檔中有一個啟用中的 VPN 服務。其他網路過濾、企業存取或隧道工具可能與目前用戶端衝突。啟動後若另一個應用程式中斷，先確認系統限制與工作設定檔，再決定要保留哪個服務。不要反覆同時啟動多個應用程式，否則產生的中斷記錄無法準確反映單一用戶端的穩定性。

應用程式分流與僅代理模式

若只需接管部分應用程式，可使用用戶端提供的應用程式選擇功能。先確認清單採用的是包含還是排除邏輯：選取某個應用程式，可能代表讓它使用代理，也可能代表讓它略過代理。修改後重新連線，並透過目標應用程式發出新要求驗證。系統元件、工作設定檔中的應用程式，以及不同使用者空間中的應用程式，不一定都會出現在同一份清單。

VPN 模式與僅代理模式的涵蓋範圍不同。僅代理模式主要提供本機監聽服務，目標應用程式仍須主動使用代理，不能期待手機上的所有應用程式都自動跟隨。家用 Wi-Fi 的手動代理設定也不等同於用戶端 VPN 模式，可能只對特定網路與部分協定生效。比較耗電量或連線狀況時，請先確保兩次測試使用相同模式。

背景常駐、省電與網路切換

若螢幕亮起時可用、鎖定後中斷，先確認用戶端是否仍在執行，再檢查電池最佳化、背景活動、自動啟動與數據節省設定。不同系統的選項名稱不盡相同，請確認實際功能是否允許背景執行。先只為目前用戶端調整必要限制並觀察效果，不必一次停用全域省電功能。更多排查方式可參閱背景常駐與省電設定。

持續傳輸流量、頻繁重新連線與過於密集的檢測都可能增加耗電。排查時請記錄待機環境、網路類型，以及是否有大量流量的應用程式，不要只因電池統計中某項比例偏高就認定異常。手機從 Wi-Fi 切換到行動網路後，原有連線可能需要重新建立；先確認行動網路本身可用，以及用戶端是否被禁止在背景使用行動數據。

若系統設定了「永遠開啟 VPN」或「封鎖未經 VPN 的連線」，停止用戶端後可能仍無法直接連線。恢復網路時請檢查這些系統層級選項，不要只關閉應用程式內的按鈕。準備解除安裝或更換用戶端前，先取消相關綁定並匯出必要設定。匯出檔案與畫面截圖也可能含有敏感網址；分享排錯資訊時，只保留錯誤類型、時間與已去識別化的設定說明。

訂閱匯入與設定管理

訂閱網址、分享連結與設定檔

訂閱網址通常會回傳一組連線設定，適合集中更新；單一分享連結通常只描述一個連線；設定檔則可能還包含本機監聽、路由與 DNS 等內容。這三者不能只憑長度或外觀互相替代。匯入前先確認用戶端目前的入口接受哪種資料，避免把完整核心設定貼到訂閱網址欄，或把需要登入的帳戶頁面誤當成可直接更新的訂閱介面。

訂閱網址的路徑與查詢參數經常包含存取憑證，複製時應保持完整，不要任意刪除看似複雜的尾端內容。也不要把連結提交給來路不明的轉換網站。若服務提供者提供特定用戶端的訂閱格式，請優先選擇相符格式；通用輸出不一定保留所有傳輸擴充欄位，匯入後仍須確認實際連線參數。

建立群組並安排更新順序

依來源或用途建立群組，使用容易辨識又不會洩露帳戶資訊的名稱。首次更新時，先使用裝置目前可用的網路路徑；若設定為透過代理更新，就會依賴既有代理連線。當所有既有設定都失效時，可能形成循環：更新需要代理，代理又需要更新後的設定。此時應恢復獨立可用的網路路徑，或依用戶端選項嘗試直接更新。

更新後檢查群組內是否有內容、數量是否明顯變化，以及目前使用的設定是否仍存在。服務提供者可能變更設定識別資訊或移除舊項目，原先選取的項目不一定能自動對應。請重新選取一個項目並啟動核心，再測試連線。不要將舊記錄檔與新設定混在一起判斷；必要時記下更新完成時間，並查看該時間之後產生的新錯誤。

手動修改訂閱產生的設定時，請考慮下次更新可能會覆寫修改內容。長期需要的路由、監聽連接埠與應用程式選項，應盡量設定在用戶端獨立的全域設定中。若必須保留調整過的連線，請先了解更新關係再個別管理，並確認它不會自動套用伺服器端的變更。訂閱群組與手動設定混放時，尤其應記錄每個項目的來源。

排除訂閱更新錯誤

逾時通常表示要求未能在限定時間內完成，可能與基礎網路、網域名稱解析或所選更新路徑有關；驗證失敗較可能與網址憑證或帳戶狀態有關；解析失敗則表示回傳內容不符合預期格式。這些錯誤無法用同一種操作解決。先查看完整錯誤類型，再檢查對應層級，避免反覆重新整理觸發請求限制，也不要在公開場合貼出含憑證的原始網址。

若在瀏覽器中開啟網址後看到網頁，仍須分辨那是登入頁、錯誤頁，還是正常顯示訂閱內容的頁面。不要直接把網頁本文當成連線清單貼上。若回傳內容不符預期，請向設定提供者確認網址是否過期，以及是否需要指定輸出格式。用戶端只能處理支援的資料結構，無法將任意帳戶網頁自動轉換成可連線的設定。

匯入成功但啟動時出現欄位不支援，應優先檢查核心與協定參數。VMess、VLESS、Trojan 是不同協定，REALITY 則是相關連線設定使用的安全機制，不能只替換名稱就當成完成轉換。傳輸方式、伺服器名稱與身分憑證各有不同用途。升級或切換核心前先保留原始資料，並確認變更確實針對記錄檔指出的問題。

備份、移轉與減少資訊揭露

移轉時優先使用用戶端明確提供的匯入與匯出功能。複製整個目錄前先結束用戶端，並確認目標平台能否讀取相同的資料結構。系統代理開關、檔案路徑、憑證位置與權限狀態都屬於本機環境，不應假設會隨連線資料一併移轉。目標裝置匯入完成後，先測試一條連線，再恢復群組與其他設定，避免一次移轉大量設定而難以定位問題。

訂閱外洩後，處理重點是撤銷或重設存取憑證；只更改本機群組名稱沒有保護效果。分享排錯資訊時，保留協定類型、傳輸方式與錯誤類別即可；伺服器位址、身分識別資訊、訂閱查詢參數與 QR code 都應遮蔽。備份也應設定保存期限，不要無限累積舊帳戶、已停用服務與重複匯出的檔案。

日常維護不必把更新頻率設得太密。先了解服務設定是否經常變動，再選擇適當的手動或定期更新方式；更新與連線檢測是不同操作。操作流程可返回訂閱匯入指南。若只有單一群組更新失敗，請分開排查，不要為了解決單一來源的問題而清空整個用戶端。

路由分流與 DNS 設定

先確認接管範圍，再選擇出站方式

代理接管與路由分流處理的是不同問題。系統代理或 TUN 決定要求是否進入用戶端；路由規則則決定進入後使用哪個出站。若應用程式沒有使用系統代理，即使路由設為全域，它的要求也可能沒有進入核心。相反地，TUN 接管要求後，路由仍可決定直連、代理或阻擋，不能把接管方式與出站模式混為一談。

初次設定時先使用用戶端內建的簡單路由方案，確認一般網頁、區域網路資源與所需遠端目標都能依預期存取。所謂繞過中國大陸通常依賴網域、位址資料與規則組合，並非即時判斷地理位置。全域代理適合暫時減少分流變數，但也可能影響本機服務或機構網路。測試完成後應恢復符合實際情境的規則，不要長期保留排錯用設定。

了解規則順序與比對條件

路由通常依規則順序比對，較早符合的規則會影響後續規則是否還有機會處理。完整網域、網域後綴、分類資料庫、位址範圍與連接埠是不同條件。多個條件組合後的意義，也取決於核心的規則語法，不能把同一行中的每個欄位都解讀成任一項符合即可。修改前應先確認目標要求包含哪些資訊，以及預期使用哪個出站。

以下是 Xray 路由物件的片段範例，用來說明私有位址直連。這不是可單獨執行的完整設定，合併時必須保留現有入站與出站，並確保名為 direct 的出站已存在。用戶端產生設定時也可能覆寫手動編輯內容，建議優先使用對應的路由編輯功能，不要直接修改暫存產生檔。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

AsIs 表示該路由策略不會為了比對位址而主動解析網域名稱，並不代表整個系統不會發出 DNS 要求。若要求本身已帶有位址，仍可能符合位址規則。geoip:private 需要相應的規則資料，其他分類名稱也需要資料檔支援。檔案缺漏、分類不存在與規則順序錯誤會造成不同結果，應從核心記錄檔確認實際失敗原因。

拆解 DNS 解析流程

網域名稱可能由應用程式、系統解析器或用戶端內部解析，解析要求本身也可能經由不同出站。瀏覽器若啟用獨立的加密 DNS，還會產生另一條路徑。因此，修改用戶端 DNS 不一定能控制所有應用程式的解析。排查時先確認由誰發起解析，再查看要求送往何處、經過哪條鏈路，以及回傳位址如何參與路由；不要只替換一個伺服器位址就結束檢查。

系統代理主要處理應用程式主動交給代理的流量，不保證系統所有 DNS 要求都會被接管。TUN 可擴大涵蓋範圍，但 DNS 是否能正確處理，仍取決於介面、路由與用戶端設定。如需檢測，可依照DNS 要求路徑檢測方法逐項確認。檢測頁面顯示的解析出口也可能受快取與網路服務影響，不能只看一次結果就判定所有要求都走同一路徑。

FakeDNS 透過虛擬位址對應，協助後續還原網域名稱，主要用於特定的接管與分流情境。它不等同一般公共 DNS，也不能單獨啟用後就期待所有應用程式自動相容；還需要相應的攔截、映射與網域還原流程配合。若應用程式快取虛擬位址後改用直連，可能會連線失敗；啟用或停用相關功能後，應依實際情況重新建立連線並處理快取。

規則維護與驗證方式

GeoIP 與 GeoSite 資料會影響分類規則的涵蓋範圍，但更新檔案無法修正錯誤的規則語法。先確認用戶端讀取的是哪個檔案，以及更新是否成功，再檢查分類名稱與使用位置。相關背景可參閱GeoIP 與 GeoSite 更新及設定方式。在設定檔中引用不存在的分類，不會因名稱看起來合理就自動生效。

每次只新增一條規則，使用同一個目標建立新連線進行驗證，並從記錄檔查看出站選擇。應用程式既有的長連線可能繼續沿用舊路徑，因此修改規則後不要只重新整理介面就判斷結果。若目標涉及多個網域或重新導向流程，請分別確認主頁、資源網域與 API 要求；頁面部分載入成功，不代表所有相關網域都套用相同規則。

長期使用時，請為區域網路資源保留明確的直連範圍，並記錄自訂規則的用途。需要搭配複雜 DNS 設定前，可先閱讀FakeDNS 原理與啟用時機。恢復網路時，依相反順序撤銷最近的變更：先移除新增規則，再還原 DNS，最後切換接管方式。保留一份已驗證可用的簡單方案，能大幅縮短下次排錯時間。

常見設定問題與排錯順序

從現象判斷故障層級

先將問題描述成可重現的狀況：使用哪個平台與用戶端、採用系統代理還是 TUN、哪些應用程式失敗，以及關閉代理後是否恢復。接著確認最近一次變更，是更新訂閱、調整連接埠、啟用 DNS 功能，還是切換網路。不要同時將所有設定還原為預設值，否則可能失去解釋問題的線索，也難以恢復原本正常的部分。

排錯時應從基礎網路開始，再檢查本機程序、遠端連線與應用程式行為。先確認裝置能連上網路，再確認核心成功啟動並監聽連接埠，接著以明確指定代理的方式驗證連線，最後檢查系統代理、TUN 與分流。某一層尚未通過，就先不要修改更高層的設定。如此可避免用 DNS 調整處理連接埠占用，或用重新安裝用戶端處理系統殘留的代理設定。

啟動、訂閱與連線問題

應用程式差異與網路復原

記錄有效資訊並保留復原方案

記錄檔優先保留故障發生前後的一小段，只需包含錯誤類型、時間、用戶端名稱、作業系統與接管方式。分享前遮蔽訂閱網址、伺服器憑證、QR code 與帳戶資訊。連線逾時、憑證錯誤、網域名稱解析失敗與設定欄位不支援應分別描述，不要一概說成「不能用」。清楚標示問題層級，比分享大量未整理的記錄檔更容易後續檢查。

問題解決後，將最終變更記錄在本機維護筆記中，並保留一份已驗證可用的設定副本。若先前關閉了自動啟動、背景限制或其他工具，請逐一恢復並重新測試，確認沒有引入新衝突。如需重新走最精簡的操作流程，請回到使用指南；需要更換平台或安裝檔時，請回到用戶端下載頁。本頁各章也可作為日後升級與移轉時的檢查清單。