首次設定 · 約 10 分鐘

V2Ray 客戶端訂閱匯入與首次連線

依照「匯入訂閱、選擇代理模式、連線節點、驗證結果」的順序完成基本設定。每一步都以前一步的可見結果作為檢查點,遇到異常時不必反覆重新安裝客戶端。

桌面客戶端 v2rayN
Android 客戶端 v2rayNG
完成標誌 連線與 IP 結果一致
第一步

匯入訂閱並確認節點清單

這個階段只需確認兩件事:客戶端能否儲存訂閱網址,以及更新後能否取得節點。暫時不要修改路由、DNS 或 TUN 設定。

先複製完整的訂閱網址

從訂閱服務提供商的管理頁面複製客戶端訂閱網址。複製時應包含從協定開頭到最後一個參數的完整內容,例如網址中的 token=xxxx 也是訂閱識別資訊的一部分。不要只複製瀏覽器網址列中被截斷的片段,也不要把訂閱網址貼到搜尋框中測試。訂閱網址屬於個人設定資料,不適合公開在截圖、論壇或聊天群組中。

如果服務提供商同時提供多個入口,請選擇標示為通用訂閱、V2Ray 訂閱,或相容於 v2rayN、v2rayNG 的入口。QR Code 更適合在行動裝置上掃描,文字網址則適合貼到桌面端。兩種形式傳遞的是同類設定資料,不需要同時匯入。

在 v2rayN 中建立新的訂閱群組

開啟 v2rayN 後,從頂端選單進入 訂閱分組,選擇 訂閱分組設定。在彈出視窗中新增一筆紀錄,將完整網址貼到訂閱網址欄位,再填寫容易辨識的備註,例如服務名稱或用途。群組名稱方便節點較多時篩選,不會影響連線本身;首次使用可保留預設群組,也可以填寫與備註相同的名稱。

儲存設定後回到主視窗,再次開啟訂閱選單,執行一次「更新全部訂閱」,或單獨更新剛才建立的群組。更新完成後,主視窗應出現數筆伺服器紀錄,常見欄位包括別名、網址、連接埠、傳輸方式與安全類型。這裡不要求理解每個欄位,只要確認清單不再為空,且沒有持續跳出訂閱解析錯誤即可。

在 v2rayNG 中新增訂閱

開啟 v2rayNG 的側邊選單,進入訂閱設定並點選新增按鈕。填寫備註、貼上訂閱網址,儲存後回到訂閱清單,選取剛新增的項目並執行更新。更新成功後回到主介面,節點會以清單形式顯示。若清單仍顯示先前內容,可從主選單重新整理設定,或離開目前頁面後重新進入節點清單。

在行動裝置上透過 QR Code 匯入時,請確認掃描結果被辨識為訂閱網址,而不是單一 VMess 或 VLESS 節點。單節點設定只能新增一筆伺服器紀錄,訂閱網址則可在之後統一更新。如果只看到一個節點,但服務頁面明確提供多條線路,請返回訂閱設定檢查匯入類型。

本步完成標誌

客戶端已儲存訂閱群組,手動更新沒有持續報錯,主節點清單至少出現一筆可選擇的伺服器紀錄。

更新後仍沒有節點,該如何檢查

先重新開啟訂閱設定,確認網址前後沒有空格、參數未在複製時遺失,並核對目前啟用的是剛新增的群組。接著再手動更新一次,觀察客戶端提示的是網路請求失敗、內容為空,還是格式無法辨識。這三類提示代表不同方向:請求失敗通常與目前網路或訂閱網址是否可連線有關;內容為空需要檢查訂閱狀態;格式無法辨識則應確認取得的是客戶端訂閱網址,而不是管理頁面網址。

不要在這一步頻繁切換代理模式。客戶端尚未有可用節點時,修改系統代理不會讓訂閱內容自動出現。訂閱狀態、更新頻率與節點欄位的進一步說明,請參閱常見問題術語表;多訂閱群組、伺服器篩選與自動更新策略則另見進階手冊

第二步

選擇系統代理與路由模式

訂閱產生節點後,再決定哪些流量交由客戶端處理。首次連線以系統代理與規則模式為主,先建立容易理解與排查的基本狀態。

先區分兩個獨立設定

v2rayN 中常被混在一起討論的設定有兩類。第一類是系統代理狀態,決定遵循作業系統代理設定的應用程式是否將請求送給 v2rayN;第二類是路由模式,決定請求進入客戶端後使用代理出站、直連出站或阻止出站。前者負責「流量是否進入客戶端」,後者負責「進入後採用哪條路徑」。只修改其中一項,實際結果可能與預期不同。

