v2rayN / v2rayNG · 初次設定

匯入訂閱與代理連線
四步使用指南

已經安裝好用戶端了嗎?接著依序完成「匯入訂閱 → 選擇代理模式 → 連線 → 測試」。預留約十分鐘,先讓一個節點和一款瀏覽器正常運作,再設定分流及其他應用程式。尚未安裝的話,請先前往下載頁選擇用戶端;安裝與權限設定細節請參閱完整文件。

01 匯入訂閱:新增網址,再更新群組

先準備好服務提供者提供的訂閱網址。訂閱通常是一個供用戶端讀取的連結,可能包含帳戶識別資訊;它不是帳戶登入頁,也不是購買紀錄頁。複製時盡量使用服務提供者的「複製訂閱」按鈕,避免漏掉網址末尾的參數,或一併複製前後的說明文字。不要將完整訂閱網址貼到公開論壇、截圖或共用文件中;後續排查時只要描述錯誤,不必公開網址。

桌面版 v2rayN:儲存群組不代表已完成匯入

開啟主視窗,在「訂閱群組」選單中進入「訂閱群組設定」,新增群組。名稱可填寫方便辨識的來源名稱,再將剛才複製的連結貼到訂閱網址欄位;不確定的其他選項先保留預設值。儲存並返回主畫面後,再開啟「訂閱群組」,選擇「更新訂閱(不透過代理)」。這時才會取得訂閱內容,並將其中的伺服器設定加入清單。

更新完成後,確認主畫面的群組篩選器已選取剛建立的群組。清單中出現伺服器項目,表示用戶端已讀取設定,但不代表這些伺服器一定能連線。如果顯示更新成功卻看不到項目,先切換到對應群組或所有群組,並清除搜尋欄中的篩選條件;不要急著重複新增同名訂閱,以免之後難以判斷目前使用的是哪一組。

如果更新逾時,先確認裝置本身能正常連上網路,再檢查訂閱網址是否有效、帳戶服務是否到期。只有在已有正常運作的代理連線時,才嘗試「更新訂閱(透過代理)」。初次設定時尚無可用連線,選擇透過代理可能導致更新要求卡在尚未建立的通道中。若解析失敗,優先確認連結格式與用戶端相容性;網頁能開啟,不代表網頁內容就是有效的訂閱。

Android 版 v2rayNG:新增群組後返回清單更新

在 v2rayNG 側邊選單中開啟「訂閱群組設定」,點選新增按鈕並填寫備註與訂閱網址,儲存後返回主畫面,再從選單選擇「更新訂閱」。確認設定清單中出現項目,並點選準備使用的項目。透過掃描 QR Code 或剪貼簿匯入單一設定,與訂閱群組是不同的操作入口;只有單一設定時,不會自動取得整組訂閱的後續更新。

進行下一步前,先確認要使用哪個群組及哪台伺服器。此時先不要修改傳輸協定、連接埠或加密相關欄位;訂閱提供的參數通常應整組保留。自行修改其中一項,很容易讓原本網址正確的設定變成無法完成交握。訂閱管理的詳細說明可稍後參閱完整文件的通用準備章節,現在先完成代理模式設定。

02 選擇代理模式:分清流量接管方式與路由

用戶端常見的兩類設定,處理的是不同問題。「系統代理」或 TUN 決定應用程式流量如何進入用戶端;「繞過中國大陸」、「黑名單」、「全域」等路由選項,則決定流量進入後要直連還是走代理。開啟系統代理不代表所有程式都會經過用戶端;選擇全域路由,也不會自動改變忽略系統代理的程式之連線方式。初次使用時先分清這兩個層面,之後排查問題會容易許多。

桌面版先選擇「自動設定系統代理」

在 v2rayN 系統匣圖示上開啟選單,找到「系統代理」,選擇「自動設定系統代理」。這會將系統代理入口指向用戶端的本機監聽位址。讓 v2rayN 保持執行,並暫時關閉瀏覽器中另行設定的代理擴充功能,讓測試用瀏覽器使用系統代理,避免兩套規則互相覆蓋。部分瀏覽器或桌面環境需要在網路設定中明確選擇使用系統代理。

