INSTALLATION / SYSTEM REFERENCE

V2Ray 全平台
安裝設定指南

涵蓋 v2rayN 桌面版部署、Android 客戶端設定,以及訂閱、系統代理與 TUN 的檢查範圍。

本頁依平台與故障層級編排,適合作為系統查閱手冊。初次設定可先完成快速入門教學,再回到相關章節處理權限、路由與遷移問題。安裝檔請統一前往客戶端下載頁選擇;本頁內容不能取代客戶端內的實際設定說明。

v2rayN v2rayNG v2flyNG 訂閱 / 路由 / TUN

01 / BEFORE INSTALLATION

一般準備:系統、訂閱與流量入口

先釐清客戶端、核心與伺服器設定

圖形介面客戶端負責儲存伺服器參數、管理訂閱、產生設定並啟動核心。核心則負責協定連線、流量轉送與路由判斷。桌面平台建議使用 v2rayN;Android 優先選用搭載 Xray 核心的 v2rayNG,已有 V2Fly 設定需求時再考慮 v2flyNG。安裝客戶端不會自動提供可用伺服器,也不能取代訂閱提供者的帳戶與服務。開始前請準備有權使用的訂閱連結或單一伺服器分享連結,並確認仍在有效期限內。

Project V 有助於理解這些元件的背景,但不是需要另外安裝的桌面應用程式。V2Fly 與 Xray 屬於相關核心生態系,支援範圍會隨核心實作而異。設定能否使用,取決於協定、傳輸、安全參數與實際核心能力的組合,不能只看客戶端名稱判斷。如需了解彼此關係,可閱讀Project V、V2Fly 與 Xray 生態系關係,再決定是否需要更換核心。

確認系統架構與安裝位置

處理器架構應以作業系統顯示的資訊為準,不要只看裝置年份。Windows 可在系統資訊查看系統類型;macOS 可在「關於這台 Mac」查看晶片;Linux 則可執行下方指令。下載頁會依實際提供的安裝檔列出下載入口,架構不符時,別指望反覆啟動就能解決。也請預先決定安裝位置:可攜式目錄需要具備寫入權限;由安裝程式管理的應用程式目錄,通常不適合手動放入設定檔。

uname -m
cat /etc/os-release

Linux 輸出的 x86_64 對應常見的 x64 套件,aarch64 則對應 arm64 套件。發行版資訊可用來判斷選擇 deb 或 rpm,不能據此推論桌面代理一定會如何生效。作業系統、桌面環境與應用程式各自有網路設定,需分別確認。新部署時先保留預設目錄結構,避免單獨移走主程式後,遺漏套件隨附的資源與執行元件。

檢查項目準備內容目的
系統環境架構、發行版、可寫入目錄選擇套件類型與設定位置
連線資料訂閱網址、協定與傳輸參數區分帳戶問題與本機問題
網路基準狀態正常直連、正確時間、現有代理保留可供比較的初始狀態

建立可還原的網路基準狀態

安裝前先關閉其他正在接管流量的代理或隧道程式,並記下系統代理原本的狀態。確認一般網路連線正常,系統時間與時區也設定正確。時間偏差可能導致憑證驗證失敗;舊代理設定殘留,則可能讓訂閱更新請求送往已關閉的本機連接埠。這時看似是客戶端故障,實際問題可能發生在客戶端啟動之前。沒有建立基準狀態前,不要同時修改網路介面卡、解析器與路由預設值。

初次驗證建議先使用系統代理,不要直接啟用 TUN。系統代理仰賴應用程式遵循作業系統的代理設定,適合先測試瀏覽器連線;TUN 則透過虛擬網路介面接管更多流量,需要額外權限,也可能影響 DNS、區域網路與其他虛擬網路。兩者不是兩種伺服器協定,也不代表開啟的功能越多,連線就越穩定。基礎連線可用後,再依應用程式是否遵循代理設定,決定是否啟用 TUN。

備份與隱私界線

