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

選擇安裝檔：作業系統、架構與介面版本

v2rayN 是桌面用戶端，可管理節點、啟動代理核心及調整系統代理；安裝完成不代表已取得可用節點。首次下載時，先確認作業系統與處理器架構，不要只看檔案大小。Windows 的 x64 與 ARM64、macOS 的 Intel 與 Apple 晶片各有對應版本；即使介面能開啟，也不代表內附核心一定相容。

• Windows：開啟「設定」→「系統」→「系統資訊」，查看「系統類型」中的處理器架構。常見的 Intel、AMD 桌上型裝置通常選擇 x64；ARM 裝置則依下載頁面的說明選擇。
• macOS：開啟蘋果選單→「關於這台 Mac」，查看「晶片」或「處理器」。Apple 晶片選擇對應的 ARM64 版本，Intel 裝置選擇對應的 x64 版本。
• 介面版本：跨平台桌面版適用於 Windows、macOS 與 Linux；經典 WPF 版則適用於 Windows。兩者的選單配置不完全相同，請勿拿某一版的按鈕位置逐一比對另一版。

安裝位置：完整解壓縮後再啟動主程式

請勿直接在壓縮軟體的預覽視窗中執行壓縮檔。主程式通常需要同一目錄中的核心、資源或設定檔；只解壓出單一執行檔，可能會出現介面能啟動、核心卻無法載入的情況。安裝程式、壓縮檔與磁碟映像的處理方式不同，請依所選安裝檔的說明操作。

1. 確認安裝檔類型

   安裝程式請依精靈指示完成安裝；壓縮檔則先完整解壓縮至固定目錄。macOS 若提供磁碟映像，請開啟後將應用程式移至「應用程式」資料夾，不要長期從掛載的映像中執行。

2. 選擇固定存放位置

   Windows 免安裝版可解壓縮至 D:\Apps\v2rayN 這類可寫入的目錄，避免使用暫存目錄、壓縮檔預覽目錄或同步資料夾。路徑含有中文字不一定有問題，重點是目錄可寫入且檔案完整。

3. 處理啟動提示

   Windows 若提示缺少執行階段，先確認提示中的名稱與架構，再依安裝檔說明補齊；不要任意下載 DLL。macOS 若提示無法驗證開發者，請先確認來源，再到「系統設定」→「隱私權與安全性」查看是否有允許該應用程式的選項。

4. 首次以一般權限啟動

   先以一般使用者權限執行，只測試系統代理模式。暫時不要啟用 TUN，也不要為了解決所有問題而直接提高權限，這樣才能區分權限問題與節點問題。

5. 保留執行記錄

   開啟「說明」→「關於」，記下用戶端版本，並從記錄檔確認核心名稱與版本。退出後重新開啟，檢查節點是否仍在，確認設定能正常儲存。

載入核心：分開確認介面啟動與代理就緒

v2rayN 的介面程序並非實際轉送流量的核心程序。選取節點並設為作用中伺服器後，還要確認核心已成功啟動、本機連接埠開始監聽。記錄檔中的「找不到檔案」、「權限不足」、「位址已被使用」代表不同問題，反覆點選連線通常無法解決。

前往「設定」→「參數設定」，尋找目前版本中的核心選擇或「Core 類型」相關項目，確認節點使用的核心；若介面配置不同，請以功能名稱和執行記錄為準。不要只因節點名稱含有 V2Ray，就強制將所有設定切換到某一種核心。VMess、VLESS 是協定名稱，Xray 等則是核心實作；節點也可能要求特定傳輸方式與安全參數。

• 缺少核心檔案：先確認下載的是否為包含所需核心的完整版本；若該版本需要另外準備核心，請依安裝檔說明放至指定位置，不要任意更改檔名。
• VLESS 與 REALITY：確認所選核心支援伺服器要求的組合。伺服器名稱、公鑰、短 ID 與 flow 等欄位，請保留訂閱提供的原始值，不要猜測填寫。
• VMess 與時間：若記錄檔出現驗證或時間相關錯誤，先確認系統是否自動校時，再核對節點參數。系統時間若有嚴重誤差，也可能影響 TLS 憑證驗證。
• 結束舊程序：先從系統匣或選單列退出其他 v2rayN，再啟動目前版本。兩個介面可能各自啟動核心，並占用相同的監聽連接埠。

匯入訂閱：先確認來源，再測試一個節點

用戶端安裝檔本身不會提供伺服器連線資訊。訂閱網址由服務提供者提供，通常包含存取憑證，應像帳號密碼一樣妥善保管。不要將完整訂閱連結貼到公開截圖、討論區或線上解析工具；尋求協助時可描述狀態碼與錯誤訊息，並隱藏連結中的權杖。

