CLIENT SETUP / 使用教學

V2Ray 訂閱匯入與連線教學

依照「匯入訂閱 → 選擇代理模式 → 連線 → 測試」的順序完成初次設定。已安裝用戶端並取得有效訂閱網址時，可依照約十分鐘的流程操作；實際所需時間視網路與設定而定。本頁僅說明圖形介面的必要步驟，設定欄位完整說明請參閱設定完整指南。

開始前：準備用戶端與訂閱網址

尚未安裝時，請先前往用戶端下載頁選擇適用於作業系統的安裝程式，安裝後開啟主畫面。用戶端負責讀取設定並轉送流量，安裝完成並不會自動取得可用節點。訂閱網址或節點參數需從有權使用的服務管理頁面取得；本教學不提供公開訂閱，也不需要將網址貼到任何線上轉換頁面。

備妥訂閱網址後，先確認裝置的日期、時間與時區正確。時間明顯有誤可能影響驗證或安全連線。接著檢查是否有其他代理程式正在執行：桌面版請避免多個程式同時修改系統代理；Android 通常只能維持一個作用中的 VPN 連線。初次設定建議先關閉其他接管流量的程式，避免入口衝突，再進行以下步驟。

訂閱 URL 通常包含存取權杖，請妥善保管，如同帳號資訊。不要在截圖、公開聊天記錄或問題回報中貼出完整網址；需要求助時，只需說明用戶端名稱、操作位置及錯誤類型。了解「訂閱」與「節點」的差異後即可繼續操作，相關名詞可查閱術語表，不必先讀完協定原理。

STEP 01 / SUBSCRIPTION

匯入訂閱：儲存網址後更新節點

先確認手上的內容屬於哪一類。通常以 https:// 開頭、用來持續取得節點清單的網址是訂閱 URL；以 vmess://、vless:// 或 trojan:// 開頭的內容，通常是單一節點分享連結。兩者的匯入位置不同：訂閱應加入訂閱群組，分享連結則應使用從剪貼簿匯入的功能。若將單一節點連結填入訂閱網址欄位，可能會儲存成功，更新時卻發生錯誤。

v2rayN：新增訂閱群組

在主視窗開啟「訂閱群組」選單，進入「訂閱群組設定」並選擇新增。為群組填寫易於辨識的備註，再將完整訂閱 URL 貼到網址欄位。檢查網址開頭與結尾是否夾帶空格、換行或聊天軟體自動加入的標點；不要自行刪除或修改 URL 中的查詢參數。儲存後回到主視窗；此時只儲存了網址，尚未取得伺服器清單。

接著在訂閱選單中執行更新，可選擇目前群組對應的更新功能。首次使用且尚無可用連線時，通常先選擇「不透過代理」更新；若目前網路確實無法直接取得訂閱，且已有另一條可用連線，再考慮「透過代理」更新。查看底部資訊或日誌區域，等待更新完成，再選取剛建立的群組，確認清單中已出現節點名稱、協定及網址等欄位。

v2rayNG：新增群組並取得訂閱

在側邊選單中找到「訂閱群組設定」，點選新增按鈕建立群組，填寫備註與訂閱 URL 後儲存。回到節點主畫面，開啟右上角選單並執行「更新訂閱」或相應的更新功能。新增群組和更新訂閱是兩個不同操作：若只看到群組備註、沒有節點項目，先確認是否已執行更新，不必立刻重新安裝應用程式。

如果拿到的是單一節點分享連結，請複製完整內容，在主畫面的新增選單中選擇「從剪貼簿匯入」。匯入後確認節點已出現。單一節點匯入通常不會與訂閱群組持續同步；服務參數變更後，可能需要重新匯入。不要長期公開分享連結的 QR Code 截圖，因為其中也可能包含存取憑證。

更新失敗時，先確認網址仍有效，訂閱額度或有效期限正常，再查看日誌是否顯示網路逾時、憑證錯誤或格式不支援。不要反覆新增相同群組，否則之後難以判斷目前使用的是哪個群組。看到至少一個節點，且沒有明顯的解析錯誤後，保留清單並進入下一步；此時不必急著測試所有節點的速度。

STEP 02 / TRAFFIC ENTRY

選擇代理模式：分開設定入口與路由

