全平台指南

V2Ray 全平台安裝與設定指南

第一次設定只想先連上線,請先看使用指南,依序完成匯入、選擇模式、連線與驗證。本頁是遇到平台差異或故障時查閱的手冊:先看準備工作,再跳至目前使用的裝置章節;若已匯入訂閱卻無法使用,可直接查看路由分流或常見設定問題。

準備工作:用戶端、訂閱與基本驗證

先依裝置選用戶端,再挑安裝包

桌面裝置建議使用 v2rayN,Android 裝置建議使用採用 Xray 核心的 v2rayNG;確認設定依賴 V2Fly 核心時,再考慮備選的 v2flyNG。用戶端提供匯入、切換與記錄檢視介面,核心則負責建立連線及處理路由,兩者並不相同。在清單中看到節點,只代表用戶端讀取了該項目;能否啟動、能否辨識特定安全設定,仍取決於目前使用的核心。選擇安裝包時,請先確認裝置回報的架構,不要只憑裝置型號、處理器品牌或另一台電腦的安裝經驗推測。

四個平台的用戶端與安裝包選擇依據
平台用戶端安裝包選擇依據
Windowsv2rayNx64;優先選桌面版,其次為經典 WPF 版
macOSv2rayNApple Silicon 選 arm64,Intel 選 x64
Linuxv2rayN先選 deb 或 rpm,再選 x64 或 arm64
Androidv2rayNG、v2flyNG依系統支援情況選 arm64 或通用版

先分清訂閱網址與單一分享連結

訂閱網址用於定期取得一組設定,應填入訂閱分組;以 vmess://、vless:// 等開頭的單一分享連結,則應使用剪貼簿匯入或掃描 QR Code。成功儲存訂閱網址不代表用戶端已取得項目,新增後還要更新對應分組。反之,直接匯入的單一設定也不會因另一個分組更新而自動變更。若只能查看截圖,先確認畫面中的是一個 QR Code,還是一段選單說明;不要自行補上看不完整的網址。兩種連結的用途請參閱分享連結與訂閱網址的差異。

訂閱網址可能包含存取憑證,知道網址的人往往就能讀取該分組內容。貼上前請檢查網址開頭與結尾是否多了引號、空格或通訊軟體附加的標點;不要任意刪改網址參數,也不要貼到線上解碼工具。若需要他人協助判斷,提供用戶端名稱、所在選單與錯誤類型即可;記錄截圖請遮住完整網址、帳戶識別資訊、節點名稱與伺服器資訊。訂閱備註建議依用途區分,更新前確認備註,避免多個分組並存時更新錯誤。

記下原始設定,先做一次不經用戶端的測試

開始前記錄目前的系統代理狀態、是否有其他網路工具正在執行,以及需要存取哪些本機網站。若裝置使用公司或學校提供的代理或自動設定指令碼,請保留原設定,不要用用戶端覆蓋受管理的網路政策。先用平常能開啟的頁面測試直接連線,再選一個可重複開啟的頁面作為連線測試範例。瀏覽器顯示舊頁面不一定代表網路正常,建議開啟未快取的網址,並等候頁面實際載入完成。

第一次測試請盡量減少變因:只啟用一個用戶端、一個訂閱分組和一個已確認支援的節點。桌面版先用單一應用程式或系統代理驗證,暫時不要啟用 TUN;Android 先確認預設 VPN 連線可用,暫不調整個別應用程式分流。記下測試使用的網路與應用程式,例如家用 Wi-Fi 加瀏覽器。不同網路與應用程式的結果不能直接比較;切換網路後,應先重新測試直接連線,再判斷訂閱或路由是否有問題。

更換裝置前,優先使用用戶端提供的匯出或備份功能,並將備份存放在自己掌控的位置;若沒有匯出功能,只在本機保留訂閱來源與必要的自訂規則即可。舊裝置的本機連接埠、權限與網路介面設定不宜整套搬到新裝置。尤其是正在使用的本機連接埠,可能已被新裝置上的其他程式占用。先以新裝置的預設值確認能正常連線,再逐項加回用途明確的個人化設定。