如果裝置已有設定,請先使用客戶端提供的匯出或備份功能儲存。手動複製資料目錄前,應先退出程式,避免檔案在寫入時遭到截斷;備份內容應包含訂閱群組、路由、自訂 DNS 與必要的本機設定。訂閱網址通常含有帳戶識別資訊,分享連結也可能包含驗證欄位,請勿貼到公開截圖、討論串或公開雲端硬碟。排查時優先提供遮蔽敏感資訊後的錯誤類型與發生時間。

02 / WINDOWS

Windows:安裝 v2rayN 與代理接管

選擇桌面版或經典 WPF 版

前往Windows 下載區,先確認作業系統架構,再選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用新一代跨平台介面,WPF 版則延續經典 Windows 介面。兩者都是管理設定的入口,不代表伺服器連線品質不同。需要遷移既有設定時,請先備份,再確認目標介面能否辨識原有資料;不要讓兩個版本同時寫入同一個設定目錄。

安裝程式套件請依照精靈完成部署;可攜式套件則應完整解壓縮後再啟動。不要直接從壓縮檔預覽視窗執行,也不要只複製主程式檔案。解壓縮目錄宜放在固定且可寫入的位置,避免清除暫存目錄時遺失設定。啟動時若提示缺少執行元件,請依目前套件說明與系統提示安裝所需元件,不要從不明來源下載單一動態連結檔來替換。請保留錯誤訊息,以便判斷缺少的是執行環境還是程式資源。

啟動後匯入訂閱並確認清單

首次開啟時,先確認主畫面能正常顯示,再進入訂閱群組管理。新增群組、填入方便辨識的名稱,將完整訂閱網址貼到網址欄位,儲存後再更新訂閱。新增網址與更新內容是兩個步驟:只新增群組並不能證明已取得伺服器。更新完成後查看伺服器清單,確認協定、位址與連接埠等基本欄位都有資料。選單名稱可能會調整,請以目前介面中的訂閱管理入口為準。

如果剪貼簿裡的是單一伺服器分享連結,請使用客戶端的剪貼簿匯入功能,不要把它當成遠端訂閱網址。網頁連結也不一定是訂閱連結;帳戶控制台頁面、登入頁與回傳伺服器設定的介面用途各不相同。更新後清單空白時,先查看更新記錄中的請求結果,再向訂閱提供者確認連結格式與帳戶狀態。不要為了顯示清單而關閉憑證驗證,也不要任意刪除驗證參數。

先驗證系統代理,再擴大接管範圍

選取準備使用的伺服器並設為目前項目,確認核心能啟動後,再選擇自動設定系統代理。此操作會讓遵循 Windows 系統代理設定的應用程式使用本機監聽位址;本機連接埠請以客戶端設定為準,不要照抄其他裝置的連接埠。使用瀏覽器開啟已知可正常使用 HTTPS 的頁面,並觀察是否出現對應的連線記錄。頁面無法開啟時,先確認核心正在執行,再檢查伺服器連線,不要立刻切換所有路由選項。

Windows 系統代理不代表每個程式都會跟著使用。部分命令列工具、服務程序或具有獨立代理設定的應用程式需要另外設定。系統中的不同網路元件也可能採用不同的代理來源,因此瀏覽器正常、某個程式失敗,並不足以判定節點故障。先確認該程式是否支援 HTTP 或 SOCKS 代理,再填入客戶端實際啟用的本機監聽位址。僅供本機使用時,應維持回環介面監聽,避免意外開放給同一區域網路的其他裝置。

TUN 權限與退出順序

基礎連線可用後,若目標應用程式不遵循系統代理,再考慮使用 TUN 模式。首次啟用可能需要管理員權限、服務元件或虛擬介面,實際需求取決於目前的客戶端實作。依程式提示授權後,檢查啟動記錄是否顯示介面與路由已成功建立。不要只看開關已開啟就認定接管完成;權限遭拒、介面建立失敗或其他隧道衝突,都可能造成開關狀態與實際網路路徑不一致。

