v2rayN 首次安裝與初始設定：Windows 與 macOS 通用重點及常見問題

v2rayN 7.x 已不只是傳統的 Windows 系統匣程式，現代桌面版本也支援 macOS 與 Linux。第一次使用時，真正需要處理的不是複雜的協定參數，而是程式目錄是否可寫入、執行環境是否完整、核心類型是否符合節點，以及系統代理是否處於預期狀態。依序確認這幾項設定後，之後匯入 VMess、VLESS 或訂閱網址時會清楚許多。

下載與解壓縮先處理程式目錄

v2rayN 桌面版通常以壓縮檔或應用程式套件形式發佈。Windows 使用者應先完整解壓縮壓縮檔再執行，不要在壓縮軟體的預覽視窗中直接雙擊主程式。預覽執行所使用的暫存目錄可能在關閉視窗後遭到刪除，資料庫、日誌與下載的核心檔案也可能無法穩定保存。

Windows 可選擇 D:\Apps\v2rayN、C:\Users\目前使用者\Apps\v2rayN 這類目前帳戶可寫入的固定目錄。不要直接放入需要額外系統管理員授權的系統目錄，也不要長期放在下載資料夾中反覆覆蓋。目錄路徑可以包含中文，但排查問題時，使用短路徑與英文目錄名稱更容易辨識日誌中的檔案位置。

1. 確認平台

   Windows 請先前往「設定」→「系統」→「系統資訊」查看系統類型，一般裝置選擇 x64；採用 ARM 處理器的裝置選擇 arm64。macOS 可在「關於這台 Mac」查看晶片類型，再選擇對應的版本。

2. 完整解壓縮

   Windows 請將壓縮檔解壓縮到固定目錄，確認主程式與同包檔案位於同一層級。不要只把可執行檔單獨拖出，否則程式可能找不到資源檔或核心目錄。

3. 首次啟動

   Windows 執行 v2rayN 主程式；macOS 將應用程式移至「應用程式」後開啟。系統出現來源確認時，請透過系統設定的安全性頁面核對應用程式名稱，再選擇允許開啟。

4. 檢查寫入權限

   啟動後修改一次介面語言或視窗設定，正常結束程式後再重新開啟。若設定能夠保留，表示設定目錄具備寫入權限；若恢復原狀，應先處理目錄權限，而不是反覆匯入節點。

macOS 的應用程式本體通常位於「應用程式」，設定與快取則由程式寫入目前使用者目錄。若應用程式放在唯讀磁碟映像中直接執行，應先關閉並移至「應用程式」。Windows 便攜式目錄與 macOS 應用程式目錄的組織方式不同，不應混合複製兩邊的程式檔案。

執行環境與核心決定程式能否啟動節點

v2rayN 的圖形介面與代理核心分屬兩個層次。介面負責保存訂閱、切換節點、修改路由及控制系統代理；Xray 或 v2fly 核心則負責監聽本機連接埠、建立出站連線並執行路由規則。能夠開啟主視窗，不代表代理核心已成功運作。

以 v2rayN 7.x 為例，Windows 版本可能需要相應架構的 .NET 8 Desktop Runtime。雙擊後完全沒有視窗、事件檢視器出現執行階段錯誤，或提示缺少 Microsoft.WindowsDesktop.App 時，應先安裝與程式架構一致的執行環境。x64 程式對應 x64 執行環境，arm64 版本對應 arm64 執行環境；只安裝另一種架構無法取代。

開啟「設定」→「參數設定」→「Core 類型」，優先確認目前使用的是 Xray。若訂閱節點含有 flow=xtls-rprx-vision、Reality 公開金鑰、短 ID 或指紋參數，就不應改用 v2fly 核心。核心不相容時，常見情況是節點可以匯入，網址與連接埠也存在，但啟動日誌提示不支援欄位或出站初始化失敗。

初始參數統一連接埠與系統代理行為

本機連接埠是瀏覽器、系統代理及其他應用程式連線至 v2rayN 的入口。不同版本或移轉設定可能使用不同的預設值，因此不要把教學中的連接埠視為固定值。前往「設定」→「參數設定」查看目前的本機監聽值，並確認沒有與開發伺服器、其他代理程式或舊版 v2rayN 執行個體衝突。

為方便第一次排查，可將本機 mixed 連接埠設定為 10808，監聽位址維持 127.0.0.1。這表示只接受本機連線，不會向區域網路開放。若介面分別提供 HTTP 與 SOCKS 連接埠，可使用 10809 作為 HTTP 範例值、10808 作為 SOCKS 範例值，但實際填寫內容必須與系統代理頁面及使用該代理的應用程式一致。

系統代理的三個常見動作含義不同。「設定系統代理」會將目前系統的 HTTP 或相關代理指向 v2rayN；「清除系統代理」會刪除這組代理值；「不變更系統代理」只啟動核心，不修改作業系統現有設定。首次設定建議先選「不變更系統代理」，觀察日誌確認 127.0.0.1:10808 已在監聽，再切換至「設定系統代理」。