Windows:v2rayN 安裝、系統代理與 TUN

選擇桌面版或經典 WPF 版

先到「設定 → 系統 → 關於」查看「系統類型」,確認系統與處理器類型,再前往 Windows 下載頁面選擇安裝包。第一次安裝可先使用桌面版,它採用跨平台介面;習慣經典選單配置的使用者則可選擇 WPF 版。兩種介面的功能入口位置可能不同,閱讀舊版教學時,請優先比對選單名稱,不要只照著截圖找圖示。不要為了比較效果而同時開啟兩個版本,它們可能搶用同一個本機監聽連接埠,也可能先後改寫同一份系統代理設定。

執行安裝程式後依畫面指示完成安裝,再從開始選單開啟用戶端。第一次啟動後若關閉視窗,看起來像是程式消失,先檢查通知區域與隱藏圖示;部分設定會在關閉視窗時將程式縮至系統匣。要切換版本或釋放連接埠,請從系統匣選單選擇「結束」,不要只按視窗的關閉按鈕。若啟動時明確提示缺少執行環境,請依安裝包說明確認需求;若介面無法開啟,先處理安裝錯誤,不必急著修改訂閱或路由。

訂閱分組:新增與更新是兩個步驟

開啟「訂閱分組」,進入「訂閱分組設定」,新增一筆分組資料並填入備註與訂閱網址。儲存後切換至該分組,再從「訂閱分組」選單執行對應的更新操作。只有一個分組出現變化時,先更新目前分組,避免其他分組的請求失敗而掩蓋本次結果。看到節點後,選取一個項目並設為目前使用的伺服器,再查看記錄是否有啟動錯誤。只點選表格中的一列,不一定代表已切換目前伺服器;操作後請確認主畫面或狀態列顯示的使用中項目。

分組清單空白時,先確認清單篩選器與分組標籤是否指向剛新增的資料,再查看記錄。若記錄顯示請求逾時,請依訂閱取得問題排查;若已收到回應卻顯示解析失敗,則優先檢查是否匯入了單一分享連結,或伺服器是否回傳登入頁面。新裝置第一次設定時,通常先嘗試不經代理更新;只有在已有可用連線且確實有需要時,才依照選單使用經代理更新,避免陷入必須先有節點才能下載節點的循環。

先用系統代理,無法涵蓋時再考慮 TUN

核心正常啟動後,在主視窗或系統匣的「系統代理」選單中選擇「自動設定系統代理」,再重新開啟一個會遵循系統代理設定的應用程式進行測試。系統代理是將本機代理網址告知應用程式,不是強制每個處理程序轉送資料。已有獨立代理設定的瀏覽器、命令列程式與部分桌面應用程式可能會忽略此設定。手動設定單一應用程式時,請從「參數設定」確認本機監聽連接埠及其支援的通訊協定,不要將伺服器網址填入應用程式的本機代理欄位。

確定有應用程式不讀取系統代理時,再評估是否使用 TUN。先記下原本的系統代理狀態;在裝置權限允許的情況下,依用戶端提示啟用 TUN。若明確要求系統管理員權限,請先儲存工作並結束程式,再以所需權限重新開啟,不要長期讓所有操作都透過提升權限的程式執行。測試期間避免同時啟用其他虛擬網路工具,先確認一般網頁與本機服務正常,再測試目標應用程式。出現異常時,先關閉 TUN 後重新測試,以判斷問題是否來自虛擬介面、路由接管或原有連線。

如果記錄提示網址已被使用,先確認系統匣中沒有另一個用戶端執行個體,也沒有手動啟動的核心程序。不確定是哪個程式占用時,可以改用尚未使用的本機連接埠,再同步修改手動設定代理的應用程式;不要結束不熟悉的系統程序。變更連接埠後,也要確認瀏覽器是否還留著舊網址,否則核心雖已在新連接埠監聽,瀏覽器仍會繼續送出請求至舊連接埠。