若環境中有虛擬機器、辦公網路或其他隧道工具,請先保留區域網路存取並逐項測試。啟用 TUN 後只能存取部分資源時,優先檢查路由與 DNS,不要反覆重裝虛擬網路介面卡。結束使用前先關閉 TUN,再清除系統代理,最後退出客戶端。若程式異常結束後瀏覽器完全無法連線,可到 Windows 代理設定檢查是否仍指向已關閉的本機連接埠,確認後還原原有設定。

開機啟動與連線成功是兩回事。建議先確認手動啟動穩定,再啟用客戶端提供的自動啟動選項。需要提高權限的 TUN,啟動方式可能與一般登入啟動不同;設定後應實際登出或重新開機測試。主視窗、系統匣、記錄與參數設定的對應關係,可參閱v2rayN 主介面功能詳解,避免誤以為關閉視窗就已完全結束程序。

03 / MACOS

macOS:晶片選擇、安裝與網路權限

依晶片選擇下載檔並完成安裝

開啟系統的「關於這台 Mac」,確認使用的是 Apple Silicon 晶片還是 Intel 處理器,再前往macOS 下載區選擇對應的 v2rayN 安裝檔。arm64 與 x64 代表處理器架構,不是介面語言或功能等級。不要只因為應用程式能透過相容層啟動,就認定套件選對了;符合原生架構可減少執行元件與權限排查時的變數,尤其是之後準備啟用 TUN 時。

下載完成後開啟磁碟映像,依套件提供的方式將應用程式放到固定的應用程式目錄,再從該位置啟動。不要長期從已掛載的映像執行,也不要在應用程式仍在執行時搬移整個程式目錄。系統首次開啟時可能會檢查來源與執行權限;請先確認安裝檔來自本次選擇的下載入口,閱讀系統顯示的具體提示,再依系統允許的方式決定是否繼續。不要把關閉整體安全檢查當成安裝步驟。

應用程式無法啟動時,應區分架構錯誤、系統未達需求、缺少執行元件,以及系統阻止開啟等情況。前兩者無法靠反覆授權解決;後兩者也不能隨意更改應用程式名稱處理。先記下彈出視窗的文字與系統資訊,再核對套件說明。終端機中的移除擴充屬性指令不應當成通用修復方式,因為這會略過問題來源的判斷,也可能套用到錯誤目錄。

匯入訂閱並檢查目前服務

啟動 v2rayN 後進入訂閱群組管理,新增群組、儲存完整網址,再執行更新。首次更新建議使用目前可正常連線的一般網路;若訂閱介面只能透過既有代理連線,請先確認舊連線可用,再選擇相應的更新方式,避免陷入「先取得訂閱才能連線、先連線才能取得訂閱」的循環。更新完成後選擇一台伺服器設為目前項目,先確認核心能正常啟動,再調整系統代理。

macOS 的網路設定依網路服務個別管理。無線網路、有線網路與其他網路介面可能分別儲存代理參數;切換網路後,請重新確認目前服務的代理狀態。客戶端的自動設定功能必須套用到正在使用的服務;如果瀏覽器仍直接連線,先到系統網路詳細資料中的代理設定確認,不要立刻修改伺服器參數。手動設定時,請填入本機回環位址與客戶端顯示的連接埠,而不是遠端伺服器的連接埠。

區分系統代理與應用程式的獨立設定

遵循系統代理設定的應用程式通常能使用自動設定的入口,但有獨立網路設定的工具可能會忽略它。終端機工具也不一定會讀取桌面網路服務中的代理欄位。設定單一工具時,先確認它支援的代理方式與設定範圍,避免把測試用的臨時參數寫入所有登入工作階段。若工具支援 SOCKS,還需分辨網域名稱是在本機還是代理端解析;同一伺服器出現不同結果,有時是解析路徑不同,不一定是傳輸失敗。

瀏覽器正常、開發工具異常時,先清除該工具先前儲存的代理位址,再與客戶端目前的監聽設定比對。代理連接埠變更後,獨立設定不會自動同步。若要存取本機服務,應保留回環與區域網路直連策略,避免將本機開發流量送往遠端出口。也不要為了方便而開啟不必要的區域網路分享;本機代理與提供代理給其他裝置,是兩種不同的部署需求。

