V2Ray 全平台
安裝設定指南

準備工作：確認設定與連線路徑

區分用戶端、核心與服務設定

先區分以下三個部分。圖形用戶端負責管理伺服器、訂閱、路由與系統連線；核心負責建立連線與轉送流量；服務設定則提供遠端位址、連接埠、協定及驗證參數。安裝用戶端不代表已取得可用連線，匯入設定也不表示遠端服務一定正常運作。排查時分別檢查這三個部分，可避免位址錯誤時反覆修改系統代理，也能避免把介面成功啟動誤認為核心正常運作。

桌面平台建議優先使用 v2rayN，Android 平台可先了解 v2rayNG；需要 V2Fly 核心設定時，再考慮 v2flyNG。這三款用戶端的介面與設定能力不盡相同；同一個分享連結能成功解析，只代表語法可讀，不表示所有傳輸選項都受支援。請先確認服務提供的協定、傳輸方式及所需核心功能，再選擇用戶端；不要只為了成功匯入而任意刪除不熟悉的欄位。

確認作業系統版本、處理器架構與安裝套件類型。系統設定通常會顯示處理器與作業系統資訊；判斷架構時，應以裝置實際執行環境為準，而非只看品牌。桌面版的安裝程式、磁碟映像檔與 Linux 發行版套件各有不同安裝方式；Android 通用版與特定架構版也不能只憑檔案大小判斷。前往用戶端下載頁選擇平台，先閱讀下載卡片上的架構說明，再進行安裝。

準備訂閱，記下原有網路設定

取得仍有效的訂閱網址或單一分享連結。訂閱通常包含可更新的伺服器清單；單一分享連結則描述一組連線設定，兩者的匯入位置可能不同。複製時請確認沒有多出空格、引號或換行，也不要連同網頁標題一起複製。訂閱網址可能包含個人存取憑證，請妥善保管；截圖、記錄檔與公開求助內容都不應包含完整網址，更不要拿他人的設定當作測試資料。

記下既有代理、其他隧道工具與手動 DNS 設定，確保之後可以還原。初次設定時只啟用一種連線方式：先以系統代理測試瀏覽器，再視需要嘗試 TUN。同時啟動多個用戶端，容易造成監聽連接埠衝突、系統代理遭覆寫或路由迴圈。公司與學校管理的裝置也可能限制網路延伸功能及管理員權限；遇到政策限制時，請先確認授權範圍，不要透過修改安全性政策強行安裝。

建立最精簡可用的測試環境

開始測試前，請確認系統日期、時間與時區正確。加密連線可能會檢查憑證有效期限，系統時間偏差可能導致交握失敗。接著確認本機網路可以正常連線，且瀏覽器未啟用獨立的代理擴充功能。選定一個已知可連線的測試網站作為基準，並維持測試條件一致。用戶端的連線測試、瀏覽器要求與其他應用程式的流量可能走不同路徑，因此不能以其中一項結果代替完整驗證。

檢查本機監聽位址與連接埠。個人裝置通常只需監聽迴路位址；允許區域網路連線會擴大可存取範圍，並非解決連線失敗的通用方法。混合連接埠可在同一入口接受用戶端支援的代理要求，但實際功能仍須依參數設定而定。本頁的 10808 只是常見範例值；實際操作時請查看目前設定，不要照抄後便假設連接埠已成功監聽。

將首次成功的設定存為基準，只需記下使用的用戶端、連線方式、路由預設值與本機連接埠，不必記錄敏感憑證。之後調整 DNS、核心或 TUN 時，每次只修改一項，並在相同網路環境下重新測試。發生問題時便能直接還原到上一步，不必同時猜測多項設定。若只想完成首次連線，請返回快速入門流程，依序準備、匯入、選擇模式並進行驗證。

Windows：安裝與系統代理設定

選擇桌面版或 WPF 版

開啟Windows 下載頁，在 v2rayN 卡片中選擇桌面版或經典 WPF 版。桌面版採用跨平台介面，WPF 版則專為 Windows 設計；兩者的版面、設定位置與執行需求可能不同。請勿將某一版本的畫面截圖位置，視為另一版本的固定操作位置。選擇前請閱讀安裝套件說明，確認與系統及架構相符；如需比較介面差異，可參閱桌面版與 WPF 版選擇指南。

