SETUP NOTES · 約 10 分鐘

v2rayN 設定教學:訂閱匯入、代理模式、連線與驗證

這份入門流程只處理初次使用時必須完成的四件事:將訂閱寫入用戶端、確認流量處理方式、啟動目前設定,並透過記錄與實際存取結果確認連線狀態。

BEFORE STARTING

開始前:準備用戶端與有效訂閱

設定流程需要兩項條件:用戶端已正確安裝,且訂閱網址仍在有效期內。訂閱由相應服務提供者管理,用戶端只負責讀取其中的伺服器設定並交由核心執行。

桌面裝置使用 v2rayN,Android 裝置使用 v2rayNG。尚未安裝時,可先前往用戶端下載頁,依作業系統與處理器架構選擇對應版本。安裝完成後再回到本頁,不需要預先修改核心檔案,也不需要手動撰寫 JSON 設定。初次啟動可能會出現系統網路或 VPN 權限提示,請先閱讀提示內容,再依目前裝置的安全性設定允許用戶端建立本機代理服務。

訂閱網址通常是一段以 HTTPS 開頭的完整連結。複製時請確認開頭、結尾與查詢參數都沒有遺漏,也不要將連結貼到搜尋框、公開聊天室或其他無關應用程式中。訂閱通常與個人帳戶及服務權限相關,應按照密碼等敏感資訊妥善處理。如果提供者給的是 QR Code,v2rayNG 可以透過訂閱管理或掃描入口讀取;為了讓後續更新更穩定,仍應確認最後儲存的是訂閱項目,而不是只匯入單一臨時節點。

如果用戶端已有舊設定,不必立即刪除。先記下目前使用的訂閱群組與伺服器名稱,再新增訂閱項目,可避免誤刪仍需使用的項目。以下四個步驟依先後順序編排,建議第一次操作時不要跳過中間環節。每完成一步,都先觀察介面回應,再進行下一步。

SUBSCRIPTION

匯入訂閱並取得伺服器清單

訂閱不是連線開關,而是可更新的設定來源。儲存網址後還要主動執行一次更新,伺服器項目才會加入用戶端清單。

在 v2rayN 桌面版新增訂閱

啟動 v2rayN 後,先找到主視窗頂端的「訂閱群組」或「訂閱」選單。不同版本的選單名稱可能略有差異,但都會包含訂閱群組設定與更新操作。進入訂閱群組設定後選擇新增,在備註欄填寫便於辨識的名稱,例如服務名稱或用途;接著將完整訂閱網址貼到網址欄。備註僅供本機辨識,不會改變訂閱內容。

儲存設定後回到主視窗,再次開啟訂閱選單,選擇更新目前訂閱或更新全部訂閱。此時用戶端會請求訂閱內容並解析伺服器設定。更新完成後,主清單應出現數個伺服器項目,常見欄位包括別名、網址、連接埠、傳輸方式與訂閱群組。清單出現內容才表示匯入流程完整結束;只在訂閱設定中看到一行網址,不代表伺服器已更新到本機。

如果更新後清單仍是空的,先重新進入訂閱設定,確認網址首尾沒有空格,並檢查目前選擇的是剛建立的群組。接著查看底部記錄區:網路請求失敗通常會顯示逾時或連線錯誤,格式無法解析則會顯示與訂閱內容相關的提示。此時不要連續重複點選更新,先確認網址是否仍可使用,再執行一次更新。

在 v2rayNG Android 版新增訂閱

開啟 v2rayNG,進入側邊選單中的「訂閱群組設定」。點選右上角新增按鈕,為訂閱填寫名稱並貼上網址,然後儲存。返回伺服器清單後,開啟右上角選單,執行「更新訂閱」。更新期間介面可能會短暫停留在目前清單,完成後會顯示匯入結果,並在伺服器清單中加入相應項目。

如果服務提供者提供 QR Code,可以使用用戶端提供的掃描入口讀取,但要先判斷 QR Code 代表的是訂閱還是單一伺服器。匯入單一伺服器後通常只會形成一筆固定設定,之後不會隨訂閱更新;訂閱項目則可以再次執行更新,接收伺服器調整。對於需要持續維護的設定,儲存訂閱群組通常更合適。

訂閱可能包含多種協定與傳輸設定。入門階段不必逐項修改網址、連接埠、TLS 或傳輸欄位,因為這些值由訂閱統一提供。手動更改其中一個欄位,可能會使設定與伺服器端不一致。需要了解完整 JSON 結構時,可另行閱讀設定大全中的 outbounds 說明;目前流程只需確認項目已可選。

下一步:選擇代理模式 →
PROXY MODE

選擇代理模式與流量範圍

代理模式決定哪些請求交由目前伺服器處理。它與伺服器是否可用是兩個不同問題,初次設定時應先選擇範圍明確且便於觀察的模式。

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

