初次設定 · 四步完成

v2rayN 使用教學:
匯入訂閱與測試連線

初次連線先使用系統代理,再考慮 TUN。依序完成「匯入訂閱 → 選擇代理模式 → 連線 → 測試」,方便找出問題所在。

請先準備已安裝的用戶端,以及由可信來源提供的有效訂閱連結。用戶端不會附上可直接使用的伺服器;如果尚未取得連線設定,請先完成準備再繼續以下步驟。已有訂閱且網路正常時,初次設定約需十分鐘。

匯入訂閱

完成這個步驟的判斷方式:用戶端的伺服器清單中出現可選的設定項目。先複製訂閱提供者給的完整連結,注意不要連同說明文字、換行或前後空白一起複製。訂閱連結和網站登入網址並不相同;如果複製的是帳戶管理頁面,更新時可能會取得網頁內容,而非用戶端設定。訂閱通常包含連線憑證,請妥善保存在個人裝置中,不要貼到公開討論區或未經確認的轉換網站。

桌面版:新增群組並更新訂閱

開啟 v2rayN,在上方選單中找到「訂閱群組」,進入「訂閱群組設定」並新增群組。備註僅供本機辨識,可填寫方便區分來源的名稱;在訂閱網址欄貼上完整連結,其他選項先保留預設值,儲存後關閉設定視窗。群組儲存成功只代表已記錄網址,伺服器清單尚未變動是正常情況,還需要再更新一次。

回到「訂閱群組」選單,選擇更新目前群組的訂閱。初次設定時,如果有「不透過代理更新」選項,可先使用此功能,避免依賴尚未建立的代理連線。等待更新完成後,切回伺服器清單並選取剛新增的群組。正常情況下會看到協定、網址、連接埠等設定欄位;此時不必手動修改協定參數,先保留訂閱中的原始設定,繼續下一步。

如果清單沒有項目,先查看底部日誌是否顯示取得訂閱失敗、網址格式錯誤或解析失敗。取得失敗時,先確認目前網路能否連線至訂閱網址,以及連結是否已過期;解析失敗則需確認提供者輸出的格式是否適用於目前用戶端。只有來源明確要求轉換時才考慮轉換格式,不要因為一次更新失敗,就任意更換伺服器網址或傳輸參數。如果已有其他群組,也請確認是否誤選篩選條件,導致新項目未顯示。

Android:在 v2rayNG 中新增訂閱網址

開啟 v2rayNG,從選單進入「訂閱群組設定」,點選新增按鈕並填入備註與訂閱網址,儲存後返回主畫面。接著從主畫面選單更新訂閱;如果介面提供群組篩選,請切換至對應群組查看結果。更新成功後,主畫面應會顯示可選的伺服器設定。掃描 QR Code 或從剪貼簿匯入通常是用來新增單筆分享設定,不等同於新增可持續更新的訂閱群組;日後能否自動取得變更,取決於使用的匯入方式。

看到伺服器項目,就代表訂閱準備已完成。下一步先決定應用程式流量如何進入用戶端,不要立刻開啟所有接管選項。

選擇代理模式

初次使用建議只啟用一種流量接管方式。桌面版先使用系統代理,暫時關閉 TUN,可減少權限、虛擬網卡與 DNS 設定同時介入所帶來的變因。還要分清兩個不同問題:系統代理決定應用程式是否將流量交給本機用戶端;路由規則則決定用戶端收到流量後要直連、走代理或封鎖。選好路由預設,不代表所有應用程式都會自動使用用戶端。

桌面版:自動設定系統代理,保持 TUN 關閉

在 v2rayN 主視窗或系統匣選單中找到「系統代理」,選擇「自動設定系統代理」。「清除系統代理」用來移除系統中的代理設定;「不變更系統代理」只是不主動修改目前設定,不代表會自動啟用。選擇後請查看用戶端的狀態提示,確認目前選項確實是自動設定,而非只開啟選單查看。