使用安裝程式時，依照精靈完成安裝；若取得的是壓縮檔，請先完整解壓縮至具有寫入權限的獨立資料夾，再啟動程式。不要直接從壓縮軟體的預覽視窗執行，也不要混用不同發行套件中的程式與核心檔案。請保留可寫入的空間，避免將設定存放在會定期清除的暫存位置。首次啟動若提示缺少執行環境，請依照對應發行套件的說明補齊；不要從不明來源下載同名系統檔案來覆蓋。

啟動後先查看主介面記錄，確認核心沒有立即結束。關閉視窗後，程式可能仍在系統匣執行；再次開啟前請先查看系統匣，以免啟動第二個執行個體。若安裝路徑包含個人檔案，升級前請先匯出設定並保留舊資料夾。用戶端仍在執行時，不要直接覆寫正在使用的檔案；也不要只複製執行檔，漏掉同一發行套件中的其他資源。升級完成後，還要重新確認監聽連接埠與系統代理狀態。

匯入訂閱並啟用一種代理入口

在訂閱群組設定中新增群組，填入容易辨識的名稱與訂閱網址，儲存後更新該群組。若取得的是單一分享連結，請使用對應的剪貼簿匯入功能。更新後確認伺服器清單中出現預期項目，選取其中一個並設為目前使用的伺服器。匯入只會更新設定清單，不一定會自動切換目前使用的伺服器。可參考v2rayN 主視窗說明，尋找相應的介面區塊。

首次驗證時，請選擇自動設定系統代理，並保持 TUN 關閉。系統代理會將本機代理位址寫入系統設定，但只影響遵循該設定的應用程式。瀏覽器通常適合用於第一輪驗證；遊戲、更新程式及使用自訂網路設定的軟體則可能不會跟隨。若瀏覽器已安裝代理擴充功能，請先停用再測試。若要手動設定應用程式，請填入用戶端實際監聽的迴路位址與連接埠，並確認代理類型符合該監聽入口。

需要讓更多應用程式的流量經過用戶端時，再嘗試 TUN。TUN 透過虛擬網路介面與路由接收流量，通常需要管理員權限，實際要求視目前用戶端與系統環境而定。請先清除系統代理，再依介面提示啟用 TUN，並查看記錄中是否有權限、介面建立或路由錯誤。確認核心持續執行，且目前使用的伺服器沒有變更。成功啟用 TUN 不代表所有網路情境都適合使用；其他隧道、虛擬網卡與管理政策仍可能造成衝突。

排除連接埠占用與退出後無法上網

監聽失敗時，先查看錯誤訊息是否明確指出位址已被使用。以下命令只用於診斷本機連接埠，不會自動結束程序。範例檢查 10808，請替換為目前參數設定中的值。輸出最末欄為程序編號，可在工作管理員中查找。確認該程序屬於哪個程式後，再決定關閉重複執行個體或更換連接埠；不要只憑連接埠號碼就結束系統程序。

netstat -ano | findstr :10808

更換連接埠後，也要更新曾手動設定的應用程式。若使用自動系統代理，請重新套用代理設定，確認系統不再指向舊連接埠。更完整的排查方式請參閱本機連接埠占用排查。防火牆提示應依實際用途選擇網路範圍；個人裝置只供本機使用時，不必為了測試而開放區域網路監聽，也不應以關閉整套防護取代逐項排查。

結束用戶端前，先清除系統代理、關閉 TUN，再正常退出。若程式異常結束後瀏覽器無法上網，請開啟系統代理設定，檢查是否殘留迴路代理位址；確認用戶端已停止後清除殘留設定，再測試直接連線。電腦從睡眠喚醒或切換無線網路後若發生異常，可先重新連線至目前伺服器，再重新套用連線方式。不要反覆重新安裝來處理代理殘留，因為重新安裝未必能修復系統層級的舊設定。

macOS：晶片選擇與網路權限

確認晶片型號並完成首次啟動

