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

下載前先確認系統與處理器架構

v2rayN 7.x 的桌面介面可在 Windows 與 macOS 上執行，但兩個平台使用的檔案格式不同，處理器架構也必須相符。Windows 常見裝置使用 x64，採用高通處理器的部分裝置使用 arm64；較舊的 32 位元系統不適合直接套用目前的 64 位元版本。macOS 裝置則需區分 Intel x64 與 Apple 晶片 arm64。

在 Windows 開啟「設定」→「系統」→「系統資訊」，查看「系統類型」。顯示「以 x64 為基礎的處理器」時選擇 x64，顯示「以 ARM 為基礎的處理器」時選擇 arm64。在 macOS 開啟系統資訊，若晶片名稱為 Apple M 系列則選擇 arm64，若處理器為 Intel 則選擇 x64。架構選錯時，常見結果是程式完全沒有視窗，或系統直接提示應用程式無法執行。

Windows 壓縮檔不能直接在壓縮軟體的預覽視窗中執行。v2rayN 會在自身目錄或使用者資料目錄讀取設定、記錄檔與核心檔案；只執行壓縮檔中的單一主程式，容易出現核心遺失、設定無法儲存或重新啟動後訂閱消失的情況。建議使用類似 D:\Apps\v2rayN 的固定目錄，避免放入需要額外寫入權限的系統目錄。

macOS 首次開啟下載的應用程式時，系統可能要求確認來源。請先在 Finder 中選取應用程式並使用「開啟」，再依系統提示確認；若仍遭到阻擋，可前往「系統設定」→「隱私權與安全性」查看剛才的攔截紀錄。不要反覆點兩下開啟多個副本，否則很難判斷目前啟動的是「下載」目錄還是「應用程式」目錄中的版本。

首次啟動依固定順序完成六項檢查

首次啟動不必立即調整所有進階參數。先確保用戶端、核心、訂閱與本機監聽連接埠形成完整鏈路，再決定路由與系統代理模式。依照下列順序操作，可以區分「用戶端未啟動」與「節點本身無法使用」。

1. 解壓縮或移入

   Windows 將所有檔案解壓縮至固定目錄；macOS 將應用程式移入「應用程式」，不要保留多個同名執行副本。

2. 啟動主程式

   看到主視窗後，先確認標題列及系統匣或選單列圖示。關閉視窗後，程式通常仍會在背景執行。

3. 檢查核心

   開啟「設定」→「參數設定」→「Core 類型」，一般 VLESS、VMess 與 Trojan 節點優先選擇 Xray。

4. 新增訂閱

   進入「訂閱群組」→「訂閱群組設定」→「新增」，填寫備註與完整訂閱網址後儲存。

5. 更新節點

   執行「更新所有訂閱」，等待主清單出現節點；選取一個節點後將其設為活動伺服器。

6. 測試連線

   先執行真實連線延遲測試，再啟用系統代理。不要只根據 ICMP ping 判斷代理協定是否可用。

主視窗出現後，先查看底部狀態資訊或記錄視窗。正常狀態至少應包含目前活動節點、本機監聽連接埠與已啟動的核心程序。首次執行時，系統防火牆可能詢問是否允許網路存取；只在信任的目前網路類型下授予所需權限即可。拒絕後用戶端介面仍可能正常顯示，但其他程式連線至本機代理連接埠時會失敗。

關閉主視窗不一定代表退出。v2rayN 預設可縮至 Windows 通知區域或 macOS 選單列。需要徹底結束時，應從系統匣或選單列選單執行「退出」，然後在工作管理員或活動監視器中確認相關程序已結束。更新檔案、移動目錄或切換執行環境前，應先完成這一步。

• 程式視窗可見，但完全沒有節點：檢查訂閱是否已儲存並執行過「更新所有訂閱」。
• 節點清單存在，但底部沒有活動伺服器：以右鍵點選目標節點並設為活動伺服器。
• 核心啟動後立即退出：開啟記錄檔，優先檢查連接埠占用、節點欄位與 Core 類型。
• 瀏覽器仍使用原本的網路：確認系統代理已啟用，並檢查瀏覽器是否使用獨立代理設定。

