快速上手 / 訂閱 → 模式 → 連線 → 確認

v2rayN 訂閱匯入
與系統代理教學

以 Mac 版 v2rayN 為主。預留約十分鐘,先確認瀏覽器請求能正常通過,再設定 TUN、DNS 與自訂分流。

開始前,先安裝並開啟用戶端,準備一個來自可信來源且仍在有效期限內的訂閱連結。用戶端負責讀取設定並轉送請求,不會自動提供可用的遠端伺服器。訂閱帳號的有效期限、可用流量與裝置限制,請至訂閱服務提供者的帳戶頁面確認;這些條件與用戶端是否已在本機成功安裝無關。

首次操作建議只開啟一個代理用戶端,並暫時關閉其他會接管網路的工具,以免系統代理設定反覆遭到覆寫。先不要一次調整整套進階設定。保留用戶端預設的本機監聽設定,逐項確認訂閱、伺服器選擇與瀏覽器連線;遇到問題時,才容易找出變化發生在哪個步驟。

步驟一:匯入訂閱並更新清單

先從訂閱服務提供者的帳戶頁面複製完整的訂閱網址。請複製用來更新伺服器設定的連結,而不是帳戶登入頁面或方案介紹頁面。網址通常包含驗證資訊,請勿貼到公開聊天室或截圖中;回報問題時應遮住整個網址,而不只是最後幾個字元。如果來源只提供 QR Code 或單一分享連結,請先確認連結類型,再使用用戶端對應的匯入入口。

在 v2rayN 新增訂閱群組

開啟 v2rayN 主視窗,在選單中找到「訂閱群組」,進入「訂閱群組設定」後選擇新增。為群組填寫容易辨認的備註,將完整網址貼到訂閱網址欄位,再儲存。不同版本的介面可能將新增功能放在加號或右鍵選單中,但目的都是建立一筆包含訂閱網址的群組記錄。此時儲存的是更新來源,伺服器清單暫時沒有變化,並不代表操作失敗。

回到主視窗,開啟「訂閱群組」選單,對剛建立的群組執行更新訂閱。首次尚未建立代理連線時,建議先選擇「不透過代理」更新;如果目前的網路確實無法連上訂閱網址,再考慮使用已確認可用的其他連線方式。更新完成後切換到該群組,正常情況下應該會看到伺服器記錄。先檢查群組篩選條件,避免把其他群組的空清單誤認為這次更新沒有結果。

如果清單仍是空的,請查看用戶端提示:網路逾時與內容解析失敗是不同問題。遇到前者,先確認訂閱網址能否連線,以及連結是否已過期;遇到後者,則需確認複製的內容是否為用戶端支援的訂閱格式。請勿將回傳的網頁內容直接寫入 config.json。訂閱網址、vmess:// 或 vless:// 單一分享連結,以及完整 JSON 設定各有不同的匯入入口,不能因為內容都是文字就混用。

在 v2rayNG 使用對應入口

在 v2rayNG 開啟側邊選單,進入「訂閱群組設定」,點選加號新增群組,填寫備註與訂閱網址後儲存。返回伺服器清單,在選單中執行「更新訂閱」,再查看對應群組。只新增群組但沒有更新時,可能看不到任何伺服器。若清單已有記錄,但訂閱變更後尚未同步,請再次更新,而不是一再新增相同網址。

完成這個步驟的判斷標準是:正確的群組下有可選擇的伺服器,且更新過程沒有持續出現錯誤。暫時不必逐一測試所有記錄,也不要手動修改伺服器參數。若想了解訂閱編碼與分享連結的差異,請閱讀訂閱入口與 Base64/URI 格式說明;準備繼續時,保留伺服器清單並進入代理模式設定。

步驟二:選擇系統代理與路由模式

清單中出現伺服器,只能代表設定已匯入,不能證明應用程式的請求已進入用戶端。請分清兩個問題:系統代理或 TUN 決定請求如何進入本機用戶端,路由規則則決定請求進入後要使用哪個出口。兩者不是同一層的設定。首次使用時,先透過系統代理確認瀏覽器連線,保留既有的基本路由預設,不要同時啟用 TUN 或修改 DNS。