前往macOS 下載頁，依「關於這台 Mac」顯示的晶片類型選擇 v2rayN。Apple Silicon 對應 arm64，Intel 對應 x64。不要根據外觀或購買年份猜測架構，也不要以為相容層能解決所有網路延伸功能問題。下載完成後開啟磁碟映像檔，依發行套件提供的方式將 App 移至「應用程式」資料夾，再從該資料夾啟動；避免長期直接執行掛載映像檔中的副本。

首次開啟時，系統可能要求確認這個 App 是從網路下載的。請核對檔案來源與 App 名稱，再依系統設定中針對該 App 的提示操作。不要為了開啟單一程式而全面關閉安全性檢查，也不要直接執行來源不明的解除限制命令。若系統提示架構不相容或版本不符合需求，請回到下載說明重新選擇，而非反覆修改檔案權限。App 尚未成功啟動前，先不要排查訂閱或 DNS。

確認 App 能儲存參數，且重新開啟後設定仍保留，再繼續匯入設定。應用程式資料夾與使用者設定資料夾用途不同；升級時請使用用戶端的備份或匯出功能，不要只保留 App 圖示，便以為設定也已儲存。系統備份可提供額外的還原方式，但還原用戶端設定後仍須檢查本機連接埠、權限與網路介面，因為這些項目可能與原裝置不同，不能直接照搬。

匯入設定並確認系統代理

在訂閱群組中新增網址、儲存並更新，選定目前使用的伺服器後查看執行記錄。若匯入的是單一分享連結，請先確認內容完整，再使用剪貼簿匯入功能。其他桌面平台的分享連結通常可作為匯入資料，但不能直接用另一台電腦產生的整份設定取代本機設定。若設定包含僅存在於原電腦的憑證路徑、指令碼路徑或介面名稱，請回到介面逐項重新設定，不要讓舊路徑繼續影響啟動。

先使用系統代理測試瀏覽器。macOS 的代理設定與網路服務相關，目前使用 Wi-Fi 或有線網路，會影響應檢查的服務項目。自動設定後若瀏覽器沒有變化，請在系統網路設定中查看目前服務的代理項目，確認位址指向本機，且連接埠與用戶端設定一致。切換網路服務後請再次檢查；不要只因某個未使用的服務已啟用代理，就認為目前網路已連線。

命令列工具及自行設定代理的 App 不一定會遵循系統代理。需要單獨測試時，可明確指定代理入口，將 App 行為與系統設定分開。以下命令適用於目前混合入口可接受 HTTP 代理要求的情況，只用來確認單次要求能否經由本機入口傳送，不會修改系統代理。收到回應代表要求已完成，但是否使用預期的遠端出口，仍需參考路由記錄與出口測試結果。

curl -I --proxy http://127.0.0.1:10808 https://example.com

啟用 TUN 並處理網路切換

需要使用 TUN 時，先記下目前可正常運作的系統代理設定，清除系統代理後再啟用 TUN。依用戶端提示完成必要的權限授權；授權視窗的形式會因系統與發行方式而異。若記錄顯示操作遭拒、虛擬介面建立失敗或路由新增失敗，請先檢查是否已完成授權，不要接著修改遠端協定參數。TUN 負責讓流量進入用戶端，無法修復伺服器位址、驗證資訊或傳輸方式錯誤。

與其他隧道工具同時執行時，特別留意預設路由與 DNS 由哪個工具管理。測試期間只保留一個接管網路的用戶端，避免兩個程式輪流改寫設定。連上公司網路、手機熱點或公共 Wi-Fi 後，可能需要先完成該網路的登入程序，再重新連線代理。若直接連線也失敗，請先處理基礎網路；此時反覆更換伺服器，通常無法解決登入頁面無法開啟的問題。

從睡眠喚醒後若只有部分網站無法連線，請先重新建立連線，並查看 DNS 錯誤與路由是否已更新。不要立即清除所有系統網路設定。可先退出用戶端，確認系統代理已還原，再測試直接連線，之後重新啟用一種連線方式。手動 DNS、瀏覽器安全 DNS 與用戶端核心 DNS 位於不同層級；自訂來源過多時，更難判斷實際查詢路徑，建議依本頁路由章節逐層檢查。

