· 入門指南 · 約 8 分鐘

v2rayN 初次安裝設定指南:Windows 與 macOS 步驟及常見問題

依序整理解壓縮位置、執行環境、核心選擇、本機連接埠、系統代理與首次匯入訂閱等 v2rayN 必要設定,並說明新手常見問題。

本文重點

本文適合第一次在 Windows 或 macOS 設定 v2rayN 的讀者。先確認用戶端與核心都能正常啟動,再匯入訂閱、選取節點並確認監聽連接埠,最後開啟系統代理,使用同一個應用程式測試設定是否生效。遇到問題時,先找出故障發生的步驟,再調整相應設定。

安裝檔、解壓縮位置與執行環境

請依作業系統與處理器架構選擇安裝檔。x64 適用於 64 位元 Intel 或 AMD 處理器;ARM64 適用於 Windows ARM 裝置或搭載 Apple 晶片的 Mac。系統是 64 位元,不代表處理器架構就是 x64。以下以 v2rayN 7.x 常見介面為例;不同小版本或建置版本的選單文字與位置可能略有差異。

核心類型:依節點需求選擇

v2rayN 是桌面用戶端,代理核心則負責讀取節點設定並建立連線。請依節點實際使用的協定、傳輸方式與安全性設定判斷,而不是看訂閱群組名稱。例如 VLESS 是協定,REALITY 是安全性設定的一部分,不能在核心下拉選單中把這兩個名稱當成核心來找。

初次安裝的兩種選擇

Xray 核心

建議

如果伺服器明確指定 VLESS、REALITY 與 Vision 流量控制,請優先依伺服器要求使用 Xray。匯入後保留原有欄位,不要自行把一般 TLS 節點改成 REALITY 節點。

適用情況:節點明確要求使用 Xray,或訂閱包含依賴 Xray 功能的設定。

V2Ray 核心

如果服務提供者註明使用 V2Fly 的 V2Ray 核心,請依其文件確認協定與傳輸方式。VMess 搭配 WebSocket 和 TLS 不代表一定要更換核心;只有在用戶端提供該選項、核心已就緒且設定受到支援時,才考慮切換。

適用情況:服務提供者提供明確的 V2Ray 核心設定說明,且節點需要依照說明設定。

首次匯入訂閱並啟用系統代理

訂閱網址用來取得節點清單,不等於單一節點連結。請先準備服務提供者給的訂閱網址與群組名稱。首次測試只選一個節點,不要同時調整 DNS、路由與 TUN;這樣日誌出現錯誤時,較容易找出原因。

從空白清單到連線測試

  1. 新增訂閱群組

    在主視窗開啟「訂閱群組」→「訂閱群組設定」,新增群組、填寫備註與訂閱網址後儲存。部分版本可從群組列上的「+」新增。貼上網址時請確認內容完整,尤其不要刪掉問號後的參數;這些參數可能包含存取憑證,請勿放進公開截圖。

  2. 更新目前的訂閱

    選取新建的群組,在「訂閱群組」選單中尋找「更新目前的訂閱」相關選項。若目前沒有可用代理,先選擇「不透過代理」更新;更新後回到該群組,確認清單中確實出現節點。更新成功只代表用戶端已取得並解析清單,不代表清單中的節點已可連線。

  3. 設為使用中的節點

    在清單中對節點按右鍵,選擇「設為活動伺服器」,並確認主視窗顯示的使用中節點與剛才所選相同。若要確認預設核心,請前往「設定」→「參數設定」→「Core 類型設定」,查看對應協定;如果版本允許為單一節點指定核心,也請一併確認該節點設定。

  4. 確認本機監聽狀態

    查看主視窗狀態列與日誌,再前往「設定」→「參數設定」查看本機監聽設定。若目前顯示的混合連接埠是 10808,後續就檢查此連接埠;若顯示其他數值,請以實際設定為準。日誌若顯示連接埠遭占用或核心啟動失敗,請先排除監聽問題,不要急著開啟系統代理。

  5. 啟用代理並測試

    在系統匣選單或主視窗的「系統代理」入口選擇「自動設定系統代理」。使用遵循系統代理設定的瀏覽器開啟測試頁面,同時查看用戶端日誌是否出現相應請求。若切換前後網頁都能開啟,請進一步確認路由結果:日誌中出現請求,不代表請求一定是透過目前節點轉送。

