適合首次在 Windows 或 macOS 上使用 v2rayN 的使用者。依序完成安裝包選擇、啟動程式、匯入訂閱、設定本機監聽與系統代理，再透過日誌和連接埠檢查判斷問題所在。首次連線建議先用系統代理測試，確認基本連線正常後，再考慮 TUN 模式和更細緻的路由規則。
一、選擇安裝包與可寫入的存放位置
v2rayN 是圖形化用戶端，負責管理節點、訂閱和執行設定；實際連線則由核心處理。下載用戶端不代表已取得可用伺服器。開始前請準備有權使用的節點或訂閱網址，並確認節點所需協定與安裝包內含的核心相容。
Windows 和 macOS 安裝包不能混用；同一作業系統也要區分 x64 與 ARM64。Windows 可前往「設定」→「系統」→「關於」查看系統類型；macOS 可從蘋果選單→「關於這台 Mac」查看晶片資訊。Apple 晶片請優先選擇對應的 ARM64 安裝包，Intel 處理器則選擇 x64 安裝包，不要只憑壓縮檔大小判斷。
- Windows 壓縮包：請先完整解壓縮至目前使用者可寫入的位置，例如
C:\Users\你的用户名\Apps\v2rayN。不要直接在壓縮軟體的預覽視窗中執行，也不要只把主程式檔案拖出來。 - macOS 應用程式：依發布包形式解壓縮或掛載後，將應用程式移至「應用程式」資料夾再啟動。避免長期從暫時掛載的磁碟映像檔執行。
- 相依元件與核心：請保留發布包的目錄結構。框架相依套件可能需要相符的執行環境；自包含套件通常已附帶相應的執行環境。若出現缺少元件的提示，請依目前套件的說明處理，不要任意加入其他版本的動態連結程式庫。
- 設定與備份：更新前請先退出程式，再備份現有設定。應用程式目錄和設定目錄不一定相同，實際位置會依作業系統和用戶端的建置形式而異。
二、首次啟動與匯入訂閱的操作順序
首次啟動時，請先確認視窗能正常開啟、設定可以儲存、核心可以啟動，再開啟系統代理。否則系統可能已指向本機連接埠，但本機沒有可用服務，導致原本能瀏覽的網頁也無法開啟。
-
檢查執行環境
啟動主程式。若 Windows 顯示缺少執行環境，請記下提示中的產品名稱、架構和版本需求，再安裝相符元件；不要把所有缺少元件的提示都當成缺少同一種執行階段。
-
處理啟動權限
若 macOS 提示應用程式來源受限制，請先確認下載來源，再前往「系統設定」→「隱私權與安全性」查看是否有允許開啟的選項。若提示檔案已損毀或遭安全軟體判定有風險，請停止執行並確認來源，不要直接關閉系統防護。
-
新增訂閱群組
前往「訂閱群組」→「訂閱群組設定」，輸入群組名稱和完整訂閱網址後儲存。部分介面會以「+」作為新增入口；訂閱網址應由服務提供者提供，請勿將管理後台的頁面網址誤當成訂閱網址。
-
更新訂閱內容
返回「訂閱群組」，執行「更新全部訂閱（不透過代理）」。若目前網路無法連線至訂閱來源，而用戶端已有可用節點，再嘗試「更新全部訂閱（透過代理）」。首次使用且沒有可用節點時，透過代理更新無法憑空建立連線。
-
選擇使用中的節點
在節點清單中選取一個節點，從右鍵選單選擇「設為活動伺服器」，再檢查日誌是否出現核心啟動失敗。接著開啟系統代理，用瀏覽器瀏覽已知正常的 HTTPS 網站，確認連線成功，而不只是看到延遲數值。
匯入訂閱後，VMess、VLESS、傳輸方式和 TLS 參數通常會由訂閱自動產生，不需要為了「最佳化」而手動修改。若節點使用 REALITY 等功能，請確認所選核心支援相應設定；用戶端顯示節點名稱，不代表目前的核心一定能執行該節點。
三、確認本機監聽連接埠與系統代理
本機連接埠是應用程式連線至用戶端的入口；伺服器連接埠則是用戶端連線至遠端節點的目標，兩者不能互換。以下以 127.0.0.1:10808 作為本機混合監聽範例，說明檢查方式；並非要求所有版本都改用相同連接埠。請以「設定」→「參數設定」中的實際監聽設定為準。
用戶端本機監聽
- 範例位址
127.0.0.1- 範例連接埠
10808- 監聽協定
- 以介面標示的 HTTP、SOCKS 或混合類型為準
- 區域網路存取
- 初次設定時保持關閉
迴圈位址僅供本機使用，不必為了瀏覽網頁而改成對外監聽。
系統代理目標
- 代理伺服器
- 指向用戶端的本機監聽位址
- 代理連接埠
- 必須對應支援該協定的監聽連接埠
- Windows 檢查方式
- 「設定」→「網路和網際網路」→「Proxy」
- macOS 檢查方式
- 「系統設定」→「網路」→目前的連線→「詳細資訊」→「代理伺服器」
系統代理通常由用戶端設定；手動檢查時，請確認位址和連接埠是否一致。
若目前版本分別提供 HTTP 和 SOCKS 連接埠，請勿將 SOCKS 專用連接埠填入系統的 HTTP 代理欄位。修改監聽連接埠後，請依介面提示重新啟動核心或套用設定，並重新設定系統代理，以免系統仍指向舊連接埠。
- Windows 可從系統匣選單或主介面的「系統代理」→「自動設定系統代理」開啟；使用完畢前，請選擇「清除系統代理」。實際選項位置依目前介面而異。
- 若 macOS 要求授權以修改網路設定，請確認要求是由目前使用的用戶端提出。未授予必要權限時，即使視窗正常顯示，也不代表系統代理已生效。
- 首次測試時，請勿同時啟用另一套代理工具或瀏覽器專用代理擴充功能，否則請求可能經由不同入口，造成用戶端日誌與瀏覽結果不一致。
四、如何選擇系統代理、TUN 與路由分流
系統代理和 TUN 負責將流量導入用戶端；路由分流則決定流量進入後要直連或經由代理。兩者不是同一層級的設定。「自動設定系統代理」不代表所有連線都會經由代理，也不代表用戶端會自動判斷每個網站的需求。
先從系統代理開始
建議讓遵循系統代理設定的應用程式將請求送至本機監聽連接埠。首次安裝時建議先用瀏覽器測試，設定步驟較少，遇到問題也容易還原。
適用情境：首次連線、瀏覽器瀏覽、基本故障排除
透過 TUN 模式接管流量
透過虛擬網路介面接管更多應用程式的流量，可能需要管理員授權、虛擬介面元件，以及相應的路由與 DNS 設定。實際涵蓋範圍仍受作業系統、應用程式和設定影響。
適用情境：基本連線已確認正常，或應用程式不遵循系統代理設定
個別設定應用程式
在支援代理設定的應用程式中指定本機位址、連接埠和協定。此設定可獨立於系統代理，適合用來確認是哪個應用程式沒有讀取系統設定。
適用情境：命令列工具、單一應用程式連線測試
初期請保留內建路由規則，不必急著加入大量自訂網域。規則通常依序比對，範圍過廣的規則若排在前面，可能會優先套用而遮蔽後續的具體規則。若某網站只能直連或只能透過代理瀏覽，請先查看命中的規則，再調整相應設定，不要同時更換核心、DNS 和傳輸方式。
五、如何排查連接埠占用與安全軟體封鎖
若日誌出現 address already in use 或與 bind 相關的錯誤，請先檢查本機監聽連接埠是否已被占用。常見原因包括同時啟動兩個用戶端、舊的核心程序未結束，或其他軟體剛好使用相同連接埠。以下命令均以範例連接埠 10808 為檢查對象；若實際連接埠不同，請替換數字。
Windows：查看監聽程序
netstat -ano | findstr ":10808"請留意本機位址中的該連接埠，以及狀態為 LISTENING 的項目；僅看到遠端位址包含相同數字，不能證明本機連接埠已被占用。最後一欄是程序 ID，可在「工作管理員」→「詳細資料」中依 PID 查找。確認程序歸屬後，請正常退出相應軟體，不要結束不熟悉的系統程序。
macOS：查看監聽程序
lsof -nP -iTCP:10808 -sTCP:LISTEN若輸出結果指向舊的用戶端程序，請先從選單正常退出，再重新啟動。若其他程式確實需要使用此連接埠，可在 v2rayN 的「設定」→「參數設定」中修改本機監聽連接埠，並同步更新系統代理或應用程式代理的目標位址。沒有輸出也不代表節點可用，只表示此命令未找到相應的 TCP 監聽。
- 主視窗能開啟，但核心啟動失敗：請檢查安全軟體的隔離記錄和用戶端日誌，確認核心檔案是否遭移除。不要從不明來源單獨下載同名執行檔補進目錄。
- 檔案遭封鎖：記下檔案路徑、警示名稱和發生時間，確認下載來源後，再評估是否還原檔案或設定例外規則；不要將整個下載資料夾加入範圍過大的例外。
- 提示無法寫入設定：請檢查目錄權限、磁碟剩餘空間，以及檔案是否為唯讀。日常使用系統代理通常不需要一直以管理員身分執行，請先排除特定目錄的寫入問題。
六、首次連線常見問題與退出檢查
訂閱更新逾時，是用戶端沒安裝好嗎？
請先檢查訂閱網址是否完整、是否已過期，並分辨網域解析失敗、連線逾時或伺服器回應錯誤。若已有可用節點，可嘗試透過代理更新；若完全沒有節點，請向訂閱提供者確認目前網路可用的匯入方式。請勿公開訂閱網址，其中通常包含存取憑證。
節點測得到延遲，為什麼網頁還是打不開？
延遲測試只驗證特定測試路徑，不代表瀏覽器請求一定成功。請先確認目前使用的伺服器，再核對系統代理是否指向實際監聽連接埠，並查看瀏覽器連線時日誌是否出現新請求。若有請求但連線失敗，再檢查節點驗證、TLS、DNS 和路由；若沒有請求，請先檢查流量入口。
出現憑證錯誤，可以略過驗證嗎？
請先前往系統的「日期與時間」設定，確認時間和時區正確，再核對節點的伺服器名稱、TLS 設定與訂閱內容。憑證錯誤可能是憑證過期或名稱不符所致，不建議將略過驗證當成預設解法，請向服務提供者確認正確參數。
退出後，整台電腦都無法上網了？
請先重新開啟用戶端，執行「系統代理」→「清除系統代理」，關閉 TUN 後再退出。若程式無法開啟，請前往系統網路設定，檢查是否仍保留指向 127.0.0.1 的手動代理；僅移除此次設定，保留公司或學校要求的網路設定。
完整的首次安裝驗收應涵蓋啟動、匯入、瀏覽和退出四個步驟。後續排除問題時，每次只修改一個變數，並記錄修改前後的日誌狀況，比反覆重新安裝更容易找出原因。向他人求助時，可提供作業系統類型、用戶端顯示的版本、所選核心和已隱去敏感資訊的錯誤行；請勿附上節點密碼、完整分享連結或訂閱憑證。
- 重新啟動程式後，訂閱群組和使用中的伺服器仍正確保留。
- 啟用系統代理後，瀏覽器可以瀏覽目標網站，日誌中也沒有持續出現核心啟動錯誤。
- 關閉代理並退出用戶端後，原本可直連的網站仍能正常瀏覽。