V2Ray 全平台安裝與設定指南
安裝包、訂閱匯入、系統代理與 TUN
如果是第一次設定,只想先連通一次,請從快速入門開始,依序完成匯入、連線與確認。本頁是依平台整理的操作手冊:遇到安裝包選擇、系統權限或分流差異時,前往相應章節;已完成安裝但連線異常,則可直接從連線確認與回復設定開始排查。
一般準備工作
客戶端、核心與安裝包
桌面平台建議使用 v2rayN 管理訂閱群組、伺服器、路由設定與本機入口,實際處理連線的是執行中的核心。Android 平台優先選用搭載 Xray 核心的 v2rayNG;確定需要 V2Fly 核心時,再選 v2flyNG。判斷相容性時,請檢查完整連線參數:兩筆同樣標示 VLESS 的設定,傳輸方式、安全類型與流控仍可能不同,不能只看協定名稱就認定兩款客戶端可以互換。若已知訂閱包含 REALITY,建議先確認 Xray 客戶端能否正確辨識相關節點。
| 平台 | 客戶端 | 安裝包選擇依據 | 常見流量入口 |
|---|---|---|---|
| Windows | v2rayN | x64 桌面版或傳統 WPF 版 | 系統代理、TUN |
| macOS | v2rayN | Apple Silicon 選 arm64,Intel 選 x64 | 系統代理、TUN |
| Linux | v2rayN | 先依發行版選 deb / rpm,再確認架構 | 桌面代理、明確指定代理、TUN |
| Android | v2rayNG、v2flyNG | 支援 64 位元 ARM 應用程式時選 arm64,否則確認通用版 | 系統 VPN 介面 |
從客戶端下載頁前往對應平台。先在系統資訊中確認架構,再選擇安裝包類型;Linux 還需確認發行版支援哪種套件格式。兩台裝有 ARM 處理器的裝置,不代表安裝包可以通用;桌面與手機的應用程式格式不同,同一平台的作業系統也可能只提供部分執行環境。若安裝失敗,請先保留系統原始提示,分辨是架構不符、缺少執行元件或安裝權限不足,再決定要更換安裝包還是修復環境。
訂閱網址、單一節點連結與服務參數
訂閱網址可定期取得一組伺服器;單一節點連結則只會匯入一筆伺服器資料。網站上的訂閱管理頁面,與客戶端讀取的訂閱網址也不是同一回事。複製前先確認用途,別把登入頁面貼到訂閱群組。訂閱網址可能包含存取憑證,不宜將原始連結附在截圖、日誌或支援單中。若服務商只提供 QR Code,請先確認內容是單一節點還是訂閱,再選擇掃描或匯入訂閱。
若已有自行管理的節點,建議與訂閱匯入的節點分開存放。更新訂閱可能會重建所屬群組,直接修改訂閱節點的參數也未必能保留。群組名稱可註明用途,但不要寫入帳號、密碼或完整網址。更新後記下目前使用的節點所屬群組與協定,避免名稱相似的項目其實連到不同伺服器。多台裝置共用同一訂閱時,也要確認服務商對裝置數量及同時連線數的限制。
記錄原始狀態,簡化首次測試
確認裝置日期、時間與時區正確,且未使用代理時可以正常開啟測試頁面。記下目前的系統代理、企業網路設定、其他 VPN 狀態,以及客戶端顯示的本機監聽連接埠。若裝置受組織管理,先確認自己有權變更哪些設定。第一次設定時,只選一個節點和一種流量入口,不要同時套用舊路由、自訂 DNS 和其他轉送設定。確認基準狀態可重複測試後,再逐項加入其他設定。
準備兩個可重複存取的目標:一個用來確認直連路徑,另一個用來測試代理路徑。首次測試時固定網路、節點與目標,不要一邊切換無線網路、一邊更換節點。若要從既有客戶端遷移,先保留舊的啟動方式與設定目錄,再測試新安裝;不要讓兩個客戶端同時使用同一個可寫入目錄。之後即使變更失敗,也能回復原本的網路狀態。
Windows:安裝 v2rayN 與設定系統代理
桌面版與傳統 WPF 版
開啟 Windows 下載頁。v2rayN 桌面版採用跨平台介面,傳統 WPF 版則使用 Windows 傳統介面。兩個版本的選單位置可能不同,但安裝後的主要流程相同:新增訂閱群組、更新訂閱、選取伺服器,再設定流量入口。切換介面版本時,先結束舊版本的執行個體,並確認工作列通知區沒有仍在背景執行的程序。兩個執行個體同時啟動,可能會搶用同一個監聽連接埠,或在結束時覆蓋對方剛寫入的系統代理設定。
前往「設定 → 系統 → 關於」,查看「系統類型」。x64 安裝包對應的是應用程式架構,不能只因系統顯示「64 位元」就認定應選 x64;如果裝置使用 ARM 處理器,也要另外確認系統是否支援相容執行環境。啟動時若系統提示需要執行元件,請確認提示中的元件名稱與架構;若主視窗可以開啟但核心無法啟動,請查看客戶端日誌。不要把應用程式啟動失敗誤認為訂閱失效,也不要同時更換安裝包與節點。
匯入訂閱並選取使用中的伺服器
開啟「訂閱群組」選單,在「訂閱群組設定」中新增群組,或使用介面上的「新增訂閱群組」入口,填入備註與訂閱網址。儲存後執行「更新全部訂閱」或相應操作;若選單還區分透過代理與不透過代理更新,首次設定且尚未建立可用連線時,請先確認目前網路能否直接取得訂閱。若服務商要求使用特定下載方式,請依其授權說明取得訂閱,不要把管理頁面或錯誤提示頁當作訂閱內容。
等節點出現在所屬群組後,從清單中明確選取一台伺服器作為目前使用的伺服器。反白一列只表示已選取,是否已成為目前伺服器,應以狀態列或系統匣提示為準。更新後若看不到節點,先確認群組網址、更新日誌與服務期限;若只有部分節點未出現,再檢查這些項目的格式及目前核心是否支援。要確認安裝正常,不必先測速整個群組;選一個已知可用的節點更容易找出問題。
系統代理、TUN 與正確結束順序
先在系統匣的「系統代理」選單中選擇「自動設定系統代理」,再用會遵從系統代理設定的瀏覽器測試。必要時前往 Windows「設定 → 網路和網際網路 → 代理伺服器」,確認代理位址與連接埠指向目前的客戶端。這裡的「自動設定系統代理」是由客戶端寫入系統代理設定,不等同於 Windows 的「自動偵測設定」。部分終端工具、背景服務及自行設定代理的應用程式不會使用同一套系統設定;瀏覽器正常,不代表所有程式都已接管。
若目標程式不讀取系統代理,先查看是否有自己的代理設定;需要透過虛擬網卡接管流量時,再嘗試「啟用 Tun 模式」。測試前先清除客戶端設定的系統代理,讓測試只使用一種入口;啟用時依提示授予必要權限,並確認虛擬介面、路由設定與本機網路運作正常。不要為了安裝或排除問題而長期以系統管理員身分執行所有工具,也不要同時保留另一套會接管預設路由的程式。結束前記得清除本次寫入的代理與 TUN 設定,還原先前記錄的狀態。
macOS:依晶片選擇安裝包與設定網路服務
依晶片選擇安裝包並辨識系統提示
從 Apple 選單開啟「關於這台 Mac」。資訊欄顯示「晶片」且為 Apple Silicon 時,請從 macOS 下載頁選擇 arm64 安裝映像檔;若顯示 Intel 處理器,則選擇 x64。開啟安裝映像檔後,依視窗提示將應用程式移至「應用程式」資料夾,再從該資料夾啟動,不要長期從已掛載的映像檔執行。更新時先結束選單列中的舊執行個體,再替換應用程式,避免兩個副本共用設定或同時修改系統設定。
第一次開啟若遭系統阻擋,請先仔細閱讀提示。架構不符、系統提示應用程式已損毀、來源尚未獲得確認及組織政策限制,是不同問題。重新確認安裝映像檔與系統架構後,若仍有安全性提示,請依系統提供的單一應用程式處理流程及組織規範處理,不要關閉全域安全性機制。若介面已啟動但網路功能無法使用,先查看客戶端日誌;這不代表應用程式無法開啟,也不能只靠將應用程式移到其他資料夾解決。
訂閱群組與選單列狀態
在 v2rayN 的「訂閱群組」中新增網址與容易辨識的備註,儲存後執行更新。開啟訂閱群組,確認節點實際包含位址、連接埠與協定欄位,再選取一台伺服器作為目前使用的伺服器。若更新失敗,先確認瀏覽器能否正常瀏覽一般網頁,以及目前網路是否要求登入,再檢查訂閱回應是否為客戶端可解析的內容。在瀏覽器登入服務後台,不代表客戶端也取得相同登入狀態;若收到的是登入頁,請回到服務商後台重新複製專用訂閱網址。
關閉視窗不一定代表程序已結束。日常確認使用中的節點、代理模式與結束狀態時,也要查看應用程式選單列或狀態區。首次確認時固定節點,用同一個瀏覽器視窗開啟同一個目標。若先前儲存的設定包含路由或自訂解析,先記下相關設定,再暫時使用簡單規則完成基準測試。更換節點前先確認目前伺服器是否確實生效,不要把節點清單中的反白項目當成連線狀態。
目前網路服務、TUN 與睡眠喚醒
啟用客戶端的「自動設定系統代理」後,前往「系統設定 → 網路」,開啟目前連線服務的「詳細資訊 → 代理伺服器」進行確認。Wi-Fi 與有線連線可能是不同的網路服務,前者連線正常,不代表切換到後者時代理仍有效。若原先設定了自動代理設定檔或組織代理,先記錄其設定,不要擅自覆寫。瀏覽器可用但終端工具無法連線時,先檢查工具本身的代理設定;系統代理不保證每個命令列程序都會讀取。
需要測試不讀取系統代理的應用程式時,先清除本次設定的系統代理,再依客戶端提示啟用 TUN。確認沒有其他 VPN、網路過濾功能或組織管理政策同時接管流量。權限提示應與目前操作相符;若系統未建立所需的網路狀態,先在這個環節排查,不必反覆更新訂閱。關閉 TUN 後,分別測試需要代理的應用程式與本機服務,確認連線確實回到預期路徑。
從睡眠狀態喚醒後,若網頁一直載入,可先關閉本次流量接管,確認目前的 Wi-Fi 或有線連線本身正常,再恢復原模式並使用同一個節點重測。執行 scutil --proxy 可查看系統回報的代理狀態,但無法證明每個應用程式都遵從這項設定。若問題只在切換網路後出現,優先檢查目前使用的網路服務、舊代理連接埠與虛擬介面,再考慮服務端參數。
Linux:套件格式、桌面代理與 TUN
套件格式與處理器架構
從 Linux 下載頁選擇 v2rayN。Debian、Ubuntu 等系統通常選 deb,Fedora 等系統通常選 rpm;其他發行版應先確認套件格式與相依條件,不要只改副檔名。執行以下命令查看機器架構與發行版識別資訊。輸出為 x86_64 時,對應下載頁的 x64;輸出為 aarch64 時,請確認 arm64 下載選項。發行版識別資訊用來判斷安裝方式,不能用來推斷處理器架構。
uname -m
cat /etc/os-release
下載後可在檔案管理員中使用系統套件安裝程式開啟本機套件。若桌面環境沒有提供安裝入口,可使用發行版的套件管理器處理本機檔案:在相應的 apt install 或 dnf install 命令中填入實際下載套件的絕對路徑;路徑含空格時,請將整個路徑括起來。不要在同一次安裝中混用 deb 與 rpm,也不要用強制忽略相依性的選項掩蓋錯誤。若無法解決相依問題,請查看錯誤涉及的程式庫、架構或套件庫,不要一律重裝系統。
以目前的桌面使用者啟動客戶端
從應用程式選單以目前使用者身分啟動 v2rayN,先確認主視窗與狀態區顯示正常。設定通常與執行使用者有關;若同一客戶端交替以一般使用者和提升權限的使用者執行,可能讀取不同設定,或留下一般使用者無法修改的檔案。需要 TUN 權限時,只在相應步驟提升權限,不要長期以高權限執行整個桌面應用程式。若關閉視窗後找不到應用程式,先確認目前桌面環境是否支援系統匣顯示,再決定是否重新啟動執行個體。
在「訂閱群組」中新增網址、執行更新,再選取一台伺服器作為目前使用的伺服器。若更新時出現網路錯誤,先確認桌面瀏覽器與客戶端各自使用哪種代理。瀏覽器能開啟訂閱相關頁面,不代表客戶端的更新請求也使用相同路徑。匯入後若核心啟動時回報連接埠已被占用,可執行 ss -ltn 查看本機 TCP 監聽狀態,再與客戶端顯示的入口比對;確認衝突來源前,不要終止不明程序。
分別測試桌面、命令列與虛擬介面
桌面代理是否有效,取決於桌面環境及應用程式取得代理設定的方式。GNOME 或 KDE 的代理設定可能會被部分桌面程式讀取,命令列程式通常使用自己的選項或程序環境變數。客戶端顯示自動設定成功時,可先用明確遵從桌面代理的應用程式測試,再透過明確指定代理確認監聽連接埠。終端機中單獨設定的環境變數不一定會傳給從桌面啟動的應用程式;新開的終端機也不一定會繼承另一個終端機暫時設定的變數。
需要使用 TUN 時,先關閉桌面代理或應用程式代理,作為單一入口進行對照測試,再啟用客戶端的 TUN 功能。控制容器、受限環境或受管理工作站時,即使有桌面介面,虛擬介面也可能無法使用。在具備權限的主機上,可執行 ip link show 比較啟用前後的介面,並用 ip route show 查看常用路由;後者只顯示預設查詢範圍,不能據此排除政策路由的影響。若系統使用政策路由,請再檢查 ip rule show 與實際目標所走的路徑。
若問題只出現在圖形介面應用程式,優先檢查桌面代理與應用程式設定;若只在 TUN 模式下失敗,優先檢查權限、介面、路由與 DNS 接管差異。關閉客戶端後,若終端機仍有異常,請確認命令是否繼續讀取舊的代理環境變數。結束工作階段、清除測試用環境變數及還原桌面代理是不同操作,依實際變更逐項還原即可,不必重設整台裝置的網路。
Android:訂閱、VPN 授權與分應用程式代理
安裝架構與客戶端選擇
開啟 Android 下載頁。v2rayNG 是優先選擇,採用 Xray 核心;需要 V2Fly 核心時,可改用 v2flyNG。支援執行 64 位元 ARM 應用程式的裝置,優先選擇 arm64;不確定架構或 arm64 安裝包明確顯示不相容時,再確認通用版及系統需求。處理器支援 64 位元,不代表目前的系統能安裝所有 64 位元應用程式。安裝失敗也可能是系統需求不符、儲存空間不足,或現有應用程式與新安裝包的簽章不相容。
從瀏覽器或檔案管理員開啟安裝包時,系統可能會要求授權目前的來源安裝應用程式。確認來源與本次安裝需求後再授權,完成後可撤銷相關權限。升級時若發生衝突,不要直接解除安裝目前使用的客戶端:先確認來源是否一致、訂閱是否仍有可用項目,以及是否需要備份手動新增的節點。兩款客戶端的資料分開儲存,安裝另一款通常不會自動遷移原有群組、路由與應用程式清單。
新增訂閱並選取伺服器
在客戶端選單中開啟「訂閱群組設定」,新增群組備註與訂閱網址並儲存,接著返回設定清單,執行「更新訂閱」或相應的更新操作。入口位置與按鈕名稱可能隨介面調整,重點是分清新增訂閱群組與從剪貼簿匯入單一節點。更新後確認節點所屬群組,並選取要使用的節點。若節點數量與預期不符,先確認清單是否篩選了其他群組,再檢查訂閱內容是否相容。
不要直接以某款客戶端能解析的項目,作為另一款客戶端的測試基準。若訂閱包含多種傳輸與安全性組合,請先選擇目前核心明確支援的節點進行測試。失敗時記下錯誤類別、協定與發生時間,不要在群組聊天或公開截圖中顯示訂閱網址。行動裝置切換 Wi-Fi 或行動數據時,先用原節點重新測試,再決定是否更換節點,以便分辨問題來自網路切換還是服務端變動。
VPN 介面與分應用程式範圍
選好伺服器後,點選主畫面的連線按鈕。首次啟動時,Android 會透過系統介面詢問是否允許建立 VPN 連線;確認請求是由剛啟動的客戶端發出後再授權。兩款客戶端使用的是 Android VPN 介面,不能直接套用桌面版「自動設定系統代理」的步驟。連線圖示或狀態標記只表示介面可能已建立;仍須開啟實際使用的應用程式,確認流量進入客戶端並收到回應。
先不要啟用分應用程式篩選,使用一款瀏覽器完成測試,再依需要設定「分應用程式代理」。判斷目前模式時以介面說明為準:允許清單表示只有選取的應用程式會進入 VPN 介面;排除清單則表示選取的應用程式會略過此介面。流量進入介面後仍會經過客戶端路由判斷,不代表該應用程式的所有請求都一定使用代理出站。瀏覽器能連線但目標應用程式無法連線時,先確認目標應用程式是否包含在接管範圍,再檢查網域與出站規則。
使用一段時間後若連線中斷,請確認系統是否啟用了另一個永遠開啟的 VPN,或限制客戶端在背景執行,再比對螢幕關閉前後的日誌。若系統提供「不受限制」或類似的電池用量選項,只有在確定是背景中斷時才針對此客戶端調整,並觀察耗電量與穩定性變化。部分裝置也會限制背景啟動;選單名稱依品牌而異,不要照著其他品牌的路徑盲目尋找。更多介面與模式說明,請參閱 v2rayNG Android 使用要點。
連線確認、日誌與回復設定
先確認流量從哪個入口進入
將連線拆成四個環節:應用程式送出請求、本機入口收到請求、路由選擇出站,以及出站建立連線並傳回回應。介面顯示已連線,通常只代表客戶端已啟動所需服務或介面。即使瀏覽器能開啟頁面,也不能據此斷定請求經過代理;頁面可能來自快取,也可能是規則將請求送往直連。應搭配客戶端日誌、目標位址與測試時間確認,避免混淆兩次不同請求的結果。
桌面平台先從 v2rayN 的設定或狀態列確認連接埠、監聽位址與入口類型。HTTP 與 SOCKS 是不同的應用層入口,不能因為兩者都在本機就任意互換。部分設定使用混合入口,另一些則使用不同連接埠,請以目前介面顯示為準。若系統中還有舊代理設定,請逐項與目前入口比對。Android 則應確認 VPN 授權、目前使用的客戶端與分應用程式範圍,不要將桌面版連接埠測試套用到手機的所有應用程式流量。
使用相同目標測試明確指定的代理
以下命令適用於已安裝 curl 的桌面環境;在 Windows PowerShell 中,可將命令名稱寫成 curl.exe。第一行在應用程式層停用 curl 的代理,第二行則明確使用本機 SOCKS 入口。只有客戶端確實在 127.0.0.1:10808 提供 SOCKS 服務時,第二行才能直接執行;否則請改用介面顯示的本機位址與連接埠。執行對照測試前先關閉 TUN;第一行無法略過系統層已接管的流量。
curl --noproxy '*' --max-time 15 -I https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com/
socks5h 會將目標網域交由 SOCKS 入口處理,但不代表所有網域都由遠端解析;後續行為仍取決於核心的路由與解析設定。此命令示範的是如何隔離本機入口,並非用來評分節點。兩條命令都收到回應時,還要確認代理請求實際使用哪個出站。若服務網址不支援 HEAD 請求,可透過同一入口執行一般 GET 進行驗證;不能只因伺服器拒絕該方法,就判定網路中斷。
依錯誤發生位置縮小排查範圍
若錯誤直接指向本機迴送連接埠,先確認客戶端是否正在執行、監聽是否成功,以及連接埠或協定是否設定錯誤。若日誌已顯示正在連線至遠端,則依序檢查遠端位址、連接埠、連線逾時與交握參數。connection refused 要先確認是哪一端拒絕連線,不代表所有伺服器都失效;i/o timeout 則要釐清是連線、讀寫還是解析逾時。若 TLS 交握一再失敗,先確認系統時間,以及訂閱要求的伺服器名稱、安全類型與傳輸設定,再向服務商確認參數。詳情請參閱 v2rayN 執行日誌排查。
還原基準狀態,再逐項加回設定
回復設定時,先關閉本次啟用的 TUN,再還原原有系統代理、清除目標應用程式手動填入的測試代理,最後確認原網路能否直接開啟基準頁面。若仍無法恢復,應先排查網路本身或原有管理設定,不要繼續修改訂閱。恢復基準狀態後,每次只加入一個節點、一種流量入口或一項路由變更,並記錄設定、目標與實際結果。若問題在修改後立即出現,先撤銷最後一項變更,再測試一次後下結論。需要逐項確認時,可參閱已連線但無法上網的排查清單。
路由分流與 DNS 設定
先分清流量接管範圍與出站選擇
系統代理、明確指定的代理或 TUN,決定哪些請求能進入核心;路由規則則決定進入核心的請求使用哪個出站。若系統代理沒有接管某個程序,調整核心的網域規則通常不會影響該程序。反過來說,應用程式流量即使已進入核心,也可能依路由設定直連。排查時先確認入口日誌,再查看出站標記。若日誌中找不到目標請求,請先檢查應用程式代理或虛擬介面,不要反覆調整規則順序碰運氣。
在 v2rayN 中開啟「路由設定」,先確認目前實際使用的規則組,再決定要修改哪一項。規則通常依清單順序比對,前置的廣泛規則可能先符合條件,導致後面的例外規則無法生效。修改前可保留原規則集,並為測試規則集設定獨立名稱。確認例外條件時,固定目標與應用程式,不要同時更換節點與解析方式。完成測試後,再用第二個目標確認原本分流仍有效,避免修好一個網站,卻將其他應用程式的流量誤送到錯誤的出站。
規則欄位與核心設定範例
以下片段展示 Xray 核心設定中的 routing 欄位,適用於已宣告 direct 出站標籤的設定:第一條規則只比對完整網域 example.com,第二條則比對指定的私有位址範圍。這不是完整的客戶端設定,不能貼到訂閱網址欄位。使用 v2rayN 圖形介面時,可在自訂規則中填入相應網域或 IP 條件,並選擇目前規則集中已有的直連出站;不要只複製標籤名稱而未確認實際出站。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:example.com"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
"outboundTag": "direct"
}
]
}
}
full: 只會比對指定的完整名稱,不會自動涵蓋其子網域;若要比對該網域及其子網域,再考慮使用 domain:。outboundTag 是對實際出站的參照,不是獨立協定。範例中的 AsIs 不會為了讓網域符合 IP 規則而主動解析網域。如果進入核心的目標本身是 IP,網域規則也未必有可用的網域名稱可供判斷。除錯時應查看日誌中實際收到的目標,不要只憑瀏覽器網址列推斷所有子請求都使用相同格式。
DNS 診斷與調整順序
應用程式、作業系統與核心都可能參與網域解析。瀏覽器的安全 DNS、客戶端解析設定,以及 TUN 是否接管 DNS,都會影響請求以網域或 IP 位址進入核心,也可能讓同一網域在不同應用程式中解析出不同位址。排查時記錄失敗目標的完整網域、發生時間與目前模式;比較系統直連與明確指定代理的結果時,先釐清兩者分別將網域交由哪一端解析,不要只比較網頁能否開啟。
若某個網域無法存取,但同一服務的其他位址正常,先查看日誌中是否有解析錯誤,再確認規則使用的是網域、IP 還是外部分類資料。直接將 HTTPS 網址中的主機名稱改成 IP,不能視為同等測試,因為伺服器名稱與憑證比對結果也會不同。存取本機共用資源、印表機或組織網路服務時,請確認私有位址是否仍走預期路徑;不能只以公共網站可用作為驗收標準。保留變更前的 DNS 與路由設定,每次只調整一個層面。欄位說明可參閱名詞速查。
常見設定問題
訂閱更新成功,為什麼沒有使用中的節點?
先確認更新訊息是否對應目前的群組,再檢查節點清單是否受搜尋文字、群組或篩選條件限制。更新成功只代表客戶端完成取得或解析等其中一個環節,不保證原本使用的伺服器仍在清單中。服務商可能已更名或停用原節點;此時請在該群組中重新選取一台伺服器,並確認其使用狀態。若整個群組都是空的,先確認訂閱回應是否為客戶端支援的格式,再檢查訂閱權限、有效期限,以及是否誤將管理頁面網址當成訂閱網址。
瀏覽器可以上網,其他應用程式為什麼不行?
先確認瀏覽器使用的是系統代理,還是瀏覽器本身的代理設定。若桌面應用程式提供代理選項,可依客戶端實際監聽的協定與連接埠個別設定;應用程式沒有相關選項時,再評估是否使用 TUN。Android 則先確認目標應用程式是否被分應用程式設定排除。若日誌已出現目標應用程式的請求,但業務頁面仍無法開啟,接著檢查該網域使用哪個出站,以及 DNS 是否正常,不必重新安裝客戶端。測試前也要確認業務應用程式本身可以正常登入。
系統代理和 TUN 可以同時啟用嗎?
不同系統、客戶端與規則集對重疊流量的處理方式各異,不能只因兩個開關都已開啟,就認定應用程式使用哪條路徑。首次設定或排查問題時,只啟用一種入口更容易重現測試結果。從系統代理切換到 TUN 時,先清除本次寫入的系統代理,再啟用 TUN;反向切換時,先關閉 TUN,確認網路正常後,再自動設定系統代理。若裝置另有組織指定的代理或 VPN,不要擅自關閉,應先確認流量接管範圍與管理規定。關閉測試設定後,記得還原原值,不要一律清成空白。
如何判斷是節點故障還是本機設定問題?
先固定一台裝置、一個網路與一個測試目標。在確認本機入口已收到請求的前提下,測試同一群組中的兩個獨立節點;若一個失敗、另一個正常,優先檢查失敗節點的服務狀態與參數。若多個節點都在本機相同環節失敗,例如連線至本機連接埠時都遭拒絕,先處理本機入口;若都在出站解析時失敗,再檢查 DNS 與網路條件。多個節點同時失敗,不代表所有服務端都有問題;它們可能共用相同的網路條件、解析路徑或驗證狀態。
更換客戶端或重新安裝前,要先保存哪些資料?
記下訂閱群組名稱、使用中的路由組、流量接管方式、本機監聽連接埠與手動新增的節點。客戶端若提供匯出功能,只在受控位置保存設定;匯出內容可能包含網址與存取參數,不應上傳到公開雲端硬碟或聊天群組。跨客戶端遷移時,建議重新匯入訂閱並逐項恢復路由,不要假設另一款應用程式能完整讀取舊設定目錄。遷移是否成功,應以「項目可見、使用中的節點正確、本機入口可用、目標流量依預期分流」為準,而不是看舊目錄能否複製過去。客戶端差異可參閱客戶端比較評測。
請他人協助時,提供哪些資訊比較有用?
提供作業系統與架構、客戶端名稱及介面顯示的實際版本、使用中的核心、流量入口、失敗範圍與首次發生時間。說明是否剛更新訂閱、切換網路或啟用 TUN,以及是否能恢復原本的網路狀態。日誌只保留故障前後相關內容,遮蔽伺服器位址、訂閱網址與存取憑證;截圖也不要意外露出帳號或組織內網資訊。比起只說「一直連不上」,提供「同一個瀏覽器、同一個目標,系統代理可用但 TUN 無法使用」這類對照結果,更容易判斷該從哪裡開始排查。