接著找到路由設定,初次使用可選擇「繞過中國大陸」等符合目前連線需求的預設。此類預設通常會讓符合規則的目標直接連線,其餘流量則依預設出站方式處理;實際行為仍取決於目前規則內容與順序。不要以為每個網域永遠都會得到固定結果。若只是依照教學完成初次連線,保留一組預設即可,暫時不要加入從網路複製的大量自訂規則。

最後確認 TUN 開關處於關閉狀態。系統代理主要適用於遵循系統代理設定的應用程式,部分命令列工具或獨立網路程式可能不會使用此設定,這不代表啟用失敗。先用一般瀏覽器測試。如果之後確實需要接管這類應用程式,再前往完整手冊了解 TUN 的權限、路由與 DNS 設定,不必在初次連線時一併完成。

Android:了解 VPN 接管與路由設定

v2rayNG 常見的運作方式是建立本機 VPN 接管入口,再由設定決定實際出站方式,不需要尋找桌面版的「自動設定系統代理」。這次先保留預設的應用程式代理範圍,不新增個別應用程式的排除規則;若裝置上已有其他使用 VPN 通道的工具,請先停止它們,避免同時占用通道。路由設定可先使用符合自身網路需求的預設,連線授權留待下一步處理。

設定項目本步驟操作判斷重點
桌面版系統代理自動設定系統代理瀏覽器是否遵循系統代理
桌面版 TUN暫時關閉先排除權限與虛擬網卡變因
Android VPN 接管連線時確認系統授權通道是否已啟動、應用程式是否在接管範圍內
路由預設先保留一組規則比對條件與最終出站方式是否符合預期

確認接管方式與路由預設後,就可以選擇實際使用的伺服器。此時不必繼續調整 DNS 或切換核心,先保留容易重現的基本設定。

連線並檢查執行狀態

匯入訂閱不代表其中每筆設定都可用,選取項目也不一定代表已設為目前使用的伺服器。連線時要分別確認「目前使用哪筆設定」和「核心是否正常執行」。初次使用只選一筆來源明確且仍在有效期限內的設定,避免不斷切換,導致無法判斷日誌對應哪次操作。

桌面版:設定目前使用的伺服器並查看日誌

在 v2rayN 伺服器清單中,按右鍵點選目標項目,選擇「設為目前使用的伺服器」或功能相同的選單項目;部分版本也支援雙擊或使用快速鍵,請以介面提示為準。操作後檢查該列的啟用標記或狀態列,確認目前使用的項目確實已變更。v2rayN 通常會在目前使用的設定變更後重新載入服務,不一定會提供獨立的大型「連線」按鈕。

開啟底部的日誌區域,查看切換後的訊息。如果核心已停止,或出現監聽網址已被占用、設定解析失敗、無法讀取資源檔等錯誤,應先處理該錯誤,而不是反覆更換系統代理選項。日誌顯示服務已正常啟動,只能代表本機執行正常;遠端是否可連線,仍需進行下一步的實際測試。

遇到連接埠占用時,請進入參數設定確認本機監聽連接埠。混合監聽連接埠可能是 10808,但請以目前介面顯示為準,不要為了和教學一致而強制改成特定數字。確認是否同時執行了另一個用戶端。如果調整監聽連接埠,儲存並重新載入服務後,還要重新套用系統代理,讓系統指向的連接埠與用戶端一致。自行填寫代理網址的應用程式也需要同步修改。

如果切換後一直沒有新日誌,先確認日誌面板沒有暫停或套用篩選,再從用戶端選單執行一次「重新啟動服務」並查看結果。原因不明時,不要連續重新啟動整台裝置。若需依據錯誤訊息逐項診斷,可參閱核心啟動失敗的日誌診斷方法;本頁先以恢復正常啟動為目標。

Android:選擇設定並確認 VPN 授權

在 v2rayNG 主畫面點選目標設定,再按底部的連線按鈕。初次啟動通常會出現系統 VPN 連線要求,閱讀提示並確認後,返回用戶端等待狀態變更。若拒絕授權,即使已匯入設定,也不會建立接管通道。裝置顯示 VPN 狀態標記,代表系統通道已建立,但這本身無法證明遠端服務可用。