用戶端中的「模式」可能指兩件不同的事。第一是應用程式流量如何進入用戶端，例如桌面版的系統代理、Android 的 VPN 接管；第二是流量進入後如何轉送，例如依照比對規則走代理或直接連線。啟用入口不代表所有請求都會經過代理；選擇代理路由也不代表其他應用程式已將流量送入用戶端。初次設定時先分清這兩個層面，後續排查就不必反覆修改無關選項。

v2rayN：先透過系統代理完成初次測試

在視窗底部或系統匣的右鍵選單中，找到「系統代理」相關選項，確認有「自動設定系統代理」和「清除系統代理」等功能。初次使用採用系統代理即可，不必同時啟用 TUN。先確認入口方案，等第三步確認核心正常執行後，再啟用「自動設定系統代理」，讓遵循系統代理設定的應用程式將請求送至本機監聽連接埠。

接著查看路由選擇區域。用戶端常見的規則集會區分代理、直連與封鎖，具體名稱依目前安裝版本而異。如果不清楚預設規則的含義，請先閱讀說明，不要只憑「全域」兩字就認為所有應用程式都會受到控制。若要確認特定目標能否透過所選節點連線，可暫時使用明確將該目標導向代理的規則；測試完成後再恢復日常需要的分流方式。

系統代理主要適用於會讀取系統設定的應用程式。部分命令列工具、遊戲或使用自有網路堆疊的應用程式可能不會遵循系統代理，因此本教學先透過瀏覽器檢查，不能只因「某個應用程式沒有變化」就判定節點失效。若要進一步了解 TUN、入站連接埠或不同流量入口，請參閱inbounds 入站設定；初次連線前不要同時變更多個入口。

v2rayNG：檢查路由與應用程式範圍

從側邊選單進入「設定」，查看路由相關選項。初次操作可保留版本提供的預設規則，但要留意預設規則可能會讓部分目標直接連線。若先前設定過依應用程式分流的代理，也要確認用來測試的瀏覽器沒有被排除；遭排除的應用程式可能直接連線，即使頂端顯示 VPN 已連線，也無法證明它的請求經過代理。

暫時不要同時啟用複雜的自訂 DNS、應用程式排除清單及多組路由覆寫。先將變因控制在「一個節點、一套容易理解的規則、一個測試應用程式」；連線成功後再逐項調整。網域比對、IP 比對與 domainStrategy 的詳細說明，請參閱術語表中的路由與 DNS 說明及routing 路由參考。確認代理模式後，回到節點清單準備啟動。

STEP 03 / CONNECT

連線節點：確認選取的節點與啟動日誌

清單中出現節點不代表它已設為目前的出口；連線按鈕顯示執行中，也不代表遠端一定連得上。這一步先確認目前使用的節點，再確認本機核心已啟動，最後才將應用程式流量導入。暫時只選擇一個參數來源明確的節點，連線過程中避免切換群組或大量編輯設定。

v2rayN：設為目前伺服器並啟用入口

在節點清單中找到目標項目，按右鍵選擇「設為活動伺服器」或同等功能。不同版本也可能支援雙擊切換；操作後請以目前伺服器標記、狀態列資訊或日誌為準，不要只看清單中反白的項目。用戶端會依照目前伺服器產生執行設定，並在需要時重新載入核心；等待日誌狀態穩定，再確認是否出現啟動失敗訊息。

如果日誌顯示本機連接埠已被占用，先關閉其他代理用戶端，並確認是否仍有另一個 v2rayN 執行個體在運作。不要為了消除錯誤而隨意修改所有連接埠；若確實需要更改監聽連接埠，系統代理或手動使用該連接埠的應用程式也必須同步修改。如果日誌顯示設定無法解析，請回到匯入步驟確認協定與用戶端是否相容，不要反覆點選啟動。

確認核心沒有立即關閉後，啟用上一節準備的「自動設定系統代理」。一般情況下，將 v2rayN 視窗最小化後程式仍會在背景執行，但選擇「結束」會停止相關服務。測試期間請保持用戶端執行，不要一邊關閉程式一邊測試瀏覽器。若安裝版本要求額外權限或執行元件，請依照畫面提示完成後重新啟動，再從目前節點繼續。

v2rayNG：選取節點並確認系統授權

在主畫面點選目標節點，將它設為目前選取項目，再點選底部的啟動按鈕。首次執行時，Android 系統會顯示建立 VPN 連線的授權提示；確認應用程式名稱正確後，允許連線。若取消授權，即使節點參數完全正確，應用程式也無法依照本教學接管流量；此時回到主畫面重新啟動並完成授權即可。

