約 10 分鐘完成

v2rayN 與 v2rayNG 使用教學

從匯入訂閱開始,依序完成代理模式選擇、用戶端連線及結果驗證。本教學只涵蓋首次使用所需的基本操作,設定欄位與複雜路由規則可在後續文件中繼續查閱。

4 個連續步驟 桌面版與 Android 介面說明 包含連線檢查
開始之前

準備用戶端與有效訂閱網址

開始操作前,請先安裝對應平台的用戶端,並準備服務提供方提供的有效訂閱網址。訂閱網址通常是一段以 https:// 開頭的完整連結,用來讓用戶端取得伺服器設定。它與單一 VMess、VLESS 或其他分享連結並非同一概念:訂閱可以包含多組設定,也能由提供方統一更新。

複製網址時,應從開頭到結尾完整選取,不要附帶通訊軟體產生的空格、句號或換行。訂閱連結通常包含存取憑證,應視為私密資訊保存,不要貼到不明網頁或公開內容中。如果目前只有單一分享連結,也可以透過用戶端的「從剪貼簿匯入」功能新增,但本教學以較常見的訂閱匯入流程為主。

首次設定不需要先修改 DNS、路由 JSON 或核心參數。保留預設設定,更容易判斷問題出在訂閱、連線還是網路環境。完成四個基本步驟後,再依實際需求閱讀 術語表設定欄位參考

第一步

匯入訂閱並更新設定清單

先將訂閱網址儲存至用戶端,再主動執行一次更新。成功的判斷標準不是顯示「已儲存」,而是主畫面出現可選取的伺服器設定。

在 v2rayN 桌面版新增訂閱

開啟 v2rayN 後,先查看視窗頂端選單。進入「訂閱分組」或名稱相近的訂閱管理入口,再開啟「訂閱分組設定」。在設定視窗中選擇新增,為這組訂閱填寫容易辨識的備註,例如服務名稱或用途分類,然後將完整訂閱網址貼到網址欄。備註僅供本機辨識,不會改變訂閱內容。

儲存後返回主視窗,再次開啟訂閱選單,執行「更新全部訂閱」,或單獨更新剛才的分組。v2rayN 會讀取訂閱內容,並將設定列在主畫面中。更新期間不要連續重複點選;請先等待狀態列或提示訊息結束。如果清單原本已有設定,更新後可依分組名稱確認新內容是否加入,不要只查看總列數。

如果選單中同時出現「更新訂閱」和「透過代理更新訂閱」,首次操作通常先選擇一般更新。只有在目前網路無法直接存取訂閱網址,但用戶端已有可用連線時,才考慮透過現有代理更新。新安裝狀態尚未建立活動連線,透過代理更新通常無法解決首次匯入問題。

1 訂閱分組設定 新增名稱與網址
2 儲存訂閱分組 返回主視窗
3 更新全部訂閱 等待設定清單重新整理

在 v2rayNG Android 版新增訂閱

開啟 v2rayNG,進入側邊選單中的「訂閱分組設定」。點選新增按鈕後,填寫訂閱名稱與訂閱網址,並儲存目前分組。部分版本會在儲存後直接返回訂閱清單,部分版本仍會停留在編輯頁面;只要新分組已顯示,就能返回主畫面繼續更新。

接著開啟右上角選單,選擇「更新訂閱」。更新完成後,主清單會顯示訂閱中的設定名稱。如果清單仍是空的,請先返回訂閱分組設定,重新開啟剛才儲存的項目,檢查網址開頭、結尾及中間是否有換行。不要在同一個輸入框中連續貼上兩個訂閱網址;需要新增多個來源時,應分別建立訂閱分組,後續更新與排查都會更清楚。

確認第一步是否完成

訂閱更新完成後,至少應看到一組可選取的設定。名稱、地區標籤及排列方式由訂閱提供方決定,用戶端不會自動判斷哪一組最適合目前網路。如果更新提示解析失敗、回應為空或網址無法存取,先不要進入代理模式設定,因為後續步驟都必須依賴有效設定。

此時應先確認連結可以完整複製、訂閱仍在有效期限內,且裝置日期與時間準確,再嘗試切換一次本地網路後重新更新。關於訂閱、節點、分享連結及協定之間的差異,可查看 訂閱與節點術語。確認清單已出現設定後,再繼續選擇代理模式。

第二步

選擇代理模式與基本路由

代理模式決定哪些應用程式會將流量交給用戶端,路由規則則決定流量進入核心後使用哪個出站。首次連線請先採用簡單且容易判斷的組合。

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

在 v2rayN 中,「系統代理」與「路由模式」屬於兩個層次。系統代理會通知瀏覽器及遵循系統代理設定的應用程式,將請求傳送至 v2rayN 的本機監聽連接埠;路由模式則由核心依據網域、IP 或規則集,決定請求使用代理出站、直接連線出站,或予以阻擋。只調整路由,卻沒有讓應用程式使用本機代理時,瀏覽器仍可能依原本的網路路徑存取。