如果只啟動節點卻沒有設定系統代理，瀏覽器可能仍會直接連線；如果關閉 v2rayN 後系統代理仍被保留，瀏覽器會繼續連線到已停止監聽的本機連接埠，結果是所有網頁立即載入失敗。遇到這種情況，重新開啟 v2rayN 並執行「清除系統代理」，或在作業系統的網路設定中關閉手動代理。

訂閱與節點依固定順序完成首次連線

訂閱網址是一份可更新的節點清單，VMess 或 VLESS 分享連結通常只代表一個節點。兩者都可以匯入 v2rayN，但後續維護方式不同：訂閱需要定期更新，單一連結則不會自動取得服務端新增或調整後的節點。匯入前應先確認剪貼簿內容完整，沒有多餘空格或換行截斷。

不同 v2rayN 7.x 小版本的選單文字可能略有調整，訂閱相關操作通常位於「訂閱群組」選單。先建立群組並儲存訂閱網址，再執行更新；只新增網址但未進行更新，不會自動在主列表產生節點。

1. 新增訂閱

   開啟「訂閱群組」→「訂閱群組設定」→「新增」，填寫容易辨識的別名與完整訂閱網址，儲存後返回主介面。

2. 更新群組

   執行「訂閱群組」→「更新全部訂閱」。狀態列應顯示新增或更新的節點數量；若顯示 0，請檢查群組是否啟用，以及網址是否完整。

3. 選擇節點

   在節點列表中選擇一個協定與核心相容的項目，設為活動伺服器。不要一次批次修改傳輸方式、TLS、SNI、UUID 或 Reality 參數。

4. 啟動核心

   啟動後開啟日誌，確認本機連接埠監聽成功，且沒有出現連接埠遭佔用、欄位不支援、網域名稱解析失敗或握手失敗。

5. 接管代理

   選擇「系統代理」→「設定系統代理」，再用瀏覽器造訪兩個不同的網站。接著切換回「清除系統代理」，確認瀏覽器能夠恢復直接連線。

延遲測試只能反映某次探測的回應結果，不代表完整的網頁流量一定可用。某個節點顯示 80 毫秒，仍可能因 TLS 參數、傳輸路徑或出口策略錯誤而無法建立實際連線。首次驗證應同時觀察節點延遲、核心日誌與瀏覽器造訪結果。

開機啟動與路由放在連線測試之後

開機啟動解決的是程式自動執行，不會自動修復無效節點、錯誤訂閱或連接埠衝突。建議至少完成一次啟動、連線、清除代理、結束程式與重新開啟的完整循環，再進入「設定」中的啟動選項啟用開機啟動。這樣可以避免系統每次登入後立即寫入一組無法使用的代理參數。

Windows 啟用開機啟動後，可前往「設定」→「應用程式」→「啟動」查看 v2rayN 是否處於啟用狀態。macOS 可在「系統設定」→「一般」→「登入項目」中核對。若 v2rayN 自身選項已開啟，但系統列表中沒有對應項目，應先關閉該選項、正常結束程式，再重新啟動並開啟一次。

• 開機啟動：只負責在使用者登入後執行 v2rayN，不代表節點一定能成功連線。
• 啟動時最小化：適合已完成設定的日常使用，首次排錯階段建議保留主視窗與日誌可見。
• 自動設定系統代理：應在活動節點穩定後啟用，並確認程式結束時會執行清理。
• 自動更新訂閱：先確保手動更新成功，再設定更新間隔，避免啟動階段同時出現多個變數。
• 路由模式：首次連線先使用內建基礎規則，不要同時匯入多份來源不明的自訂規則。

路由分流決定哪些網域或 IP 走代理、直接連線或封鎖，與系統代理是否開啟並不是同一層。系統代理負責將應用程式流量送至 v2rayN，本機核心再依據路由規則選擇出站。網頁無法開啟時，應先判斷流量是否進入本機連接埠，再確認是否被路由至正確的出口。

新手常見的誤區是一次開啟 TUN、替換 DNS、匯入路由規則並修改連接埠。這樣發生故障後，很難判斷是哪個步驟造成的。更穩妥的順序是：透過一般系統代理連線成功後，先保留一份可用設定；之後每次只修改一個項目，修改後查看日誌並重新測試。

常見啟動問題依現象逐項排除

排錯時不要頻繁重新安裝。v2rayN 的介面、設定資料庫、代理核心與系統代理分屬不同層次，先依現象定位層級更有效：程式無法開啟先檢查執行環境與目錄；程式能開但核心失敗先檢查連接埠與核心類型；核心正常但網頁失敗，再檢查系統代理、節點與路由。

如果日誌只顯示節點連線逾時，不要立刻修改 UUID、連接埠、傳輸路徑或伺服器名稱。這些欄位通常由訂閱提供，手動猜測會讓原本可以恢復的設定進一步偏離。請先更新訂閱、切換同一群組中的其他節點，並確認本機時間與時區正確，再判斷是否屬於單一節點故障。

完成首次設定後，建議記錄目前的 v2rayN 版本、核心版本、本機連接埠、啟用中的訂閱群組與系統代理模式。之後升級或移轉時，只要逐項比對這些資訊，就能快速判斷變化發生在圖形介面、核心、節點或作業系統網路設定。