10 MIN QUICKSTART

V2Ray 用戶端 10 分鐘快速設定

依固定順序完成匯入訂閱、選擇代理模式、建立連線、驗證生效。本頁聚焦首次設定,不展開核心參數與複雜路由規則。

BEFORE START

開始前確認三項內容

準備工作只包含用戶端、有效的訂閱網址與正確的系統時間。先確認基礎條件,可避免在後續步驟中反覆退回。

平台介面提示

v2rayN 桌面端通常透過頂端選單、伺服器清單與系統匣選單完成操作;v2rayNG Android 端主要使用側邊選單、右上角操作按鈕與底部連線按鈕。兩者的選單位置不同,但設定順序一致:先儲存訂閱,再更新設定,接著選擇模式並連線。

開始前先確認已安裝對應用戶端。Windows、macOS 與 Linux 桌面環境使用 v2rayN,Android 裝置使用 v2rayNG。本教學不要求手動撰寫完整核心設定,也不要求先理解所有協定欄位。訂閱服務會將伺服器網址、連接埠、傳輸方式與驗證資訊整理成用戶端可讀取的設定,首次使用只需確保訂閱網址完整且仍在有效期限內。

第二項是檢查裝置時間。連線驗證與 TLS 交握依賴正確的日期、時間與時區。若系統時間偏差明顯,用戶端可能顯示伺服器清單可更新,但連線時持續逾時或交握失敗。建議開啟系統自動設定日期與時區,再完全結束用戶端後重新開啟。網路本身也必須能存取訂閱網址;若瀏覽器直接開啟訂閱網址就顯示過期、拒絕存取或伺服器錯誤,應先向訂閱提供者處理,而不是反覆修改用戶端。

第三項是保留清楚的回復路徑。首次設定時先不要同時修改自訂 DNS、複雜路由規則、TUN 參數與系統防火牆。變數越少,越容易定位問題。先依預設設定完成一次連線驗證,確認基礎鏈路正常後,再依用途調整分流與 DNS。協定、傳輸層、TLS、訂閱群組等名詞可在概念速查中查閱;系統化的故障分析則放在疑難手冊中。

SUBSCRIPTION

匯入訂閱並更新伺服器清單

此階段的完成標誌不是網址已儲存,而是用戶端主清單中已出現可選擇的伺服器設定。

v2rayN 桌面端操作

開啟 v2rayN 後,先找到「訂閱群組」選單,再進入「訂閱群組設定」。不同版本的選單排列可能略有差異,但設定視窗中都會提供新增群組、填寫別名與填寫訂閱網址的區域。建立一個新群組,名稱可依用途填寫,例如「日常設定」或「備用設定」;名稱只用於本機辨識,不會參與連線。接著將訂閱網址完整貼到網址欄,注意不要連同聊天軟體或文件中的前後空格一起複製。

儲存群組後,設定視窗關閉並不代表伺服器已匯入。回到主介面,再次開啟「訂閱群組」選單,執行「更新全部訂閱」,或更新剛建立的群組。更新過程中,用戶端會請求訂閱內容並解析設定。正常情況下,完成後主清單會出現數個伺服器項目,通常可看到別名、網址、連接埠或協定類型等欄位。此時先不要急著逐一測試延遲,只要確認清單不是空白,就能繼續下一步。

如果儲存後完全看不到新增群組,先重新進入訂閱群組設定,確認剛才的紀錄確實存在。如果群組存在,但更新後清單仍為空白,請重點查看用戶端底部狀態資訊或記錄視窗。常見原因包括訂閱網址複製不完整、訂閱已失效、目前網路無法存取訂閱介面,或伺服器回傳的內容不是用戶端可辨識的格式。不要連續快速點擊更新;先讀清楚一次更新產生的提示,再依提示處理。

v2rayNG Android 端操作

開啟 v2rayNG,進入側邊選單中的「訂閱群組設定」。點擊新增按鈕後填寫群組名稱與訂閱網址,然後儲存。返回主介面後,從右上角選單執行「更新訂閱」。部分介面會要求先選取訂閱群組,再開始更新;若已建立多個群組,應確認目前操作對應剛新增的項目。更新結束後,主介面應出現伺服器設定清單,而不是只顯示空白頁面。