同一選單中的「清除系統代理」會移除系統代理設定,適合停止使用時還原;「不變更系統代理」則代表用戶端不主動修改現有系統設定,並不表示先前的代理位址已清除。請先記住兩者的差異:如果系統仍指向某個本機連接埠,而對應程式已經關閉,瀏覽器可能會直接顯示代理連線錯誤。

路由先保留用戶端目前的預設值,並記下預設名稱。使用「繞過中國大陸」時,部分目標直接連線是預期結果;使用「全域」時,也應配合實際規則確認是否有本機位址等例外情況。為方便判斷,可在測試階段短暫切換預設值進行比較,但每次只修改一項設定。不要同時更換伺服器、路由與 DNS,否則即使連線恢復,也很難確認是哪項設定生效。

視需要啟用 TUN;Android 版需允許 VPN 要求

如果瀏覽器已能正常運作,但遊戲、命令列工具等應用程式沒有使用系統代理,再考慮啟用 TUN。先完成本頁的瀏覽器測試,再依照完整文件設定虛擬網路介面權限、路由與 DNS。初次測試時不要同時啟用多個流量接管工具;若 TUN 啟動失敗,先將它關閉並查看記錄檔,不要反覆勾選碰運氣。需要切換接管方式時,也要確認原有系統代理是否保留。

Android 版 v2rayNG 透過系統 VPN 服務處理流量,首次點選連線時會跳出系統連線要求;確認應用程式名稱後允許即可。如果裝置上已有其他 VPN 正在連線,請先停止另一項服務,再返回 v2rayNG。若設定過「依應用程式代理」,也要確認測試用瀏覽器在預期範圍內。VPN 圖示只表示本機的流量接管服務已啟動,不能單獨證明遠端伺服器可連線;下一步還要檢查啟動結果。

03 連線:設為作用中伺服器,確認核心已啟動

準備好訂閱與模式後,返回伺服器清單。先選擇訂閱中一個明確可用的項目,不必一開始就測試整組伺服器。選取某一列通常只表示介面焦點停在該處;還要透過「設為作用中伺服器」或相應的選取狀態,確認要用來連線的設定。若項目名稱相近,請依群組與備註判斷,避免誤用舊訂閱中已失效的設定。

v2rayN:確認作用中項目與啟動記錄

在目標項目上開啟右鍵選單,選擇「設為作用中伺服器」。用戶端會依該設定載入或重新啟動核心;如果目前已有連線,也可能短暫中斷。接著查看主視窗中的目前伺服器提示或作用中標記,再開啟記錄區,檢查是否出現啟動失敗、設定解析失敗或連接埠遭占用等錯誤。不要把「視窗能開啟」當成「核心已執行」;圖形介面與實際處理連線的核心是不同環節。

如果記錄檔顯示本機連接埠遭占用,先確認是否重複啟動用戶端,或仍有其他代理軟體正在執行。關閉重複執行的程式後再試,比任意修改一連串連接埠更容易恢復正常。若確實需要調整監聽連接埠,也要同步更新系統代理或應用程式的手動代理設定。若顯示權限不足,請依照對應平台的權限流程處理,尤其是 TUN 相關錯誤;只是要測試一般系統代理時,不要直接擴大整個應用程式的權限。

部分版本在切換作用中伺服器後會自動載入設定,不需要另外尋找通用的「連線」按鈕。此時讓用戶端持續執行即可,最小化至系統匣通常不影響運作。暫時不要啟用開機啟動或背景自動啟動,先確認手動連線正常。若啟用了多種核心選項,請保留與該設定相符的用戶端選項;協定與核心的相容性細節可參閱核心說明。

v2rayNG:選取設定後點選連線按鈕

在主畫面點選目標設定,確認選取標記位於正確項目,再點選連線按鈕。首次啟動時須允許系統 VPN 連線要求,之後查看按鈕狀態與系統狀態列提示。如果允許要求後服務立即停止,請開啟應用程式記錄檔查看原因,優先排查設定格式、服務啟動與系統權限;若應用程式持續執行但目標網頁無法開啟,留待下一步判斷路由與遠端連線,不要先重新授予所有權限。

