第一次在 Windows 或 macOS 使用 v2rayN,先選對安裝套件並確認設定能儲存,再匯入可信來源的節點或訂閱,最後開啟系統代理並測試瀏覽器。遇到問題時,依序檢查「程式能否啟動、核心是否正在監聽、應用程式是否經由代理連線」,每次只調整一項設定。
選對安裝套件:先確認處理器與執行環境
v2rayN 是用來管理設定的桌面用戶端;實際建立連線的是它啟動的核心,例如 Xray。視窗能開啟,只代表用戶端已啟動。如果套件未包含所需核心,或系統阻止核心執行,選取節點後仍可能無法連線。
Windows 與 macOS 安裝前檢查
Windows
- 前往「設定」→「系統」→「關於」,查看「系統類型」,再依 x64 或 ARM64 選擇對應套件。
- 使用壓縮檔時,先完整解壓縮至目前使用者可寫入的固定資料夾,例如
%LOCALAPPDATA%\v2rayN,再執行v2rayN.exe。不要只把主程式拖到桌面,也不要直接從壓縮檔預覽畫面啟動。 - 若啟動時提示缺少 .NET,請依提示及套件說明安裝相符主版本與架構的執行階段。傳統 WPF 版若明確要求
Microsoft.WindowsDesktop.App,請安裝 .NET Desktop Runtime,而非一般的 .NET Runtime。
macOS
- 從蘋果選單開啟「關於這台 Mac」:若顯示 Apple 晶片,選擇 ARM64;若顯示 Intel 處理器,則選擇 x64。
- 依發布套件格式解壓縮或開啟磁碟映像,將
v2rayN.app移至「應用程式」後再啟動;不要把已掛載的磁碟映像當作日常執行位置。 - 若系統阻止程式啟動,先閱讀提示並確認套件來源與架構。只有在確認來源可信,且系統針對這次啟動提供個別授權選項時,才前往「系統設定」→「隱私權與安全性」處理;不要關閉全域安全檢查。
先以一般權限啟動;只有遇到明確的執行階段或寫入錯誤時,才依提示處理,不要預設以系統管理員權限執行。
初次設定:匯入節點並測試瀏覽器
節點是單一伺服器的連線設定;訂閱則是透過連結一次取得多個節點。初次使用時只匯入一個來源,發生問題時較容易分辨是訂閱未取得,還是個別節點無法使用。以下以 v2rayN 7.x 中文介面的常見選項為例,不同版本的按鈕名稱可能略有差異。
確認設定可以儲存
前往「設定」→「參數設定」,確認視窗能正常開啟。匯入後正常關閉再重新開啟,檢查群組是否仍在;若每次重開都變成空白,先確認程式是否從暫存資料夾執行,以及記錄檔是否顯示設定寫入失敗。
匯入單一來源
取得訂閱連結後,開啟「訂閱分組」→「訂閱分組設定」,新增一個群組,填入方便辨識的備註與訂閱網址並儲存。回到主畫面選取該群組,再使用「訂閱分組」→「更新目前訂閱(不透過代理)」測試一次。若取得的是單一節點連結,請複製連結,使用「伺服器」→「從剪貼簿匯入分享連結」匯入,不要將節點連結填入訂閱網址欄位。
啟用節點並查看記錄
在清單中的節點上按右鍵,選擇「設為活動伺服器」;部分版本也可按兩下切換。查看主視窗的記錄區,先確認沒有核心啟動失敗或監聽失敗,再繼續操作。清單中出現節點,只代表設定已匯入,不代表遠端節點可用。
開啟系統代理
從用戶端選單開啟「系統代理」,選擇「自動設定系統代理」。系統代理是作業系統提供給支援此設定的應用程式使用的代理設定,不會接管每個程式。初次測試時先不要開啟 TUN(虛擬網卡接管模式),也先保留現有路由規則,避免同時改變流量入口與分流方式。
比對網頁與記錄
使用支援系統代理的瀏覽器開啟新分頁,前往平常能連線的 HTTPS 網站,並查看同一時間的核心記錄。網頁成功開啟不代表該連線一定經過遠端代理:路由分流會依規則決定流量直連或交由代理處理;若記錄顯示直連,只能證明該直連路徑可用。
本機連接埠占用:先查監聽狀態,再調整設定
本機監聽連接埠是應用程式連線至本機代理的入口,不是訂閱中伺服器的遠端連接埠。v2rayN 常見的本機入口預設連接埠為 10808,實際設定請以「設定」→「參數設定」中的本機監聽設定及啟動記錄為準。只有記錄出現繫結失敗、地址已被使用等訊息時,才優先檢查連接埠衝突。
查看哪個程式占用了連接埠
在 Windows 開啟 PowerShell,查看監聽記錄中的處理程序編號 OwningProcess,再到工作管理員的「詳細資料」頁籤依 PID 找出對應程式。
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
在 macOS 開啟「終端機」,查看輸出中的 COMMAND 和 PID。若本機實際設定的連接埠不是 10808,請先將指令中的數字改為記錄顯示的錯誤連接埠。
lsof -nP -iTCP:10808 -sTCP:LISTEN
- 若確認是另一個已啟動的 v2rayN,請從選單正常結束舊執行個體後再試。看到 Xray 程序不一定代表有衝突:若它屬於目前的執行個體,且目前記錄沒有錯誤,監聽就是預期行為。
- 若連接埠由其他必須保留的軟體使用,不要結束不熟悉的程序。確認替代連接埠可用後,前往「設定」→「參數設定」修改本機監聽連接埠,讓核心重新啟動,再重新套用系統代理。曾手動設定代理位址的應用程式,也需要更新連接埠。
- 若只在這台電腦上使用,請維持迴送位址監聽,不要為了解決衝突而開啟「允許來自區域網路的連線」。更換連接埠也無法修復遠端驗證錯誤或失效的訂閱網址。
常見問題:依症狀找出問題所在
點開應用程式後閃一下就消失,該先檢查什麼?
先重新確認架構與解壓縮位置。若 Windows 仍沒有出現視窗,請前往「事件檢視器」→「Windows 記錄」→「應用程式」,查看剛才啟動時間的應用程式錯誤或 .NET 執行階段記錄,並依記錄指出的缺少項目處理。若 macOS 顯示無法開啟,先確認是系統安全性提示,還是套件損毀或架構不符;後兩種情況應優先重新下載相容套件,不要靠提高權限解決。
訂閱已儲存,為什麼清單還是空的?
先確認目前選取的群組,再檢查網址是否含多餘空格或換行,並手動更新目前群組。若記錄顯示 401 或 403,請向訂閱服務提供者確認連結是否仍有效;若發生逾時,且手邊已有可用連線,再試試「更新目前訂閱(透過代理)」。沒有可用連線時,反覆切換這個選項也無法讓本機代理憑空連線。
節點測得到延遲,為什麼瀏覽器還是無法開啟網頁?
先確認已選擇「自動設定系統代理」,而不只是選取節點。在 Windows 前往「設定」→「網路和網際網路」→「Proxy」檢查是否生效;在 macOS 前往「系統設定」→「網路」→目前網路服務的「詳細資訊」→「代理伺服器」確認。若瀏覽器或擴充功能另有設定代理,先改用遵循系統設定的瀏覽器交叉測試。延遲測試成功只代表該次測試請求完成,不保證網頁所需的所有連線都正常。
結束 v2rayN 後,網頁反而無法開啟?
若原本沒有公司代理或手動代理設定,請重新開啟 v2rayN,在「系統代理」中選擇「清除系統代理」,再正常結束程式。若電腦原本依賴公司代理或自動設定指令碼,請依原設定還原,不要一律清除。尤其程式異常結束後,請確認系統沒有繼續將請求傳送至已停止監聽的本機連接埠。
完成初始設定後,保留可還原的狀態
先測試完整的開啟與關閉流程,再考慮開機啟動或較複雜的分流設定。正常結束程式後重新開啟,確認群組仍在;需要代理時檢查瀏覽器與記錄,不使用代理時確認電腦能恢復原本的網路設定。日後升級或更換套件遇到問題時,就能用這組已知可用的設定作為比對依據。
- 記下用戶端版本、套件架構與實際本機監聽連接埠。尋求協助時附上完整錯誤訊息與發生時間,比只說「連不上」更容易找出原因。
- 截圖或複製記錄前,請遮蔽完整訂閱網址、存取權杖與節點帳密;訂閱網址通常不只是一般網頁網址。
- 確認測試穩定後,再逐項開啟自動啟動或自訂路由。若調整後立刻出現問題,先還原最後一項變更,不要同時更換核心、節點和連接埠。