Android 系統可能限制應用程式在背景持續連網。首次更新時建議讓 v2rayNG 保持在前景,等提示結束後再切換應用程式。如果更新過程被系統中斷,可以重新開啟用戶端執行一次更新。只要伺服器清單已正常出現,就不需要重複匯入同一個網址;重複建立多個內容相同的群組,會讓後續選取設定與排查變得混亂。

看到什麼才算完成

完成此步驟後,用戶端主清單至少應出現一項可選擇的設定,且更新操作沒有持續顯示解析錯誤。伺服器名稱是否容易理解不影響後續操作;關鍵是設定已進入用戶端。下一步要處理的是「哪些流量交由用戶端處理」,因此先不要變更清單,也不要同時修改每項設定的底層參數。

subscription-group
群組名稱
日常設定
訂閱網址
https://example.invalid/sub
儲存後操作
更新全部訂閱
完成狀態
主清單出現伺服器設定
下一步:選擇代理模式 →

PROXY MODE

選擇代理模式與流量範圍

伺服器設定決定連線到哪裡,代理模式決定哪些流量進入用戶端。這是兩個獨立設定,不能只選伺服器而忽略系統代理或連線模式。

先區分路由模式與系統代理

v2rayN 桌面端常見的兩個設定是「路由模式」與「系統代理」。路由模式負責判斷進入核心後的流量應代理、直連或阻擋;系統代理則讓瀏覽器及其他遵循系統設定的應用程式將請求傳送給 v2rayN。只修改路由模式卻未開啟系統代理,瀏覽器流量可能根本沒有進入用戶端。只開啟系統代理卻選錯活動伺服器,也可能看到本機代理已啟動,但外部連線始終失敗。

首次設定建議使用用戶端提供的按規則分流模式。此模式會依內建規則判斷流量方向,適合先驗證一般瀏覽是否正常。全域代理會讓更多請求統一透過目前設定,方便判斷某些分流規則是否造成誤判,但在尚未確認基礎連線前,不建議長期使用。直連模式主要用於暫時停用代理路徑;若誤選直連,即使用戶端程序正在執行,目標請求也不會經由所選伺服器。

在 v2rayN 中,先從路由設定或系統匣選單選擇按規則分流,再將系統代理切換為「自動設定系統代理」,或目前版本中意思相同的啟用項目。切換成功後,系統匣圖示或狀態列通常會顯示系統代理已開啟。此時尚未完成連線,因為活動伺服器仍未確定;但流量入口已準備就緒,可以進入下一步選取具體設定。

v2rayNG 的模式選擇

v2rayNG 透過 Android 系統提供的連線介面接管裝置流量,因此操作重點是應用程式內的路由設定與連線開關。首次使用可保留預設路由設定,先完成基礎驗證。點擊連線按鈕時,系統可能跳出連線授權提示,確認後用戶端才能建立本機介面。此授權只代表允許 v2rayNG 處理裝置流量,不代表遠端伺服器已連通,最終仍要結合連線狀態與實際存取結果判斷。

如果應用程式提供「繞過區域網路」、「依網域規則」或預設路由選項,第一次設定不要同時勾選多組互相重疊的規則。預設規則能減少變數。等連線驗證成功後,再依實際需求調整直連範圍。關於 domain、ip、geosite、geoip 等規則物件的含義,可先查看路由與分流術語;複雜規則衝突與 DNS 分流不屬於本頁的快速流程,統一交由疑難手冊處理。

本步驟的結束狀態

桌面端應處於按規則分流且系統代理已啟用的狀態;Android 端應保留明確的路由模式,並準備在下一步確認連線授權。此時不要同時開啟其他代理用戶端,因為多個程式可能爭用同一個系統代理設定或本機連接埠。關閉不參與本次測試的同類程式後,再繼續選擇活動伺服器。

routing-mode
按規則分流 首次設定建議
全域代理 用於對照排查規則
直連 流量不經過活動設定
下一步:選擇設定並連線 →

CONNECT

選擇活動設定並建立連線

此階段只做兩件事:從訂閱清單中確定一項活動設定,然後啟動用戶端的連線入口。