正常結束時先停止 TUN，再清除系統代理，最後退出 App。解除安裝前也應完成這些步驟；刪除 App 不代表所有網路設定都會自動清除。退出後若仍無法上網，請檢查目前網路服務中的代理項目是否仍指向已停止的本機連接埠。保留正常連線時的參數紀錄，尤其是本機連接埠與連線方式，日後系統更新或換機時便能更直接地還原，不必重新猜測各項設定。

Linux：套件與桌面代理連線

選擇套件格式與處理器架構

開啟Linux 下載頁，依發行版選擇 v2rayN 的 deb 或 rpm 套件，再確認架構為 x64 或 arm64。不能只憑桌面外觀判斷套件格式；使用相同桌面的發行版也可能採用不同套件管理系統。請優先從系統資訊確認發行版與架構；需要輔助檢查時，可執行下方的唯讀命令。常見的 x86_64 對應 x64，aarch64 通常對應 arm64。

uname -m

使用發行版提供的圖形化軟體安裝程式開啟對應套件，查看相依性資訊後再安裝。若安裝程式提示無法滿足相依性，請先確認系統發行版與套件來源狀態，不要強制忽略相依性，只求表面上完成安裝。安裝後從桌面應用程式選單啟動，並查看視窗與記錄。若圖形介面正常顯示但核心退出，應接著檢查核心記錄，不要將介面顯示問題與網路協定錯誤混為一談。

請維持使用者設定資料夾的正確擁有者與權限。不要為了使用一般代理功能，長期以最高權限執行整個圖形用戶端，否則可能產生一般使用者無法寫入的設定檔。之後以一般使用者啟動時，就可能發生儲存失敗、訂閱無法更新或記錄無法寫入等問題。若曾變更執行身分，請先找出受影響的資料夾，再依發行版文件還原權限；不要遞迴放寬整個家目錄的存取控制。

匯入訂閱，區分桌面設定與應用程式設定

訂閱匯入流程與其他桌面平台相同：新增群組、填入網址、儲存、更新，再選擇目前使用的伺服器。更新失敗時，先確認該要求是否需要透過既有代理傳送，不要同時修改訂閱網址與網路模式。若要從其他裝置遷移，優先使用用戶端支援的分享連結或匯出功能；涉及本機路徑的設定則需要重新建立。確認核心已啟動後，再設定應用程式入口，以免應用程式持續連線至尚未監聽的連接埠。

Linux 桌面的系統代理支援情況，取決於桌面環境與個別應用程式。有些應用程式會讀取桌面代理設定，有些使用環境變數，另一些則只認自己的設定。用戶端顯示已設定系統代理，不代表每個程式都會使用該入口。請先用瀏覽器完成基本測試，再逐一檢查其他應用程式。若系統匣沒有顯示圖示，也不要立即判定程式未執行；可查看應用程式視窗與程序狀態，確認是否只是桌面系統匣整合方式不同。

明確指定代理的單次要求，有助於排查連線入口問題。以下命令要求本機連接埠接受 SOCKS 要求；socks5h 會將目標主機名稱交由代理入口處理，而不是先由本機解析。這不代表後續所有 DNS 查詢都必定透過遠端伺服器，實際行為仍取決於核心的路由與 DNS 設定。替換連接埠後即可執行，不必將設定寫入全域環境變數。

curl -I --proxy socks5h://127.0.0.1:10808 https://example.com

不建議首次測試就修改系統層級的環境檔案。環境變數可能只影響之後啟動的程序，已執行的瀏覽器不會自動套用新值；從圖形桌面啟動的程式也未必會讀取終端機設定。若命令列應用程式確實需要代理，請先針對單一應用程式驗證，再決定是否永久設定。不要同時設定桌面代理、應用程式代理與全域環境變數，最後只憑某個程式能上網就認定整體設定正確。

確認 TUN 權限與監聽狀態

TUN 需要建立虛擬介面並管理路由；啟用方式會受發行版、核心與用戶端發行方式影響。請依目前用戶端的提示完成授權，不要套用其他作業系統的權限操作。啟用前先停用其他會接管路由的工具；啟用後確認介面確實建立且規則已套用。圖形介面開關即使顯示已啟用，若記錄指出權限不足，實際流量可能根本沒有進入 TUN；更換伺服器無法修復這一層問題。