了解系統代理的三種選項

v2rayN 的「自動設定系統代理」會嘗試將系統代理指向用戶端的本機監聽位址,讓遵循此設定的應用程式使用代理。「清除系統代理」用來移除系統代理設定,通常在停止使用或排查問題時選擇。「不變更系統代理」代表用戶端不會主動修改目前的系統設定,並不等於直接連線,也不代表代理已啟用:如果系統原本保留其他代理位址,該設定仍可能生效。

現在先找到這三個選項,確認操作位置。切換到「自動設定系統代理」前,請先依照下一步選定伺服器並確認核心已啟動。如果目前的系統代理指向未執行的程式,可以先清除,避免瀏覽器在準備過程中無法連線。之後進行自動設定時,請以用戶端顯示的本機監聽位址與連接埠為準,不要照抄其他教學中的固定連接埠。

先使用分流預設,再考慮 TUN

在用戶端的路由設定或路由選擇入口,選擇現有且符合目前用途的分流預設。分流表示部分請求直接連線,部分請求則交由代理出口;全域代理類預設會讓更多請求經由代理出口。實際行為取決於規則內容與順序,不能只看預設名稱判斷。首次測試時,選一個明確會套用代理規則的網站,同時保留一個直連網站作為對照。

TUN 透過虛擬網路介面接管流量,通常需要額外權限,也可能改變 DNS 與路由行為。它適合處理不遵循系統代理的應用程式,但首次連線失敗時,不應立刻再啟用這項設定。先關閉 TUN,透過系統代理確認基本連線;確實需要接管特定應用程式時,再依照完整文件中的平台章節個別設定,避免同時改動兩種接管方式,讓問題難以判斷。

v2rayNG 主要透過系統 VPN 介面接管應用程式流量,不需要尋找桌面版的系統代理三態選單。如果啟用了應用程式分流代理,請確認要測試的瀏覽器是否包含在接管範圍內。路由模式與應用程式清單都會影響結果,首次測試時建議沿用明確的基本設定,不要加入大量例外規則。選好模式後,下一步才是讓指定伺服器實際參與連線。

步驟三:選擇伺服器並啟動連線

回到 v2rayN 的伺服器清單,選擇一筆由訂閱服務提供者明確標示為可用、且符合目前用途的記錄。點選反白列有時只代表選取,並不表示已設為目前使用的伺服器。請透過右鍵選單的「設為活動伺服器」或目前版本提供的對應功能設定,並確認活動標記已移至該筆記錄。名稱相近的記錄可能使用不同協定或傳輸方式,請勿從一筆記錄複製欄位到另一筆拼湊設定。

先確認核心,再設定系統代理

v2rayN 通常會在套用活動伺服器後啟動或重新載入核心。開啟主視窗中的記錄區域,查看最新訊息,確認沒有持續出現設定解析錯誤、啟動失敗或連接埠遭占用。視窗已開啟不代表核心一定正常;如果本機監聽尚未建立,即使系統代理設定正確,也沒有本機服務可以接收請求。

如果記錄顯示連接埠遭占用,請先結束其他代理程式或同一用戶端的重複執行個體,再重新嘗試。不要隨意更換連接埠後,忘了同步系統設定。如果記錄指出設定欄位不受支援,請先確認用戶端版本與訂閱格式,不要刪除不熟悉的欄位來強行啟動。遇到安裝權限、應用程式開啟限制或平台執行環境問題,請參閱全平台安裝與設定文件;首次連線不必手動維護整份設定檔。

核心正常後,在 v2rayN 選單中選擇「自動設定系統代理」。macOS 使用者可前往「系統設定 → 網路」,選取目前使用的網路服務,再於「詳細資訊 → 代理」查看相關設定;不同系統版本的選單名稱與層級可能略有差異。請確認已啟用的代理項目指向本機,且連接埠與用戶端目前的監聽設定相符。只需檢查實際啟用的項目,不必開啟頁面中的所有代理類型。

