CLIENT / CONFIGURATION / DIAGNOSIS

V2Ray 常見問題
訂閱、連線與代理排查

先區分安裝包、訂閱內容、流量接入與路由規則,再依問題現象逐一檢查。以下步驟適用於 v2rayNG Android 版與 v2rayN 桌面版,設定名稱可能因版本略有不同。

基礎認識

先了解用戶端、核心與設定各自的用途。

v2rayNG、v2rayN 與 v2flyNG 該如何選擇?

Android 通常選用 v2rayNG,主要搭載 Xray 核心;需要 V2Fly 核心設定時,再考慮 v2flyNG。Windows、macOS 與 Linux 桌面則選用 v2rayN。用戶端負責匯入、編輯及啟動設定,核心負責建立連線與執行路由,兩者屬於不同層級。選擇前先確認作業系統,再核對伺服器要求的協定、傳輸方式與安全層;不要只因名稱相近,就認定設定可以互換。下載入口集中在下載頁,核心功能與協定差異請參閱協定手冊。

安裝用戶端後,為什麼沒有可用的連線設定?

用戶端安裝包提供圖形介面與執行所需元件,不會自動產生遠端伺服器位址或存取憑證。請先取得有權使用的訂閱網址、單一分享連結或完整設定檔,再匯入相應的用戶端。匯入後確認位址、連接埠、協定與安全層是否完整,選取一筆作為目前設定,再啟動連線。畫面出現設定項目只代表解析成功,不表示遠端服務可連線。本網站提供用戶端下載入口與設定說明;連線服務是否可用,請向設定提供者確認。

V2Ray 訂閱連結和單一分享連結有什麼不同?

訂閱網址通常是用戶端取得設定清單的 HTTPS 網址;更新時,用戶端會再次向該網址發出請求。單一分享連結通常以 vmess://、vless://、trojan:// 或 ss:// 開頭,內容描述一筆連線設定。Base64 訂閱通常是多筆分享連結的編碼集合,並非另一種代理協定。訂閱網址應填入訂閱群組,單一連結則透過剪貼簿匯入等入口新增。若將訂閱網址當成一般分享連結貼上,用戶端可能會提示格式不支援;也別把瀏覽器中的登入頁面網址誤認為訂閱網址。

系統代理、全域路由和 Android VPN 模式是同一回事嗎?

不是。系統代理會引導遵循該設定的應用程式將請求交給本機代理;全域路由決定送入核心的請求要採用哪個輸出;Android VPN 模式則透過系統 VPN 介面接收流量。將路由切換為全域,不會自動讓所有桌面程式使用系統代理;啟用 Android VPN,也不代表所有請求都會經過遠端代理,仍須視路由與分應用程式設定而定。排查時先確認應用程式流量是否進入用戶端,再檢查規則將流量分配至何處。桌面 TUN 是另一種流量接入方式,不應與路由預設混為一談。

安裝設定

從安裝包架構、匯入入口與系統授權著手檢查。

Android 安裝包該選 arm64 還是 universal?

多數較新的 Android 手機可選 arm64,但仍應以系統支援的應用程式 ABI 為準,不能只看處理器的宣傳名稱或購買年份。可先查閱裝置規格;若仍無法確認,選擇 universal,其包含多種架構所需的元件,安裝包通常較大。有些裝置雖採用 64 位元處理器,系統卻只支援 32 位元應用程式,此時可能無法安裝 arm64 版本。若出現安裝包不相容的提示,先核對架構與最低系統需求;若提示簽章衝突,則應另行確認既有應用程式的來源,不要反覆更換架構嘗試覆蓋安裝。

v2rayNG 的訂閱網址要在哪裡填寫?

開啟 v2rayNG 側邊欄,進入訂閱群組設定,點選新增並填寫備註與訂閱網址。儲存後返回設定清單,再從選單執行更新訂閱。不同版本的入口名稱可能略有差異,但操作順序都是先儲存群組,再要求取得訂閱內容。貼上前檢查網址前後是否多了空格、換行或通訊軟體附加的標點,並保留網址原有參數。更新完成後,選取該群組中的設定並啟動。不要將整個網頁內容貼進網址欄,也不要在公開討論區分享訂閱憑證;詳細步驟請參閱入門指南。

匯入時提示格式錯誤或不支援,該先檢查什麼?

先確認輸入內容是訂閱網址、單一分享連結還是完整設定檔,再使用對應的匯入入口。v2rayNG 與 v2rayN 的剪貼簿匯入主要用於可辨識的分享內容,並非通用的訂閱格式轉換工具。複製時移除程式碼區塊標記與說明文字,並保留完整連結參數;若使用 QR Code,則檢查影像是否遭裁切或模糊。若取得的內容是登入頁、錯誤頁或其他設定格式,即使下載成功,也無法依目前格式解析。確認格式後,再檢查用戶端及核心是否支援其中的協定與傳輸組合,不要直接批次修改連結前綴。

啟用 VPN 或 TUN 時提示權限不足,該怎麼辦?

在 Android 上啟動 v2rayNG VPN 模式時,請確認並允許系統顯示的 VPN 連線要求;若先前拒絕,重新啟動連線並授權。同時檢查是否已有其他 VPN,或「一律開啟 VPN」等政策占用介面。桌面版 v2rayN 的 TUN 模式會使用虛擬介面與系統路由,所需權限取決於作業系統、安裝方式與版本,可能需要管理員權限或相應的輔助服務。先查看記錄中的明確錯誤,再依用戶端提示處理權限。不要將長期以最高權限執行當成通用修復方式,也不要任意關閉系統安全功能。

使用技巧

先確認應用程式如何接入,再調整請求的輸出方式。