首次使用建議在 v2rayN 系統匣選單或主畫面的系統代理選單中,選擇「自動設定系統代理」,或選擇目前版本中意義相同的啟用選項。接著在路由設定中採用用戶端提供的預設規則模式。這樣既能讓常用瀏覽器接入用戶端,也能保留預設分流邏輯,方便完成基本驗證。

全域模式會將更多請求交給同一個代理出站,適合短時間判斷規則是否造成存取差異,但不建議將它作為排查所有問題的第一選擇。如果規則模式下某個網址無法存取,而全域模式可以存取,問題較可能出在路由匹配;如果兩種模式都失敗,則應回頭檢查活動設定、訂閱有效性及本地網路。

v2rayNG 中的模式選擇

v2rayNG 建立的是裝置層級的連線通道,主畫面中的路由設定會決定請求如何分流。首次設定可以保留預設規則,不必立即匯入自訂規則檔案。如果設定頁中有「分應用程式代理」,請先保持關閉,避免待測試的應用程式因未被選取而繞過用戶端。完成基本連線驗證後,再依實際用途設定應用程式範圍。

不同版本對預設模式的命名可能略有不同,判斷時應查看說明,不要只看名稱:規則模式會依網域和 IP 條件選擇出站,全域模式會讓大部分請求使用活動代理設定,直連模式則主要用於暫停代理路徑。此處選擇規則模式後返回主畫面,不需要反覆切換。

規則模式

依照用戶端預設的網域與 IP 規則進行分流,適合作為日常基本設定。

全域模式

讓更多請求使用活動代理出站,可用於短時間對照路由結果。

直連模式

請求主要使用本地網路路徑,通常不適合用來驗證代理連線。

暫時保留預設監聽連接埠

v2rayN 通常會設定本機 HTTP、SOCKS 或混合監聽連接埠。首次連線不必修改預設連接埠,也不要讓另一個同類型用戶端同時佔用相同連接埠。如果啟動核心時明確提示連接埠已被佔用,請先退出其他正在執行的代理用戶端,再重新啟動 v2rayN。確實需要並行執行時,再到設定中更換本機監聽連接埠,並同步修改曾手動設定代理網址的應用程式。

路由中的 domainipgeosite 與規則優先順序屬於進階設定。此時只需知道規則通常會依既定順序匹配,越早符合的規則越先決定出站。詳細欄位與 JSON 範例可繼續閱讀 路由設定欄位,不必在首次連線階段修改。

第三步

選擇活動設定並建立連線

從訂閱清單選定一組設定,設為目前活動項目,再啟動核心或裝置連線。連線狀態與代理模式需要同時成立。

在 v2rayN 中設為活動伺服器

返回 v2rayN 主清單,點選一組來自剛才訂閱分組的設定。可以按 Enter 鍵,或透過右鍵選單選擇「設為活動伺服器」。活動項目通常會以顏色、粗體、標記或狀態列文字顯示,具體形式會隨版本變化。重點是狀態區域已顯示目前設定名稱,而不只是清單中的選取反白。

設為活動伺服器後,查看視窗底部的狀態列或記錄區域。核心正常啟動時,通常會顯示啟動完成、本機監聽已建立或目前設定已載入等訊息。如果剛才已開啟系統代理,瀏覽器等遵循系統設定的應用程式會開始將請求傳送給 v2rayN。若系統代理仍處於關閉狀態,核心即使正在執行,瀏覽器的存取結果也不會因此自動改變。

v2rayN 關閉主視窗後,可能仍會駐留在系統匣中。需要暫停時,應從系統匣選單清除系統代理或退出用戶端,不要只根據主視窗是否可見來判斷執行狀態。重新開啟視窗後,也應先查看目前活動設定與系統代理狀態,再決定是否重新啟動。

在 v2rayNG 中啟動連線

在 v2rayNG 主清單中點選一組設定,使其成為目前選取項目。接著點選主畫面下方的連線按鈕。首次建立裝置連線時,系統會顯示連線授權視窗;確認授權後,按鈕狀態會改變,系統狀態區域也會出現連線標示。授權只允許用戶端建立連線通道,不會取代訂閱設定本身。

如果點選連線後立即恢復為未連線狀態,請先開啟記錄查看最後幾行錯誤。常見方向包括設定欄位無法解析、伺服器網址無法解析、網路連線逾時或系統時間偏差。不要連續快速點選連線按鈕,因為上一輪核心可能仍在退出;請等待數秒,確認狀態穩定後再重試。

連線前的四項確認

  1. 已選取設定:主畫面能辨識目前活動設定,不只是存在一組尚未選取的清單。
  2. 訂閱剛完成更新:設定來自目前有效的訂閱,更新過程中沒有解析錯誤。
  3. 已選擇模式:桌面版系統代理與用戶端路由狀態符合第二步的設定。
  4. 核心正在執行:狀態列或系統連線標示維持啟用,沒有立即退出。

如何處理單一設定連線失敗

