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

安裝前先確認系統、架構與執行環境

初次設定不要一開始就貼上訂閱連結。先確認下載套件與裝置架構相符，再判斷使用的是自包含套件還是需要執行階段的套件。架構選錯時，程式可能無法啟動；缺少執行階段時，系統通常會提示缺少對應的 .NET 元件，而不是節點設定錯誤。

v2rayN 7.x 桌面版支援 Windows、macOS 與 Linux。Windows 常見裝置使用 x64 套件，採用 ARM 處理器的裝置應選擇 arm64；macOS 也要區分 arm64 與 x64。不能只依檔名中的「桌面版」判斷，下載前應在系統資訊中確認處理器架構。

• 完成解壓縮後再執行主程式，避免設定檔、記錄檔與核心檔案無法正常寫入。
• 更新版本前先關閉正在執行的 v2rayN，確認選單列或系統匣中的程序已經結束。
• 保留訂閱位址與必要的自訂路由規則備份，遷移時不要只複製單一可執行檔。
• 程式可以開啟但核心啟動失敗時，先查看記錄中的檔案路徑、權限與執行階段提示，再檢查節點參數。

首次啟動依固定順序完成基本設定

正確順序是先確認核心，再新增訂閱，接著選擇伺服器，最後開啟系統代理。若一開始就反覆切換系統代理，問題會混在一起：可能是核心尚未啟動，也可能是訂閱尚未更新，還可能只是瀏覽器沒有讀取新的代理設定。

1. 確認核心

   開啟「設定」→「參數設定」→「Core 類型」，一般 VLESS、VMess 節點可先選擇 Xray。儲存後回到主介面，檢查底部記錄是否出現核心啟動成功的訊息。

2. 新增分組

   進入「訂閱分組」→「訂閱分組設定」→「新增」，填寫容易辨識的別名並貼上完整訂閱位址。位址前後不要保留空格或換行。

3. 更新訂閱

   儲存分組後執行「訂閱分組」→「更新全部訂閱」。等待節點清單重新整理，並確認更新結果不是逾時、內容空白或格式解析失敗。

4. 選擇節點

   在伺服器清單中選取一個節點並設為作用中伺服器。選取列只代表目前目標，仍需確認核心已在執行。

5. 設定路由

   首次驗證可選擇規則明確的基本路由模式。確認連線正常後，再依區域網路、直連網站與代理網站的需求調整自訂規則。

6. 開啟代理

   從系統匣或選單列開啟「系統代理」，選擇自動設定系統代理。測試結束或關閉程式前，可切換為清除系統代理，避免系統保留失效的連接埠。

每完成一個步驟就觀察一次主介面狀態與記錄，排查問題會更直接。例如訂閱更新已經報錯時，不必繼續修改路由；核心連接埠沒有監聽時，也不必先懷疑瀏覽器快取。

分開理解系統代理、核心連接埠與路由模式

「節點已連線」不等於「所有應用程式都已經透過代理」。核心負責在本機監聽連接埠並與遠端通訊，系統代理負責將遵循作業系統代理設定的應用程式導向本機連接埠，路由規則再決定具體要求要透過代理出站或直接出站。三個層次缺少任何一個，都可能出現部分程式可用、部分程式無法使用的情況。

不要機械式照抄連接埠。10808 和 10809 是常見初始值，但使用者修改、舊版本遷移或其他本機服務都可能改變結果。最可靠的依據是「設定」→「參數設定」中的本機監聽設定，以及核心啟動記錄中實際出現的監聽位址。

匯入訂閱後檢查協定欄位與更新結果

訂閱不只是簡單的節點名稱清單。每筆記錄還包含伺服器位址、連接埠、使用者識別碼、傳輸方式、TLS 參數、路徑、Server Name、Reality 公鑰或指紋等欄位。v2rayN 更新訂閱後會將這些內容轉換成本機設定，任何關鍵欄位缺失都可能導致握手失敗。