第一次設定時,請先在 v2rayN 底部狀態區或系統匣選單中將系統代理設為自動設定系統代理,再將路由選擇設為規則模式。不同版本對規則模式的名稱可能略有差異,介面常見設定是繞過本機網路與常用直連目標,其餘請求依目前活動伺服器處理。選擇後留意底部狀態列,系統代理與路由兩處文字應同步反映目前設定。

何時使用全域模式

全域模式表示進入客戶端的請求會優先交由目前代理出站處理。它適合用於短時間的對照測試:如果規則模式下某個網頁未如預期開啟,可以暫時切換到全域模式,再重新整理同一頁面。若全域模式正常而規則模式異常,問題較可能出在路由匹配;若兩種模式都失敗,應回頭檢查節點狀態、訂閱內容或網路連通性。

全域模式不代表系統內所有程式都會自動進入客戶端。有些程式不讀取系統代理設定,有些使用獨立網路堆疊,另一些則內建代理設定。遇到這種情況,應先檢查程式本身的代理選項;確實需要接管更多流量時,再評估 TUN 模式,而不是只在規則與全域之間反覆切換。

v2rayNG 的模式選擇

在 v2rayNG 中,先從設定或路由設定選擇規則模式。回到主介面後,連線按鈕會建立系統層級的 VPN 通道,Android 會顯示權限確認視窗。第一次連線時必須允許此請求,否則即使選取了節點,流量也不會進入客戶端。這項系統授權只負責建立通道,實際流量仍依 v2rayNG 目前的路由規則處理。

如果只是確認訂閱與節點是否可用,維持預設規則設定即可。自訂網域規則、應用程式分流、DNS 查詢路徑與 FakeDNS 會同時改變多個判斷條件,不適合在首次連線前集中調整。先完成本頁四個步驟,確認基本連線穩定後,再到進階手冊逐一修改單一變數。

本步完成標誌

v2rayN 已顯示系統代理開啟與規則模式,或 v2rayNG 已選定規則設定並具備建立系統通道的權限。

完成模式選擇後,客戶端已知道如何接收與處理流量,但還未決定實際使用哪一台伺服器。下一步應先測試節點,再將確認可連線的紀錄設為活動伺服器,避免把「模式設定錯誤」與「節點本身不可用」混成同一個問題。

第三步

測試節點並建立連線

節點名稱只能提供地區、倍率或協定線索,不能證明目前可用。連線前先執行一次真實連線測試,再從成功結果中選擇活動伺服器。

使用真實連線延遲排除失效節點

在 v2rayN 主清單中選取幾個候選節點,開啟右鍵選單或測試選單,執行「測試伺服器真實連線延遲」。此測試會依節點設定完成實際代理握手,比一般網路 Ping 更接近瀏覽器建立連線時的狀態。測試結束後,成功紀錄會顯示連線耗時,失敗紀錄通常會顯示逾時、錯誤或空白結果。

不要只挑數值最小的一個。首次選擇時,更重要的是結果是否能穩定回傳,以及節點協定、地區與訂閱標示是否符合用途。可以對兩到三筆候選紀錄各重複測試一次,排除偶發的網路抖動。如果第一次有結果、第二次卻持續逾時,暫時改用另一個節點會更方便完成設定。

一般 Ping、真實連線延遲與下載測速衡量的對象不同。Ping 較接近基礎網路往返時間,真實連線延遲包含代理握手,下載測速則會使用實際流量,並同時受到伺服器頻寬、線路壅塞與本地網路影響。首次連線只需確認真實連線延遲成功,不必先進行完整下載測速。三種數值的詳細差異請參閱延遲測試說明

將測試成功的紀錄設為活動伺服器

在 v2rayN 中雙擊測試成功的節點,或透過右鍵選單選擇「設為活動伺服器」。設定後,節點列通常會出現顏色、圖示或狀態標記,底部狀態區也會顯示目前伺服器資訊。單純點選一列通常只是選取紀錄,不一定會變更活動伺服器,因此應以狀態標記是否改變為準。

確認活動伺服器後,檢查 v2rayN 核心是否正在執行。正常情況下,啟動客戶端或切換節點時,日誌區會看到設定載入、核心啟動與建立本機監聽等資訊。如果日誌持續重複啟動與退出,應先停止切換節點,查看最接近錯誤位置的提示。連接埠被佔用、設定欄位不相容與本機安全軟體阻擋程序是不同問題,不宜用反覆更新訂閱取代問題定位。

在 v2rayNG 中選取並連線節點

回到 v2rayNG 主清單,點選一筆節點紀錄,使其成為目前設定。節點旁的選取狀態應隨之改變。接著點選主介面的連線按鈕;首次建立通道時,系統會要求確認連線權限,允許後等待狀態圖示變為已連線。若客戶端提供測試入口,可先對目前節點執行連線測試,再開啟通道。