本機入口無法連線時，可使用 ss -lntp 查看正在監聽的 TCP 連接埠；能看到的程序資訊範圍取決於目前權限。找不到目標連接埠時，先確認核心是否退出，以及設定是否已載入。若連接埠已被其他程序使用，確認程序用途後再關閉重複執行個體或更改監聽值。遠端連線失敗時，則應繼續檢查 DNS、驗證與傳輸記錄；不要為了處理遠端錯誤而將監聽位址改成所有介面。

切換網路、從睡眠喚醒或退出用戶端後，請檢查桌面代理是否仍有殘留。解除安裝套件不保證所有手動設定過代理的應用程式都會自動還原，終端機環境變數也需另外移除。建議將變更限制在明確知道如何還原的範圍，並在操作前記錄設定。測試結束後，分別驗證瀏覽器、所需應用程式與直接連線是否符合預期，才算完成桌面環境的安裝設定。

Android：安裝、授權與背景執行

選擇用戶端並安裝相符架構

前往Android 下載頁，建議優先查看使用 Xray 核心的 v2rayNG；需要 V2Fly 核心設定時，再以 v2flyNG 作為替代選擇。較新的主流裝置通常採用 arm64，但仍應以裝置支援的應用程式架構為準。無法確認時，可考慮通用版套件，不要接連安裝多種架構版本碰運氣。安裝失敗可能與系統版本、架構或既有應用程式的簽章衝突有關，應分別確認原因。

透過瀏覽器或檔案管理員開啟安裝套件時，系統可能會要求允許該來源安裝應用程式。授權通常只適用於目前用來開啟檔案的應用程式；安裝完成後，可視需要撤銷該授權。若系統提示與已安裝的應用程式衝突，請先確認既有應用程式的來源並匯出設定，不要等到解除安裝後才考慮如何還原資料。不同用戶端的應用程式資料彼此獨立；安裝其他用戶端不會自動繼承原有訂閱、伺服器與路由設定。

首次開啟後，先查看通知與網路相關提示，再進入訂閱管理。Android 用戶端會使用系統 VPN 服務介面建立流量入口；系統授權不等於已連上遠端伺服器。授權只允許應用程式建立網路通道，之後仍需要有效設定與正常運作的核心。若裝置受工作設定檔或管理政策控制，系統可能限制可用的 VPN 服務；請先確認管理要求，不要反覆安裝相同套件。

匯入訂閱並確認連線範圍

在訂閱設定中新增群組，填入名稱與訂閱網址，儲存後執行更新。若只有單一分享連結，請使用剪貼簿匯入功能；只有在需要掃描設定時，才需要授予相機權限。匯入後請確認伺服器名稱、協定與傳輸設定完整，再選取一組設定啟動。不要反覆將已失效的訂閱網址當成單一分享連結匯入，兩種入口處理的內容不同，重複嘗試也不會讓網址恢復有效。

點選連線後，閱讀系統 VPN 授權對話框並確認。查看常駐通知與用戶端記錄，確認服務沒有立即停止。Android 通常只允許同一使用者環境中有一個作用中的 VPN 服務；其他網路工具可能會取代目前連線。測試時先停用其他同類服務，尤其是同樣使用 VPN 介面的過濾工具。系統顯示 VPN 標記只能表示通道已建立，仍須透過實際要求驗證遠端連線與分流結果。

檢查應用程式分流設定。啟用允許清單時，未選取的應用程式可能不會經過代理；啟用排除清單時，列出的應用程式則可能直接連線。這兩種設定的含義相反，不能只看清單中是否有某個應用程式。建立基準時，先使用預設連線範圍測試瀏覽器，再逐步加入需要的應用程式。瀏覽器自身的安全 DNS、快取與連線重用也會影響測試結果；修改規則後請重新發出要求，不要只重新整理已開啟的頁面。

兼顧背景持續執行與電池續航

螢幕關閉後若連線中斷，先確認是系統停止服務，還是服務仍在運作但網路要求失敗。前者應檢查應用程式的電池最佳化、背景活動與自動啟動限制；後者則要查看記錄、目前網路與伺服器狀態。各家裝置的設定位置不同，請依實際系統尋找功能相同的項目。不要一次取消所有背景限制；先調整直接影響執行的一項，再觀察螢幕關閉與喚醒後的情況。