macOS:v2rayN 安裝與網路服務設定

依處理器下載,從「應用程式」資料夾啟動

開啟 Apple 選單中的「關於這台 Mac」,顯示 Apple 晶片的裝置請前往 macOS 下載頁面選擇 arm64;顯示 Intel 處理器的裝置則選 x64。兩種安裝包對應不同架構,不應靠反覆安裝來判斷。開啟磁碟映像檔,依視窗指示將應用程式拖曳至「應用程式」資料夾,再從該資料夾啟動。若一直從磁碟映像檔視窗執行,卸載映像檔後原本的入口就會失效,日後更新也更容易誤開舊版本。若已安裝用戶端,請先正常結束程式,不要在執行期間取代應用程式。

系統提示無法開啟時,請先確認是應用程式來源警告、系統版本不相容,還是檔案本身無法開啟。來源警告與架構問題是兩種不同的排查方向,下載另一種架構的安裝包無法解決前者。確認來源與安裝包類型後,查看「系統設定 → 隱私權與安全性」是否有針對該應用程式的處理提示,並依裝置管理規定操作。受管理的電腦若設有限制,應交由管理員處理,不建議為了安裝而關閉整台電腦的防護功能。

匯入分組後,確認兩次狀態變化

在 v2rayN 的「訂閱分組」中開啟分組設定,新增並儲存網址;返回清單後切換至新建分組,再執行更新。第一次確認分組中是否出現預期項目;第二次確認設為目前使用的伺服器後,核心是否正常啟動。若要從其他電腦匯入多個分組,可先只匯入一個,避免一開始就受到多組節點名稱與路由規則干擾。修改通訊協定欄位前,請先確認使用的是服務提供者給的原始設定;伺服器端的傳輸與安全參數,無法只靠用戶端單方面修改來配合。

收到訂閱回應後仍沒有項目,先確認內容是否為用戶端支援的訂閱格式,而不是帳戶登入頁面或服務控制台的分享頁面。複製單一節點時,請從剪貼簿匯入;複製分組網址時,則使用訂閱入口。若同一分組只有一個節點無法啟動,其他項目正常,請比對該項目的通訊協定與核心支援範圍,不必刪除整個分組。新增與更新的詳細步驟請參閱桌面版與 Android 訂閱匯入說明。

代理設定會依網路服務而異,不一定隨裝置變動

核心啟動後,可先在用戶端選擇「自動設定系統代理」,並確認目前使用中的連線。系統中的檢查路徑通常是「系統設定 → 網路 → 目前網路服務 → 詳細資訊 → 代理」。Wi-Fi 與有線網路可能對應不同的網路服務;插拔擴充基座後,即使用戶端仍在執行,實際使用的代理設定也可能改變。如果系統原本啟用了自動代理設定,請記下原本的設定方式,不要同時保留來源不明的手動代理網址。

若瀏覽器正常,只有某個命令列工具無法連線,先確認該工具是否會讀取系統代理;不會讀取的工具可使用自己的代理選項進行測試。只有在確認需要讓系統代理無法涵蓋的程式接入,而且目前的安裝包提供 TUN 功能時,才依提示授權並啟用。啟用後,同時測試瀏覽器、區域網路服務,以及裝置睡眠喚醒後的連線狀態。喚醒後發生問題時,先停用再重新啟用所選模式,觀察記錄是否重新建立連線,不必立刻重裝應用程式。

退出前建議先還原原本的代理設定並關閉 TUN,再從應用程式選單徹底結束程式;關閉視窗和結束應用程式不一定是同一個動作。應用程式已結束但網頁仍無法開啟時,請回到目前網路服務的「代理」設定,檢查是否殘留本機網址。還原前先記錄目前狀態,還原後再對同一個測試頁面發出新請求。若直接連線仍失敗,再確認 Wi-Fi 是否需要重新登入,或原有網路是否已變更。