連線按鈕顯示開啟,只代表本機通道已建立,不能單獨證明遠端節點可用。因此不要在這裡結束檢查。保持目前活動節點與模式不變,直接進入下一步,透過瀏覽器結果與客戶端日誌交叉確認。若連線後所有網頁都無法存取,先中斷通道,再換用一個通過真實連線測試的節點重新嘗試,避免連續疊加設定變更。

本步完成標誌

至少一個節點已通過真實連線測試並設為活動伺服器,客戶端核心或系統通道處於連線狀態,日誌沒有持續重複相同錯誤。

測試全部失敗時的最短排查順序

先更新一次訂閱,確認節點紀錄確實來自目前啟用的群組;再檢查裝置時間與時區是否正確,因為部分協定握手會受到明顯時間偏差影響;接著完全退出客戶端並重新開啟,只測試一個節點。如果仍然全部失敗,記下錯誤出現的階段與關鍵提示,到FAQ 的故障排查分類比對處理。此時不建議刪除所有設定,保留訂閱與日誌更容易判斷問題發生在哪一層。

第四步

確認瀏覽器流量是否經過代理

最終判斷不依賴按鈕顏色,而是同時查看客戶端狀態、存取結果與出口資訊。驗證期間保持節點與模式不變,避免結果失去可比性。

使用新的瀏覽器視窗進行測試

建立連線後,開啟新的瀏覽器視窗或私密視窗,再造訪常用的 IP 檢測頁面。新視窗可以減少既有連線、快取與擴充功能設定對結果的影響。記下頁面顯示的出口位址與地區,然後中斷客戶端連線並重新整理同一頁面作比較。連線前後結果出現合理變化,且開啟連線時網頁能穩定載入,即表示瀏覽器流量已進入目前的代理鏈路。

不要只用一個長時間開啟的網頁分頁來判斷。瀏覽器可能重複使用舊連線,頁面本身也可能快取先前結果。若檢測頁面顯示沒有變化,先關閉該分頁並建立新視窗,再確認瀏覽器沒有啟用獨立代理擴充功能。獨立擴充功能可能覆寫系統代理,讓 v2rayN 的模式切換看起來沒有作用。

搭配日誌判斷請求是否進入客戶端

保持檢測頁面開啟,在 v2rayN 中觀察日誌區。重新整理網頁時,若日誌出現新的連線紀錄,表示請求已到達客戶端;此時頁面仍無法開啟,應繼續檢查節點握手、DNS 或路由結果。若重新整理頁面時日誌完全沒有變化,應優先檢查系統代理狀態、瀏覽器代理設定,以及目標程式是否遵循系統代理,而不是立即更換協定。

v2rayNG 的判斷方式相近:連線狀態應維持開啟,系統狀態區顯示通道正在運作,重新整理頁面時客戶端日誌或流量狀態會產生變化。若中斷連線後恢復正常、連線後所有請求都失敗,通常表示流量已進入客戶端,但目前節點或設定未能完成出站連線。若連線前後毫無差異,則優先核對目前選取的節點、通道權限與路由模式。

再進行一次實際存取檢查

確認 IP 結果後,再開啟兩到三個平時會使用的網頁,分別檢查首頁載入、圖片資源與後續頁面跳轉。只開啟檢測頁無法涵蓋所有 DNS 與連線情境。實際網頁能連續開啟、客戶端日誌沒有持續報錯,且中斷連線後出口結果恢復原狀,才算完成首次設定。

如果部分網頁正常、部分網頁異常,不要直接歸結為整個客戶端失效。先暫時切換全域模式進行對照:全域模式正常時,檢查規則匹配與 DNS 設定;全域模式仍異常時,換用一個已通過真實連線測試的節點。測試完成後恢復規則模式,確保日常狀態與排查狀態有所區分。

本步完成標誌

新瀏覽器視窗的出口結果與未連線時不同,實際網頁存取正常,客戶端日誌能觀察到對應請求,中斷連線後結果可以恢復。

完成後一次只調整一個變數

基本連線驗證通過後,可以依實際需求設定訂閱自動更新、節點群組、路由規則或 TUN 模式。每次只修改一項主要設定,修改後重複「連線—查看日誌—檢查出口」的驗證流程。即使出現異常,也能快速確認是哪次修改造成,不必重建全部設定。

訂閱群組、伺服器篩選、DNS 路徑、FakeDNS、TUN 模式與自訂出站彼此相關,集中修改容易擴大排查範圍。這些主題已在進階設定手冊中分章說明。協定名稱、核心關係與路由術語可先查閱術語表;遇到明確錯誤提示,則前往FAQ依故障類型定位。

下載v2rayN