常駐通知可顯示服務狀態；通知消失不一定能單獨證明服務已停止，但可作為排查線索。若需長時間連線，保留可辨識連線狀態的通知會更容易判斷。耗電偏高時，請檢查是否有高頻連線測試、反覆重新連線、記錄層級過高或背景應用程式持續傳輸流量。將應用程式加入電池最佳化白名單，主要是改善持續執行條件，不會直接降低核心耗電，也無法修復遠端連線不穩定。

從 Wi-Fi 切換至行動網路時，原有連線可能失效，需要重新建立。若只在某個網路下失敗，先確認該網路本身可以連線，再使用相同伺服器與相同設定進行比對測試。公共網路可能要求先完成登入頁面驗證；行動網路也可能受數據節省功能與背景數據權限影響。不要因切換網路後第一次要求逾時，就立即重建所有訂閱；先觀察重新連線結果與記錄，更容易找出原因。

停止使用時，先在用戶端中中斷連線，再確認系統連線標記與常駐通知狀態。更換用戶端前，請先停止原有服務，不要將授權切換誤判為伺服器故障。若要進一步調整背景限制與耗電設定，可參閱v2rayNG 背景執行與省電設定。保留必要記錄後再清除資料；清除應用程式資料會刪除本機設定，不應作為每次斷線時的例行處理方式。

訂閱與遷移：維護可還原的設定

選擇正確的匯入方式

訂閱網址、分享連結與完整設定檔用途不同。訂閱網址用於定期取得清單，分享連結用於傳遞單一連線參數，完整設定檔則可能同時包含本機入口、出站、路由與 DNS。用戶端支援其中一種格式，不代表其他格式也能透過相同入口匯入。匯入前請先確認內容類型，尤其不要把一般網頁網址當成訂閱，也不要將完整設定文字貼到只接受連結的輸入欄位。

建立清楚的訂閱群組名稱，標示來源或用途即可，不必包含憑證。儲存後先更新單一群組，再確認結果。若群組更新成功但清單為空，請檢查是否收到空白內容、訂閱格式不相容，或條目被篩選條件隱藏。更新後若出現重複名稱，也不要只憑顯示名稱刪除伺服器，名稱並非唯一識別資訊。請先確認群組與目前使用伺服器的關聯，再整理舊條目，以免刪除仍需使用的設定。

維護時，請區分訂閱管理的條目與手動新增的條目。更新訂閱時可能覆蓋遠端提供的參數；若直接修改訂閱條目的傳輸設定，下次更新後可能會遺失。確實需要暫時測試時，請使用用戶端支援的複製或獨立設定方式，標示測試用途並保留原始條目。不要把臨時修補的設定當成長期來源；遠端服務變更時，應優先更新訂閱或向設定提供者確認參數。

找出訂閱更新失敗的階段

先確認更新要求是否已送出。網址空白、格式錯誤或複製時多出字元，都會在連線前失敗；網域解析失敗則發生在建立連線前；逾時、憑證錯誤與拒絕存取則屬於後續階段。有些網址會重新導向至登入頁面或傳回錯誤頁面；要求成功並不代表收到的內容就是訂閱。請查看記錄中的狀態與錯誤摘要，避免將服務到期、存取限制或內容格式問題一概說成「用戶端無法開啟」。

「更新訂閱時不透過代理」只會改變更新要求的傳送路徑，不會改變一般應用程式流量的路由。目前伺服器無法使用，而更新又依賴該伺服器時，可測試直接更新；若訂閱網址只能透過代理存取，則須先建立可用連線再更新。每次只變更這項設定，並保留錯誤結果供比對。不要同時切換 DNS、目前使用的伺服器與更新方式，否則即使更新成功，也難以確認真正有效的條件。

更新後，確認目前使用的伺服器仍然有效。遠端清單可能移除舊條目或變更內部參數；用戶端是否自動切換目前選項，則取決於具體實作。不要只看到「更新完成」就關閉視窗，請接著測試目前連線，並確認群組篩選沒有隱藏新條目。必要時手動重新選擇伺服器。若所有條目都同時失敗，應優先檢查訂閱內容、帳戶狀態與本機網路等共同因素，不要逐一反覆修改連接埠。

遷移設定並驗證還原結果