Linux:v2rayN 安裝、桌面代理與權限

確認發行版、套件格式與架構

前往 Linux 下載頁面選擇符合發行版的套件。Ubuntu、Debian 及其衍生桌面系統主要使用 deb;Fedora 等使用 rpm 的系統則選 rpm。確認格式後再核對架構:x86_64 對應下載頁面的 x64,aarch64 對應 arm64。若桌面系統安裝在虛擬機中,請在虛擬機內確認,不要直接沿用主機的資訊;部分容器與相容環境的使用者空間架構,也可能不同於主機環境。

uname -m
cat /etc/os-release

在目標系統中執行上方兩個命令,分別查看機器架構與發行版識別資訊。若有圖形化軟體安裝工具,可用它開啟下載的套件,並依畫面提示檢查相依性;若沒有相應的圖形工具,請使用發行版原生套件管理器安裝本機套件,並填入實際下載檔案的路徑。若安裝時提示缺少相依套件,先確認發行版版本與已啟用的軟體來源,不要混用其他發行版的程式庫檔案。第一次啟動可從桌面選單搜尋 v2rayN;若啟動後沒有視窗,請檢查系統匣與應用程式記錄,分辨程式已在背景執行或是啟動失敗。

先用一個分組與一個應用程式驗證

開啟「訂閱分組」並新增網址,清楚填寫分組備註,儲存後更新並設定目前使用的伺服器。更新失敗時,記下記錄顯示的是取得失敗還是解析失敗。若命令列必須透過其他代理才能存取訂閱網址,而用戶端直接更新失敗,兩者的請求路徑就不同。先記下這些環境差異,再決定是否切換更新方式;不要因為終端機能存取同一個網址,就認定用戶端一定能取得內容。

桌面版的系統代理是否生效,取決於桌面環境,以及應用程式是否會讀取代理設定。GNOME 或 KDE 的網路代理設定可作為檢查入口,但 shell、背景服務與部分以隔離方式執行的桌面應用程式,不一定共用同一份設定。先測試一個確定會讀取代理設定的圖形應用程式,再獨立測試命令列,避免混淆兩種環境。以下範例假設已在用戶端確認 10808 是可用的本機 SOCKS 連接埠;測試前請以自己的「參數設定」為準。

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

此命令只會為這次請求指定代理,socks5h 會將網域名稱交由代理端解析,不會修改登入環境。收到回應代表這次請求透過本機入口取得了結果,不代表所有桌面流量都已接入,也不代表套用了某一條特定分流規則。若立即顯示連線遭拒,請優先確認核心是否正在執行、連接埠是否正確;若已接入本機連接埠但請求仍逾時,再檢查目前使用的設定與相關記錄,不要先在系統啟動指令碼中加入全域環境變數。

只有需要 TUN 時,才處理虛擬介面與授權

TUN 通常需要建立虛擬介面並調整路由,能否啟用取決於系統環境與用戶端的權限設定。若記錄提示裝置無法使用或權限不足,先確認是否處於容器、虛擬機或受限制的工作階段,再依照安裝包說明處理。不要將整個桌面工作階段改成高權限執行,也不要為了排除問題而清空現有路由或防火牆設定。若已安裝企業網路工具,請先確認管理規定;如果只需讓單一應用程式接入,本機代理通常更容易還原。

確認日常使用穩定後,再考慮設定登入後自動啟動。桌面自動啟動是在使用者登入工作階段後啟動應用程式,並不代表電腦開機時就會立即接管所有使用者的流量。請先手動啟動,確認訂閱、連接埠與代理設定正常,再新增一個自動啟動入口。登入後若發生連接埠衝突,請檢查桌面自動啟動項目與現有服務是否都在啟動程式;保留一個清楚且容易管理的入口即可。