v2rayN 設定系統代理後,為什麼只有部分應用程式生效?

系統代理只會影響讀取該設定的應用程式;有些程式使用獨立代理設定,另一些則直接建立連線。先確認 v2rayN 核心已啟動,並已執行設定系統代理,再核對系統代理連接埠是否與用戶端本機監聽連接埠一致。若瀏覽器安裝了代理擴充功能,請暫時停用,或統一代理設定;終端機通常需要另外設定環境變數。不要因為單一應用程式未生效,就立刻修改遠端設定。若確實需要讓更多應用程式的流量經過代理,再評估 TUN 模式,並確認權限、路由與 DNS 符合使用情境。

如何讓終端機使用 v2rayN 的本機代理?

先在用戶端設定中確認實際的本機 HTTP 或 SOCKS 監聽位址與連接埠,再依終端機工具的文件設定代理。常見工具會讀取 http_proxy、https_proxy 或 ALL_PROXY,但各程式對變數大小寫與協定的支援不盡相同。變數值應指向本機實際監聽的代理;HTTPS 要求透過 HTTP 代理時,通常仍使用 http:// 格式,不要只因目標網址是 HTTPS 就改成 https://。修改後在同一個終端機工作階段測試;停用代理時,也要一併清除變數。不要照抄他人的連接埠,也不要把遠端伺服器連接埠當成本機代理連接埠。

啟用分應用程式代理後,哪些應用程式會經過用戶端?

在 v2rayNG 設定中啟用分應用程式代理後,先閱讀目前所選模式的說明,確認清單代表只代理所選應用程式,還是略過所選應用程式。不同版本的顯示方式可能不同,不能只看勾選狀態判斷。儲存後重新啟動 VPN 連線,讓新的應用程式範圍生效,再用目標應用程式測試連線。分應用程式設定決定哪些流量會交由代理處理,路由規則則會進一步決定這些請求的輸出方式。若瀏覽器正常、其他應用程式異常,先確認目標應用程式是否遭排除,以及是否依賴未納入範圍的其他服務元件。

路由規則和 DNS 需要一起修改嗎?

建議分開調整,每次只改變一個變數。路由規則決定請求的去向,DNS 負責名稱解析,而 domainStrategy 會影響路由比對時何時嘗試解析網域名稱。先記錄目前可用的設定,確認採用的路由預設與規則順序,再處理解析問題。不要只因為某個網站開啟較慢,就同時啟用本機 DNS、變更解析位址並重排規則,否則很難判斷是哪個變更生效。使用 geosite 或 geoip 規則時,也要確認資源檔可用。若要比較效果,請在相近的網路環境下,使用同一個應用程式與目標進行測試,並保留可還原的原始設定。

故障排除

保留可用設定,依據記錄判斷故障所在層級。

訂閱更新失敗,但原有設定仍可連線,該怎麼處理?

訂閱更新與既有設定連線所使用的請求路徑可能不同,因此兩者可能各自成功或失敗。先保留現有設定,檢查訂閱網址是否過期、存取憑證是否變更,以及裝置日期與時間是否正確。接著依據記錄判斷是名稱解析失敗、連線逾時、憑證錯誤還是 HTTP 狀態錯誤;若遭拒絕存取或網址已失效,請聯絡訂閱提供者。若用戶端提供透過代理更新訂閱的選項,先確認目前網路能否直接連線,或是否需要使用仍可用的連線,再選擇適當方式。尚未取得新內容前,不要刪除整個訂閱群組,也不要將完整訂閱網址貼到公開記錄中。

節點測試逾時,是否代表伺服器一定無法使用?

不一定。不同測試可能檢查 TCP 建立連線、完整代理請求或特定網址的連線,因此逾時所代表的失敗層級也不同。先確認測試類型,再實際開啟已知可連線的網址,並查看同一時間的記錄。檢查伺服器位址與連接埠是否完整、裝置時間是否正確,以及目前網路是否允許該連線方式;若情況允許,可換個網路重測。TCP 連線成功,也不代表驗證、TLS 或傳輸協商一定成功。不要把單次測試結果視為永久狀態,也不要反覆縮短測試逾時時間;若在多個網路都遇到相同錯誤,再向設定提供者確認服務狀態與參數。

用戶端顯示已連線,但網頁打不開,應依什麼順序排查?

顯示已連線通常只代表本機服務或 VPN 介面已啟動,不表示遠端連線已經驗證。先確認選取了預期的設定,再檢查目標應用程式是否接入本機代理;Android 請留意 VPN 與分應用程式範圍,桌面則檢查系統代理、擴充功能與終端機的獨立設定。接著查看記錄,區分 DNS 解析、驗證、TLS 協商或遠端連線錯誤,再確認路由規則是否將目標分配至預期的輸出。改用其他應用程式與目標網址交叉測試,避免把單一網站異常當成整體故障。每次只調整一項,驗證後記錄結果,不要同時更換訂閱、DNS 與路由預設。

螢幕鎖定一段時間後斷線,或網路恢復後無法重新連線,該怎麼辦?

先確認問題發生在螢幕鎖定、切換 Wi-Fi 與行動網路,還是系統清理背景程式之後。Android 可在系統的應用程式設定中檢查 v2rayNG 的電池管理、背景執行與背景數據權限,依裝置提供的選項允許必要的背景活動,不必放寬所有應用程式的限制。確認系統 VPN 狀態是否仍在,再嘗試停止並重新啟動連線;若切換網路後才出現問題,請記錄重新連線時的錯誤。桌面裝置則檢查睡眠喚醒後的網路與本機核心狀態。頻繁重新啟動無法長期協助定位原因,應比較不同電池管理設定與網路環境下的重現情況。