遷移前先使用用戶端提供的匯出或備份功能，並確認匯出範圍。有些功能只匯出伺服器連結，有些則包含訂閱與介面設定，不能只憑檔名判斷。請另外記錄訂閱來源與必要的自訂規則，並存放在受保護的位置。不要為了方便遷移而開放整個設定資料夾供區域網路存取，也不要將包含憑證的檔案放進公開同步資料夾。只要原裝置仍可使用，就應先確認備份能否還原。

跨平台遷移時，優先轉移通用伺服器資訊與訂閱網址，再於目標裝置重新設定本機連接埠、系統代理、TUN 與檔案路徑。Windows 路徑與網路介面名稱不能直接套用於 Linux 或 macOS；Android 的分應用程式清單也不等同於桌面應用程式設定。核心不同還可能影響支援的協定欄位。匯入後請確認用戶端是否忽略了部分參數；「沒有報錯」不代表所有欄位都已完整遷移。

還原完成後，先測試單一伺服器，再還原路由與 DNS，最後設定自動更新與背景執行。每個階段成功後都記錄結果，建立可供還原的檢查點。升級用戶端時也適用相同順序：匯出、停止執行、完成升級、確認連接埠，再驗證要求。沒有可還原的備份時，不要直接清除舊資料夾；也不要將舊程式產生的整份執行設定，強行覆寫到新版介面管理的資料夾。

路由與 DNS：區分入口、規則與出口

先區分系統連線方式與路由決策

系統代理與 TUN 決定流量如何進入用戶端；路由則決定流量進入後使用哪個出口，兩者不是同一個開關。啟用系統代理但應用程式不遵循時，流量就不會進入核心；啟用 TUN 後仍可由規則選擇直接連線。用戶端所稱的全域代理，通常表示預設選擇代理出口，不代表系統中的所有程序都一定會被接管。分析結果前，先確認要求從哪個入口進入，再檢查路由，最後確認遠端連線是否成功。

初次使用時，先選擇用戶端提供的路由預設值，建立可運作的基準。之後再加入確實需要的規則，並留意比對順序。常見規則會依順序逐一判斷；較寬泛的條件若排在前面，可能會涵蓋後方較精確的條件。讓區域網路位址直接連線，有助於存取路由器、印表機與本機服務；但能否涵蓋所有本機環境，仍取決於預設規則內容。企業內部網域可能解析至私人位址，不能只靠公開網域清單處理。

編輯自訂規則前，先確認比對對象。網域條件、目標位址條件與應用程式條件屬於不同維度，不能彼此取代。應用程式若直接連線至數字位址，單純的網域規則可能不會生效；啟用流量嗅探後，或許能取得額外網域資訊，但並非對所有連線都有效。規則未命中時，應查看實際目標、比對順序與預設出口，不要立刻清空整組規則，以免失去原本正常的分流設定。

檢視規則片段並確認實際出口

以下示範 Xray/V2Fly 格式的路由物件：區域網路位址直接連線，範例網域及其子網域則透過代理。這是語法參考，並非可直接貼入任意用戶端文字欄位的完整設定。請確認目前核心支援所用欄位，且產生的設定中確實有名為 direct 與 proxy 的出站標籤。若使用用戶端的圖形化規則編輯器，請填入相應條件，不要將整個物件貼到只接受網域清單的位置。

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

片段中的私人位址規則依賴核心可用的地理資料資源；若缺少資源，可能導致設定載入失敗。不同核心的規則語法與資源組織方式不能混用。保留用戶端產生的設定作為唯讀排查資料較安全；直接編輯產生的檔案，常會在儲存介面設定或重新啟動後遭到覆寫。修改後先確認設定載入成功，再測試規則是否命中；若核心啟動失敗，應先處理語法與資源錯誤，而非分析網頁存取結果。

分層檢查 DNS 與連線重用

DNS 查詢可能由系統、瀏覽器、應用程式或核心負責。修改用戶端 DNS 不會自動取代所有應用程式自己的解析策略。瀏覽器安全 DNS 與系統私人 DNS 也可能改變實際查詢路徑。排查時先記下由誰負責解析目標網域，再確認查詢是否經過預期出口。不要將某個公開 DNS 位址視為萬用解法；不同網路的可達性、延遲與回應可能不同，應搭配實際要求驗證。