Android:v2rayNG 安裝、訂閱與 VPN 連線

優先使用 v2rayNG,依系統支援情況選擇安裝包

前往 Android 下載頁面優先選擇 v2rayNG;確認現有設定需要 V2Fly 核心時,再考慮備選的 v2flyNG。多數較新的裝置可先選 arm64 安裝包,但能否安裝仍取決於系統使用者空間是否支援該架構,不能只看處理器硬體。若系統明確提示架構不相容,且下載頁面提供通用版,可再嘗試通用版。若提示安裝包與現有應用程式衝突,請先確認已安裝應用程式的來源與升級方式,不要反覆更換架構。

開啟已下載的安裝包,依系統提示授予目前安裝來源的權限。若手機受到家長監護、工作資料或公司政策限制,請先確認裝置管理規定。若已安裝舊版應用程式,不要為了解決安裝衝突就直接解除安裝:解除安裝可能同時刪除本機分組、自訂規則與個別應用程式設定。先備份可匯出的內容,並確認能取回訂閱網址,再決定是否遷移。第一次啟動先完成基本設定,暫時不要啟用自動連線或背景常駐,方便逐步確認各項功能。

新增訂閱分組,更新後再選擇節點

在 v2rayNG 開啟選單,進入「訂閱分組設定」,新增備註與訂閱網址並儲存;返回清單後,再從選單選擇「更新訂閱」取得項目。介面配置可能因發行版本而異,請以選單名稱為準。更新完成後切換至對應分組,點選一個節點並確認目前選取狀態。只有分享連結時,請使用「從剪貼簿匯入」或「掃描 QR Code」,不要先將單一連結新增為訂閱網址。若從聊天視窗複製長網址,請返回輸入欄確認是否只複製了第一行。

更新發生錯誤時,先確認手機目前使用的網路是否需要登入,再判斷是無法連上伺服器,還是內容無法解析。若 Wi-Fi 可以更新、行動數據卻不行,請在同一台裝置、使用同一個網址,比較兩種網路的結果;不要同時修改核心、訂閱與節點。若清單項目突然減少,請確認目前選取的分組、篩選條件,以及服務端內容是否已變更;先保留現有可用資料,再決定是否刪除並重新新增。

允許 VPN 連線請求,再確認應用程式是否納入

按下連線按鈕後,第一次通常會出現系統的 VPN 連線請求;確認請求來自剛開啟的用戶端後再允許。此處透過系統 VPN 介面接管裝置流量,不必照搬桌面版的「系統代理」選單,也不必將桌面本機連接埠填入手機 Wi-Fi 的代理欄位。系統顯示連線圖示,代表介面已建立;仍需用瀏覽器實際開啟網頁確認。若畫面提示已有其他 VPN,先查看系統 VPN 設定;在裝置政策允許的情況下,先中斷衝突的連線再測試。

瀏覽器正常,但某個應用程式沒有依預期接入時,先查看用戶端的「個別應用程式代理」設定與目前清單的篩選方式:有些模式只納入選取的應用程式,有些則會排除選取的應用程式。測試時先恢復成容易判斷的模式,再重新開啟目標應用程式,避免沿用舊連線。工作資料與個人資料中的同名應用程式,也可能套用不同的設定範圍;請在實際使用的資料空間中測試,不要只憑圖示判斷。

若只有關閉用戶端後網路無法恢復,請到系統 VPN 設定檢查是否為該應用程式啟用了「永遠開啟」或「封鎖未使用 VPN 的連線」。這是系統層級的政策,與分組中是否有節點無關。個人裝置可依需要還原啟用前的設定;受管理裝置則應遵守原有設定。更換用戶端時,請先確認舊連線與相關政策是否仍在生效,再為新用戶端個別授權,避免將舊政策造成的斷線誤判為新應用程式安裝失敗。

路由與 DNS:接入方式及分流規則

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

