Windows
桌面版採用跨平台介面，WPF 版則保留經典桌面操作方式。先依使用習慣選擇介面，再查看安裝需求。已有設定的使用者應先備份訂閱群組、自訂路由與本機連接埠，不宜直接以另一種介面版本覆蓋整個程式資料夾。
首次啟動後，先檢查設定中的本機監聽連接埠，再決定是否啟用系統代理。程式能正常開啟，不代表核心已啟動；若出現執行環境提示，請依安裝頁說明補齊所需元件，再匯入節點。
V2Ray 用戶端 · 設定參考
V2Ray百科v2rayN 用戶端下載與設定檔參考
依作業系統選擇開源用戶端，從匯入訂閱到 config.json 欄位參考，逐項確認本機連接埠、出站協定與分流規則。
設定工作台僅示意部分欄位，省略驗證、伺服器連接埠及直連出站設定，無法直接作為完整設定檔使用。
Project V / 開源代理生態
Xray · V2Fly / 核心家族
JSON / 設定結構
4 / 桌面與行動平台
CONFIGURATION / 欄位索引
從設定結構找到相關選項
用戶端介面負責產生設定，核心則依設定處理連線。先釐清流量如何進入、如何選擇出站，以及網域在哪一層解析，再修改對應欄位；不必一次展開所有參數。
{
"inbounds": [{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}]
}入站位址與本機連接埠
入站設定會定義應用程式如何將連線交給核心。若僅供本機使用，監聽位址通常設為迴送位址；連接埠則須與瀏覽器或呼叫程式一致。範例使用 SOCKS 入站，該連接埠不能直接當作 HTTP 代理連接埠。若啟動失敗，先檢查連接埠是否已被占用，再確認用戶端是否產生同名入站。相較於只查看系統代理開關，檢查入站設定能分辨「應用程式未送出流量」與「核心未能成功監聽」兩種情況。變更監聽範圍前，也應先確認哪些裝置可以存取此入口。
前往設定參考查看 →{
"outbounds": [{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}]
}分別確認協定參數與傳輸層
出站設定會定義連線離開核心的方式。代理出站需要伺服器位址、連接埠與驗證資訊；直連出站則可使用 freedom。VLESS 等協定名稱不足以完整描述節點，還須確認傳輸方式，以及 TLS 或 REALITY 相關參數。路由會透過 tag 指定出站，因此名稱必須完全一致。比起重複匯入節點，依序確認協定、傳輸與安全層，更容易找出缺漏欄位。範例僅展示直連出站；實際使用代理協定時，請以伺服器提供的參數及所選核心的支援範圍為準。
前往設定參考查看 →{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}]
}
}依序比對網域與位址
路由規則由上而下比對，符合後便選擇對應的出站。應將明確的例外規則放在較廣泛的規則之前，並確認 outboundTag 已在出站設定中定義。domainStrategy 決定路由比對時何時嘗試解析網域，並不等同於系統 DNS 設定。範例會將私有位址交由 direct 處理；使用地理資料規則前，還須確認所需資料檔可用。相較於直接切換全域模式，明確規則可保留區域網路存取，也能為特定網域指定路徑。排查時先減少規則數量，再逐條恢復。
前往設定參考查看 →{
"dns": {
"servers": ["localhost"]
}
}區分系統解析與核心解析
DNS 設定會影響核心需要解析網域時所使用的解析器，但不會自動接管裝置上每個應用程式的查詢。範例中的 localhost 表示使用本機解析機制，並非手動填入公共 DNS 位址。設定前應先區分應用程式自行解析、系統解析與核心解析這三條路徑，再配合路由策略判斷實際使用哪一層。比起只更換解析器位址，追查解析要求的流向更有助於找出問題。若用戶端提供 DNS 路由或查詢策略選項，也須確認該選項在目前核心中的具體作用。
前往設定參考查看 →用戶端訂閱群組
備註 日常設定
自動更新 視需要啟用
更新後 檢查所選節點
匯出前 移除訂閱網址與驗證資訊訂閱由用戶端管理
訂閱網址由用戶端讀取，用於批次更新節點，並非 config.json 通用的頂層欄位。匯入時可依用途建立群組，並加上清楚的備註。更新後應確認原先選取的節點是否仍存在，以及手動修改的參數是否被重新產生。相較於逐一複製分享連結，訂閱更方便集中管理；但不同用戶端對訂閱格式及擴充參數的支援可能有所差異。分享截圖、設定檔或排錯記錄前，請先移除訂閱網址及驗證資訊。需要移轉裝置時，應先區分節點資訊與本機專屬設定。
前往設定參考查看 →DOWNLOADS / 平台下載
依作業系統選擇用戶端安裝套件
桌面平台使用 v2rayN；Android 優先參考 v2rayNG，若需要 V2Fly 核心，再比較 v2flyNG。安裝入口與設定文件分開整理，方便先確認作業系統與架構，再回到教學完成設定。
macOS
在「關於這台 Mac」查看晶片資訊，選擇相符架構的下載入口。系統代理設定與用戶端路由屬於不同層次：前者決定應用程式是否將連線交給用戶端，後者決定連線進入後使用哪個出站。
初次執行時請留意系統提示，不要為了排錯而同時變更多項權限。若瀏覽器可以連線，但其他應用程式仍沿用原本路徑，請檢查該應用程式是否遵循系統代理，或是否設有獨立的網路選項。
Android
先查看 v2rayNG 的 arm64 與通用版下載入口；若不確定裝置架構，再依系統資訊選擇。v2flyNG 是另一種核心家族的替代選項，是否適用於現有節點，應依協定與擴充參數判斷，而非只比較應用程式名稱。
連線時須確認系統的 VPN 連線授權。應用程式分流、背景執行限制與電池管理都可能影響使用結果；若前景可連線、螢幕鎖定後卻中斷，請先檢查系統對背景活動的限制，避免反覆匯入相同訂閱。
Linux
依發行版的套件管理格式選擇 deb 或 rpm，再確認 x64 或 arm64 架構。不同桌面環境對系統代理的支援程度可能有所差異；安裝完成後，應分別檢查核心執行狀態、桌面代理設定，以及目標應用程式本身的網路設定。
本機連接埠衝突、權限不足與相依元件缺失是不同問題，應依記錄中的實際錯誤分別處理。圖形用戶端與其他代理程式同時執行時，先確認哪個程式正在監聽目標連接埠，以免誤將其他程式的回應當成目前設定已生效。
QUICKSTART / 操作流程
從匯入訂閱到確認連線
初次設定的目標是建立一條可追蹤的連線路徑。先完成匯入，再選擇接管方式，最後確認結果。每次只變更一個項目，通常比同時開啟多個進階選項更容易找出問題。
01 / 匯入
建立群組並匯入節點
在用戶端的訂閱管理頁面新增訂閱網址，為群組填寫易於辨識的備註，再執行更新。若已有單一分享連結，可透過剪貼簿或 QR Code 匯入。兩種方式的管理範圍不同：更新訂閱會重新取得整個群組的內容，單一分享連結通常只會建立一筆本機項目。
匯入完成後，先開啟節點編輯頁，確認協定、伺服器位址、連接埠與傳輸設定。訂閱名稱不是連線參數，節點顯示名稱也無法證明參數完整。若系統提示無法辨識格式，先確認複製內容是否夾帶多餘空格、說明文字或網頁網址，再確認用戶端是否支援該格式。
訂閱網址可能包含存取憑證，不應貼到公開截圖或討論區。需要排錯時，只記錄協定類型與錯誤訊息即可，驗證資訊請妥善保密。更新失敗與節點連線失敗發生在不同階段；前者應先檢查訂閱取得流程，而非修改出站協定。
02 / 接管
選擇系統代理與路由模式
選定節點後，再設定流量進入用戶端的方式。桌面平台可先從系統代理開始；Android 則依畫面提示確認 VPN 連線授權。系統代理只會影響遵循該設定的應用程式；路由模式則處理已進入核心的連線，兩者不能互相取代。
初次使用時，建議先保留用戶端提供的基本路由方案，確認區域網路資源仍可使用，再新增特定網域規則。不要只為了讓單一應用程式生效就立即開放區域網路監聽，也不要把所有分流異常都歸咎於節點。先檢查應用程式是否將要求交給用戶端，排查範圍會更明確。
若要變更本機連接埠，也須同步調整使用該連接埠的應用程式設定。HTTP 與 SOCKS 是不同的代理介面，即使監聽位址相同，也不能任意互換。若用戶端提供混合連接埠，請依該選項的實際說明設定，避免照抄其他裝置的連接埠號碼。
03 / 確認
分層檢查記錄與應用程式行為
啟動連線後，先確認核心是否正常執行，再透過目標應用程式送出要求。節點測試結果只反映特定測試方式，不能取代實際應用程式的驗證。應分別判斷「核心啟動成功」、「應用程式要求已送出」、「規則命中預期出站」及「遠端連線完成」。
若出現憑證相關錯誤，請檢查系統時間、伺服器名稱與傳輸安全參數；若提示位址已被使用，則返回檢查本機連接埠設定。排錯時請備份原有參數，並記錄本次變更及對應現象。如此恢復設定時便有明確依據，不會在連續嘗試中遺失原始設定。
確認連線行為後，再考慮自動更新、開機啟動或應用程式分流。切換網路、重新啟動裝置及解除鎖定後，都可重複相同的驗證步驟。若問題只出現在特定應用程式，優先檢查該應用程式本身的解析與代理設定，再決定是否需要修改全域設定。
PROJECT V / 核心與用戶端
開源生態與設定範圍
V2Ray、V2Fly、Xray 與圖形用戶端並非同一層級的軟體。釐清這些名稱，有助於判斷功能由哪個元件提供、錯誤出自何處，以及移轉設定時需保留哪些內容。
Project V 與核心家族
Project V 是以網路代理元件為核心的開源生態，V2Ray 是其中廣泛使用的核心實作。V2Fly 延續 V2Ray 的社群開發，Xray 則以相關程式碼為基礎，發展出自己的核心路線。兩者共用部分設定概念，但協定擴充、欄位支援及預設行為會隨各自發展而有所不同。若將它們一概視為同一種核心，匯入設定或查閱文件時便容易忽略適用範圍。
核心負責處理協定、建立傳輸、比對路由及解析網域等工作；圖形用戶端則將這些功能整理成節點清單、訂閱群組與設定介面。介面中有某個選項，不代表所有可選核心都會以相同方式解讀。排查相容性問題時，應先記下目前使用的用戶端與核心，再查閱對應欄位說明，不要只憑分享連結的開頭判斷整份設定。
三款用戶端的功能
v2rayN 是適用於桌面系統的開源圖形用戶端，提供節點匯入、訂閱更新、路由管理與系統代理操作。常見設定可透過介面管理，同時也保留自訂設定的彈性。切換核心或變更節點類型後，應重新確認產生的傳輸與安全層參數；儲存了節點項目，不代表遠端支援相應功能。
v2rayNG 是適用於 Android 裝置、使用 Xray 核心的開源用戶端；v2flyNG 採用 V2Fly 核心，是另一種相容路線的選擇。兩款應用程式的操作介面可能相近，但不能因此假設所有擴充欄位都能互換。選擇時先確認現有設定需求，再考量訂閱格式、應用程式分流與背景執行體驗。桌面與手機共用訂閱時，本機監聽及系統接管設定仍須分別管理。
開源授權與功能判斷
V2Fly 核心採用 MIT 授權，Xray 核心採用 MPL 2.0；用戶端及其相依項目也各自受相應授權條款規範。開源代表可在授權範圍內閱讀、使用與修改程式碼，不表示所有元件的發布時程一致。授權說明有助於了解軟體的使用與散布條件，不能取代對具體功能、執行環境及設定內容的檢查。
用戶端提供連線工具，不會自動建立可用的遠端服務。伺服器位址、驗證資訊及相關參數須由使用者自行準備。首頁展示的範例位址僅用於說明欄位，路由片段也只呈現比對邏輯。參考範例學習時，請先辨認哪些是結構說明、哪些必須替換為現有服務的參數，避免將示範設定誤當成完整節點。
更新與設定維護
用戶端介面、核心與路由資料檔都可能各自更新。更新用戶端後，部分欄位可能重新產生；更新規則資料後，同一分類名稱所包含的網域或位址也可能改變。因此，應分別記錄設定來源與自訂內容，重要規則請保留易讀的備註。使用行為改變時，先比對產生的設定與記錄，再決定是否還原特定選項。
訂閱適合集中更新遠端參數，備份則應包含本機設定。兩者無法互相取代：訂閱未必包含系統代理偏好、應用程式分流清單或手動路由規則。跨裝置移轉時，請將可重複使用的節點資訊，與裝置專屬的監聽、權限及啟動設定分開整理。本網站的設定參考依欄位整理內容，教學則依操作流程編排，可按目前遇到的問題選擇閱讀。
NOTES / 使用筆記
設定操作與問題排除
從初次安裝、規則優先順序到憑證錯誤，依遇到的問題查找資訊。文章中的參數說明與設定參考相互補充；修改前請先確認使用中的核心及用戶端設定範圍。
V2Ray TLS 交握失敗與憑證錯誤排除：系統時間偏差、SNI 與 allowInsecure 設定
整理 TLS 憑證錯誤的常見原因，包括系統時間未同步、SNI 與憑證網域不符、偽裝網域填寫錯誤，並逐項說明在用戶端中的檢查位置。
閱讀文章 →V2Ray 自訂路由規則寫法：domain、ip、geosite 比對語法與規則順序
逐一說明 domain、full、regexp、geosite、geoip 等比對前綴的寫法，解析 routing 規則由上而下的比對順序，以及 domainStrategy 對比對結果的影響。
閱讀文章 →v2rayN 初次安裝後如何設定：Windows 與 macOS 初始設定重點及常見問題
介紹 v2rayN 解壓後執行、系統代理模式、本機連接埠、開機自動啟動等初次設定項目，並說明執行階段缺失、連接埠占用、權限提示等常見問題的處理方式。
閱讀文章 →