對於 VMess 與 VLESS，不要只比較伺服器位址。相同位址可以承載不同連接埠、不同傳輸方式與不同安全層。手動編輯節點時尤其要避免將一種協定的欄位複製到另一種協定中。

• 更新後節點數量為零：先查看訂閱回應是否為空，再確認位址沒有因換行而被截斷。
• 舊節點仍然存在：檢查目前更新的是否是另一個訂閱分組，以及分組是否啟用了清除舊記錄的策略。
• 節點名稱正常但全部失敗：優先檢查訂閱有效性、系統時間、核心類型，以及記錄中的握手錯誤。
• 只有個別節點失敗：與同一分組中的其他節點比較，判斷是單一節點參數問題，還是本機共用設定問題。

設定開機啟動、訂閱更新與設定儲存

確認基本連線後，再啟用自動化設定。這樣可以避免程式每次登入系統後立即載入尚未驗證的設定。Windows 與 macOS 的登入啟動機制不同，但檢查思路一致：程式路徑必須固定，系統登入項目必須存在，啟動後核心與本機監聽連接埠也要正常。

1. 啟用開機啟動：在「設定」→「參數設定」中找到開機自動啟動選項。Windows 同時檢查系統啟動應用程式清單；macOS 同時檢查登入項目是否指向目前的應用程式位置。
2. 保持路徑固定：啟用登入啟動後不要任意移動程式目錄。若已經移動，應先刪除舊登入項目，再從新位置重新啟用。
3. 設定更新間隔：在訂閱分組設定中依實際需求填寫自動更新間隔。個人裝置可從 1440 分鐘開始，也就是每天檢查一次，不必每隔幾分鐘重複發出請求。
4. 保留啟動記錄：重新啟動系統後先查看核心是否自動啟動，再確認訂閱更新是否成功。自動啟動成功與自動更新成功是兩個獨立結果。
5. 測試退出行為：關閉主視窗可能只是縮到系統匣或選單列。需要徹底停止代理時，應從程式選單執行退出，並確認系統代理已經清除。

自動更新並不是越頻繁越好。間隔過短會讓錯誤記錄快速堆積，也可能在網路剛恢復時反覆觸發請求。若裝置不是全天連線，每天一次通常已足夠；需要立即取得變更時，手動執行「更新全部訂閱」更明確。

用一組可重現的測試確認設定有效

首次連線不要只看伺服器清單中的顏色或延遲數字。完整驗證至少包括核心啟動、本機連接埠監聽、系統代理生效、目標網頁存取，以及切換節點後的再次測試。每次只變更一個變數，才能判斷結果來自節點、路由還是本機設定。

表中的 186 ms 與 241 ms 是一次排查記錄範例，不是速度標準。延遲會受到節點位置、線路、時段與握手方式影響。這裡真正需要記錄的是測試條件：同一網路、同一目標、同一路由模式，以及切換前後唯一變更的節點。

• 先測試一個節點，成功後再批次測試清單，避免大量失敗記錄掩蓋第一個錯誤。
• 切換節點後重新開啟測試頁面，減少舊連線重複使用造成的誤判。
• 規則模式失敗而暫時全域驗證成功時，重點檢查網域、IP 與出站標籤的路由匹配。
• 兩個節點在同一時間都失敗時，先檢查本機網路、訂閱狀態與核心記錄，不要連續修改協定欄位。

首次使用的常見問題與處理順序

排查的基本原則是由本機向遠端逐層檢查：先看程式與核心，再看連接埠與系統代理，接著查看訂閱與節點，最後檢查路由與傳輸參數。跳過前面的基礎層，往往會將連接埠占用誤判為節點失效。

完成這些檢查後，應能明確回答五個問題：程式是否從固定目錄執行，核心是否成功啟動，訂閱是否正常更新，系統代理是否指向正確連接埠，以及路由是否依預期選擇出站。日後遇到連線變化，也可以沿用相同順序快速定位。