TUN 與其他網路延伸功能的共存

需要接管更多應用程式時,再啟用客戶端實際提供的 TUN 功能。系統可能要求管理員授權或相關輔助元件,權限需求取決於客戶端實作。授權後查看記錄與系統網路狀態,確認虛擬介面確實已建立。若已有辦公隧道、網路過濾或虛擬機器網路,請一次只啟用一種接管方式進行驗證,再測試共存;多個元件同時變更預設路由,可能造成連線繞回自身或無法連線到區域網路。

從睡眠狀態恢復、切換無線網路或連接有線網路後,若只有 TUN 模式失效,可先停用再重新啟用,並檢查 DNS 是否隨目前網路恢復。不要在隧道仍運作時連續更換多個 DNS 伺服器。若系統代理模式仍可使用,可暫時切回該模式,保留可用連線後再檢查 TUN。退出應用程式前,請清除其設定的代理,尤其要留意異常結束後系統中殘留的回環位址。

04 / LINUX

Linux:deb、rpm 與桌面代理環境

先選擇套件格式,再處理安裝依賴

Linux 桌面版可使用 v2rayN。先查看發行版與架構,再前往Linux 下載區選擇 deb 或 rpm。Debian、Ubuntu 系統通常選擇 deb;Fedora、openSUSE 等採用 rpm 套件格式,但相依套件的處理方式仍由發行版決定。x64 與 arm64 應分別選擇對應架構,套件格式正確不代表架構也正確。下載完成後,可使用發行版的圖形化軟體安裝程式,或執行本機套件安裝指令。

以下兩個指令分別適用於對應的套件管理環境,請只執行符合系統的一個。在儲存安裝檔的目錄開啟終端機,並將檔案路徑替換成實際下載的完整檔名。使用套件管理員安裝本機檔案,有助於一併處理相依套件;安裝失敗時應查看相依套件名稱、架構與套件庫錯誤,不要強制略過依賴,讓程式在不可預期的狀態下執行。openSUSE 請使用對應的軟體管理工具,不要直接照抄 Fedora 指令。

sudo apt install ./實際下載的檔案名稱.deb

sudo dnf install ./實際下載的檔案名稱.rpm

安裝完成後,從桌面應用程式選單啟動。圖形介面程式應以一般使用者身分執行,設定也會儲存在該使用者的環境中。不要為了啟動已安裝的程式而長期以超級使用者身分執行整個介面,否則可能產生屬於超級使用者的設定檔,之後一般使用者啟動時便無法寫入。只有確實需要虛擬網路介面或輔助服務時,才依客戶端提示提供所需權限;不要把所有系統代理問題都歸咎於權限不足。

匯入訂閱與桌面環境差異

進入訂閱群組新增網址,儲存並更新,再選擇目前要使用的伺服器。先確認核心能啟動,記錄中沒有缺少檔案或監聽失敗,再設定代理。GNOME、KDE 與其他桌面環境的代理設定介面各不相同,應用程式是否會讀取桌面代理也各有差異。客戶端顯示已設定系統代理,只能代表相關操作已執行,不能據此推論所有程序都已透過代理連線。請分別測試瀏覽器與實際需要使用的工具。

瀏覽器可用、終端機不可用時,先檢查終端機程序的環境變數。以下指令只會查看常見代理變數,不會修改網路。不同工具對變數名稱大小寫的支援可能不同,舊工作階段也可能仍保留已停用的連接埠。若要暫時替單一指令設定代理,優先使用該工具支援的單次參數;確認效果後再決定是否永久保存,不要直接寫入所有使用者共用的環境設定檔。

env | grep -iE '^(http|https|all|no)_proxy='

桌面代理、環境變數與應用程式內部代理是三條獨立路徑。它們可以指向同一個本機監聽位址,但不會自動互相同步。使用 NO_PROXY 的工具也可能略過某些目的地,而且各工具的比對語法不盡相同。遇到「特定網域總是直接連線」時,除了檢查客戶端路由,也應查看工具本身的略過清單,避免在錯誤的層級反覆調整 GeoSite 規則。