1. 開啟「訂閱群組」→「訂閱群組設定」，新增群組並填入容易辨認的名稱與訂閱 URL。不同版本的介面可能以「新增」或「+」表示新增操作。
2. 儲存後，從「訂閱群組」選單更新目前群組。初次使用尚無可用代理時，先嘗試不透過代理更新；只有直接連線失敗且已有可用節點時，再嘗試透過代理更新。
3. 更新成功後，確認伺服器清單確實新增項目。若只有群組名稱、沒有伺服器，可能是回傳內容空白、訂閱已到期，或目前版本不支援該格式；請先查看更新記錄。
4. 選取一個節點，從右鍵選單選擇「設為作用中伺服器」啟用，再查看核心記錄。僅選取表格中的列，不代表實際對外連線已切換。

初次驗證只需選一個節點，不必反覆測試整份訂閱的速度。延遲測試成功只代表該次測試請求收到回應，不代表瀏覽器已使用代理，也不代表下載頻寬達到特定數值。先用同一個節點實際瀏覽一次網頁，再比較其他節點，較容易重現並排查問題。

系統代理與連接埠：先以瀏覽器建立基準

系統代理與路由分流是兩種不同設定：前者決定應用程式是否將請求送至本機代理，後者則決定進入核心的請求如何對外連線。初次測試可在 v2rayN 主介面或系統匣的「系統代理」選單中選擇「自動設定系統代理」，並維持一般路由設定。請勿將「啟用系統代理」理解為所有程式都會經過代理；部分應用程式不會讀取系統代理設定。

Windows 可前往「設定」→「網路和網際網路」→「Proxy」檢查系統代理；macOS 可前往「系統設定」→「網路」→目前的連線→「詳細資訊」→「代理伺服器」查看。系統選項名稱可能隨版本變更。先由用戶端寫入設定，再到系統頁面確認結果，避免同時從兩處修改而造成混淆。

curl -I -x http://127.0.0.1:10808 https://example.com

上述指令僅適用於確實在 10808 提供 HTTP 或混合代理的設定；Windows 可使用 curl.exe，避免命令別名造成影響。指令會明確指定代理，用來區分「本機代理可用」與「系統代理未被應用程式採用」。收到 HTTP 回應表示該次請求有收到回應，並非速度測試；若連線遭拒，先檢查監聽連接埠；若出現 TLS 或遠端連線錯誤，再搭配核心記錄判斷。

• 指令成功、瀏覽器失敗：暫時停用瀏覽器中另外設定代理的擴充功能，並確認是否使用了不同的連接埠。
• 指令和瀏覽器都失敗：先確認核心是否正在執行，再檢查作用中節點與記錄檔，不要立刻更動 DNS、Mux 和所有路由規則。
• 只有部分網站無法使用：記下網域、時間與套用的路由，再檢查 DNS 或分流設定。不要只因單次網頁連線失敗，就認定是安裝檔有問題。

開機啟動與退出：確認代理設定不會殘留

請在確認連線正常後再設定開機啟動。自動啟動用戶端、啟動後縮至最小化，以及自動設定系統代理是不同選項：介面在背景執行，不代表系統代理已設定；系統代理已啟用，也不保證上次使用的節點仍可連線。初次設定完成後，至少測試一次退出後重新開啟，以及重新登入。

• 用戶端設定：前往「設定」→「參數設定」，尋找自動啟動、啟動後縮至最小化等選項，依需求啟用。若目前版本沒有相關選項，再使用作業系統提供的啟動管理功能。
• Windows 設定：前往「設定」→「應用程式」→「啟動」，檢查啟動項目，避免同時透過捷徑、工作排程和用戶端自動啟動三種方式啟動。
• macOS 設定：前往「系統設定」→「一般」→「登入項目」，確認是否允許應用程式在登入時啟動。若移動過應用程式位置，也要重新確認登入項目是否仍有效。
• 退出前：先從「系統代理」選單選擇「清除系統代理」，再退出用戶端。接著開啟一般網頁，確認直接連線已恢復；若先前設定過公司或機構的網路代理，請還原原有設定，不要直接清除。

初次安裝常見問題：依現象逐項排查

安裝完成與否可以用具體標準判斷：用戶端重新開啟後仍能讀取設定，作用中節點可啟動核心，瀏覽器能透過系統代理連線，退出後直接連線恢復，重新登入後也符合預期地自動啟動。保留用戶端版本、核心版本、監聽連接埠與一次失敗記錄，比只說「連不上」更有助於排查問題。備份設定時也請留意其中可能含有訂閱憑證與節點金鑰，不要公開上傳。