10 分鐘快速入門

v2rayN 與 v2rayNG:從匯入訂閱到連線驗證

先準備訂閱連結,再依序完成匯入、模式選擇、連線與驗證。每一步只調整目前需要的設定,完成後再進行下一步。

準備

開始前準備:用戶端與訂閱連結

先安裝與目前裝置相符的用戶端。桌面裝置開啟 v2rayN,Android 裝置開啟 v2rayNG。首次啟動時,系統可能要求確認網路存取權限;請允許用戶端建立網路連線,否則即使匯入設定,後續也無法正常建立連線。桌面版啟動後若主視窗沒有出現,可查看系統匣區域,v2rayN 通常仍會在背景執行。

接著準備一條可用的訂閱連結。訂閱連結由設定提供者提供,通常是一段以 https:// 開頭的網址。複製時請包含完整內容,不要連同連結前後的說明文字一起選取。連結是設定入口,不適合貼到公開頁面、聊天群組或截圖中;本教學只需將它填入用戶端的訂閱網址輸入框。

如果手上只有單一分享連結,也可以在用戶端使用「從剪貼簿匯入」之類的入口,但單一連結不會自動同步後續變更。快速入門更建議使用訂閱群組:設定提供者更新節點後,只需在用戶端執行一次「更新訂閱」,不必重新逐條匯入。

桌面版

開啟 v2rayN 主視窗

確認頂端選單、伺服器清單及底部狀態區域都能正常顯示。視窗關閉後,程式仍可能留在系統匣中。

Android

開啟 v2rayNG 主畫面

確認側邊選單可以展開,並準備在系統提示出現時,授予建立網路連線所需的權限。

完成這些準備後,先不要修改 DNS、TUN、連接埠或核心參數。預設設定已足以完成首次連線。需要理解不同核心、協定與進階路由規則時,再進入從新手到進階的完整手冊逐章設定。

步驟 1

匯入訂閱:新增群組並更新設定

v2rayN 桌面版

在 v2rayN 主視窗中開啟「訂閱群組」,進入訂閱群組設定。選擇「新增」,在備註欄填寫方便辨識的名稱,例如「日常設定」,再將完整訂閱連結貼到網址欄。備註只用於本機辨識,不會影響連線;日後新增多條訂閱時,清楚的群組名稱有助於判斷伺服器來源。

儲存群組後返回主視窗,開啟訂閱選單並執行「更新全部訂閱」。用戶端會讀取剛才儲存的網址並解析設定。更新完成後,伺服器清單應出現一筆或多筆可選記錄。此時先確認清單確實產生新內容,不必從名稱猜測協定,也不需要手動修改網址、連接埠、傳輸方式或安全設定;這些欄位已包含在訂閱結果中。

如果儲存後清單仍是空白,先重新進入訂閱群組設定,檢查網址開頭、結尾及中間是否多了空格。接著單獨更新這個群組,並查看視窗底部提示或日誌。出現「無法連線」「逾時」等結果時,不要連續快速點擊更新,先確認裝置目前能正常連線網路,再稍候重試。

v2rayNG Android 版

開啟 v2rayNG 的側邊選單,進入「訂閱群組設定」,點擊新增按鈕。填寫群組名稱與訂閱網址後儲存,返回主畫面,再從選單執行「更新訂閱」。部分版本會要求先選取剛建立的群組,再開始重新整理;如果主畫面沒有出現設定,請回到群組清單確認該群組已啟用。

更新完成後,主畫面會列出訂閱解析出的設定。點擊其中一筆記錄,讓它成為目前選取的項目。目前項目通常會有選取標記或不同的背景狀態。這裡只是指定下一步要連線的設定,尚未真正啟動網路連線。

如果訂閱中包含大量記錄,首次操作只需選擇一筆名稱清楚的設定繼續。延遲測試可作為後續篩選工具,但測試結果會受到目前網路、測試目標與時間影響,不必為了追求特定數值反覆重新整理。先完成一次穩定連線,再處理節點整理與訂閱群組。多訂閱篩選、備註及更新策略請參閱訂閱與節點管理章節

步驟 2

選擇代理模式:先使用系統代理與規則分流

完成訂閱匯入後,需要決定哪些程式與請求交由用戶端處理。首次使用時,桌面版建議先選擇「自動設定系統代理」,路由模式選擇「繞過中國大陸」;Android 版建議先選擇規則模式。這組設定容易觀察,出現問題時也較容易分辨是節點、程式代理或路由規則造成。

v2rayN:自動設定系統代理