TUN、解析服務與容器網路

TUN 需要存取虛擬網路介面,並具備建立路由等必要權限。啟用失敗時,先查看客戶端記錄中的權限或裝置錯誤,再依目前套件提供的方式設定輔助元件。不要遞迴開放整個安裝目錄的寫入權限,也不要任意為未知的執行檔授予系統能力。發行版的安全政策、服務啟動方式與安裝檔配置都會影響結果,應針對錯誤訊息處理,不要從其他系統複製一整組提權指令。

Linux 的 DNS 可能由網路管理員、本機解析服務或其他元件管理。啟用 TUN 後若只有網域連線失敗,而已知位址仍可連通,應檢查解析路徑與客戶端 DNS 設定。不要反覆覆寫暫時產生的解析檔案,因為網路重新連線時可能會重新產生。容器、虛擬機器與網路橋接器通常也有自己的路由與解析設定;請保留對應網段的存取,再評估是否需要納入 TUN。

登入時自動啟動與升級還原

桌面客戶端通常應在使用者登入並進入圖形工作階段後啟動。優先使用程式提供的自動啟動選項,再檢查桌面啟動應用程式清單是否有重複項目。不要同時啟用桌面自動啟動、使用者服務與系統服務來啟動同一份設定,否則容易造成連接埠被占用。自動啟動後也要確認系統代理已套用到目前工作階段,不能只看到程序存在就認定接管完成。

升級前先退出客戶端並備份資料,優先沿用相同的安裝來源與套件格式。升級後若介面正常但連線失敗,先檢查核心路徑、設定相容性與規則資源,不要立刻刪除使用者目錄。需要還原時請保留本次記錄,並回到備份比對差異。安裝程式、桌面啟動項目與登入自動啟動的詳細步驟,可參閱v2rayN Linux 部署與自動啟動說明。

05 / ANDROID

Android:安裝客戶端與 VPN 授權

選擇 v2rayNG 或 v2flyNG

前往Android 下載區,優先選擇搭載 Xray 核心的 v2rayNG。v2flyNG 是採用 V2Fly 核心的替代選項,適合已確認設定與該核心相容的情況。不要將反覆安裝多個客戶端當成同一設定的預設排錯方式;請先確認目前核心支援所用的協定、傳輸與安全參數。兩款應用的資料各自獨立,安裝另一款不代表訂閱、路由與授權會自動遷移。

較新的主流裝置通常採用 arm64;不確定裝置架構時,可考慮下載頁提供的通用套件。仍應以裝置系統資訊與套件說明為準。系統安裝程式提示不相容時,先檢查架構、系統需求與下載是否完成;若提示與現有應用程式衝突,則確認套件來源與簽章是否一致。不要先解除安裝再排查,因為解除安裝通常會移除應用程式的私人資料,原有訂閱與自訂設定可能無法還原。

安裝外部下載的應用程式時,Android 會依發起安裝的來源管理授權。只授予目前使用的檔案管理員或瀏覽器必要權限,安裝完成後可視需要撤銷。若裝置由組織管理,安裝或 VPN 權限可能受到政策限制,請遵守裝置管理規定。不要用不明工具繞過系統限制;先確認問題屬於安裝權限、應用程式相容性還是裝置政策,再決定後續處理方式。

新增訂閱、更新並選擇設定

在應用程式中開啟訂閱設定或訂閱群組入口,新增名稱與完整 URL,儲存後回到主畫面更新。遠端訂閱與剪貼簿中的單一設定,應使用各自的匯入入口。更新完成後確認清單是否出現設定,並選取準備連線的項目。若服務提供者同時提供不同協定的項目,請依其說明選擇,不要根據排列順序推測效能,也不要把位址與驗證欄位拼接到其他不相關的設定中。