Core 類型、監聽連接埠與系統代理如何設定

Core 類型決定由哪個核心解析節點設定。Xray 對 VLESS、REALITY、XTLS Vision 以及常見 VMess 設定的支援較完整，適合作為 v2rayN 的日常預設選項。V2Fly 核心較適合驗證既有 VMess、WebSocket 等設定的相容性。核心選擇必須與節點欄位相符，不能靠更換名稱修復伺服器端缺少的參數。

本機監聽連接埠是瀏覽器或其他應用程式連線 v2rayN 的入口。v2rayN 常見的基本連接埠為 10808，實際值應以「設定」→「參數設定」中的本機監聽設定與執行記錄為準。連接埠可以修改，但不能與其他代理程式或本機服務重複。記錄出現「address already in use」或「連接埠已被占用」時，可先退出其他代理程式，或將連接埠改為 10818 後重新啟動核心。

系統代理只負責將遵循系統代理設定的流量交給本機連接埠，並不代表所有程序都會自動接入。部分命令列工具、遊戲及自行管理網路堆疊的軟體會忽略系統代理。首次驗證時，先用一般瀏覽器測試網頁，再處理需要個別填寫 SOCKS 或 HTTP 位址的應用程式。

匯入訂閱後先驗證節點欄位

訂閱連結儲存成功後，節點不一定會立即出現。需要執行「更新所有訂閱」，用戶端才會讀取遠端內容並寫入目前群組。更新結果為零時，先檢查訂閱網址是否完整，以及複製時是否混入空格，再查看記錄中的 HTTP 狀態與解析提示。不要連續建立多個相同群組，否則會造成節點重複，也難以辨認更新結果。

訂閱匯入的優點是協定欄位由提供方統一下發。以 VLESS + REALITY 為例，伺服器位址、連接埠、使用者識別碼、Server Name、公鑰、Short ID、指紋與 Flow 必須彼此對應；其中任何一項過期或缺失，用戶端可能成功啟動，卻無法完成協定交握。VMess + WebSocket + TLS 則需要同時符合 Host、路徑、TLS 與伺服器端傳輸設定。

節點出現後，先選擇單一節點進行真實連線延遲測試。該測試會經過本機核心並嘗試建立實際連線，比單純 ping 更接近代理交握結果。單次結果只能反映當下的網路狀態，建議間隔 10 秒測試 3 次。例如同一節點得到 168 ms、175 ms、171 ms，波動較小；若得到 140 ms、890 ms、逾時，則較像線路抖動、封包遺失或交握不穩定。

延遲可用不代表下載速度快。延遲測試主要反映建立連線所需的時間，吞吐量還會受到伺服器頻寬、中間線路壅塞、傳輸方式與目標網站限制影響。首次安裝階段只需確認連線能建立、網頁能載入、DNS 解析正常；速度最佳化應在基礎鏈路穩定後另行進行。

Windows 常見啟動失敗與系統匣問題

Windows 上最常見的啟動失敗來自三個地方：壓縮檔未完整解壓縮、.NET 執行環境不相符，以及程式目錄無法寫入。點兩下後完全沒有介面時，先開啟工作管理員查看程序是否曾短暫出現；接著檢查程式目錄中的記錄檔與系統事件記錄。若錯誤明確指向 .NET 8，應安裝與 v2rayN 架構一致的 Desktop Runtime，而不是只安裝 SDK 或其他架構的執行環境。

主視窗關閉後找不到程式，不代表程序已經退出。Windows 可能將圖示摺疊至通知區域的隱藏清單。點選工作列右側的向上箭頭查看 v2rayN 圖示，並在「設定」→「個人化」→「工作列」的系統匣圖示設定中允許顯示。重複啟動主程式可能只會喚醒現有程序，不會建立第二個視窗。

