v2rayN 初次安裝與設定：Windows、macOS 常見問題

先選對安裝檔：作業系統、架構與執行環境

先到下載頁面，依作業系統與處理器架構選擇安裝檔，別只看檔名裡的 v2rayN。Windows 桌面版與傳統 WPF 版的介面並不相同；WPF 版僅適用於 Windows，無法在 macOS 執行。macOS 則要分辨 Apple Silicon 與 Intel，分別下載 arm64 或 x64 版本。

v2rayN 是用來設定及管理代理的用戶端，實際處理連線的是核心。程式視窗能正常開啟，不代表核心已準備就緒。首次啟動若提示缺少執行環境，請先記下提示中的框架名稱、架構與需求，再依安裝檔說明補齊；不要憑印象安裝名稱相似的執行環境。

首次啟動：解壓縮位置與權限提示

Windows 壓縮檔必須完整解壓縮後再執行，不要直接在壓縮軟體的預覽視窗中雙擊主程式。可選擇目前帳戶有寫入權限的獨立資料夾，例如 D:\Tools\v2rayN。這只是路徑範例，電腦不一定要有 D 槽；重點是主程式、隨附檔案與子資料夾都要保留。

如果只把單一執行檔複製到桌面，用戶端可能會找不到核心或其他相依檔案。請先結束程式，再重新完整解壓縮，通常比逐一補檔更容易找出問題。也不要同時執行位於不同資料夾的兩個版本，否則看到的設定、記錄與連接埠可能各不相同。

1. 完整解壓縮

   在 Windows 中對下載的壓縮檔選擇「全部解壓縮」，再進入解壓縮後的資料夾啟動主程式。不要移動或刪除不熟悉的核心子資料夾。

2. 固定存放位置

   在 macOS 中將 App 複製到「應用程式」，退出磁碟映像檔後再開啟 App，避免持續從暫時掛載的位置執行。

3. 確認系統提示

   若遭系統阻擋，請先確認檔案來源與提示內容。macOS 通常可在「系統設定」→「隱私權與安全性」找到允許開啟的選項；僅對已確認來源的 App 操作，不要關閉整台電腦的安全防護。

4. 查看記錄

   進入用戶端的「記錄」區域，查看是否有缺少檔案、拒絕存取或連接埠占用等錯誤。選單位置可能因桌面版介面而異，請優先記下第一則具體錯誤訊息。

匯入訂閱：儲存網址不代表已取得節點

訂閱網址用來取得節點設定，不是節點名稱，也不是服務商的登入頁面。取得網址後，先在用戶端建立訂閱群組，再執行更新。只儲存群組而未更新，節點清單仍可能是空的；更新成功後，還要選取一個節點作為目前使用的伺服器。

不同桌面版介面可能將入口標示為「訂閱群組」或「訂閱群組設定」。以下依常見選單名稱說明操作；若按鈕名稱有所調整，請尋找「群組設定」與「更新訂閱」功能，不要照著他人的截圖任意修改其他選項。

1. 開啟「訂閱群組」→「訂閱群組設定」，選擇「新增」，填入方便辨識的名稱與完整訂閱網址。
2. 儲存後返回「訂閱群組」，對該群組執行「更新訂閱（不透過代理）」。初次使用、尚未建立可用代理時，這種方式較不依賴其他連線。
3. 若無法直接連線至訂閱網址，而手邊已有確認可用的代理節點，再試試「更新訂閱（透過代理）」。並非所有訂閱都必須使用這個選項。
4. 更新完成後查看節點清單，選取一個節點，透過右鍵選單中的「設為活動伺服器」或目前介面上的對應功能啟用。
5. 若出現解析錯誤，請確認網址是否完整、是否誤貼網頁網址，以及訂閱提供者是否提供用戶端可辨識的格式。