掃描 QR Code 適合匯入單一分享設定,但 QR Code 內容仍可能包含驗證資訊。使用系統截圖或跨裝置傳送圖片時,請留意圖片儲存位置與分享範圍。訂閱更新失敗後,可先查看應用程式記錄,分辨請求失敗、回應內容為空或解析失敗。瀏覽器能開啟帳戶網站,不代表訂閱介面也能使用;介面可能需要完整路徑與查詢參數,複製時少了一段就可能得到完全不同的回應內容。

了解系統 VPN 授權與應用程式範圍

首次連線時,Android 通常會透過系統 VPN 介面接管本機流量,需確認系統跳出的連線授權。這只是本機流量進入客戶端的入口,不代表應用程式已成功連上遠端伺服器。完成授權後仍需查看記錄與實際連線結果。系統狀態列出現 VPN 圖示,只能表示本機介面正在運作,不能單獨證明所選伺服器可連線,或 DNS 已依預期解析。

Android 通常只允許一個應用程式使用目前使用者的活動 VPN 通道。若已有其他隧道程式、網路過濾應用程式或工作資料中的網路元件,請先確認是否衝突,再測試連線。應用程式分流清單也會改變接管範圍:允許清單與略過清單的意思不同,儲存後可能需要重新連線才會生效。某個應用程式仍直接連線時,先確認它是否在接管範圍內,不要立刻修改伺服器或重新匯入訂閱。

背景執行、網路切換與 DNS

若連線只在鎖定螢幕後中斷,通常需要檢查背景執行與電池管理策略。依系統設定允許必要的背景活動,再測試螢幕關閉與恢復後的連線;不同裝置的選單名稱可能不同,不要直接照搬其他廠牌的螢幕截圖。維持連線不代表必須關閉裝置所有省電功能,只需調整與客戶端相關的限制。若設定了永遠開啟 VPN,也請了解它與「未連線時封鎖網路」選項的關係,避免誤以為一般網路也故障。

無線網路與行動網路切換後,底層位址、解析器與可達路徑都可能改變。先等候應用程式重新建立連線,再查看記錄中是否有明確錯誤。若只有特定網路連線失敗,應比較該網路的登入狀態、DNS 與伺服器連通性,不要刪除所有設定。系統私人 DNS、客戶端 DNS 與應用程式本身的加密解析也可能同時作用;請一次只變更一個解析來源,並記下哪次修改影響了結果。

遷移到新裝置後,請重新確認系統 VPN 授權、背景執行策略與應用程式範圍;這些系統設定不一定會隨設定檔一併遷移。完成遷移後先使用預設路由驗證,再還原自訂分流與 DNS。匯入入口與更新操作的常見差異,可搭配快速入門教學逐步確認;其他安裝與使用問題請參閱說明中心。

06 / CONFIGURATION LAYERS

訂閱與分流:儲存、比對與解析

更新訂閱不會同步所有設定

訂閱通常用來提供伺服器設定,不等於同步本機的所有偏好。系統代理、本機連接埠、TUN 權限與應用程式分流,通常仍由裝置本機管理。更新時,客戶端可能會取代或重建訂閱項目,因此不要把長期手動修改只存在可能被覆寫的項目中。若確實需要固定修改,可使用客戶端支援的獨立設定或分組方式,同時記錄修改原因,以免下次更新後無法分辨哪些欄位來自訂閱、哪些是手動調整。

更新訂閱與連線伺服器所使用的網路路徑也可能不同。目前代理無法使用時,選擇透過代理更新可能失敗;若訂閱介面在直接連線時無法存取,選擇直連更新也會失敗。請依實際可用的路徑選擇更新方式,不要反覆切換直到偶然成功。更新前後核對群組、項目與目前選取的項目,確認伺服器是否有變更後再決定是否重新測試。訂閱保留舊名稱,不代表底層位址沒有改變。

先確認流量是否進入核心

路由規則只會處理已進入核心的流量。應用程式忽略系統代理時,無論新增多少網域規則,都無法讓該應用程式自動改走代理。反過來說,流量經 TUN 進入核心後,仍可依規則選擇直連,因此接管範圍與遠端出口選擇是兩個層次。排查時先確認入口,再確認路由命中情況,最後檢查出口連線。混淆這三個層次,容易誤判成瀏覽器正常、其他應用程式卻一直失敗。