確認本機連接埠與系統代理

本機監聽位址是應用程式將請求交給 v2rayN 的入口;訂閱中的伺服器位址與連接埠則供核心連線至遠端使用。兩者不可互相填入。初次使用請維持僅限本機監聽,不要開啟「允許來自區域網路的連線」。

兩處設定的確認項目

用戶端監聽

本機位址
127.0.0.1
混合連接埠範例
10808,以介面顯示為準
區域網路存取
關閉
異常線索
address already in use 表示監聽位址與連接埠已被占用

混合連接埠可接收 HTTP 與 SOCKS 請求;若介面分別列出兩種連接埠,請依應用程式選用的代理類型填入相應數值。

系統代理

Windows 檢查位置
「設定」→「網路和網際網路」→「Proxy」
macOS 檢查位置
「系統設定」→「網路」→ 目前的網路服務 →「詳細資訊」→「Proxy」
瀏覽器測試
使用系統代理設定,不要同時啟用瀏覽器自訂的代理規則
結束前
在用戶端選擇「清除系統代理」,必要時還原先前記錄的設定

系統代理只會影響遵循該設定的應用程式。結束前清除設定,可避免應用程式繼續向已停止的本機連接埠發送請求。

常見故障:依症狀排查

先記下故障發生時間、使用中的節點與本機連接埠,再重現一次。請分別確認三件事:訂閱能否下載、核心是否正在監聽,以及應用程式的請求是否依預期送出。每次只調整一項,修改後用同一個應用程式開啟同一個頁面,才能判斷設定是否生效。

初次設定常見問題

訂閱顯示更新成功,為什麼清單還是空的?

先選取剛更新的群組,並清除清單搜尋條件,再確認更新的是目前群組還是其他群組。如果日誌顯示解析失敗,請向服務提供者確認該網址回傳的是 v2rayN 支援的訂閱格式,而不是登入頁面或帳戶頁面;回報問題時只提供已去除敏感資訊的錯誤訊息。

訂閱更新逾時,需要改成透過代理嗎?

先確認目前網路可以正常開啟一般網頁,再檢查訂閱網址與用戶端日誌。如果已有經驗證可用的使用中節點,可以試著選擇「透過代理」更新,並保留兩次結果以便比較。剛安裝、清單中還沒有節點時,切換更新方式無法憑空建立代理,應先向服務提供者確認網址的存取條件。

連接埠遭占用,可以直接改成 10818 嗎?

可以先檢查是否有重複執行的用戶端。正常結束舊的執行個體後再試一次。如果原連接埠必須留給其他應用程式使用,而且 10818 尚未被占用,可以將混合連接埠改成此數值並重新載入核心,再讓 v2rayN 重新套用系統代理。先前手動輸入連接埠的應用程式也要一併修改,否則仍會連到舊連接埠。

網頁顯示連線遭拒,是節點失效了嗎?

先確認錯誤訊息指向哪個位置。如果遭拒的是 127.0.0.1:10808,請先確認核心是否已啟動,以及應用程式設定的連接埠是否與目前監聽的連接埠一致。如果用戶端已收到應用程式請求,但日誌顯示連線遠端失敗,再確認節點位址、連接埠與目前網路狀態。不要把本機入口的錯誤當成遠端故障。

結束 v2rayN 後,為什麼瀏覽器無法上網?

檢查系統代理是否仍指向本機連接埠,也確認瀏覽器是否手動設定了代理。如果殘留的是本次測試新增的設定,可以重新開啟用戶端,選擇「清除系統代理」後再結束程式測試;如果電腦原本有公司或學校的代理設定,請依照測試前的紀錄還原,不要直接覆寫。

下載用戶端