桌面端選擇活動伺服器

回到 v2rayN 的伺服器清單,點擊準備使用的設定,再透過右鍵選單選擇「設為活動伺服器」,也可以使用目前版本提供的快速操作。活動設定通常會以顏色、圖示、字型變化或狀態列文字標示。不要只因清單中某一列被滑鼠選取,就判斷它已生效;滑鼠選取代表介面焦點,活動伺服器才是核心真正讀取的目標。

首次選擇時不必反覆執行所有伺服器測試。測試結果會受目前網路、伺服器回應方式與測試目標影響,只能作為輔助資訊。可以先選擇訂閱提供者標註為一般用途的一項設定,設為活動伺服器後觀察用戶端底部狀態。接著確認系統代理仍處於啟用狀態。如果剛才切換模式時用戶端重新載入設定,請等待狀態穩定後再開啟瀏覽器。

正常情況下,v2rayN 會在背景啟動所選核心,並監聽本機代理連接埠。記錄中通常可看到設定載入、入站監聽與執行啟動相關資訊。這裡不需要手動修改連接埠,只要記錄沒有提示連接埠被占用或設定解析失敗即可。如果發生連接埠占用,先完全結束其他同類用戶端,再重新啟動 v2rayN;不要在不了解用途時連續修改多個本機連接埠。

Android 端啟動連線

在 v2rayNG 主清單中點擊準備使用的伺服器設定,使其成為目前設定。介面通常會以選取標記指出活動項目。然後點擊底部連線按鈕。首次啟動時,Android 系統可能顯示連線請求,確認後狀態列會出現系統連線標記,v2rayNG 的底部按鈕也會變為已連線狀態。若拒絕授權,應用程式無法接管裝置流量,需要再次點擊連線並完成確認。

連線按鈕變為啟動狀態,只代表本機連線介面已建立,不能單獨證明遠端伺服器可用。讓 v2rayNG 保持在前景數秒,查看是否立即出現設定錯誤、交握失敗或持續逾時。若沒有明顯錯誤,再進入下一步以實際存取進行驗證。測試期間避免頻繁在多個伺服器間快速切換,每次切換後都要給用戶端時間重新載入設定並建立連線。

連線時出現錯誤怎麼辦

如果記錄明確顯示設定解析失敗,通常表示訂閱中的某項設定欄位與目前用戶端或核心不相容。先更新一次用戶端訂閱,再改用同一訂閱中的另一項設定測試。如果每項設定都顯示相同錯誤,記下錯誤發生階段與關鍵字,接著查閱疑難手冊中的用戶端與設定章節。如果表現為連線逾時,先切換網路或選擇另一項設定進行交叉驗證,不要立即修改 DNS 與路由。

進入驗證前的檢查點

v2rayN 應已標記活動伺服器,系統代理處於啟用狀態,記錄沒有持續顯示啟動失敗;v2rayNG 應已選取設定,並顯示連線已啟動。符合這些條件後,用戶端端的準備工作就完成了。接下來不要繼續盯著按鈕狀態,而要透過新的瀏覽器連線與記錄變化,確認請求是否真的經過用戶端。

connection-state
  1. 活動設定 已選取
  2. 本機代理 已啟動
  3. 路由模式 按規則
  4. 下一項 實際存取驗證
下一步:驗證連線是否生效 →

VERIFY

驗證代理是否真正生效

驗證時要同時觀察實際存取與用戶端記錄。只看連線圖示、測試延遲或本機連接埠,都不足以確認完整鏈路。

使用新的瀏覽器工作階段測試

先關閉先前一直開啟的測試頁面,再建立新的瀏覽器分頁,造訪一個需要經過代理規則的一般網站。重新開啟頁面可減少瀏覽器快取、既有連線與 DNS 快取對判斷的影響。如果頁面能正常載入,繼續點擊站內另一個連結,確認不是只讀取了本機快取。桌面端還應測試一個一般直連網站,確認按規則分流下兩類存取都能正常運作。

如果瀏覽器仍顯示舊的網路狀態,請完全結束瀏覽器後重新開啟。部分瀏覽器會保留已建立的長連線,系統代理在建立連線後變更時,舊連線未必會立即切換。桌面應用程式是否遵循系統代理取決於應用程式本身的實作,因此首次驗證優先使用瀏覽器,不要以代理機制不明確的軟體作為唯一判斷依據。