在 v2rayN 中,「系統代理」控制瀏覽器與其他遵循作業系統代理設定的程式,是否將請求傳送給用戶端;「路由模式」則決定請求進入用戶端後,使用代理出站、直連出站或阻斷出站。兩者需要搭配使用,但作用層級不同。只選取伺服器而未開啟系統代理時,一般瀏覽器通常仍會依原本的網路路徑存取;開啟系統代理後,用戶端才會接收這些程式的請求。

初次操作可以在系統匣選單或主視窗中選擇自動設定系統代理,並使用用戶端提供的規則模式。規則模式會依內建或訂閱提供的路由規則決定流量去向,適合日常使用與後續排查。全域模式會將更大範圍的請求交由代理伺服器處理,適合短時間判斷某個存取問題是否由路由規則造成,但不宜視為所有情境的固定答案。需要保持直連的本機網址、區域網路裝置與特定網域,應由路由規則明確處理。

macOS 與 Linux 上的 v2rayN 桌面版同樣需要留意系統代理狀態。由於桌面環境與網路管理元件不同,選單文字或授權提示可能與 Windows 不完全一致。操作時以「系統代理已開啟」的狀態為準,並確認使用中的瀏覽器會讀取系統代理設定。某些擁有獨立代理設定的應用程式不會自動跟隨系統設定,需要在該應用程式內另外選擇使用系統代理。

Android 端確認應用程式代理範圍

v2rayNG 透過系統 VPN 服務接管流量。初次使用時維持預設路由設定通常較容易完成驗證,不必立即啟用複雜的應用程式分流。若啟用應用程式分流,應明確選擇「僅代理所選應用程式」或「繞過所選應用程式」,兩者意思完全相反。清單中若未選取用於驗證的瀏覽器,即使連線按鈕顯示運作中,瀏覽器流量也可能沒有經過用戶端。

如果目前目標只是確認訂閱與伺服器可用,可以暫時關閉應用程式分流限制,讓驗證路徑保持簡單。連線成功後,再依實際需求縮小應用程式範圍。如此可將「伺服器不可用」與「應用程式未納入代理範圍」兩個問題分開,避免初次設定時同時修改過多變數。

選定模式後,不必立即瀏覽大量設定頁面。先回到伺服器清單,準備選擇具體項目並建立連線。若需要設定網域、IP、入站標籤與出站標籤的細部規則,可在基本連線完成後閱讀設定大全中的 routing 章節

下一步:建立連線 →
CONNECT

選定伺服器並建立連線

連線操作包含兩個環節:先指定目前使用的伺服器,再讓用戶端核心與系統代理或 VPN 服務進入運作狀態。

將伺服器設為目前使用項目

在伺服器清單中選擇剛才訂閱群組中的項目。v2rayN 通常可以透過雙擊、右鍵選單或快速操作,將項目設為目前使用的伺服器;成功後,該列會出現選取標記、顏色變化或目前使用狀態提示。v2rayNG 則可直接點選伺服器名稱,被選取的項目通常會在左側顯示選取標記。不要只停留在瀏覽清單的狀態,應確認用戶端已明確指向一項目前使用的設定。

初次選擇不必追求最低延遲。延遲測試只能反映探測當下的連通情況,不能取代實際連線驗證。若用戶端提供測試功能,可以先排除完全逾時的項目,再選擇能夠回傳結果的設定。測試結果為空也不一定等同於無法使用,因為部分網路環境或伺服器設定可能不回應特定探測方式,最後仍應以連線記錄與實際存取結果為準。

啟動桌面版連線

v2rayN 選定伺服器後,確認核心已啟動,並在系統代理選單中選擇前一步確定的代理狀態。主視窗底部或記錄區通常會出現啟動資訊,系統匣圖示與狀態列也會反映目前的系統代理狀態。此時不要立即關閉用戶端程序;關閉視窗若只是最小化至系統匣,連線仍可繼續,而從系統匣選單結束程式則會同時停止本機代理服務。

如果啟動後立刻停止,先查看記錄末尾。連接埠被佔用時,記錄通常會指出監聽失敗;設定欄位不相容時,會出現解析或啟動錯誤;核心檔案無法執行時,則會在啟動階段直接中斷。入門排查應先關閉佔用相同本機連接埠的其他代理程式,再重新啟動 v2rayN,不要直接編輯由訂閱產生的伺服器欄位。

啟動 Android 端連線

在 v2rayNG 中選定伺服器後,點選主介面右下角的連線按鈕。系統首次建立 VPN 服務時會跳出授權對話框,確認後用戶端才有權限建立本機 VPN 介面。連線成功時,按鈕狀態會改變,系統狀態區也會顯示 VPN 連線標記。若點選後按鈕很快恢復為未連線狀態,應開啟用戶端記錄,查看啟動或交握階段的錯誤資訊。

部分 Android 裝置會限制背景應用程式執行。第一次驗證時讓 v2rayNG 保持在前景,先完成網頁存取與記錄檢查,再考慮背景策略。如果前景連線正常,切換到背景一段時間後才中斷,問題更可能與系統電池策略或背景限制有關,而不是訂閱匯入錯誤。