系統代理與 TUN 決定應用程式流量如何進入用戶端;路由規則則決定已進入的流量從哪個出口離開。若應用程式不讀取系統代理,修改路由清單也無法讓它接入;若流量已接入但命中直連規則,請求不經遠端節點也可能是預期結果。排查時先用一個明確透過本機連接埠的應用程式進行測試,再比對該應用程式在系統代理或 TUN 下的表現。不要把「切換路由模式」和「切換系統代理」當成同一個按鈕。

桌面版啟用 TUN 時,請留意本機服務、虛擬網卡與其他網路工具。管理後台、區域網路裝置及部分虛擬機網路,可能需要依既有規則直連。先記下這些網址原本的存取方式;若啟用 TUN 後本機服務無法連線,先關閉 TUN 重新測試,確認是接入範圍改變後,再決定要調整規則或改用單一應用程式代理。若原本不由用戶端處理的流量也被接入,應檢查匹配範圍,而不是新增一大批與問題無關的規則。

依網域、位址與連接埠縮小規則範圍

在 v2rayN 開啟「路由設定」,先確認目前使用的是哪一套規則。編輯前保留原始設定;若可以複製,請在副本上修改。依網域比對適用於目標以主機名稱表示的情況;依位址比對則適用於目標直接使用位址,或已依策略完成解析的情況。應用程式可能請求介面網域、靜態資源網域或重新導向後的主機名稱,不一定等同於瀏覽器網址列中的主要網域。先選一筆可重現的請求作為範例,確認它進入用戶端時顯示的目標,再判斷應使用哪一類條件。

通常應將較具體的例外規則放在較廣泛的比對規則之前;同一個請求命中前面的規則後,就不會再繼續比對後面的例外。不要在清單開頭放入範圍過大的兜底規則,也不要只憑常見連接埠判斷某個服務,因為同一個連接埠可能被許多無關服務使用。編輯規則後,請確認指定的出口確實存在;圖形介面中的直連或代理名稱與設定中的出口標籤有關,不宜從其他設定檔複製本機未定義的標籤。

routing.domainStrategy 常見值
值對路由比對的影響
AsIs不會為了比對規則而額外解析目標網域;已有的位址仍可用於位址規則比對。
IPIfNonMatch原始目標未符合規則時,才會嘗試解析網域,並以取得的位址進行比對。
IPOnDemand比對過程需要檢查位址條件時,可先解析目標網域。

這些值控制核心進行路由判斷時,何時需要解析網域,並不保證應用程式的查詢一定使用核心 DNS。如果前面已有一條通用規則接住請求,也不能期待 IPIfNonMatch 繼續嘗試位址規則。手動設定前,請確認用戶端目前使用的核心及版本是否支援;先觀察網域規則與位址規則各自命中了哪些請求,再比較策略差異,不要把這個欄位當成通用的連線開關。

設定 DNS 後,用同一筆請求驗證路徑

若某個網域無法開啟、其他網站卻正常,先分辨是解析失敗、取得不適用的位址,還是已取得位址但連線失敗。瀏覽器可能使用自己的安全 DNS,命令列也可能使用系統解析器,因此兩者查到的結果不一定相同。測試時保持應用程式與網路不變,一次只比較一項 DNS 或路由設定。若需要調整核心 DNS,可先參閱DNS 分流設定說明,再決定哪些網域應交由哪個解析器處理。

儲存規則後發出新請求,避免舊連線直接沿用,繞過本次變更。若能看到命中資訊,請比對目標、規則與出口;若看不到,分別測試一個預期直連的本機目標,以及一個預期經代理處理的目標。只有其中一個失敗,先檢查對應的比對條件與出口;兩者都失敗,則回到接入層檢查。測試成功後,請在備註中寫下新規則的用途,日後排查時便能依用途撤銷整項變更,不必再猜是哪一列出了問題。

常見設定問題:從錯誤位置著手排查

更新失敗:先確認是否取得內容