Android 系統的省電策略可能在螢幕鎖定後限制背景服務。先在螢幕亮起時完成測試,確認連線正常後,再依系統設定允許應用程式必要的背景執行,並避免使用清理程式結束服務。桌面裝置進入睡眠、切換網路,以及 Android 從 Wi-Fi 切換到行動數據,也可能中斷原有連線;必要時重新連線即可。到這一步,用戶端應已能接收應用程式的要求,接著透過實際瀏覽確認整條連線路徑。

04 確認是否生效:查看瀏覽結果與記錄檔

測試時要確認三件事:裝置原本的網路是否正常、測試應用程式是否將流量送進用戶端,以及目標要求是否依預期送往遠端。顯示「已連線」的圖示只能說明部分狀態,測得一次延遲也不代表整個網頁都能載入。使用同一個瀏覽器與同一組目標連續檢查,會比不斷更換應用程式更容易比較結果。

先測試一般網頁,再確認預期會走代理的目標

先開啟平常可正常瀏覽的網頁,確認新設定沒有影響基本網路連線;接著前往明確預期會經過代理的目標,留意主要文件與頁面資源是否都能載入。測試時重新開啟分頁或重新整理,避免只看到瀏覽器快取內容。如果一般網頁也都無法開啟,先確認用戶端仍在執行、系統代理是否指向目前的監聽連接埠,以及是否殘留其他軟體的設定。

需要確認出口時,可使用可信任的出口 IP 查詢頁面,但不要輸入訂閱網址或帳戶資訊。查詢結果只代表目前瀏覽器連線至該查詢目標時所經過的路徑;分流規則可能讓該頁面直接連線,因此不能只因為「出口沒有變」就判定用戶端失效。先確認查詢目標符合哪條路由,再決定是否暫時切換預設值進行比較;測試完成後請還原原有規則。

送出要求時查看記錄檔,依現象縮小問題範圍

保持記錄檔視窗開啟,再用瀏覽器送出新的要求。如果用戶端完全沒有相關記錄,先確認應用程式是否使用系統代理,或是否被 Android 的依應用程式規則排除。記錄詳細程度會影響可見內容,因此不能只因為沒有存取明細就判定要求沒有進入用戶端;必要時可依用戶端提供的設定,短暫提高記錄層級,排查完成後再還原。分享記錄檔前,請刪除網址、使用者識別資訊及其他敏感內容。

如果要求已進入用戶端,但遠端連線逾時,優先改用同一訂閱中的另一個項目進行比較,並確認服務狀態與目前的網路環境。如果只有網域名稱解析失敗,請檢查 DNS 設定,不要直接修改協定參數。如果網頁能開啟但某個應用程式無法使用,優先檢查應用程式本身的代理設定與流量接管範圍。每次只修改一項並測試一次,記下結果;較複雜的路由問題可繼續閱讀路由規則章節。

確認連線正常後再測速度。單一測試目標的回應時間,不能代表下載大型檔案的能力;網頁變慢也可能是目標網站、線路壅塞或本機無線網路所致。先確認一般瀏覽穩定,再依照連線測試說明比較不同項目。不要把「更新訂閱」、「重新連線」、「切換模式」連續做成固定流程,以免掩蓋真正出問題的環節。

完成後記下設定,結束使用時還原網路

預期瀏覽的網頁能正常載入、用戶端運作穩定,且路由行為符合預期時,基本設定就完成了。記下目前的訂閱群組、作用中伺服器、流量接管方式與路由預設值,之後遇到問題時先還原這組已驗證的設定。不必為了「設定完整」立刻啟用所有功能;TUN、自訂分流與 DNS 調整,都可以等到有明確需求時再處理。

桌面版停止使用時,先在「系統代理」中選擇「清除系統代理」,再關閉 v2rayN;若啟用了 TUN,請先關閉 TUN 並確認網路已恢復。Android 版則透過 v2rayNG 的連線按鈕停止服務,並確認系統 VPN 狀態已結束。結束使用後若瀏覽器顯示代理伺服器無法使用,請先檢查系統或瀏覽器是否仍保留本機代理位址。之後要在其他裝置安裝、設定權限或整理規則時,可直接前往全平台完整文件,不必重做已確認有效的步驟。