連線圖示只能表示本機服務已啟動,無法單獨證明目標請求成功抵達遠端。因此還需要最後一步驗證。驗證時保持目前伺服器與模式不變,方便發生問題時沿著相同設定路徑檢查。

下一步:驗證是否生效 →
VERIFICATION

透過實際存取與記錄驗證是否生效

有效的驗證需要同時觀察用戶端與應用程式兩端:瀏覽器產生真實請求,用戶端記錄這次請求採用的路由與出站結果。

先進行一次可重複的瀏覽器測試

保持用戶端連線狀態,開啟新的瀏覽器視窗,存取需要透過目前設定驗證的目標頁面。選擇能穩定重複存取的頁面,不要同時開啟多個下載工作或串流頁面,以免大量並行記錄干擾判斷。如果頁面能正常載入,重新整理一次並記下操作時間,然後立即返回用戶端查看記錄。

在 v2rayN 中,記錄區應出現新的連線紀錄,通常可以看到目標網域、目標連接埠、使用的入站與路由至的出站標籤。v2rayNG 的記錄頁面也會在瀏覽器發出請求後增加相應紀錄。只要瀏覽器操作時間與記錄能夠對應,就表示請求已進入用戶端;若瀏覽器有存取動作而記錄完全沒有變化,應優先檢查系統代理、應用程式分流範圍或瀏覽器本身的獨立代理設定。

根據現象定位問題環節

如果記錄出現請求紀錄,但接著顯示連線逾時、交握失敗或遠端關閉,表示流量已進入用戶端,問題更可能位於伺服器設定、網路路徑或系統時間。先執行一次訂閱更新,再換用同一訂閱群組中的另一台伺服器進行比較。涉及 TLS 的設定對系統時間較敏感,應確認裝置日期、時區與時間同步狀態正確。

如果規則模式下頁面無法載入,切換到全域模式後卻恢復,表示伺服器基本可用,差異可能來自路由比對。此時應恢復規則模式,再檢查目標網域被分配到哪個出站,而不是長期停留在全域模式。路由陣列會依順序比對,較寬泛的規則放在前面可能會提前接管請求。完整欄位關係請參閱路由規則參考

如果網域存取失敗,但已知 IP 的連線可以建立,問題可能與 DNS 解析路徑有關。不要在一次排查中同時啟用多套 DNS 方案。先保留用戶端預設設定,記錄錯誤現象,再參照DNS 設定章節逐項檢查本機解析、遠端解析與路由規則之間的關係。

如果所有伺服器都無法啟動,而且記錄在讀取設定時立即報錯,先刪除本次更新產生的異常項目,再重新更新訂閱。若只有一台伺服器失敗而其他項目正常,則不必重新安裝用戶端,應將範圍縮小到該伺服器設定。排查的基本順序是訂閱是否更新、伺服器是否選取、本機服務是否啟動、請求是否進入記錄,以及遠端連線是否成功。

完成驗證後,可以關閉測試頁面並讓用戶端繼續執行。桌面版需要結束時,應先恢復適當的系統代理狀態,再從系統匣選單結束用戶端;Android 端則可透過主介面的連線按鈕主動中斷。如此可避免應用程式已停止而系統仍保留舊代理設定,導致後續瀏覽器存取異常。

查看完成檢查 →
FINAL CHECK

完成檢查與後續閱讀

完成基本設定後,先保留一套能穩定重現的設定,再調整路由、DNS 或應用程式範圍。

01

訂閱可以更新

訂閱群組存在,手動更新後伺服器清單能正常重新整理,且沒有持續的解析錯誤。

02

目前使用伺服器明確

清單中有清楚的選取狀態,切換項目後能判斷目前實際使用的是哪一項設定。

03

代理範圍符合預期

桌面版系統代理與路由模式相互配合,Android 端用於驗證的應用程式位於正確的代理範圍內。

04

記錄對應實際請求

瀏覽器存取會產生新的記錄,能從時間與目標網址判斷請求已進入用戶端。

QUICK RECOVERY

連線失敗時的簡短回退順序

初次設定最常見的問題,通常是操作流程沒有完整走完,而不是需要重寫複雜設定。可以先將設定恢復到容易觀察的狀態:保留一個訂閱群組,選擇其中一台伺服器,關閉額外的應用程式分流限制,使用預設路由模式,然後重新啟動連線。完成這些操作後,只開啟一個瀏覽器頁面進行驗證。

若記錄沒有出現瀏覽器請求,檢查系統代理或 VPN 範圍;若記錄出現請求但遠端連線失敗,更新訂閱並更換同一群組的伺服器;若核心無法啟動,檢查連接埠佔用與啟動錯誤;若只有網域失敗,再單獨檢查 DNS。每次只修改一項並重新測試,才能保留清楚的因果關係。

本頁僅涵蓋基本連線流程。JSON 頂層結構、inbounds、outbounds、routing、dns 與 policy 的系統化說明集中在設定大全,適合在基本連線已建立後繼續閱讀。先完成可用基準,再進行欄位層級調整,通常比初次啟動前同時修改多組參數更容易定位問題。