也要區分伺服器網域解析與目標網站解析。建立遠端連線前，用戶端可能需要先解析伺服器位址；若這一步依賴尚未建立的代理通道，就可能形成循環相依。用戶端預設設定通常會處理相關引導需求，自訂時不要任意刪除。若連線記錄出現解析逾時，請先辨認出錯網域屬於伺服器還是目標網站，再決定檢查基礎網路、核心 DNS 或應用程式自身的解析設定。

修改規則後，請關閉原有連線或重新啟動測試應用程式，避免連線重用掩蓋變更。瀏覽器快取與既有長連線可能繼續使用舊結果，立即重新整理不一定會建立全新連線。驗證時選擇明確的目標，記錄命中的出口與錯誤階段，並保留直接連線的對照測試。路由成功只代表選擇了預期路徑；遠端服務仍可能拒絕要求。將這兩項結果分開判斷，才能避免持續修改已正確的規則。

設定常見問題：分層排查故障

先判斷故障影響範圍

遇到連線異常時，先說清楚「哪裡出問題」：用戶端無法啟動、核心啟動後退出、訂閱無法更新、瀏覽器無法存取，還是只有某個應用程式失敗。接著記下問題是在安裝、升級、切換網路後，還是變更某項設定後發生。影響範圍越明確，下一步就越容易判斷。不要把所有現象都歸因於節點無法使用，也不要先清除所有設定，以免失去最有價值的變更線索。

依序檢查本機網路、用戶端核心、本機入口、遠端連線與目標要求。直接連線失敗時先處理基礎網路；核心退出時先查看第一個錯誤；連接埠未監聽時先處理啟動問題與衝突；只有某個應用程式失敗時，則檢查其代理入口與分應用程式清單。若所有目標都失敗，再檢查共同的 DNS、驗證或遠端可達性問題。每次只驗證一個層級，避免同時切換多個伺服器與多組路由，造成結果難以判讀。

用戶端連線測試成功，但瀏覽器失敗，並不矛盾。測試工具可能直接呼叫目前伺服器；瀏覽器則可能沒有使用系統代理，也可能命中直接連線規則。反過來說，某項延遲測試失敗，也不能單獨證明實際服務要求一定會失敗。請以相同目標及明確入口重新測試；必要時使用本頁的明確指定代理命令，區分連線入口問題。判斷依據應是要求實際經過的路徑，而非單一狀態圖示。

判讀錯誤階段，保留必要記錄

「連線遭拒」通常表示要求到達的位址與連接埠未接受連線；可能是本機入口未啟動，也可能是遠端連接埠不符，必須依記錄中的目標判斷。「逾時」只表示某個階段未能在指定時間內完成，可能發生於解析、建立連線或交握過程，不能直接等同於伺服器離線。查看錯誤前後的相關記錄，確認失敗發生在本機還是遠端，再調整對應設定。

交握失敗時，請檢查系統時間、伺服器名稱、傳輸參數及服務端要求是否一致。不要為了處理憑證錯誤而任意關閉憑證驗證，作為長期解法；這會改變連線的安全性。驗證失敗時，優先重新匯入有效設定，避免手動修改識別資訊而造成更多問題。設定解析錯誤則應先確認欄位與核心相容性。詳細的閱讀方式可參閱執行記錄常見錯誤說明。

需要暫時提高記錄層級時，只在重現問題所需的短時間內啟用，完成後恢復日常設定。長期保留詳細記錄會增加儲存空間與效能負擔，也可能暴露存取目標。公開求助前，請移除訂閱網址、驗證資訊、個人路徑與裝置識別資料；保留錯誤類型、發生階段及相關選項即可。不要上傳整份產生的設定，也不要為了證明問題存在而公開完整分享連結。

依問題返回對應設定

恢復正常後，記下真正生效的修改，並撤銷暫時測試的設定。若問題只是連接埠衝突，保留新連接埠及應用程式的對應設定即可；若只是切換網路造成連線失效，就不必保留測試過的 DNS 與路由。若需要重新建立最精簡設定，請依照教學中的代理模式步驟回到單一入口，再逐項恢復必要功能，讓最終設定清楚、可重現且可還原。