同時觀察用戶端記錄

發起存取時查看 v2rayN 或 v2rayNG 的記錄區域。如果記錄隨頁面請求新增,表示流量已進入用戶端。此時頁面仍無法開啟,問題範圍通常在遠端設定、路由匹配、DNS 解析或目前網路鏈路。如果記錄完全沒有變化,則更可能是系統代理未生效、Android 連線未啟動,或測試應用程式沒有使用目前的代理入口。

記錄中的「建立連線」與「請求進入」應結合頁面結果理解。出現請求紀錄但持續逾時時,先改用訂閱中的另一項設定;更換設定後立即恢復,表示原活動設定暫時不可用。所有設定都逾時時,再切換裝置目前的網路進行對照。如果只有某一類網域失敗,而其他存取正常,則應將注意力轉向 DNS 或路由規則,而不是重新安裝用戶端。

檢查桌面端系統代理狀態

v2rayN 顯示執行中但瀏覽器完全沒有記錄時,回到系統匣選單檢查系統代理是否仍為啟用狀態。某些系統網路切換、用戶端異常結束或其他網路工具啟動後,系統代理設定可能被覆蓋。重新啟用系統代理,然後完全關閉並重新開啟瀏覽器測試。若系統代理啟用後很快又被變更,應檢查是否有其他程式正在管理同一項系統設定。

檢查 Android 端連線狀態

在 v2rayNG 中先確認底部按鈕處於連線狀態,再查看系統狀態列是否有對應的連線標記。如果切換到背景後連線很快停止,請檢查 Android 系統對 v2rayNG 的電池與背景執行限制。快速測試時先讓應用程式保持在前景,完成網頁存取後再處理背景常駐問題。若只有行動網路或只有 Wi-Fi 失敗,可以在兩種網路間切換一次,透過對照結果判斷問題是否與目前網路有關。

完成後再進行個人化調整

確認基礎連線正常後,可以依需求開啟訂閱定期更新、調整路由規則或設定特定 DNS。每次只修改一個類別,並在修改後重複本節的存取與記錄驗證。如此一旦出現問題,就能明確知道是哪項變更造成,而不是面對一組同時改變的參數。需要長期維護多個訂閱、複雜分流、TUN 模式或 DNS 策略時,請繼續閱讀疑難手冊,不要在首次設定階段一次啟用所有進階選項。

verification-path
  • 1 建立新分頁存取 排除舊連線與頁面快取
  • 2 觀察用戶端記錄 確認請求進入本機代理
  • 3 更換設定進行對照 區分單項設定與全域問題
  • 4 檢查分流結果 確認代理與直連均符合預期

BASIC CHECK

首次設定的基礎排查順序

不要隨意切換所有開關。依現象縮小範圍,通常比重新安裝或反覆匯入更快。

A

訂閱更新失敗

重新進入訂閱設定,檢查網址是否完整、是否多出空格,並確認系統時間正確。接著使用目前網路直接存取訂閱網址。如果伺服器回傳過期或拒絕訊息,應先處理訂閱狀態;如果只有用戶端請求失敗,再查看記錄中的網路與憑證提示。

B

顯示已連線但網頁無法開啟

先觀察存取網頁時記錄是否產生新項目。沒有紀錄就檢查桌面系統代理或 Android 連線狀態;有紀錄但逾時就更換活動設定。更換設定後仍相同,再切換目前網路進行對照,最後才檢查 DNS 與路由。

C

只有部分網站異常

這通常表示基礎鏈路已正常運作,問題更可能來自路由匹配、網域解析或網站本身的狀態。先將路由恢復為用戶端預設規則進行對照,再查看記錄中該網域命中的出站方向。不要因為單一網站異常就刪除所有訂閱。

D

切換伺服器後沒有變化

確認所選項目已設為活動設定,而不只是取得介面焦點。切換後等待核心重新載入,並重新開啟瀏覽器連線。Android 端應先停止舊連線、選取目標設定,再重新啟動;桌面端查看狀態列中的活動伺服器名稱。