首次設定 · 約 10 分鐘
v2rayN 與 v2rayNG 快速上手
匯入一組訂閱並連線,確認指定應用程式是否透過代理連線。
開始前,請準備有效的訂閱網址。還沒安裝用戶端?請先前往下載頁面,依裝置選擇安裝檔。
匯入訂閱
先確認複製的是服務提供者提供的訂閱網址,而非登入頁面、帳戶管理頁面或單一伺服器分享連結。訂閱網址用於取得設定清單;單一分享連結則只包含一台伺服器的資訊,兩者的匯入方式不同。網址可能包含帳戶識別資訊,請勿貼在公開截圖或問題回報中。若是從聊天訊息複製,貼上後請檢查網址開頭與結尾,避免一併存入引號、句號或換行。
v2rayN 桌面版
開啟主視窗,從「訂閱群組」進入「訂閱群組設定」,新增一筆訂閱。備註請填寫方便辨識的名稱,並在網址欄貼上完整連結,儲存後回到主視窗。切換至剛建立的群組,再從「訂閱群組」選單更新目前群組。若清單中有多個來源,請先只更新新加入的群組,避免將其他群組的結果誤認為此次匯入成功。
v2rayNG Android 版
開啟主畫面選單,進入「訂閱群組設定」,點選新增,將連結貼入訂閱網址欄並儲存。回到設定清單,切換至新建的群組,再從選單中選擇「更新訂閱」。儲存只是記錄網址,完成更新後伺服器才會出現在清單中。若收到的是單一分享連結,請離開訂閱設定,改從設定清單點選加號,從剪貼簿匯入,不必再手動更新訂閱。
新建群組中出現伺服器項目後,即可進行下一步。若清單仍是空的,先確認目前顯示的是正確群組,再查看更新訊息:連線逾時時,先檢查裝置是否已連上網路;若網址失效或開啟後顯示登入頁面,請向服務提供者確認訂閱是否仍有效。若訊息顯示更新成功,但群組依然空白,請檢查清單搜尋或群組篩選是否隱藏了項目。此時先別反覆切換代理模式,因為系統代理和 VPN 都無法修復空白的設定清單。群組管理與篩選規則請參閱訂閱群組手冊。
選擇代理模式
第一次測試只要讓一個應用程式的請求經過用戶端即可。先分清兩層設定:系統代理、VPN 或 TUN 決定流量如何進入用戶端;路由規則則決定流量進入後要走代理或直接連線。因此,啟用系統代理不代表每個應用程式或網站都會經由遠端伺服器連線。第一次測試請保留原有路由規則,確認連線正常後再依需求調整。
桌面版:使用系統代理測試
在 v2rayN 視窗底部或系統匣選單中找到「系統代理」,確認選單中有「自動設定系統代理」及「清除系統代理」等選項。第一次測試請選用支援系統代理的瀏覽器,待下一步選好目前使用的伺服器後,再套用「自動設定系統代理」。若瀏覽器已個別設定代理,或安裝了會接管網路連線的擴充功能,請先改用遵循系統設定的瀏覽器,避免用戶端代理與瀏覽器自身設定互相衝突。
暫時不必啟用 TUN,也不用將路由改為全域代理。系統代理適合用來初步測試瀏覽器;若瀏覽器能正常連線,但某個桌面應用程式不受影響,可能是該應用程式不會讀取系統代理。此時先查看應用程式是否有自己的代理設定,再決定是否需要了解 TUN 模式,第一次測試時請勿同時啟用兩種流量入口。
Android 版:使用 VPN 模式測試
在 v2rayNG 設定中查看執行模式;若目前版本提供切換選項,請選擇「VPN 模式」。此模式會透過系統 VPN 介面接收應用程式流量。若先前設定過「分應用程式代理」,請確認測試用的應用程式未被排除;若畫面顯示的是僅允許所選應用程式的清單,請將測試用應用程式加入清單。若手機正在執行其他 VPN,請先確認能否暫停,再啟動 v2rayNG;若目前的 VPN 由公司或裝置管理政策控管,請勿為了測試擅自修改政策。想了解本機代理、VPN 介面與輸出規則的差異,請參閱名詞解釋。
連線至伺服器
回到剛匯入的群組,選擇一台要測試的伺服器。第一次連線時,請使用相同設定與網路環境,方便從日誌找出問題。清單中的測速結果只代表特定測試請求,不等於指定應用程式一定能正常連線;即使尚未測速,也可以先用已知可用的設定進行確認。
桌面版:設為目前使用的伺服器,再套用系統代理
在 v2rayN 伺服器清單中選取項目,再透過右鍵選單將它設為目前使用的伺服器。只在清單中選取項目只是移動焦點,請確認目前使用標記或狀態列已切換至目標項目。接著查看主視窗的執行資訊,確認核心沒有啟動失敗。若日誌顯示本機連接埠已被占用,請先檢查是否還有其他同類用戶端正在執行;核心尚未啟動時,請勿讓瀏覽器透過系統代理送出請求。
確認本機代理已啟動後,從系統匣或主視窗選單套用「自動設定系統代理」,再開啟準備好的測試瀏覽器。若啟用後瀏覽器完全無法載入網頁,請先選擇「清除系統代理」,恢復測試前的連線方式,再回到用戶端查看剛才的啟動日誌。若裝置原本已設定公司或學校的系統代理,測試前請記下原設定,結束後恢復原值;清除用戶端設定並不等於還原原本的設定。
Android 版:選取設定並確認系統連線要求
在 v2rayNG 主清單中點選伺服器,確認目前選取的項目,再點選右下角的連線按鈕。第一次使用 VPN 模式時,Android 會顯示連線要求;請確認提示中的應用程式是 v2rayNG,再允許建立連線。連線按鈕進入執行狀態,或系統顯示 VPN 狀態圖示,代表本機服務已啟動或 VPN 介面已建立,但還不能據此判定遠端伺服器可用。
若按鈕很快恢復為未連線狀態,請立即查看應用程式日誌,先分辨是系統未授權、本機服務未啟動,還是送出請求後遠端沒有回應。若連線運作正常,請保持連線並直接進行下一步。只有在確認目前設定的故障環節後,才切換至另一台已知可用的伺服器作比較;切換時也請確認新的選取項目已生效。
確認連線
先測試預期會走代理的請求,再測試實際要使用的應用程式。使用前面選好的瀏覽器開啟可正常存取、且依目前規則應走代理的頁面,或用可信任的出口 IP 查詢網站進行比較。請盡量重新送出請求,不要以已載入的舊頁面作為判斷依據。回到用戶端查看同一時段的執行日誌;若目前日誌會顯示請求目標或輸出標籤,請確認是否與剛才的請求相符。只看到核心啟動或 VPN 圖示,無法證明這次請求確實使用代理輸出。
接著進行關閉代理後的對照測試。桌面版請清除測試時套用的系統代理;Android 版則點選連線按鈕中斷 VPN。保持相同網路與瀏覽器,再次開啟同一頁面,比較存取結果或出口 IP,之後視需要恢復連線。若出口 IP 沒有變化,請先確認測試網址是否被路由規則判定為直連。反之,即使某個網址的出口 IP 改變,也只能證明該次請求的路徑有所不同,不能推論所有應用程式都會走相同路徑。
瀏覽器與指定應用程式的結果不同
若瀏覽器測試成功,但指定應用程式仍有問題,桌面版請優先檢查應用程式是否會讀取系統代理;Android 版則確認分應用程式代理清單與排除規則。修改後請關閉並重新開啟指定應用程式,再送出新的請求;有些應用程式會沿用先前建立的連線。若兩者都無法連線,而且日誌顯示請求已進入用戶端,請先根據最早出現的錯誤判斷問題所在:網域名稱解析失敗與連線至遠端逾時是不同問題,不建議同時更換 DNS、伺服器和路由設定。
瀏覽器與指定應用程式都符合預期時,即可保留這次設定。記下使用的訂閱群組、目前使用的伺服器與代理模式,下次遇到問題時便可依序檢查「設定清單是否有項目 → 本機服務是否執行 → 請求是否進入用戶端 → 是否使用預期的輸出方式」。若只有特定網域的結果不如預期,請檢查路由規則順序;若日誌明確指出解析失敗,請查看DNS 設定。分享日誌時,只需摘錄相關錯誤,並刪除訂閱網址、伺服器憑證及其他敏感資訊。