請求逾時、網域無法解析、服務拒絕存取與內容解析失敗,處理方向各不相同。逾時時先確認目前網路能否正常直接連線,再確認更新工作使用的是直接取得還是透過代理取得。若出現拒絕存取或網址失效提示,請回到訂閱原始入口確認網址與帳戶狀態,不要短時間內反覆重試。若請求成功但無法解析,請先確認回應內容是否為支援的訂閱格式;登入頁面或服務提示頁即使能正常開啟,也不是可匯入的節點清單。

部分服務更新後會變更項目名稱、順序或數量。不要看到相同名稱就認為舊項目仍有效,也不要看到清單空白就立刻判定服務中斷。先清除搜尋篩選、切回正確分組,再查看更新記錄與實際項目;若更新影響了目前使用的設定,請重新選擇已知可用的節點。若需要保留舊設定,請在更新前先備份,避免網路與設定同時變動時,手邊沒有可供比對的範例。

核心無法啟動:先處理第一筆有效錯誤

開啟主畫面的記錄,留意按下連線或切換節點後最先出現的錯誤。若連接埠被占用,先檢查是否重複啟動及設定值;若找不到核心元件,先確認安裝是否完整、程式是否從正確位置啟動;若無法辨識通訊協定參數,再確認分組項目的傳輸與安全選項是否符合目前核心。用戶端不斷重試會產生大量類似記錄,後續的連線失敗可能只是第一筆錯誤造成的結果。不要先修改遠端設定來處理本機監聽失敗。

若只有自訂設定無法啟動,先切換到一個由用戶端正常匯入、先前能夠運作的項目。一般項目成功,表示排查範圍可縮小至自訂欄位、引用標籤或核心相容性;兩者都失敗,再檢查程序權限與本機連接埠。複製設定片段時也要留意,片段可能只包含部分設定,並非完整可執行的設定檔。若有幾項安全參數不確定,應向設定提供者取得彼此相符的設定,不要逐項嘗試關閉驗證。

已連線但應用程式無法使用:確認是否走同一條連線路徑

瀏覽器能存取網站,不代表其他應用程式使用了相同入口。先確認故障應用程式是否讀取系統代理、是否被 Android 個別應用程式策略排除,或是否在隔離工作階段中啟動。只有一個目標無法使用時,再檢查該目標的網域解析與路由命中;所有目標都無法使用時,優先檢查目前使用的伺服器與本機入口。驗證時請用同一個應用程式發出新請求,並記錄網路是否有切換。不要根據先前截圖中的連線狀態,推測裝置目前實際使用的路徑。

若只有切換網路後才發生問題,先確認目前網路能否直接開啟測試頁面,並檢查是否需要登入驗證;部分故障在用戶端啟動前就已發生。若一般網頁一直正常,只有特定應用程式逾時,再比對該應用程式使用的通訊協定與接入模式。例如應用程式依賴 UDP,就要確認目前的用戶端入口、節點設定與遠端是否都能處理該流量;只開啟本機的一個選項,無法證明整條路徑支援 UDP。

延遲測試成功,為什麼應用程式仍無法開啟?

延遲測試通常只驗證測試目標或連線階段。請先確認故障應用程式有經過用戶端入口,再檢查它實際存取的網域與出口。兩者目標不同,結果可能也不同。

退出後仍然斷網,需要重新安裝嗎?

通常應先檢查殘留的系統代理、TUN 或系統 VPN 政策。還原原設定後,用同一個頁面測試直接連線;只要問題發生在應用程式退出後的網路狀態,重新安裝就不是第一步。

只有一個分組出錯,需要清除用戶端資料嗎?

先保留其他可用分組,確認目前分組的網址與更新結果。可用獨立分組重現問題,再處理出錯的分組,避免以清除所有資料取代故障排查。