啟動後留意按鈕狀態與系統 VPN 圖示，再開啟用戶端日誌，檢查是否立即報錯或不斷重新啟動。系統圖示只能表示本機已開始接管流量，不能證明節點驗證成功。若另一個 VPN 應用程式仍在執行，請先停止它再啟動 v2rayNG。首次測試建議讓用戶端保持在前景；確認連線正常後，再依照裝置的電池管理設定處理背景執行問題。

此時不要把「延遲測試有數字」當成全部完成。有些測試只會連到伺服器連接埠，有些則會透過目前代理發出請求，兩者代表的意義不同。確認本機啟動正常後，進入下一步，透過實際連線檢查整條路徑；若需要比較測試方式，可另行閱讀TCPing、真實連線延遲與下載速度測試的差異。

STEP 04 / VERIFY

確認連線生效：比對實際請求與日誌

開啟用來測試的瀏覽器，新增分頁並前往一個確認正常且可連線的 HTTPS 網頁。盡量選擇先前未開啟過的頁面，或強制重新整理，以減少快取造成的誤判。不要只看舊分頁仍能顯示內容，也不要將影片緩衝後繼續播放當成新請求成功。測試時應確認的是啟動代理後發出的新連線。

接著回到用戶端，查看同一時間附近的日誌或連線記錄。如果目前日誌等級會記錄存取請求，請確認是否出現目標網域或網址，並搭配路由記錄判斷流量是經過代理還是直接連線。部分版本預設不會顯示每筆存取記錄，沒看到目標不代表測試失敗；可暫時啟用用戶端提供的存取日誌，檢查完成後恢復原設定，避免長期累積包含瀏覽目的地的資訊。

網頁能開啟，但路由記錄顯示 direct，只能證明直連路徑正常，不能據此確認所選代理節點可用。若要測試代理出口，應使用明確交由代理處理的測試目標，或暫時調整相應規則，再重新發出請求。反過來說，若代理目標可以連線，但區域網路裝置無法連線，應優先檢查區域網路直連規則，不要立刻更換節點。

連線失敗時，依三個環節逐步排查

先檢查入口。如果瀏覽器請求沒有進入用戶端，桌面版請重新確認系統代理是否已啟用，以及瀏覽器是否使用獨立的代理設定；Android 請檢查 VPN 是否仍保持連線，以及瀏覽器是否被列入依應用程式分流的排除清單。此時修改遠端 TLS 參數通常無法解決問題，因為請求尚未進入遠端連線階段。

接著檢查路由。如果請求已進入用戶端，卻走了不符合預期的出口，請檢查目前選用的規則集與目標比對條件。修改規則後儲存並重新載入設定，再用新請求測試；既有長連線可能仍沿用原本的路徑。暫時只調整與該目標相關的一條規則並記錄變更，避免同時更換節點、DNS 與代理模式，最後無法判斷原因。

最後檢查遠端連線。如果請求已交由代理出口處理，仍然連線失敗，請查看錯誤是否為連線逾時、驗證失敗或 TLS 交握錯誤。逾時可能與網址、連接埠或網路可達性有關；驗證失敗應確認訂閱是否有效及帳號參數是否正確；交握錯誤則要檢查服務要求的伺服器名稱、時間與傳輸設定。不要關閉憑證驗證來掩蓋錯誤，應優先重新取得正確設定。具體欄位請前往設定完整指南，依協定逐項核對。

確認連線後的保存與結束方式

確認請求已依預期經過代理後，只需記下有效的訂閱群組、節點備註與規則集名稱，不必記錄完整憑證。下次使用時通常只要更新訂閱、選取節點並啟動；只有服務參數或使用需求變更時，才需要重新調整前述模式設定。更新訂閱後節點名稱可能改變，請再次確認目前使用的節點，不要預設上次選取的項目一定保留。

停止使用時，v2rayN 桌面版請先清除系統代理，再結束用戶端；正常結束通常會一併清除相關狀態，但仍要留意異常關閉後殘留的系統代理設定。v2rayNG Android 版請點選停止按鈕結束 VPN 連線。若結束後瀏覽器突然無法連線，先檢查是否仍設定使用已停止的本機代理連接埠，不要馬上重設整個網路。

需要查詢名詞時，請使用術語表；想了解 JSON 中的 inbounds、outbounds、routing 與 dns 如何串接，請繼續閱讀設定檔完整參考。初次連線不必手動撰寫整份 JSON，先讓圖形用戶端的基本流程穩定運作。