在 v2rayN 的系統匣選單或主視窗底部找到「系統代理」,選擇「自動設定系統代理」。設定生效後,遵循系統代理的瀏覽器與桌面程式會將符合條件的請求交給 v2rayN。若狀態仍顯示「清除系統代理」或「未啟用」,表示用戶端雖能執行核心,但其他程式尚未取得代理入口。

接著開啟「路由設定」,選擇「繞過中國大陸」預設規則。其用途是讓常見本地網址與內網網址維持直連,同時將其他符合條件的項目交給代理出站。首次連線不要立即加入自訂網域、程序規則及複雜 DNS 項目,否則驗證失敗時很難判斷是哪條規則造成影響。

v2rayNG:規則模式

在 v2rayNG 的設定或主畫面設定項目中找到路由模式,選擇規則模式。不同版本的預設規則名稱可能略有差異,重點是使用用戶端提供的規則分流,而不是一開始就讓所有請求採用同一種出站。選擇後返回主畫面,確認剛才選取的伺服器記錄仍處於作用中狀態。

系統代理主要涵蓋會讀取系統代理設定的程式。部分遊戲、命令列工具及獨立網路程式可能繞過此設定,因此「瀏覽器可以連線、某個應用程式無法連線」不代表節點故障。TUN 模式可以接管更多類型的網路請求,但會涉及虛擬網卡、權限、DNS 及路由衝突。快速入門階段先不要啟用;需要處理不遵循系統代理的程式時,再閱讀TUN 模式章節

桌面版推薦起點 自動設定系統代理 + 繞過中國大陸
Android 推薦起點 規則模式 + 目前選取的設定
步驟 3

連線節點:設為作用中設定並啟動

完成模式設定後,返回伺服器清單選擇一組設定。在 v2rayN 中可以雙擊目標記錄,或透過右鍵選單將其設為作用中伺服器。確認作用中項目後啟動服務;如果用戶端已在執行,切換作用中伺服器通常會重新載入核心設定。底部狀態區域應顯示目前伺服器資訊與系統代理狀態,日誌區域也會出現核心啟動及設定載入記錄。

在 v2rayNG 中先點擊一筆設定,再點擊主畫面的圓形啟動按鈕。首次啟動時,系統會顯示網路連線確認視窗,確認後才能建立連線。啟動按鈕狀態變更,且系統狀態區域出現連線標示時,表示用戶端已開始處理網路請求。此時不要立即退出用戶端,也不要在系統最近使用的工作畫面中強制結束它。

正常啟動日誌通常會包含監聽連接埠、設定載入及核心執行等資訊。日誌偶爾出現單次連線關閉,不一定代表整體失敗;真正需要處理的是持續重複的設定解析錯誤、無法連線到網址、交握失敗或權限錯誤。如果日誌一啟動就停止,先保留目前畫面,記下最早出現的錯誤行,因為後續重複資訊往往只是前一個錯誤造成的結果。

連線過程中一次只切換一個變數。例如目前設定無法建立連線,可以先換到同一訂閱中的另一筆記錄,維持代理模式及其他設定不變;如果所有記錄都失敗,再更新訂閱並檢查本地網路。一次同時更換節點、模式、DNS 與核心參數,會讓排查失去明確順序。

步驟 4

驗證是否生效:依序檢查瀏覽器、路由與日誌

先建立新的瀏覽器視窗或分頁,開啟平時可直連存取的頁面,確認仍能正常載入。接著再開啟需要透過目前設定存取的目標頁面。兩類頁面都能載入,表示用戶端連線、系統代理及基本路由已形成完整鏈路。驗證時應使用熟悉且穩定的網站,不要以暫時關閉或本身回應緩慢的頁面作為唯一判斷依據。

如果目標頁面可以存取,但本地頁面明顯變慢,返回路由設定確認目前仍是規則分流,而非全域模式。如果所有頁面都無法存取,先查看用戶端是否仍在執行、作用中設定是否存在,以及系統代理是否指向目前用戶端。桌面版也可以暫時執行「清除系統代理」,確認本地網路恢復後,再重新選擇「自動設定系統代理」。此動作可區分基本網路問題與代理鏈路問題。

接著查看日誌。驗證期間新產生的日誌最具參考價值:網域解析錯誤通常指向 DNS 設定或本地網路;連線逾時可能與目前節點、網路路徑或目標網址有關;設定解析錯誤則需要重新更新訂閱,避免繼續使用欄位不完整的舊記錄。不要只截取日誌最後一行,應從本次啟動的位置開始向下查看,找出最先出現的明確錯誤。