仍無法判斷問題時,請整理成一句可重現的描述:使用哪個系統、哪個用戶端、哪種接入方式,以及哪個操作觸發了哪類錯誤。再補充最近是否更新或切換網路,並附上已遮蔽敏感資訊的第一筆錯誤記錄。比起整頁捲動截圖,這些資訊更容易協助判斷問題出在訂閱取得、核心啟動、流量接入或規則出口。

更新與還原:保留可用設定與復原步驟

分開處理用戶端更新、核心變更與訂閱更新

用戶端更新會改變介面與本機行為;核心變更可能影響通訊協定、傳輸方式及路由欄位支援;訂閱更新則會改變服務提供的項目。即使這三種操作出現在同一個介面中,也各不相同。平常只為取得新節點時,只需更新對應的訂閱分組。需要修正用戶端問題時,先記錄目前的安裝類型與使用中的連線方式,再從用戶端下載頁面選擇相同平台與架構的安裝包。若連安裝類型也要變更,請視為一次遷移,不要預設可以直接覆蓋安裝。

更新前保留一組可正常連線的設定,並記下系統代理狀態、目前使用的核心、監聽連接埠、分流規則名稱,以及是否啟用了登入後自動啟動。若用戶端提供備份功能,請建立一份容易辨識的本機備份,並確認能從預期的入口還原。備份不只有程式檔案:訂閱分組與規則通常屬於使用者資料,程式本身則可另外安裝。封存前請檢查備份是否含有網址憑證,不要將它與求助記錄一併提交,也不要放在公開可存取的位置。

先驗證程式,再還原個人化設定

升級或更換裝置時,先關閉正在使用的代理入口,並正常結束舊的執行個體,再安裝新套件。啟動後先確認介面能否開啟、核心能否啟動;接著使用一筆已知設定進行單一應用程式測試。確認正常後,再逐項還原其他分組、規則、TUN 或個別應用程式篩選。每次只還原一類設定。如此一來,如果預設環境可以連線,還原某條分流規則後才出錯,就能據此檢查規則,不必在整份遷移資料中反覆尋找問題。

桌面系統升級後,請重新檢查原本的網路服務名稱、系統代理與虛擬介面權限;Android 換機後,則要確認 VPN 授權、背景限制,以及工作資料與個人資料中的應用程式範圍。即使成功匯入舊裝置資料,新裝置也不會因匯入訂閱而自動取得相同的系統權限。先在前景確認連線,再測試睡眠喚醒或鎖定螢幕後的情況。只有兩種情況都符合預期,才需要啟用自動連線或延長背景執行時間。

依序從小範圍開始還原

剛修改規則就出錯,先切回上一套規則;剛開始使用 TUN 就出錯,先關閉 TUN,還原為先前確認可用的接入方式;修改監聽連接埠後只有部分應用程式失敗,先修正這些應用程式的本機代理網址。還原後重新執行原本的測試。若問題已解決,就不要同時刪除訂閱與應用程式資料;先單獨記下剛才的變更,日後有需要再重試。只有新舊環境確實無法相容,且備份可用時,才考慮重新安裝或清除舊設定。

並非每次斷網都適合清除系統網路設定。用戶端結束後系統仍異常,應先還原啟用前記錄的代理設定,並檢查是否有持續生效的 VPN 政策;若已還原仍無法直接連線,再檢查目前的網路本身。公司或學校提供的設定,應還原至管理單位要求的狀態。若需要解除安裝,先結束執行中的程式、還原網路並保留必要的使用者資料,再透過系統的應用程式管理功能移除程式,避免解除安裝後才發現原本的代理仍指向已不存在的連接埠。

將常用設定簡要記錄下來,並區分必要項目與選用項目:例如必要項目包括目前分組、使用中的核心,以及單一應用程式測試所用的入口;選用項目則包括開機啟動與額外規則。下次設定新裝置時,可先依照使用指南的連線步驟驗證必要項目,再回到本頁查閱特定設定;遇到不熟悉的欄位時,先查名詞解釋,不必為了記住選單位置而保留一整份容易過時的介面截圖。