如果 v2rayN 可以啟動，但每次重新啟動後設定都恢復預設，通常需要檢查目錄寫入權限與設定檔實際位置。不要將程式長期放在暫存解壓縮目錄，也不要讓清理工具定期刪除其資料目錄。移動程式前先退出用戶端並保留設定備份；移動完成後重新檢查訂閱與 Core 類型。

• 先確認主程式與其餘解壓縮檔案位於同一目錄層級。
• 再確認執行環境架構與程式架構一致。
• 接著檢查 10808 等本機連接埠是否被其他程序占用。
• 最後檢查系統代理是否指向目前正在監聽的連接埠。

macOS 權限、背景圖示與代理殘留處理

macOS 上首次啟動的重點是應用程式位置與系統權限。應從「應用程式」目錄啟動應用程式，首次確認後盡量維持路徑不變。若每次都從下載目錄中的不同副本開啟，系統可能將它們視為不同應用程式，反覆詢問權限，設定檔位置也容易混淆。

關閉主視窗後，應檢查螢幕頂端選單列中的 v2rayN 圖示。選單列空間不足時，部分圖示可能會被隱藏；可先退出占用選單列空間的應用程式，再從活動監視器確認 v2rayN 是否仍在執行。需要重新啟動用戶端時，應先從選單執行退出，避免舊核心持續占用本機連接埠。

1. 在 Finder 中確認目前執行的副本位於「應用程式」。
2. 開啟「活動監視器」，搜尋 v2rayN 與目前的核心程序。
3. 確認退出後，再重新開啟應用程式並選擇活動節點。
4. 啟用系統代理後測試瀏覽器；退出前先清除系統代理。

如果用戶端退出後網路請求持續失敗，先重新開啟 v2rayN 並執行清除系統代理，再前往「系統設定」→「網路」中開啟目前網路服務的詳細設定，檢查代理項目是否仍指向 127.0.0.1 與舊連接埠。系統代理殘留的典型表現是一般網頁全部失敗，但直接連線至區域網路裝置仍然正常。

當應用程式可以開啟、訂閱可以更新，卻只有啟動節點失敗時，問題通常已經不在系統權限層。此時應回到記錄檔，檢查 Core 類型、節點欄位與連接埠占用。不要連續修改指紋、Server Name、Flow 與傳輸路徑；先重新更新訂閱，再用另一個節點比較，能更快判斷是單一節點故障還是本機環境問題。

完成安裝後的基本維護清單

首次連線成功後，建議只保留少量且容易說明的變更。路由規則、Mux、並行測試與自訂 DNS 都會增加排查變數，不適合在基礎連線尚未穩定時一次啟用。先持續使用一段時間，確認訂閱更新、節點切換、系統代理與退出流程都正常，再依實際需求調整。

訂閱網址相當於設定入口，應儲存在受控位置，不要貼入公開記錄、截圖或共用文件。向他人提供故障資訊時，可以保留協定類型、連接埠、傳輸方式與錯誤文字，但應遮蓋訂閱網址、使用者識別碼、公鑰關聯資訊及伺服器憑證。

• 每次更新用戶端後，重新檢查「設定」→「參數設定」→「Core 類型」。
• 訂閱更新失敗時先查看記錄，不要立即刪除原有群組。
• 保留一個已驗證可用的節點，用來區分新節點故障與本機故障。
• 修改本機連接埠後，同步更新瀏覽器、命令列工具及其他手動代理設定。
• 升級或移動程式目錄前先正常退出，並備份目前設定。
• 排查完成後將記錄層級恢復為 warning，避免長期產生過多除錯記錄。

一個可重現的基本狀態應為：v2rayN 正常顯示主視窗與背景圖示，Xray 核心能持續執行，訂閱更新後節點數量合理，活動節點的真實連線延遲能返回結果，啟用系統代理後瀏覽器可以連線至網路，清除系統代理並退出後直連網路恢復正常。六項皆成立，即可視為完成首次安裝。