節點能匯入，只代表設定已被辨識，不代表能連上伺服器。訂閱網址也常包含存取憑證，請勿將完整網址貼到公開截圖中。需要求助時，保留錯誤訊息與協定類型，並遮蔽訂閱參數、使用者識別資訊與伺服器敏感資料。

選擇核心：協定參數必須相符

V2Ray 與 Xray 是核心專案，v2rayN 則是桌面用戶端，三者並非同一名稱的不同寫法。VMess、VLESS 是節點協定；WebSocket 是傳輸方式；TLS 則是連線保護機制。選擇核心時，應確認它支援整組節點設定，不要只看清單中的協定縮寫。

若節點使用 REALITY、xtls-rprx-vision 等參數，請選擇支援相應組合的 Xray，並確認用戶端能正確產生設定。常見入口為「設定」→「參數設定」→「Core 類型」；部分介面會將此項獨立列為「Core 類型設定」。修改後重新啟用活動節點，再查看記錄中的實際啟動結果。

• 先保留匯入值：網址、連接埠、使用者識別碼、傳輸方式、路徑、SNI 與公鑰等欄位由提供者決定，不要為了「最佳化」而自行猜測填寫。
• 接著確認支援範圍：若出現「不支援的欄位」或設定載入失敗，請檢查目前選用的核心及其設定支援範圍，不要先修改 DNS。
• 最後排查連線錯誤：若設定載入成功但連線仍逾時，再檢查網路、伺服器狀態與節點資訊。連線逾時不等於解析失敗。

系統代理：確認本機位址與監聽連接埠

首次測試網頁時，建議先使用系統代理。在 v2rayN 的「系統代理」中選擇「自動設定系統代理」，再確認作業系統記錄的代理位址與連接埠。這項操作會讓使用系統代理的 App 連線至本機用戶端，不是把遠端伺服器位址直接填入系統設定。

以下兩個連接埠僅供排查時參考，不要求覆寫現有設定，也不代表每個版本都預設使用這些連接埠。不同用戶端介面可能採用混合監聽，或分別提供 HTTP 與 SOCKS 監聽；混合監聽可在同一連接埠處理兩種代理協定，分開監聽則需分別確認。

若記錄顯示連接埠已被占用，請先關閉重複執行的用戶端與其他代理程序，再重試。若確實需要變更連接埠，修改用戶端的監聽設定後，請重新執行自動設定系統代理，並確認系統端的連接埠已同步。只修改其中一處，可能導致程式正常開啟、節點已選取，但瀏覽器仍無法連線。

驗證與收尾：每次只變更一個條件

驗證時，先固定使用一個活動節點、一組已知路由設定，以及一種流量接管方式。系統代理只會影響遵循該設定的 App；有些程式會使用自己的代理選項，或直接連線。瀏覽器能開啟網頁，不代表所有 App 都已透過代理連線；節點延遲測試有結果，也不代表目標網站一定能正常使用。

路由分流會決定哪些連線直接連線、哪些經由代理。初次測試請使用用戶端提供、定義清楚的預設設定，並記下目前選項。只有需要分辨「規則未命中」與「節點無法使用」時，才暫時切換至全域代理測試；測試完成後請還原原本的分流設定。

• 程式視窗無法開啟：回頭檢查安裝檔、架構與執行環境，先不要處理訂閱。
• 節點清單空白：檢查群組是否已儲存、更新結果與訂閱格式。
• 啟動節點時發生錯誤：檢查核心支援、設定產生情況與本機連接埠是否被占用。
• 瀏覽器顯示代理連線失敗：先確認本機監聽與系統代理的連接埠，不要直接認定是伺服器故障。
• 只有部分網站無法開啟：接著檢查路由規則是否命中、DNS 解析，以及節點能否連線至目標網站。

設定完成後，記下安裝資料夾、活動節點、所選核心、監聽連接埠與系統代理狀態。下次遇到問題，從最後一次變更的項目開始檢查。升級前請備份設定；不要任意混用新舊資料夾中的設定與核心，也不要在確認新版本可用前刪除原有設定。