也可以關閉用戶端連線後,再次存取同一目標頁面,接著重新連線進行對照。結果應符合預期:關閉後恢復直連狀態,啟動後由目前規則處理。若關閉用戶端後瀏覽器仍嘗試存取舊代理連接埠,表示系統代理未正確清除。此時在 v2rayN 系統匣選單中選擇「清除系統代理」,退出並重新開啟瀏覽器,然後再啟動用戶端。

部分程式不會讀取系統代理,因此瀏覽器驗證成功後,其他程式仍可能維持原本的連線方式。先檢查該程式本身是否提供代理設定;若有,可填寫 v2rayN 的本機監聽位址與連接埠。需要讓更多程式統一經過用戶端時,再依照完整手冊中的 TUN 步驟檢查權限、虛擬網卡與 DNS,不要直接照搬來源不明的整段設定。

訂閱清單中存在可選擇的設定
目前伺服器已設為作用中項目
系統代理或規則模式處於預期狀態
新開啟的頁面可以依規則存取
日誌中沒有持續重複的啟動錯誤
完成後

日常使用:更新訂閱、切換節點與退出

首次驗證完成後,日常操作可以維持簡單。設定提供者通知內容已更新時,在用戶端執行「更新訂閱」,等待清單重新整理,再選擇要使用的作用中伺服器。更新過程中不要刪除原訂閱群組後重新建立,除非訂閱網址本身已變更;保留群組即可繼續使用原有的備註與群組關係。

需要切換伺服器時,先在清單中選擇另一筆記錄並設為作用中項目,再重新開啟目標頁面驗證。用戶端通常會自動重新載入設定,但既有程式可能維持先前建立的連線。遇到「切換後結果沒有變化」時,先關閉對應程式的舊頁面或連線,再重新發出請求,不要立即修改路由規則。

暫時不使用時,桌面版先在系統匣選單中清除系統代理,再退出 v2rayN。只關閉主視窗可能只是將程式縮到系統匣,系統代理仍會保持啟用。Android 版先點擊停止按鈕,確認連線狀態結束後再退出。依照這個順序操作,可避免下次啟動瀏覽器時仍指向已停止的本機代理連接埠。

完成快速入門後,建議只依實際需求繼續增加設定。需要讓中國大陸與海外網域分別解析時,再設定 DNS;需要處理不遵循系統代理的程式時,再設定 TUN;需要固定直連或代理目標時,再新增自訂路由。協定差異、核心選擇、路由優先順序、DNS 分流與維護方式集中在從零到進階的完整手冊,快速使用階段不必一次設定所有功能。

遇到問題時

快速排除:依匯入、啟動、代理、解析順序檢查

伺服器清單為空時,問題通常發生在訂閱匯入階段。檢查訂閱群組是否啟用、網址是否完整,再執行一次單獨更新。更新提示格式錯誤時,應重新複製原始連結;更新提示網路逾時時,先用一般網頁確認目前基本網路正常。清單為空時不要繼續調整系統代理,因為此時用戶端還沒有可啟動的有效設定。

清單存在但核心無法啟動時,先改用訂閱中的另一筆記錄。如果所有記錄都在相同位置回報設定錯誤,請更新訂閱並重新啟動用戶端;如果只有一筆記錄失敗,可以暫時使用其他記錄。用戶端版本過舊也可能無法辨識較新的設定欄位,可前往用戶端下載頁選擇目前平台版本。

用戶端顯示已連線但瀏覽器沒有變化時,檢查 v2rayN 的系統代理是否為「自動設定系統代理」,或確認 v2rayNG 的連線狀態仍處於啟用狀態。桌面版還要留意瀏覽器是否使用獨立代理擴充功能或手動代理網址;多個代理入口同時生效時,瀏覽器可能不會採用系統設定。先暫時停用額外代理設定,只保留用戶端的系統代理進行驗證。

只有網域無法開啟、直接存取已知網址卻有回應時,排查重點轉向 DNS。先還原用戶端預設 DNS 設定,重新啟動連線並測試。如果問題只在啟用 TUN 後出現,應先關閉 TUN,回到本教學的基本模式確認連線正常,再依完整手冊逐項設定 DNS 出站、查詢規則與虛擬網卡。關於解析請求的流向與洩漏排查,可閱讀v2rayN DNS 檢測與修復步驟

完成以上檢查仍無法判斷時,保留用戶端名稱、作業系統、代理模式、發生時間及最早的一筆明確錯誤資訊。問題描述應說明「訂閱能否更新、核心能否啟動、瀏覽器是否遵循系統代理、哪些頁面受到影響」,比只寫「連線失敗」更容易定位具體環節。

下載用戶端