安卓端點選連線並確認系統要求

在 v2rayNG 的伺服器清單中選取目標記錄,再點選連線按鈕。首次出現系統 VPN 連線要求時,先確認要求確實由目前使用的用戶端發起,再允許建立連線。系統狀態列出現連線圖示,表示接管介面已建立,但不能單憑此點判定遠端伺服器可連線。如果另有使用同類介面的網路工具正在執行,請先停止該工具,再重新連線,以免介面發生衝突。

連線後可先使用用戶端提供的測試功能作為參考,但測試失敗不一定代表所有應用程式都無法連線;測試成功也不代表每個應用程式都會使用相同路徑。不要只憑一次測試結果就連續更改多項設定。此時請保持伺服器、路由與接管模式不變,進入下一步,以實際瀏覽器請求確認完整連線。

步驟四:確認設定是否生效

開啟一個會遵循系統代理的瀏覽器,新增分頁,前往你有權使用且預期會套用代理規則的 HTTPS 網站。不要只查看先前已開啟的頁面:快取、既有連線與背景預先載入,都可能讓頁面看起來仍然正常。請重新載入頁面並執行一次新操作,同時查看用戶端記錄中新產生的連線,對照存取時間與相關記錄。

交叉確認頁面、記錄與系統設定

各項結果應彼此吻合:頁面能完成新的請求,用戶端能看到對應的連線活動,系統代理或安卓接管狀態也符合預期。如果記錄包含出口標籤,可進一步辨別請求是走 proxy 還是 direct;實際標籤由設定決定,不一定與範例相同。使用分流模式時,部分網站仍走直連是正常情況,因此不必要求每筆連線都使用代理出口。

再開啟一個預期會直連的頁面,確認基本網路連線沒有受到影響。如果使用出口位址查詢,請只把結果當作輔助資訊:分流規則可能讓查詢頁面本身走直連,而同一個瀏覽器的其他請求則走代理。查看出口位址前,應先確認查詢目標符合哪條規則,不要只因位址沒有變化就判定所有代理都失效。

發生異常時,一次檢查一個層級

如果所有頁面都無法開啟,先清除系統代理,確認基本網路是否恢復;安卓端則先中斷 v2rayNG 連線,再進行相同測試。基本網路正常後,回到用戶端查看核心狀態與活動伺服器。瀏覽器若顯示本機代理連線遭拒,通常應先檢查監聽服務與連接埠;如果請求已進入用戶端但遠端連線逾時,再檢查伺服器可用性、訂閱狀態及目前的網路環境。不要把不同層級的錯誤一概歸因於 DNS。

如果瀏覽器連線正常,但某個應用程式沒有變化,先檢查該應用程式的代理選項,以及它是否遵循系統代理。部分應用程式需要個別設定,其他則適合使用 TUN 接管。只有特定網域異常時,再檢查路由規則與 DNS 行為。更完整的分層排查方式請參閱完整文件中的常見設定問題;目前先保留已確認可用的瀏覽器連線,不要為了修復單一應用程式而推翻所有設定。

停止使用前還原網路設定

桌面版停止使用時,先選擇「清除系統代理」,再結束 v2rayN。只關閉主視窗可能只是隱藏介面;直接結束程序,也可能讓系統仍指向已停止的本機連接埠。結束後若瀏覽器無法連線,請前往系統網路設定檢查是否仍有代理設定,並還原至操作前的狀態。若裝置由公司或組織統一管理,請勿刪除原有的管理設定,並先確認可修改的範圍。

使用 v2rayNG 時,先點選中斷連線,確認系統連線圖示消失後再離開介面。最後記下本次測試成功的伺服器、路由預設與接管方式即可,不必記錄或公開訂閱網址。至此,訂閱更新、活動伺服器、請求接管與實際連線已形成完整流程。日後修改設定時也請依照相同順序,每次只調整一項,再以同一組目標確認;若發生問題,就能找到最近一次變更。