QUICKSTART / 首次設定
v2rayN 訂閱匯入與連線設定
依序完成匯入訂閱、選擇代理模式、連線與測試。先建立一條方便檢查的連線路徑,再調整分流與 TUN 設定。
開始前,請先準備已安裝的用戶端,以及有權使用的訂閱網址或單一分享連結。用戶端本身不會提供伺服器。尚未安裝時,請先前往用戶端下載頁面選擇適用的安裝方式;如果只有伺服器參數而沒有訂閱網址,也可以直接匯入分享連結,不必先建立訂閱群組。
首次操作時,建議先關閉其他正在接管流量的代理連線,並確保網路仍可正常瀏覽一般網頁。本文只說明基本連線設定,不需要修改原生設定檔。訂閱網址可能包含存取授權資訊,複製時請勿貼到公開頁面;擷取畫面時也應避免顯示完整網址或帳戶欄位。
STEP 01 / 設定來源
匯入訂閱。先確認清單內容。
先確認取得的是哪一種連結。訂閱網址通常用來讓用戶端取得一組伺服器設定;單一分享連結通常以 vmess://、vless://、trojan:// 或 ss:// 開頭。兩者的匯入方式不同。不要只因網址很長就認定它是訂閱,也不要把帳戶管理頁面的網址當成訂閱網址。
在 v2rayN 主視窗開啟「訂閱群組」,進入「訂閱群組設定」並選擇新增群組。輸入容易辨識的群組備註,將完整訂閱網址貼到網址欄位,再儲存設定。備註僅供本機識別,不會變更伺服器參數。貼上後請檢查網址前後是否多出空格或換行,也不要連同說明文字一起複製。
儲存群組不代表已取得伺服器設定。回到主視窗,在「訂閱群組」選單中執行更新訂閱;若是首次設定且目前沒有可用的代理,請優先使用選單中不透過代理更新的選項。等待操作完成後查看日誌或提示,再確認清單是否出現含協定、網址等資訊的伺服器項目。如果介面提供群組篩選,請切換至剛建立的群組,避免因仍顯示其他群組而誤以為匯入失敗。
如果取得的是單一分享連結,請複製完整連結,然後在「伺服器」選單中選擇「從剪貼簿匯入分享連結」。匯入後請確認新增項目的協定類型與網址是否符合預期。不要自行修改連結中的編碼內容;若格式無法辨識,請先向設定提供者確認用戶端是否相容,不要反覆更改連結開頭。
在 v2rayNG 中,開啟選單內的「訂閱群組設定」,使用新增功能填入備註與訂閱網址並儲存;接著回到伺服器清單,從選單執行更新訂閱。若要匯入單一連結,請在主畫面的新增選單中選擇從剪貼簿匯入。Android 系統可能會提示應用程式讀取剪貼簿,這是匯入流程的一部分;完成後仍須確認清單中確實新增了項目。
清單沒有項目時,請先查看更新結果,不要立刻調整路由。網址無法連線、訂閱內容為空,或伺服器回傳的是網頁而非設定,都可能導致匯入失敗。若目前的網路無法直接取得訂閱,請先使用已有的有效設定建立連線,再透過代理更新;如果沒有現成設定,請向提供者確認可用的取得方式。
清單中出現伺服器項目,只代表設定已匯入用戶端,不表示伺服器一定能連線。此時不必逐一修改進階欄位,先保留原始參數,進入下一步選擇流量接管方式。如需了解訂閱更新與分享連結的差異,請參閱常見問題中的安裝與設定說明。
STEP 02 / 流量入口
選擇代理模式。分清流量接管與路由分流。
匯入設定後,接著要決定如何將應用程式流量交給用戶端處理。這裡有兩個不同層次:系統代理或 TUN 決定流量如何進入核心;路由規則則決定流量進入核心後使用哪個出口。啟用系統代理不代表所有應用程式都會使用代理;選擇路由預設也不代表連線已啟動。
桌面版首次測試可先使用系統代理,並保持「啟用 Tun 模式」關閉。在主視窗底部或系統匣圖示的「系統代理」選單中,找到「自動設定系統代理」。此選項會將本機代理監聽網址寫入系統代理設定,供遵循該設定的應用程式使用。如果核心尚未啟動,部分應用程式可能暫時無法連線;因此選好模式後,請繼續完成下一步,不要只停在這裡判斷連線結果。
接著檢查「路由」設定。如果用戶端提供「繞過大陸」預設,可將其作為一般瀏覽情境的起點;此設定會依據目前的規則資料,決定哪些請求直連、哪些請求透過代理。即使預設名稱相同,不同版本的規則內容也不一定完全一致。測試時請選擇依目前規則應透過代理連線的目標,不能只因為直連網站能開啟,就認定代理已生效。
系統代理適合用來測試瀏覽器的連線流程。有些應用程式有自己的代理設定,或不讀取系統設定,因此行為可能與瀏覽器不同。遇到這種情況,請先查看該應用程式的網路選項,不要為了讓單一應用程式正常運作而同時啟用多種流量接管方式。確認基本連線正常後,再依需求考慮 TUN 與應用程式分流設定。
v2rayNG 不需要尋找桌面版的「自動設定系統代理」按鈕。它通常透過 Android VPN 介面接管流量,啟動時由系統要求授權。連線前請進入設定檢查路由選項;若已啟用應用程式分流,請確認用來測試的瀏覽器位於接管範圍內,並分清清單代表的是「僅代理所選應用程式」還是「略過所選應用程式」。這兩種清單的意義相反,不能只看是否有勾選。
如果先前使用過自訂規則,首次排查時可先記錄原有設定,再還原為容易理解的預設。不要同時修改 DNS、路由、傳輸參數與流量接管方式,否則發生問題時難以判斷是哪項設定造成影響。關於 TUN 權限、系統代理適用範圍及規則比對順序的詳細說明,請在完成基本測試後參閱協定與核心參考。
完成這個步驟時,應能清楚說明兩件事:要測試的應用程式透過哪個入口交給用戶端處理,以及測試目標會依照哪套路由規則處理。保持這兩項設定不變,下一步只選擇伺服器,並觀察核心啟動狀態。
STEP 03 / 啟動核心
連線至伺服器。確認活動項目並查看日誌。
回到 v2rayN 伺服器清單,選擇一個設定完整的項目。按右鍵開啟選單,選擇「設為活動伺服器」,將其設為目前使用的連線設定。部分版本也支援快速鍵或雙擊操作;首次使用時請以選單為準,避免將一般選取誤認為已切換。操作後查看清單中的活動標記與底部狀態,確認目前使用的是預期項目。
v2rayN 通常會在設定活動伺服器後載入相應設定,並啟動或重新啟動核心,不一定會有獨立的「連線」大按鈕。開啟主視窗的日誌區域,查看這次操作後的新訊息。留意是否出現設定載入失敗、連接埠被占用或核心無法啟動等錯誤;若有錯誤,請先處理,不要只在瀏覽器中不斷重新整理。
若提示本機連接埠被占用,可能是用戶端重複執行,也可能有其他程式正在監聽相同連接埠。請先檢查系統匣與工作列,結束重複的執行個體,再重新啟動目前的用戶端。若確實需要變更監聽連接埠,也請確認系統代理指向新的連接埠。本文不指定固定的連接埠值,請以目前用戶端設定與狀態列顯示為準。
確認核心已啟動後,再檢查「系統代理」是否仍為「自動設定系統代理」,以及路由是否維持上一步的選擇。切換活動伺服器通常不必重新匯入訂閱。若必須重新啟動用戶端才能繼續,重新啟動後也要再次確認這兩項設定,不要假設之前的選擇一定會保留。
在 v2rayNG 中,先點選伺服器項目,確認活動標記已移至目標項目,再按下主畫面的啟動按鈕。首次啟動時會出現 Android 系統的 VPN 連線要求,確認應用程式名稱後再允許。系統通常只會保留一個作用中的 VPN 連線;若另一個應用程式仍在執行,請先停止該連線,再啟動目前的連線。
啟動後,v2rayNG 的按鈕狀態與系統連線標示應會改變。這表示本機服務與流量接管介面正在執行,但不足以單獨證明遠端伺服器能正常轉送請求。若按鈕很快又回到停止狀態,請查看用戶端日誌,分辨是授權遭拒、設定載入失敗,還是服務啟動失敗,再決定下一步處理方式。
用戶端提供的 Tcping 或類似測試,主要用來檢查目標連接埠是否可連線,無法完整測試代理交握與目標網站存取。「真連線延遲測試」更接近實際代理請求,但結果仍會受到測試網址與路由影響。首次設定時可用來輔助檢查,不必為了單一延遲數字反覆切換;真正的完成條件是下一步能透過預期的應用程式存取目標。
STEP 04 / 存取測試
確認是否生效。從應用程式回查連線路徑。
保持用戶端執行,開啟瀏覽器的新分頁,前往已知可用且依目前路由設定應透過代理連線的 HTTPS 網頁。盡量選擇能確認內容已更新的頁面,不要只查看已開啟分頁中的快取內容。等待頁面實際載入文字或其他資源後,再回到用戶端查看這段期間的日誌。
一次有效的測試須同時確認三項條件:核心已啟動、瀏覽器確實將請求交給用戶端,以及目標使用預期的出口。只看到用戶端的執行圖示,或只確認某個一般網站可以開啟,都不足以涵蓋全部條件。若日誌等級與介面支援連線記錄,可搭配目標網域與出口標記判斷;若未顯示詳細記錄,也不要直接將「日誌沒有變化」解讀為沒有流量。
桌面版請先檢查系統網路設定中的代理網址與連接埠,確認與用戶端目前的本機監聽設定一致。若瀏覽器裝有可單獨控制代理的擴充功能,請檢查其模式是否會覆寫系統設定。先讓瀏覽器使用系統代理,再以相同目標重試;不要在擴充功能、系統與用戶端三處設定互不相同的代理網址。
Android 裝置請先確認 v2rayNG 仍在執行,且系統 VPN 連線未被其他應用程式取代,再確認測試用的瀏覽器是否在應用程式分流的接管範圍內。如果只有切換至背景後連線才中斷,可檢查系統對該應用程式的電池使用與背景執行限制。是否需要放寬限制,應依裝置的實際狀況判斷;首次啟動前不必一次關閉所有系統管理選項。
網頁無法開啟時,請依序檢查「本機啟動、應用程式接管、伺服器連線、目標存取」。先確認是否有啟動錯誤,再檢查系統代理或 VPN 狀態,然後對目前的活動伺服器執行真連線測試。若只有一個目標失敗,請改測另一個同樣應透過代理連線且已知可用的目標;若所有目標都失敗,再檢查伺服器參數與網路連線。不要因為單一網站無法回應,就直接判定整個用戶端故障。
如果日誌明確顯示名稱解析或憑證錯誤,請先保留錯誤原文並確認發生時間。遇到憑證錯誤時,應檢查裝置時間與設定中的伺服器名稱,不要關閉驗證來規避問題。名稱解析異常也不應立刻改用固定 IP,因為這可能同時影響 TLS 與路由行為。個別錯誤的後續處理方式請參閱常見問題與疑難排解;本頁先維持基本設定不變。
需要更換伺服器進行比較時,只更改活動伺服器,並維持瀏覽器、接管模式、路由與測試目標不變。完成一次測試後再比較結果,才能判斷差異是來自伺服器還是本機設定。如果同時變更多項條件,即使恢復連線,也很難重現原因;下次遇到相同問題時仍得從頭檢查。
確認存取結果符合預期後,可以關閉測試分頁,保留目前的群組與模式。日後訂閱內容更新時,從原有群組執行更新即可,不必每次刪除後重建。桌面版準備結束用戶端時,先選擇「清除系統代理」,確認一般網路存取已恢復,再結束程式;Android 版則按下停止按鈕結束連線,並確認系統連線標示已消失。