以下路由規則片段用來說明私有位址與中國大陸網域分類的比對方式,不能直接取代客戶端完整設定檔。使用前請確認所選核心支援這些欄位、規則資源存在,且出站標籤已在實際設定中定義。客戶端可能使用不同的標籤名稱,範例中的名稱無法脫離目前設定單獨運作。建議優先透過客戶端的路由編輯介面管理;手動編輯前請先備份。

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

規則順序、資源檔案與預設出口

常見的路由實作會依規則順序逐項檢查,前面符合的規則會影響後續規則是否生效。特定網域例外應放在較廣泛的分類之前,再確認客戶端預設值是否另外產生了其他規則。以上片段沒有指定未符合規則的流量要送往何處,預設出口仍須根據完整設定判斷。看到兩條直連規則,不代表其餘流量一定會走代理;也不要把介面中的「全域」理解成略過本機所有應用程式設定。

geosite:cn 依賴網域分類資料,geoip:private 則依賴相應的位址分類支援。網域規則需要可供比對的網域資訊,IP 規則則依目的位址判斷,兩者不能直接互換。規則庫缺漏或標籤不存在時,核心可能無法啟動;規則庫內容更新也可能改變分流結果。更新客戶端後,請一併留意資源載入記錄;詳細說明請參閱GeoIP 與 GeoSite 規則庫更新方法。

設定層級主要作用常見誤判
系統代理 / TUN決定哪些流量進入客戶端誤把應用程式未被接管當成路由錯誤
路由規則選擇直連、代理或封鎖出口忽略規則順序與預設出口
DNS 策略決定解析來源與網域處理方式以為只修改路由就會同步影響解析

DNS 與核心切換的界線

DNS 分流與連線分流需要搭配,但不是同一個設定項目。網域走直連出口,不代表查詢一定使用本機解析器;遠端 DNS 位址本身也需要可用的連線路徑。導入 FakeDNS 後,還需考慮虛擬位址對應與接管範圍,不能只從其他設定複製一個開關。請先在一般解析模式下驗證連線,再逐步加入分流設定。如需設定細節,可閱讀V2Ray DNS 分流設定說明,並對照目前核心的欄位。

切換 Xray 與 V2Fly 時,請重新確認協定、傳輸、安全參數與客戶端產生的設定。客戶端提供選項,不代表任意組合都相容。切換前請保留原設定與記錄;切換後先確認核心成功啟動,再測試先前可存取的目標。不要在切換核心的同時更換 DNS、路由與伺服器,否則即使結果改變,也無法判斷是哪項調整造成影響。

07 / DIAGNOSTICS

常見設定問題:由啟動到連線逐層排查

先記錄狀況,再選擇檢查層級

故障描述應包含平台、客戶端、接管模式、操作步驟與錯誤類型。把「連不上」拆解成應用程式無法開啟、核心無法啟動、訂閱更新失敗、瀏覽器無法連線,或只有特定應用程式失敗,才能選擇有效的排查路徑。先保留一份目前的設定,不要馬上清除資料。請查看故障發生時間附近的記錄;啟動時的舊錯誤可能與稍後的連線失敗無關,不要只搜尋醒目的錯誤字詞就下結論。

建議固定依序檢查本機網路、客戶端程序、核心啟動、本機監聽、伺服器連線、網域解析與應用程式接管。每一層只驗證一個問題,並保留結果。可用已知正常的普通網頁比較前後狀態,但不要以單一網站能否開啟作為所有連線的結論;網站本身故障、帳戶限制或應用程式快取也會影響結果。排查目標是縮小問題範圍,而不是不斷更換設定直到暫時成功。

客戶端能開啟,為什麼核心沒有正常運作?

介面與核心是不同的程序或元件。先查看啟動記錄,確認是否缺少資源、設定欄位不相容,或本機連接埠已被占用。遇到連接埠占用時,先退出重複啟動的客戶端與舊程序,再重新嘗試;若確實需要更換連接埠,也要同步更新應用程式中的獨立代理位址。不要只修改一個連接埠,就認定所有呼叫端都會自動跟著更新。

