基礎認識
先分清用戶端、核心與節點設定，再選擇適合裝置的安裝包。
v2rayN、v2rayNG 與 v2flyNG 該選哪一款？
Windows、macOS 與 Linux 桌面版適合使用 v2rayN，主要功能包括訂閱分組管理、系統代理與路由設定。Android 可優先考慮採用 Xray 核心的 v2rayNG；若現有設定明確依賴 V2Fly，再考慮 v2flyNG。名稱相近不代表安裝包或設定完全通用，桌面版安裝包不能用於手機。請先依作業系統選擇用戶端，再確認節點協定、傳輸方式與核心支援情況；勿只因介面相似就直接套用整份設定。
V2Ray、Xray 與圖形化用戶端有什麼不同？
V2Ray 通常泛指 Project V 生態系中的代理工具與相關設定體系；V2Fly 延續其中的核心開發，Xray 則是另一個核心分支。圖形化用戶端負責儲存訂閱、選擇節點及產生執行設定，實際連線則由核心處理。因此，介面能辨識某個分享連結，不代表目前使用的核心支援其中所有參數。遇到 REALITY 或特定流控無法啟動時，應一併檢查用戶端的解析結果與核心日誌，而不只是確認節點名稱是否出現在清單中。
安裝用戶端後，為什麼還需要訂閱或節點設定？
用戶端是設定與連線工具，本身並不等於可用的遠端服務。建立連線還需要伺服器位址、連接埠、身分資訊、協定及傳輸參數，通常透過訂閱網址或單筆分享連結匯入。訂閱網址是取得一組設定的入口，不應填入伺服器位址欄位。匯入前請確認來源與使用權限，匯入後還要更新分組並選取節點。訂閱可能包含存取憑證，請勿將完整網址、分享連結或 QR Code 貼到公開討論區。
Apple Silicon、Intel、arm64 與 universal 該怎麼選？
在 Mac 上，先開啟蘋果選單中的「關於這台 Mac」：顯示 Apple 晶片的裝置請選 Apple Silicon 對應的 arm64 版本；顯示 Intel 處理器的裝置則選 x64 版本。Android 的 arm64 與 universal 是另一組安裝包選項，請勿與 Mac 下載項目混淆。2015 年後推出的主流 Android 手機通常可先選 arm64，但仍須視裝置系統支援的應用程式架構而定；較舊的裝置或安裝時出現架構不相容提示，可改用通用版。通用版包含較多架構元件，通常檔案較大，不代表連線速度更快。
安裝設定
分別檢查訂閱格式、更新網路與系統權限，別用同一種方式處理所有錯誤。
v2rayNG 訂閱匯入失敗，該先檢查什麼？
先確認取得的是訂閱網址、單筆分享連結，還是原生 JSON。訂閱網址應填入訂閱分組設定，再執行更新；單筆分享連結應使用從剪貼簿匯入等相應功能；原生 JSON 則依用戶端支援的自訂設定方式處理。複製時請移除前後空白、換行，以及聊天軟體附帶的說明文字。若日誌顯示格式無法辨識，請確認網址回傳的是設定內容，而非登入頁面或錯誤頁面，並請設定提供者提供用戶端可辨識的格式；不要一再將網頁網址當成節點匯入。
訂閱更新失敗，但原有節點還能用，需要刪除分組嗎？
先保留目前可用的分組，並記下更新時的錯誤訊息。確認訂閱是否到期、網址是否已變更，以及目前網路能否連上訂閱服務。若更新需要透過代理，先選取仍可用的節點，再確認用戶端是否提供透過代理更新的選項；若目前代理已失效，請改用能連上該服務的網路重試。瀏覽器能開啟網址，不代表回傳格式一定正確；也請排除帳戶登入頁面與存取限制。不要一開始就清除所有節點，以免失去仍可使用的連線及排查依據。
macOS 自動設定系統代理未生效，該怎麼辦？
先確認 v2rayN 核心已成功執行，並在系統代理選單中選擇「自動設定系統代理」。接著前往系統設定的網路代理頁面，確認目前使用的 Wi-Fi 或有線網路已填入用戶端的本機監聽位址與連接埠；不同 macOS 版本的選項名稱可能有所差異。接著關閉並重新開啟要測試的應用程式。系統代理只會影響遵循該設定的程式，應用程式內建的代理選項、環境變數或其他代理工具都可能覆蓋設定。不要只因某個命令列程式未使用代理，就判定整個系統設定沒有生效。
啟用 TUN 時出現權限不足，該怎麼處理？
TUN 需要建立虛擬網路介面並調整相關網路設定，通常需要額外授權。請先退出其他 VPN 或類似的網路接管工具，再依照目前版本用戶端的權限提示完成授權；Windows 可能需要系統管理員權限，macOS 與 Linux 則視用戶端的權限輔助機制而定。不要直接套用其他平台的命令，也不要一再以高權限啟動來掩蓋未知錯誤。先用一般系統代理確認節點可正常連線，再單獨啟用 TUN；若仍失敗，請保存第一次出現的錯誤訊息及介面建立相關日誌，逐項檢查權限與路由衝突。
使用技巧
了解流量入口與路由出口，再調整測速、DNS 與核心選項。
「自動設定系統代理」和「繞過中國大陸」有什麼不同？
兩者作用於不同環節。「自動設定系統代理」決定遵循系統代理設定的應用程式是否將請求交給本機用戶端；「繞過中國大陸」則是流量進入核心後，選擇直連或透過代理連出的路由預設。可以同時啟用自動設定系統代理與繞過中國大陸，也可以讓進入用戶端的流量依全域代理規則處理。若應用程式沒有將請求交給用戶端，單獨切換路由預設通常不會改變結果。排查時先確認流量是否進入，再檢查規則比對與最終出口；不要把系統代理選單當成路由模式切換開關。
V2Ray 節點測速該看延遲，還是實際連線結果？
先確認測試方式，再比較結果。TCP 連線測試主要用來確認連接埠能否建立連線；應用層延遲測試還會受到握手及測試目標回應影響，兩者都不能直接視為下載速度。建議固定使用相同網路、測試目標與時段，先確認常用網頁能正常開啟，再檢查長時間傳輸是否穩定。不要同時測試大量節點後，立刻依單次結果排序；網路壅塞與伺服器限流都可能影響判斷。若低延遲節點仍無法連上目標網站，請繼續檢查 DNS、路由與遠端出口，而非一再測速。
V2Ray DNS 設定該從哪裡開始調整？
先記下目前的 DNS 設定，並確認系統解析、瀏覽器的加密 DNS 與核心 DNS 是否各自參與請求。只有部分網域無法連線時，再檢查日誌中的解析錯誤、DNS 請求路徑及路由是否形成迴圈；不要同時更換所有解析器與分流規則。使用 TUN 時，尤其要確認 DNS 接管範圍，以及解析器位址本身能否依預期直連或透過代理存取。測試時請使用相同網域，並視需要清除相關快取。遠端伺服器無法連線或憑證參數錯誤，不會因為任意更換 DNS 就自動恢復。
切換節點或核心前，應保留哪些設定？
先備份訂閱分組資訊、自訂路由、DNS 設定及需要手動維護的節點參數，並確認備份中的憑證不會外流。切換核心前，請確認目標核心支援目前使用的協定、傳輸方式、REALITY 參數與流控；不要只因協定名稱相同，就認定兩者完全相容。每次只修改一項：先更換節點確認連線，再考慮調整核心或路由。訂閱更新可能覆蓋由訂閱產生的節點，若要長期手動修改，應另存為獨立設定。若要在多台裝置上使用，也應分別確認用戶端支援情況，而非直接複製整套執行設定。
疑難排解
保留第一次出現的錯誤訊息，並區分啟動失敗、請求未進入用戶端與遠端連線失敗。
節點一直逾時，如何判斷是本機網路還是伺服器問題？
先關閉代理，確認基本網路能連上原本可直接存取的網站，再檢查用戶端日誌。連線逾時、連線遭拒、網域名稱解析失敗與驗證失敗是不同問題，不應一律當成逾時處理。確認伺服器位址與連接埠沒有被誤改，裝置時間正確，再使用同一節點切換到其他可用網路測試。若只有一個節點失敗，優先確認該節點服務與參數；若所有節點都失敗，先排除本機防火牆、網路限制或核心未啟動。排查期間避免頻繁更改多項參數，否則難以判斷是哪一步影響結果。
用戶端顯示已連線，但瀏覽器無法上網，該怎麼辦？
「已連線」有時只代表本機服務已啟動，不代表每個遠端請求都成功。先確認瀏覽器送出請求時，用戶端是否出現相應日誌：沒有記錄，請檢查系統代理、瀏覽器內建代理與本機連接埠；有記錄但請求失敗，則繼續檢查 DNS、握手或路由出口錯誤。接著確認是所有網站都無法連線，還是只有特定網域有問題。若系統代理與 TUN 同時啟用，先關閉其中一種接管方式，以最精簡的設定重新測試。不要同時更改 DNS、節點與路由；依請求是否進入用戶端逐層排查會更有效。
v2rayN 啟動後閃退，或 Mac 顯示無法開啟，該如何排查？
先確認安裝包架構符合作業系統需求，並保留完整錯誤訊息。Windows 需區分缺少必要的 .NET 桌面執行階段與應用程式設定異常，是否需要另外安裝執行階段取決於發行包；Linux 請檢查發行包類型與缺少的相依套件。Mac 則需區分未識別開發者提示、檔案存取權限問題與程式實際當機；確認來源可信後，再依系統「隱私權與安全性」頁面的提示處理。不要把所有無法開啟的情況都歸因於權限問題，也不要大量關閉系統防護。若問題是在更新後才出現，先備份設定，再參考啟動日誌定位。
退出用戶端後網路中斷，或只有特定應用程式未使用代理，該怎麼辦？
退出後網路中斷，先確認系統是否仍指向已停止的本機代理連接埠。可重新開啟用戶端，選擇「清除系統代理」後再退出，並檢查是否有其他網路工具重新寫入設定；若曾使用 TUN，也要確認虛擬介面與路由已恢復。若只有特定應用程式未使用代理，請檢查該應用程式自己的網路設定；命令列工具也可能讀取代理環境變數。不要為了解決本機應用程式問題，就將本機監聽開放給所有網卡。若需要進一步協助，請提供作業系統、用戶端、接管方式與錯誤摘要，並先遮蔽日誌中的訂閱憑證及身分資訊。