一組設定連線失敗時,不要立即刪除整個訂閱。先在同一訂閱分組中切換另一組設定,再執行相同的連線操作。如果其他設定可以建立連線,表示用戶端基本設定大致正常,問題較可能集中在原設定的可用狀態或網路路徑。如果同一分組中的所有設定都失敗,則應重新更新訂閱,並確認本地網路是否能正常存取訂閱網址。

用戶端記錄是判斷問題階段的主要依據。包含「解析」、「連線逾時」、「拒絕連線」、「連接埠被佔用」等資訊的記錄,對應的排查方向各不相同。首次使用時只需記下錯誤發生在啟動前還是連線後,不需要立即編輯完整 JSON。複雜記錄與入站、出站欄位的對應關係,可在 入站設定出站設定 中繼續查詢。

第四步

驗證代理是否真正生效

最後檢查分為用戶端狀態、應用程式存取及記錄三個層面。三者互相印證,可避免將「核心已啟動」誤認為「應用程式已使用代理」。

先檢查用戶端狀態

在 v2rayN 中確認狀態列仍顯示活動設定、核心沒有停止,且系統代理仍維持第二步選擇的啟用狀態。接著查看記錄末尾,正常執行時可能會出現請求記錄或連線建立資訊,但不應持續重複同一則錯誤。偶爾一組連線失敗不一定代表整體無法使用,因為頁面可能同時請求多項資源;應留意錯誤是否持續出現,以及瀏覽器存取是否同步失敗。

在 v2rayNG 中確認連線按鈕維持啟動狀態,系統連線標示沒有消失。開啟記錄時,先記住開始測試的時間,再切換到瀏覽器發起一次存取,接著返回記錄查看是否出現對應的新記錄。這比翻看啟動前的舊記錄更容易判斷目前請求是否進入用戶端。

使用瀏覽器完成一次實際存取

開啟常用瀏覽器,建立無痕視窗,或關閉舊頁面後重新開啟一個熟悉的網站。使用新視窗可以減少快取、既有連線及瀏覽器擴充功能對結果的干擾。如果頁面能正常載入,再開啟另一個不同網域的頁面進行對照,避免單一網站本身故障造成誤判。

桌面版若用戶端顯示正在執行,但瀏覽器沒有任何變化,請檢查瀏覽器是否使用獨立代理設定。部分瀏覽器或擴充功能會覆寫系統代理,此時應暫時關閉衝突設定,或將瀏覽器恢復為「使用系統代理」。v2rayNG 若只有部分應用程式沒有變化,請返回設定確認是否啟用了分應用程式代理,以及目標應用程式是否包含在選取範圍內。

依序定位驗證失敗原因

驗證失敗時,請從最短路徑開始,不要同時修改多個參數。第一,重新確認目前活動設定;第二,更新訂閱並更換一組設定;第三,檢查系統代理或裝置連線是否仍然開啟;第四,切換本地網路後再試。每次修改後都重複相同的瀏覽器測試,才能知道是哪個項目造成變化。

如果瀏覽器完全無法開啟任何頁面,可以先清除 v2rayN 系統代理或停止 v2rayNG 連線,確認本地網路本身是否正常。基本網路恢復後,再重新連線用戶端。如果直連正常、連線後全部失敗,應重點查看活動設定、核心記錄及 DNS 錯誤;如果只有特定網域異常,則較可能與路由規則或 DNS 分流有關。

DNS 問題通常表現為網域無法解析,但直接連線某些已知網址時仍能建立路徑。首次教學不建議直接替換完整 DNS 設定,可以先重新啟動用戶端、更換一組設定並重新測試。問題持續存在時,再閱讀 DNS 設定欄位,了解伺服器清單、網域匹配及查詢策略之間的關係。

完成標準

以下狀態同時成立,即可結束首次設定

  • 訂閱分組能正常更新,主清單中存在可選取的設定。
  • 用戶端保持連線,核心記錄沒有持續重複的啟動錯誤。
  • 桌面瀏覽器已使用系統代理,或 Android 應用程式的請求已進入連線通道。
  • 至少兩個不同網域的頁面能依目前路由模式正常載入。

完成後的日常使用方式

日常啟動通常不需要重新匯入訂閱。開啟用戶端後先更新訂閱、確認活動設定,再啟用系統代理或裝置連線即可。服務提供方調整設定後,用戶端只有執行訂閱更新才能取得新內容;單純重新啟動核心不會自動替換舊訂閱資料,除非設定中已明確啟用啟動時更新。

需要暫停時,v2rayN 應先清除系統代理,再退出用戶端;v2rayNG 則可直接停止目前連線。更換訂閱時,建議新增獨立分組,確認新分組可以更新並建立連線後,再決定是否刪除舊分組。這樣能保留清楚的復原路徑,也方便判斷問題來自哪個訂閱來源。

到這裡已完成基本設定。協定含義、用戶端與核心的關係可從 V2Ray 術語表 查詢;需要編寫入站、出站、路由、DNS 或策略欄位時,再進入 設定檔參考。待基本連線穩定運作後再修改進階欄位,排查路徑會更短。

繼續查看用戶端設定

完成基本連線後,可依需求查詢協定術語、路由規則與 DNS 欄位,不必一次修改所有設定。