若錯誤指向設定解析,請回頭檢查最近變更的路由、DNS 或核心選項,還原預設值後逐項驗證。若錯誤涉及權限或檔案存取,請確認目前使用者能讀取程式資源,並能寫入自己的資料目錄。不要用擴大整個目錄權限來取代具體排查,也不要直接刪除記錄中提及的檔案。

訂閱更新成功,為什麼選取的設定仍無法連線?

更新成功只代表客戶端已取得並解析訂閱內容,不代表每台伺服器都能連線。確認目前選取的項目是否來自剛更新的群組、帳戶是否有效,以及伺服器位址與連接埠是否存在,再查看連線記錄中的拒絕、逾時或驗證錯誤。遇到逾時應比較目前網路與其他設定;驗證錯誤則核對訂閱提供者給的參數,不要用同一種方法處理這兩類問題。

傳輸與安全參數必須成組一致,例如主機名稱、路徑與憑證相關欄位各有用途。不要任意互換連線位址與安全交握使用的名稱,也不要為了消除錯誤而關閉必要的驗證。系統時間明顯不準也可能導致交握失敗;先校正時間再測試,可排除常見的本機因素。

瀏覽器正常,為什麼其他應用程式不走代理?

先確認目標應用程式是否遵循系統代理、是否儲存了自己的代理設定,以及是否被應用程式分流排除。桌面版終端機還需檢查環境變數;Android 則要確認接管清單與系統 VPN 狀態。客戶端沒有該應用程式的連線記錄時,通常應先檢查流量入口,而不是修改出口規則。部分應用程式會保留長時間連線,變更設定後可能需要重新啟動,才能建立新的連線路徑。

確實需要使用 TUN 時,先確認系統代理模式下的基礎連線可用,再啟用 TUN 並檢查介面權限。只有 TUN 模式失敗時,重點檢查 DNS、預設路由與其他虛擬網路;系統代理與 TUN 都失敗時,則回頭檢查伺服器與核心。這種交叉比對能減少無效修改,也能保留暫時可用的方案。

啟用 TUN 後無法連線到區域網路裝置或本機服務,該怎麼辦?

先關閉 TUN 比較連線結果,確認問題是否由流量接管造成。若關閉後恢復,請檢查私有位址路由、區域網路略過項目、虛擬機器網段與 DNS。存取印表機、檔案服務或開發環境時,也要分辨使用的是位址還是本機網域名稱;位址可連線但名稱無法解析,多半應繼續檢查解析路徑,而不是只新增更多位址直連規則。

辦公隧道與其他虛擬網路可能會管理自己的路由,不應直接刪除。先記錄原本狀態,使用範圍最小的略過設定進行驗證,確認沒有影響其他目的地後再保留。有些網路需要專用解析器,強制改用統一的公共解析服務可能導致內部名稱無法解析。請依目前網路的管理規定處理,不要把所有網域都交給同一個解析入口。

升級後發生異常,如何還原而不遺失設定?

先退出程式並儲存目前記錄,再將升級前的備份還原到獨立位置進行驗證。程式檔案、使用者資料與系統代理狀態應分別處理;不要把舊程式直接混入新目錄,也不要同時執行兩個實例。還原前先確認資料格式是否已變更;若舊程式無法讀取新資料,應使用相應版本的備份,不要反覆嘗試讓舊程式寫入同一個目錄。

還原後先使用預設路由與系統代理進行驗證,再逐步恢復自訂項目。檢查完成後,移除不再使用的自動啟動項目,避免下次登入時舊程序再次占用連接埠。如需進一步查閱,請前往說明中心,依安裝設定、使用技巧或故障排查分類尋找問題;提交資訊時只保留必要記錄,並遮蔽訂閱網址、驗證欄位與帳戶資訊。

NEXT / SELECT A PACKAGE

確認安裝步驟後,返回客戶端下載頁選擇對應平台與架構。只需完成首次連線時,請依序參閱快速入門教學。

返回準備工作 ↑
下載客戶端