適合第一次在桌面電腦上使用 v2rayN 的讀者。先依作業系統和處理器選擇套件,確認主視窗與代理核心都能啟動;接著匯入已知可用的節點,並用瀏覽器測試系統代理。最後確認清除代理後能否恢復直接連線,將安裝、節點與應用程式連線問題分開排查。
Windows 與 macOS 首次啟動
先確認安裝套件符合電腦架構。Windows 可前往「設定」→「系統」→「系統資訊」(部分版本會顯示為「關於」)查看「系統類型」;標示 x64 的套件適用於 x64 處理器,別只看作業系統是否為 64 位元。macOS 可在「關於這台 Mac」查看「晶片」或「處理器」:Apple 晶片選 arm64,Intel 處理器選 x64。
依發布套件類型啟動
Windows
- 如果下載的是 ZIP,請先選擇「全部解壓縮」。開啟解壓縮後資料夾中的
v2rayN.exe,不要在壓縮檔預覽視窗中啟動,也不要只把主程式拖到桌面。 - 請將資料夾放在目前帳戶可寫入且位置固定的路徑。如果下載的是附有安裝精靈的 EXE,請依照精靈完成安裝,再從開始功能表啟動;ZIP 套件不適用這些步驟。
- 桌面版與 WPF 版是介面套件選項,不是節點協定選項。首次安裝時先保留一個版本,避免兩個執行個體同時監聽同一個連接埠。
macOS
- 開啟 DMG,將 v2rayN 拖移到「應用程式」。複製完成後退出磁碟映像,再從「應用程式」啟動;不要一直從已掛載的視窗執行。
- 如果下載的是壓縮檔,請先解壓縮,再將完整的 App 移到「應用程式」。不要從 App 封裝中單獨取出同名的可執行檔來啟動。
- 如果系統阻止開啟,請先確認套件來源、架構與發布說明。若提示 App 已損毀,請重新下載對應套件;排查時不要關閉系統安全檢查。
先確認主視窗能正常開啟,關閉後也能再次啟動。完成這項檢查後,再匯入節點並調整系統代理。
執行階段與本機連接埠
Windows 上按兩下後若出現「You must install .NET to run this application」,請先確認提示中的框架名稱、主版本與架構。例如提示缺少 Microsoft.WindowsDesktop.App 8.0 x64,就安裝相對應的 .NET 8 Desktop Runtime x64;只安裝相同主版本的一般 .NET Runtime,不一定能滿足桌面程式的需求。不同發布套件的需求可能不同,別將 .NET 8 視為固定條件。若使用標示為自包含的套件,主視窗已能開啟、只有連線失敗時,請先查看核心記錄,不必重複安裝執行階段。
前往「設定」→「參數設定」查看本機監聽設定。新版常見「本機混合監聽連接埠」,同一個連接埠可接收 HTTP 和 SOCKS 要求;舊版則可能分開設定兩種連線入口。上述數字僅供辨識常見設定,請勿單憑數字判斷代理類型。手動設定應用程式時,請以目前設定為準,位址填入 127.0.0.1,連接埠填入對應入口;這不是節點的遠端位址,也不必為了本機使用而啟用「允許來自區域網路的連線」。
如果記錄出現 address already in use,請先關閉舊執行個體或其他占用相同連接埠的程式。確定需要變更連接埠時,請在參數設定中儲存新值、重新啟動核心,再重新套用系統代理;已手動設定代理的應用程式也要同步更新。只變更用戶端的監聽連接埠,瀏覽器仍可能向舊連接埠傳送要求。
匯入節點與選擇核心
v2rayN 是桌面介面,負責管理節點並啟動核心;核心則依節點設定建立連線。初次設定時只要匯入一組訂閱或一個已知可用的節點,再將它設為目前使用的伺服器。先使用預設核心設定進行測試;只有節點要求特定傳輸或安全選項,或記錄明確指出設定不受支援時,才需要更換核心。
- 取得訂閱網址後,開啟「訂閱分組」→「訂閱分組設定」,新增分組,在「地址(url)」貼上完整網址並儲存。回到主視窗,從「訂閱分組」選單執行不透過代理的更新;如果目前網路無法連上訂閱網址,請先確認訂閱的存取條件,不要一再更換核心。
- 取得單一
vmess://或vless://分享連結時,請複製完整連結,並從「伺服器」選單選擇「從剪貼簿匯入批次 URL」;也可在主視窗取得焦點時按 Ctrl + V(Windows)。請勿將分享連結貼到訂閱分組的網址欄位。 - 確認節點已出現在目前分組中,按兩下目標列將它設為目前使用的伺服器,再查看記錄是否有核心啟動錯誤。若要檢查核心類型,請前往「設定」→「參數設定」尋找「Core類型設定」;介面文字可能因發布版本而異。
Xray 核心
建議節點明確使用 VLESS 與 REALITY 時,優先選用 Xray,並保留匯入連結時帶入的傳輸與安全參數。Xray 也支援常見的 VMess 設定,不必只因連結以 vmess:// 開頭就更換核心。
適用情境:首次設定 VLESS + REALITY,或使用來源未要求改用其他核心的常見 VMess 節點。
V2Ray 核心
如果目前版本提供此選項,而且節點文件明確要求使用 V2Ray 重現特定 VMess 設定,可依文件選擇。不要把缺少核心檔案、連接埠衝突或節點逾時都當成相容性問題。
適用情境:有明確版本與設定要求的 VMess 環境。
訂閱更新成功只代表用戶端取得了節點清單,不代表清單中的節點都能連線。「Core類型設定」可能影響其他使用相同協定的節點;變更前先記下原本的選項,每次只調整一項。如果錯誤訊息指出找不到核心執行檔,請先確認所選發布套件是否包含對應核心,以及是否已完整解壓縮;不要靠修改協定欄位來試錯。
系統代理與瀏覽器測試
先讓瀏覽器使用系統代理,不要同時啟用 TUN,也不要另外修改瀏覽器的手動代理設定。這樣才能單獨確認「應用程式是否連上本機代理」。路由是下一步:流量進入核心後,路由規則才會決定直接連線或透過節點。啟用系統代理不代表所有應用程式都會使用代理,也不代表所有目的地都會經過節點。
| 系統代理選單 | 實際作用 | 首次設定建議 |
|---|---|---|
| 自動設定系統代理 | 寫入系統代理設定,供遵循系統設定的應用程式使用。 | 將節點設為目前使用的伺服器後,用此模式測試瀏覽器連線。 |
| 清除系統代理 | 清除系統代理設定,但不會關閉程式,也不會清除應用程式自行儲存的代理設定。 | 測試結束後用來恢復直接連線;電腦若有公司代理設定,請先記下原值,以便還原。 |
| 不變更系統代理 | 不會改寫目前的系統代理,也不會主動清除先前留下的設定。 | 只想為特定應用程式手動設定本機代理,或需要保留現有系統設定時使用。 |
- 在 v2rayN 的系統匣選單或主畫面開啟「系統代理」,選擇「自動設定系統代理」。Windows 前往「設定」→「網路和網際網路」→「Proxy」確認目前設定;macOS 前往「系統設定」→「網路」→目前網路服務的「詳細資訊」→「代理伺服器」,確認位址和連接埠。
- 使用支援系統代理的瀏覽器開啟一個已知可用的 HTTPS 網頁,重新整理一次並查看 v2rayN 記錄。出現要求記錄只代表流量進入核心;若要確認是否經過節點,請再查看該要求的出口是代理還是直接連線。
- 測試完成後選擇「清除系統代理」,再用同一個瀏覽器開啟原本可直接連線的網頁。確認已恢復後再關閉程式,避免核心已停止,應用程式卻仍向本機代理連接埠傳送要求。
首次啟動常見問題
按兩下沒反應,是因為沒安裝執行階段嗎?
先查看系統匣或選單列是否已經有 v2rayN;也可能只是視窗沒有顯示在最前面。若找不到執行中的程序,再檢查架構、解壓縮目錄與執行階段提示。如果主視窗能開啟但核心無法啟動,請查看主畫面的記錄,優先處理第一則啟動錯誤。
延遲測試有數值,為什麼網頁還是打不開?
延遲測試不代表瀏覽器已經使用代理。請先選取目前使用的節點並套用「自動設定系統代理」,再確認系統顯示的連接埠與核心監聽連接埠相同。重新整理網頁時若沒有要求記錄,請檢查瀏覽器是否設定了自己的代理,或代理設定是否由擴充功能接管。
瀏覽器能開啟,其他軟體還是連不上?
先確認該軟體是否會讀取系統代理。如果有獨立的代理設定,請依照軟體支援的 HTTP 或 SOCKS 類型填入本機連線入口,再分別測試。若軟體不支援系統代理,也沒有手動代理設定,反覆切換 v2rayN 的系統代理模式也不會改變它的連線方式。
關閉 v2rayN 後,為什麼連直接連線的網頁也打不開?
重新開啟 v2rayN,選擇「清除系統代理」。如果程式無法開啟,請前往系統的代理設定頁面,移除這次設定留下的本機代理;若電腦原本有工作網路要求的代理設定,請還原先前記下的值。只有單一應用程式仍無法連線時,再檢查該應用程式自己的代理設定。