如果點選後立刻停止,請開啟日誌查看啟動失敗原因;如果執行一段時間後中斷,則檢查系統是否限制背景活動。初次測試時可先讓用戶端保持在前景,確認連線正常後再處理背景執行設定。進行到這裡,桌面版應有正常執行的本機核心,Android 應已建立獲授權的通道,接著透過實際連線檢查整條路徑。

確認是否生效

測試時應確認「目標頁面能否連線」以及「請求是否使用預期的出站方式」,不要只看連線圖示。先開啟一個依目前規則應直連的頁面,再開啟一個依規則應走代理且服務正常的目標頁面。初次測試盡量使用同一個瀏覽器,避免混淆不同應用程式的代理行為。頁面能開啟只是初步結果,搭配日誌更容易確認路由是否符合預期。

先測試連線,再核對日誌與代理入口

桌面版若瀏覽器一直保持開啟,可先關閉後重新開啟,再次連線。部分瀏覽器擴充功能、自行設定的代理或管理政策可能會覆蓋系統設定;如果瀏覽器被個別設定為直連,就不會使用這次設定的系統代理。請先確認瀏覽器使用系統代理,不要馬上修改伺服器協定。Android 裝置則要檢查該瀏覽器是否被應用程式分流規則排除,尤其是曾設定自訂代理範圍的裝置。

返回用戶端日誌,依剛才連線的時間尋找目標請求。可見內容會隨日誌層級與核心而異:如果有出站記錄,可據此判斷流量是直連還是走代理;如果沒有詳細記錄,不應直接認定請求沒有進入用戶端,也不要為了增加日誌內容而長時間啟用過於詳細的記錄。分享日誌前,請遮蔽訂閱網址、伺服器網址與身分參數,只保留排查問題所需的錯誤片段。

用戶端內建的連線測試或延遲測試,可用來協助排除明顯無法使用的項目,但測試目標與方法和日常連線並不完全相同。測試成功不保證每個應用程式都能連線;測試失敗也可能是測試網址本身的問題。最終應綜合實際應用程式的連線請求、相關執行日誌與可重現的結果來判斷。

連線失敗時,每次只檢查一個環節

如果所有頁面都無法連線,先確認本機核心仍在執行,再檢查系統代理指向是否與實際監聽連接埠一致。如果直連頁面正常,但應走代理的頁面無法連線,請優先檢查目前使用的伺服器、訂閱有效性與遠端連線錯誤。如果只有一個應用程式無法連線,先確認它是否遵循系統代理,或是否納入 Android 接管範圍。逐步檢查可區分本機接管問題與遠端連線問題,不必刪除所有設定重頭開始。

如果日誌明確顯示網域名稱解析錯誤,再檢查 DNS 設定。先記下目前設定值,確認網路本身是否能正常解析,再參閱完整手冊中的 DNS 與路由說明逐項調整。不要一次更換 DNS、路由預設、核心與伺服器,否則即使恢復正常,也很難判斷是哪個設定生效。若想了解「網域名稱解析」與「路由分流」的差異,可先閱讀術語手冊。

確認連線正常後的設定保留與結束使用

兩類目標都能依預期連線,且日誌沒有持續出現啟動或連線錯誤時,就可以保留這次的基本設定。記下目前使用的群組、伺服器、代理模式與路由預設;平時只需在有需要時更新訂閱,不必每次啟動都重新匯入。更新訂閱可能會移除舊項目;更新後若有異常,先確認目前使用的伺服器是否仍在清單中,再檢查其他設定。

桌面版結束使用時,先在 v2rayN 中選擇「清除系統代理」,再結束用戶端;如果曾啟用其他接管方式,也要先關閉。如此可避免系統繼續將請求傳送至已停止的本機監聽連接埠。Android 則在 v2rayNG 中點選停止,並確認系統 VPN 狀態已結束。下次使用時,依序啟動用戶端、確認目前使用的設定,再啟用相應的接管方式即可。

下載v2rayN