Shadowrocket
完整使用手冊

取得與安裝

先確認裝置平台，再選擇取得方式。iPhone / iPad 請從 App Store 取得；Mac、Windows、Android 與 Linux 請前往本站下載頁選擇安裝檔，檔案由本站的 /dl/shadowrocket/ 路徑提供。不要把手機上的購買紀錄當成電腦版的安裝步驟，也不要把下載完成視為設定完成。安裝只會準備好客戶端；連線仍需要使用者已有的伺服器參數或訂閱網址。

確認 iPhone / iPad 的 App Store 商品頁

從下載頁的 App Store 入口前往商品頁，確認名稱為 Shadowrocket、開發者為 Shadow Launch Technology Limited，且 App ID 為 932747118。圖示應與本站頁首的官方圖示一致。確認這些資訊比只搜尋「小火箭」更準確；名稱相近不代表是同一款 App。iPhone / iPad 的系統需求以 App Store 頁面標示為準，安裝前請確認裝置符合需求。

iPhone / iPad 版於 App Store 售價 $2.99，一次性付費；Mac / Windows / Android / Linux 版免費。App Store 會依帳號所在店面顯示當地貨幣，付款前請以商品頁資訊為準。換用另一台 iPhone 或 iPad 時，先確認 App Store 登入的是原購買帳號，再到已購項目中尋找。若搜尋不到，先確認帳號地區與 App 的供應情況，不要反覆修改客戶端設定來處理商店問題。

選擇電腦與 Android 安裝檔

Mac 提供 Apple 晶片版與 Intel 版，兩者都可從下載頁取得。開啟系統「關於這台 Mac」；若顯示 Apple 晶片名稱，請選擇 Apple 晶片版；若顯示 Intel 處理器資訊，則選擇 Intel 版。下載後開啟磁碟映像檔，將 App 移至 Applications，再從該資料夾啟動。不要長期直接從磁碟映像檔執行，否則日後替換 App、清理下載檔案或處理系統權限時，容易找錯位置。

Windows 請選擇下載頁提供的安裝檔；先關閉正在執行的舊版，再完成安裝。Android 請選擇相應的 arm64 安裝檔；若裝置提示不相容，應確認裝置架構與系統需求，不要反覆點選安裝。Linux 請依發行版選擇 deb 或 rpm；AppImage 適合以獨立檔案方式執行。各平台入口集中在全平台下載，本手冊不另列可能過期的安裝檔名稱。

了解首次開啟時的系統阻擋

桌面版與 Android 安裝檔沒有程式碼簽署，首次開啟時可能遭到系統阻擋。處理提示前，先確認檔案是從本站下載頁取得、檔案類型符合裝置，並閱讀系統顯示的 App 名稱。由組織管理的電腦可能禁止使用者自行放行，此時應由裝置管理員處理。不要為了啟動單一 App 而關閉整台裝置的安全防護，也不要對來源不明的檔案執行下列操作。

若 Mac 提示 App「已損壞」，先刪除這次下載的檔案，再從本站重新取得，以排除下載中斷或選錯套件的可能。確認 App 已放入 Applications、來源正確，且仍受隔離屬性影響後，才在終端機執行下列指令。此指令會遞迴清除該 App 目錄的擴充屬性，並不能修復真正損壞的檔案；請勿擴大指令的作用範圍。操作後重新啟動 App；若仍失敗，請保留完整提示並繼續排查。

xattr -cr /Applications/Shadowrocket.app

Linux 使用 AppImage 時，可在檔案管理員的權限設定中授予執行權限，避免手動輸入錯誤的檔名。若授權後仍無法啟動，請檢查發行版所需的執行環境及終端機錯誤訊息，不要把執行環境缺失誤認為訂閱錯誤。晶片版本選擇及系統提示的詳細說明，請參閱Mac 與 Windows 安裝說明和Linux 安裝格式說明。

首次啟動與權限

首次啟動時先確認介面，再處理連線權限。iPhone / iPad 的主要操作會用到 Home、Config、Data 與 Settings：Home 用來管理伺服器並啟動連線，Config 用來管理規則設定，Data 用來查看流量相關紀錄，Settings 用來調整客戶端行為。介面語言與系統版面可能影響文字位置；請勿只憑按鈕顏色操作，應依選項名稱及目前頁面判斷。

區分客戶端設定與系統 VPN 設定

客戶端中的伺服器、訂閱及規則檔案屬於 App 設定；系統彈出的「加入 VPN 設定」則是裝置網路權限，兩者不是同一份內容。匯入伺服器不代表系統已授權；系統已授權也不代表已有可用伺服器。首次連線時，Shadowrocket 會要求建立系統 VPN 設定；允許後，才能將需要處理的裝置流量交由客戶端處理。出現此提示本身不代表伺服器已連線。

授權時，請確認剛才是由 Shadowrocket 主動啟動連線，再依系統要求使用裝置密碼或生物辨識完成確認。此處需要的是裝置解鎖驗證，不是訂閱密碼，也不是伺服器驗證欄位。若當時取消，請返回 Home，確認伺服器項目完整後重新開啟連線開關，即可再次嘗試。連續取消授權，再反覆切換規則，無法解決尚未授予權限的問題。

允許後，可在系統設定的 VPN 相關頁面查看此設定；實際路徑會因系統版本而異，可使用系統設定搜尋 VPN。刪除系統 VPN 設定通常不等於刪除 App 內的伺服器，但下次連線時需要重新授權。不了解用途時，請勿刪除其他組織或工作 App 的網路設定；若裝置受管理，設定的新增與刪除可能由管理政策控制，一般使用者無法自行復原。

依使用情境授予權限

掃描 QR code 時，系統可能會要求相機權限。只有準備使用 Scan QR Code 時才需要允許；拒絕後仍可透過已有的文字連結或手動填寫方式匯入。若要重新啟用相機權限，請前往系統設定中的 Shadowrocket 權限頁面，不必重新安裝 App。掃描前也應確認 QR code 的來源；成功辨識只代表格式可讀，不代表其中的參數適用於目前帳號或仍然有效。

從剪貼簿匯入內容時，系統可能會詢問是否允許貼上。先確認剛複製的是自己的分享連結或訂閱網址，再允許相應操作。剪貼簿可能仍留有上一次複製的內容，因此匯入後仍須確認類型、備註與主機名稱。若需要透過本機網路存取裝置，也請留意系統的本機網路權限；這與建立 VPN 所需的系統授權不同，不能當成同一個開關。

首次使用時，不必為了消除提示而開啟所有權限。較妥當的做法是：執行一項明確操作，閱讀相應提示，授予完成該操作所需的權限，再驗證結果。若沒有使用某項功能的需求，可以維持原設定。系統通知、相機與網路設定各有不同用途；拒絕某項權限時，請確認受影響的具體功能，不要籠統地判定整個客戶端無法運作。

排除既有連線與管理政策的影響

若裝置上已有其他 VPN 連線或網路延伸功能，請先停止與這次測試衝突的連線，再啟動 Shadowrocket。多個 App 同時使用系統網路通道，可能造成開關剛開啟又關閉、狀態反覆變化，或請求仍經由舊連線傳送。排查時一次只保留目前需要的連線，並記錄關閉前的狀態；測試結束後再依原本需求恢復。不要用頻繁刪除所有網路設定來取代釐清具體衝突。

公共 Wi-Fi 可能需要先透過瀏覽器完成驗證。若裝置尚未通過驗證頁面，客戶端連線測試與訂閱更新都可能失敗。請先暫停連線，確認一般網路可以開啟驗證頁面並完成登入，再返回客戶端。行動網路與 Wi-Fi 都需要具備基本連線能力；若沒有基本網路，即使伺服器參數正確也無法建立遠端連線。系統 VPN 圖示不能取代實際的網路連線。

處理好權限後，先保持 On Demand 關閉，手動連線一次。這樣可以清楚區分手動操作造成的狀態變化與自動觸發行為。若系統設定遭誤刪、授權提示反覆出現，或在設定中找不到相應項目，請參閱加入 VPN 設定提示說明。保留錯誤提示的完整文字，比只說「連不上」更有助於判斷下一步。

新增伺服器與訂閱

先辨認手上資料的類型。單一分享連結描述一台伺服器；訂閱網址通常會傳回一組伺服器及相關資訊；Config 檔案則描述路由規則與設定行為。三者用途不同。若把規則檔案當成伺服器訂閱，或將單一伺服器連結填入不相符的欄位，可能會匯入失敗、清單空白，或只出現設定名稱卻無法連線。匯入前請先向自己的服務提供者確認資料類型與適用欄位。

使用 Add Server 手動填寫

在 Home 中開啟 Add Server，先選擇與既有資料相符的協定類型，再填入位址、連接埠及驗證資訊。位址欄通常填寫主機名稱或 IP 位址，不要順手加上網頁路徑；連接埠應填入服務端提供的連線埠。備註僅供本機辨識，修改備註不會改變連線目標。填寫時請保留原始資料，以便逐項核對；不要把網站登入密碼直接當成伺服器密碼。

協定類型會決定欄位的用途。Shadowsocks 需要符合加密方式與密碼；VMess、VLESS 常會用到使用者識別碼及傳輸參數；Trojan 常會用到密碼與 TLS；WireGuard 則使用金鑰、位址與對端資訊。各協定所需參數數量不同是正常的，不要將某個協定的欄位照搬到另一個協定。若資料未提供某項進階參數，請先確認是否需要，避免憑經驗自行填寫而導致交握失敗。

匯入分享連結或 QR code

若已有完整分享連結，優先使用客戶端支援的匯入方式，減少手動抄寫錯誤。QR code 只是承載參數的另一種形式；掃描後仍應開啟項目，檢查類型、位址與驗證欄位。若 QR code 來自截圖，請留意內容是否遭裁切，或縮放到難以辨識；辨識失敗時應索取原始文字資料，不要猜測模糊不清的字元。儲存後確認項目確實出現在 Home。

連結前綴有助辨識協定，但不能只憑前綴判斷所有參數都已齊全。分享連結中的編碼、特殊字元與查詢參數都必須完整保留；通訊軟體自動換行不一定代表連結本身含有換行。複製時請避免帶入句尾標點。單一連結與訂閱網址的差異，請參閱分享連結格式說明，再回到本章核對欄位。

新增與更新既有訂閱

向自己的服務提供者取得完整訂閱網址，在 Add Server 中選擇 Subscribe，填入網址並儲存，再執行更新。網址中的路徑與查詢參數通常用於識別，不要為了縮短網址刪除尾端內容。訂閱成功後，請檢查群組與伺服器項目，而不只是確認是否出現訂閱名稱；若名稱已儲存但內容尚未取得，就不算完成匯入。首次更新失敗時，不要急著刪除原本可用的項目。

更新訂閱會發出網路請求。網址失效、帳號狀態變更、基本網路故障或回傳內容不符預期，都可能導致更新失敗。若舊項目仍存在，先保留並記錄錯誤，再判斷是網址無法存取、回傳登入頁面，還是內容格式無法解析。更新不等於連線測試；成功取得伺服器清單，只代表資料已下載，項目是否可用仍須在後續章節驗證。

手動修改訂閱產生的伺服器項目時，請考慮下次更新可能會覆蓋修改。若需長期保留本機調整，先記錄調整目的與原始值，再確認是否適合建立獨立項目。不要同時匯入多份相同訂閱並逐一改名，否則更新後難以判斷哪個群組有效。維護時保留一個來源清楚的主要群組；待新群組驗證成功後再清理舊群組，避免排錯時失去參照。

匯入完成後，選取一台準備測試的伺服器，記下所屬群組與備註，再繼續設定 Global Routing。此時只需確認資料完整，不必一次匯入所有舊設定。若清單空白，先檢查匯入類型與訂閱更新狀態；若項目存在但無法連線，再核對協定參數。區分「沒有取得資料」與「已有資料但無法連線」，才能避免在錯誤的位置反覆操作。

Global Routing 三種模式

Global Routing 決定客戶端如何處理流量，不是伺服器清單的另一種排序方式。介面中的 Config（設定）、Proxy（代理）與 Direct（直連）代表不同的路由模式。選擇前先確認測試目標：是要驗證伺服器連線，還是檢查規則分流。即使選用相同伺服器，不同模式也可能造成不同的存取結果；因此排錯紀錄必須同時寫明選取的伺服器與當時的 Global Routing。

使用 Config 進行規則分流

使用 Config 前，請先前往 Config 頁面確認目前實際選用的設定檔。匯入多個檔案不代表它們會同時生效；編輯未選用的檔案也不會改變目前連線。先記下檔案名稱，再檢查規則順序與策略名稱。遠端設定可能會參照其他資源；若資源取得失敗，檔案存在也不代表所有規則都已就緒。遇到異常時應檢查具體內容，而不只是確認檔案標題是否熟悉。

規則通常依序比對，由最先符合的規則決定處理方式。精確目標應排在範圍較廣的規則之前，最後的兜底規則則應放在末尾。若將涵蓋範圍很大的規則提前，後面的細項規則可能永遠不會符合。以下僅展示規則區段的基本結構，並非完整設定，也不包含伺服器資料；使用前應在副本中確認目前設定的策略命名，不要直接覆寫既有檔案。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

這段範例表示：先處理指定網域，再處理指定網域後綴、本機位址範圍及地區比對，最後將其他目標交由 PROXY 處理。範例網域僅供教學，不代表實際使用時也應採用相同策略。PROXY、DIRECT 等關鍵字須保持原樣；若設定使用自訂策略群組，規則末尾必須引用確實存在的群組名稱，否則可能導向無法執行的策略。

依比對對象理解規則

DOMAIN 比對完整網域；DOMAIN-SUFFIX 比對指定網域及其子網域；DOMAIN-KEYWORD 依網域中的關鍵字比對。關鍵字的涵蓋範圍往往比預期更廣，使用前應考慮誤判的可能。IP-CIDR 與 IP-CIDR6 比對位址範圍；GEOIP 依賴位址歸屬資料；FINAL 則處理前面所有規則都未符合的目標。網域規則處理的是主機名稱，不要將完整網頁路徑填在 DOMAIN 後面。

網域解析會影響位址類規則的判斷。一個網域可能解析出多個位址，快取與網路變化也可能造成不同結果，因此「昨天符合、今天不符合」不一定代表規則文字遭到修改。檢查時應一併確認目前請求的網域、解析結果及實際符合紀錄。像 USER-AGENT 這類比對方式依賴可取得的請求資訊，不要假設它能從所有加密連線中辨識完整的 App 行為。

用 Proxy 與 Direct 縮小排查範圍

若懷疑 Config 中的規則將請求導向錯誤路徑，可暫時切換至 Proxy，重新測試同一目標。若 Proxy 成功而 Config 失敗，優先檢查目前設定、符合的規則及策略指向；這並不代表應立即重填所有伺服器參數。若兩種模式都失敗，再檢查伺服器、驗證資訊與基本網路。測試結束後請恢復原本模式，避免將臨時排錯狀態當成長期設定。

Direct 可用來判斷一般直連路徑是否正常，但不保證所有網路都能直接存取所有目標。直連失敗也不能單獨證明是客戶端有問題，仍須搭配基本網路與目標服務的實際可達性判斷。比較時，盡量使用相同裝置、目標並在接近的時間測試，避免一邊切換網路、一邊改變模式。一次只變更一個條件，才能判斷結果究竟由哪項設定造成。

完成規則調整後，分別用一個預期直連的目標與一個預期代理的目標進行驗證，並檢查實際符合紀錄。網頁能開啟，只代表至少有一條路徑可用，不能證明所有分流都符合預期。修改前先儲存設定檔副本，修改後只驗證此次涉及的目標，確認沒有影響其他連線再擴大範圍。規則關鍵字的簡要定義請參閱術語表。

連線與驗證

連線驗證應分層進行：先確認裝置具備基本網路，再確認客戶端狀態，最後確認實際請求是否經由預期路徑。Home 開關開啟、系統顯示 VPN 標誌、伺服器延遲測試有結果，分別代表不同層面的狀態；任何一項都不能單獨證明所有 App 均可正常使用。測試時選擇一個自己熟悉且能重複存取的目標，避免同時變更伺服器、規則與網路，以免結果難以判讀。

先完成一次可重複的手動連線

先停用自動觸發行為，記下目前網路、選取的伺服器、Global Routing 與設定檔。開啟 Home 的連線開關，等待狀態穩定。若連線立即中斷，先檢查是否出現權限請求、系統錯誤或其他網路連線衝突；不要在此階段連續切換十多台伺服器。客戶端尚未穩定執行時，逐台測試伺服器通常無法有效比較；應先處理本機權限或啟動問題。

若狀態穩定，請開啟瀏覽器存取測試目標，再檢查實際需要使用的 App。不同 App 可能沿用舊連線、使用自己的解析方式或保留快取，因此瀏覽器測試成功不代表所有 App 狀態都相同。對先前已開啟的 App，可先結束目前請求再重新開啟；對持續連線的服務，應重新建立連線後觀察，避免將切換前殘留的連線誤認為新設定的結果。

正確理解 Connectivity Test

Connectivity Test 用來比較目前測試條件下的連線表現。測試方式、測試位址、網路類型與伺服器負載都會影響結果；顯示的時間不是長期效能保證，也不等於下載速度。比較伺服器時，應盡量使用相同測試方式並在相近時間進行。測試失敗可能是測試目標無法連線，或伺服器不支援相應方式；仍須搭配實際存取結果判斷，不要只因單一測試結果就刪除項目。

延遲偏低但網頁無法開啟時，請檢查實際請求是否需要不同的傳輸能力、是否有驗證問題，以及路由是否指向預期伺服器。延遲偏高但服務仍穩定時，也不必只為了數字排序而立即更換所有設定。更值得觀察的是請求能否完成、是否頻繁中斷，以及問題是否只出現在特定網路。記錄測試條件，比反覆點選重新整理更能找出變化原因。

依失敗階段選擇排查方向

若所有伺服器都無法連線，先確認基本網路、系統時間及訂閱資料是否有效；尚未完成網路驗證、裝置時間明顯錯誤或系統權限遭撤銷，都可能影響連線。若只有一台伺服器失敗，優先核對該項目的位址、連接埠、驗證資訊與傳輸參數，並向既有服務的提供者確認狀態。不要因單一項目失敗就清空整個訂閱群組，其他項目仍是重要的比較依據。

若已連線但網域無法存取，請檢查解析結果與 DNS 相關設定；若只有特定目標失敗，請檢查規則符合情況、目標服務狀態，以及是否採用特殊連線方式。出現憑證錯誤時，先確認系統時間、TLS 伺服器名稱，以及網路是否轉向驗證頁面；不要將關閉憑證驗證當作一般解法。驗證錯誤與憑證錯誤發生在不同階段，應分別保留原始提示並處理。

若 Wi-Fi 可用但行動網路失敗，或情況相反，請在其他設定不變的情況下重複相同測試。網路可能以不同方式處理 UDP、長連線或特定連接埠；這類差異無法靠修改備註解決。先確認問題是隨網路變化，還是隨伺服器變化，再檢查相關協定參數。若需要服務提供者協助，只需提供測試網路類型與錯誤階段，不必傳送完整訂閱憑證。

判斷「已連線但無法上網」

應將此狀況拆成四個問題：本機客戶端是否正在執行、遠端伺服器是否可連線、Global Routing 是否正確，以及 DNS 與規則是否符合目標請求。依序檢查可避免在伺服器無法驗證時反覆調整規則，或在規則判斷錯誤時不斷重新安裝。詳細排查步驟請見開關已開啟卻無法上網的排查說明；常見問答請參閱常見問題。

驗證完成後，請將臨時設定還原為實際使用所需狀態，包括 Global Routing、選取的設定檔，以及先前暫停的自動連線條件。再完整執行一次中斷與重新連線，確認成功並非偶然或來自舊連線快取。若問題只在長時間使用後出現，請記錄發生前是否切換網路、鎖定螢幕或更新訂閱；這些時間點往往比單次測試結果更有參考價值。

不要因為成功存取某個目標，就認定匿名性或隱私保護範圍已全面驗證。客戶端會依設定處理連線，實際路徑仍會受到系統、網路及目標 App 影響。本手冊的驗證目標是確認設定與實際請求相符，而不是根據單一圖示做出過度推論。明確界定測試範圍，才能在日後維護時重現相同問題。

Data 流量與請求紀錄

Data 的主要用途是查看客戶端能記錄到的流量與連線活動，並將觀察結果與目前設定對照。先閱讀頁面所示的統計範圍與單位，再解讀數值。裝置系統、客戶端與服務提供者可能採用不同統計方式，數字不完全相同不代表其中一方有誤。排查問題時，應留意測試前後的變化、請求是否出現及處理路徑，而不只是累計總量。

區分流量、速度與延遲

累計流量表示一段統計期間內的資料量；即時速度表示單位時間內的資料變化；延遲則表示一次測試往返所需時間。三者回答的問題不同。流量增加只代表有資料經過統計範圍，不表示某個網頁已載入完成；瞬間速度偏低可能只是 App 暫時沒有請求；延遲測試成功也不保證大型檔案傳輸穩定。不要用其中一項取代另外兩項下結論。

上傳與下載都可能影響實際使用。開啟網頁也會傳送請求、驗證與確認資訊；影片播放前也可能有上傳活動，因此上傳量不一定代表異常。背景 App、系統同步與重試請求也會持續產生資料。查看統計時，先確認當時有哪些 App 正在執行；必要時暫停其他工作，只執行一次目標操作，讓變化更容易歸因。不要用一整天的總量解釋剛才幾秒鐘內的請求。

透過小範圍測試定位規則

懷疑目標沒有經由預期路徑時，先記下目前統計狀態，再單獨存取該目標，並檢查可用的連線或請求紀錄。重點查看目標網域、位址、採用的策略及錯誤階段，不要只看是否出現熟悉的 App 名稱。一個網頁可能同時請求多個網域；若主頁成功但圖片載入失敗，應分別檢查相關連線。找到實際失敗的請求後，才適合決定是否修改規則。

若紀錄顯示 DIRECT，但預期應交由代理處理，請返回 Config 檢查目前檔案與規則順序；若顯示代理策略，實際卻指向尚未準備好的策略群組，請檢查群組內的選擇。規則符合不代表遠端連線成功，後續仍可能發生解析、交握或驗證錯誤。將「為何選擇這條路徑」與「這條路徑為何失敗」分開處理，比一邊更換伺服器、一邊新增規則更清楚。

沒有看到目標紀錄時，也不能立即斷定該 App 完全繞過客戶端。可能是舊連線仍在沿用、目前紀錄篩選條件不符、頁面快取沒有產生新請求，或紀錄功能未涵蓋該類資訊。先重新發出請求或重新啟動目標 App，再檢查篩選範圍。紀錄中找不到某項內容，只代表目前的觀察條件沒有取得該紀錄，不應據此做出過度推論。

了解客戶端與服務提供者的統計差異

服務提供者的計費方式可能包含協定額外負載、雙向流量、特定倍率或結算週期；客戶端統計則反映自身觀察範圍。統計起訖時間與計量單位不同，也會造成差異。核對用量前，應先確認兩邊的週期、重設時間與單位，再比較相同時間範圍；客戶端資料不能取代服務提供者帳號中的剩餘額度，訂閱名稱中的文字也不能作為即時餘額的唯一依據。

直連與代理流量也可能出現在不同統計範圍。切換 Global Routing 後，總量變化不一定能直接反映規則是否符合預期，仍須搭配具體請求紀錄判斷。App 更新、圖片預載與連線重試都可能使短時間內的資料量突然增加。若懷疑用量異常，先暫停其他工作並記錄測試時段，再逐一恢復各 App；不要直接刪除設定而失去原始狀況。

控制紀錄範圍與資訊曝光

紀錄可能包含存取網域、時間、位址及連線錯誤，應視為涉及隱私的診斷資料。只在排查所需範圍內保留詳細資訊，結束後恢復日常紀錄層級。分享截圖前，請檢查是否露出完整訂閱網址、驗證欄位、私人伺服器位址或個人瀏覽紀錄；遮住標題不代表內文已完成去識別處理，QR code 與展開的詳細項目也要一併檢查。

清除統計前，先確認是否需要保留比較資料。重設可建立新的測試起點，但無法修復伺服器、增加遠端帳號額度或改變規則比對結果。操作後記下重設時間，再依固定步驟測試，結果才有判讀依據。若介面沒有提供所需細節，請回到更基本的連線驗證方式；不要編造不存在的數值，或靠猜測填補紀錄空白。

觀察完成後，請將結論寫成具體描述，例如「相同網路下，該目標在 Config 中符合 DIRECT；切換至 Proxy 後請求成功」。這比「流量不正常」更方便重現，也能直接指出下一步檢查方向。Data 應作為其中一項證據，搭配 Home 狀態、目前 Config 與實際存取結果一起使用，不應單獨承擔所有故障診斷。

Settings 常用項目

Settings 用來調整客戶端的運作方式，不是修復所有連線錯誤的按鈕。先保留可正常運作的基準狀態，再依需要修改單一項目。介面選項可能因系統與功能條件而異，請以目前實際顯示為準。若找不到教學提及的開關，不要在無關頁面尋找同名替代項目；先判斷該功能是否由目前設定檔、系統權限或其他條件控制。

On Demand 按需連線

On Demand 會依設定條件觸發系統連線行為，與在 Home 手動開啟開關不同，也不會替使用者選擇一定可用的伺服器。啟用前，應先完成一次穩定的手動連線，確認目前伺服器、Global Routing 與 Config 都符合預期。否則自動觸發只會反覆重現原有錯誤，表現為不斷連線、中斷，或切換網路後再次失敗。

設定觸發條件時，先寫清楚希望在哪些網路情境連線、在哪些情境暫停，再逐項設定。若條件涉及 Wi-Fi 名稱，請確認名稱完全一致，不要把相似名稱當成同一個網路。啟用後，測試進入與離開條件時的狀態，並確認手動中斷後是否又被條件觸發。若要暫時停止自動連線，也應檢查 On Demand，不要只反覆關閉 Home 開關。

DNS 與解析相關設定

DNS 會將網域解析為位址；解析失敗時，可能出現伺服器可連線但網站無法開啟的情況。修改前先判斷問題是否只涉及網域：同一目標的位址與網域測試條件不同，不要隨意拿無關位址比較。解析也可能受 Config 中的設定影響，因此檢查時要區分 Settings 的全域選項與目前設定檔的內容，避免同時修改兩處而無法追查原因。

不要只因聽說某個解析位址速度較快，就替換所有 DNS 設定。解析器的可達性、查詢路徑與快取都會影響結果，是否適用目前網路必須透過實際請求驗證。遇到解析異常時，先記下原始值，確認目前網路是否正常、設定是否引用無法連線的解析方式，再進行最小幅度的修改。修改後重新建立相關連線，必要時清除可用快取；但不要把清除快取當成每次連線前的固定步驟。

TLS、傳輸與憑證限制

TLS 相關選項會影響客戶端驗證及建立加密連線的方式。伺服器位址、伺服器名稱、憑證與系統時間必須相互符合；即使使用 IP 連線，也可能仍須填入資料中指定的伺服器名稱。發生交握失敗時應逐項核對，不要直接忽略憑證錯誤。關閉驗證會改變安全性界線，不應作為日常維護的預設做法，也不能證明伺服器端設定正確。

進階傳輸參數應依據使用者已有的伺服器資料。Host、路徑、UDP 相關能力與協定選項不是開得越多越好；客戶端與伺服器設定不一致時，額外啟用也可能導致失敗。若服務需要某種傳輸能力，先確認伺服器明確支援，再核對具體欄位。瀏覽器請求成功只驗證了部分情境，不能推斷即時音訊與視訊或其他 App 所需能力都已具備。

備份、匯入與紀錄層級

備份前先確認包含哪些內容：伺服器項目、訂閱網址、設定檔與 App 設定未必都能透過同一種匯出方式完整涵蓋。先檢查匯出內容，再存放到自己掌控的位置。訂閱網址與金鑰屬於敏感資訊，不要將備份檔當成一般規則範例公開分享。還原備份時也要考慮裝置差異，尤其是網路名稱、檔案路徑與系統權限；不要假設另一台裝置可以直接沿用。

匯入設定或備份時，可能會合併、取代或新增內容；操作前請閱讀介面提示並保留現有副本。尚未確認覆寫範圍前，不要連續匯入多份舊檔案。還原後先檢查目前選取的 Config、伺服器群組與 Global Routing，再手動測試。看到熟悉的備註，只代表部分項目已還原，不代表系統 VPN 權限、自動連線條件及所有遠端資源都已同步完成。

提高紀錄詳細程度可能產生更多診斷資料，也增加整理負擔，因此只保留定位問題所需的範圍。測試結束後，清理不再需要的敏感紀錄，但請先保存已去識別的錯誤摘要。與其長期保留大量無法判讀的紀錄，不如記下發生條件與一套可重現的步驟；這有助於更準確地比較系統更新或設定變更前後的狀況。

完成 Settings 調整後，應再次確認 On Demand 是否處於預期狀態，避免測試期間暫時啟用的條件持續影響日常連線。若不確定某項設定的用途，維持原值並查閱相關說明，比同時嘗試多組參數更可靠。若要快速恢復使用，可回到使用說明的最短操作流程，只驗證基本連線，再逐項恢復進階功能。

日常維護與問題追蹤

日常維護的目標是保留可正常運作的狀態，並讓每項變更都能追蹤，而不是定期重新安裝客戶端。分別記錄 App 更新、訂閱更新與規則更新：App 更新會更換客戶端程式；訂閱更新會刷新伺服器資料；規則更新會改變路由判斷。三者可能各自發生；更新後若出現問題，先確認究竟哪一層改變，不要籠統地歸因為「更新出錯」。

安排更新順序

iPhone / iPad 的 App 更新透過 App Store 完成；Mac、Windows、Android 與 Linux 請從本站下載頁取得相應安裝檔。電腦更新前先退出正在執行的 App，保留重要設定；安裝後重新檢查系統權限與連線狀態。Android 安裝時若系統要求允許從目前來源安裝，請確認檔案來自本站；安裝完成後可撤銷該來源的權限。不要因更新而擴大其他 App 的安裝權限。

Mac 更新後仍須確認晶片版本；遇到系統阻擋時，請依第一章的方式處理。Windows 出現 SmartScreen 提示時，先確認檔案來源，再透過「更多資訊」查看是否可以選擇「仍要執行」。Linux 使用相同套件格式與套件管理方式，比較容易追蹤；若要更換格式，先確認舊版是否仍在執行，避免桌面捷徑啟動的是舊檔案，而不是剛下載的程式。

建議在基本網路穩定時更新訂閱。更新前記下目前使用的伺服器備註；更新後檢查該項目是否仍存在、參數是否變更，以及目前選取項目是否轉移。訂閱內容由既有服務的提供者維護，名稱變更不一定代表客戶端異常。若舊項目消失，先確認更新是否完整及帳號資料是否變更，不要立即手動補回無法確認有效性的舊參數。

為規則變更保留還原點

修改規則前，先複製目前可用的設定檔，以容易辨識用途的名稱儲存，並在本機記下修改原因。一次只處理一個目標或一類明確問題，測試完成後再繼續。匯入遠端設定時，先閱讀其中的 DNS、策略群組與遠端資源參照，不要只看規則數量。設定內容越多不代表越符合目前需求；不了解的項目可能改變本機網路存取或其他 App 的連線路徑。

出現回歸問題時，先切回已驗證的設定，維持伺服器與網路不變，再存取相同目標。若恢復正常，應優先比較新舊規則及解析設定；若仍然失敗，再檢查伺服器狀態與網路條件。還原是用來定位變數的方法，不是問題結論。切回設定時，不要同時更新訂閱、切換網路或更換伺服器，否則無法判斷是哪項變更讓連線恢復。

換機與重新安裝前的準備

換機前，備份需要的伺服器資訊、訂閱網址與 Config 檔案，並確認備份檔可以正常讀取。系統移轉不一定會自動還原 VPN 權限，首次連線時仍可能需要重新授權。iPhone / iPad 請使用原購買帳號，從已購項目還原 App；iPhone / iPad 版於 App Store 售價 $2.99，一次性付費；Mac / Windows / Android / Linux 版免費，可重新從本站取得相應安裝檔。

不要只保留含伺服器名稱的截圖，因為截圖通常不足以還原驗證與傳輸參數。備份也不能取代向自己的服務提供者妥善保存帳號資訊。若舊裝置遺失，或懷疑訂閱網址已外洩，請透過既有服務的管理入口處理憑證，再更新新裝置上的資料；單純刪除本機項目不會自動撤銷遠端憑證，也不會讓已外洩的網址失效。

建立精簡的排查紀錄

一份有效的問題紀錄應包含：發生時使用的網路、執行的操作、原本預期的結果、實際出現的提示，以及最近一次明確變更。保留錯誤原文比自行概述更重要，尤其是解析、連線、驗證與憑證問題。若需要截圖，請先遮蔽敏感資訊再保存；不要為了方便而讓完整訂閱網址、分享 QR code 或金鑰出現在公開討論中，也不要附上與故障無關的個人瀏覽紀錄。

1. 切回基本網路，確認裝置本身能正常連線。
2. 檢查 Home 中目前的伺服器、Global Routing 與選取的 Config。
3. 對同一目標發出一次可重複的請求，並搭配 Data 查看結果。
4. 一次只變更一項條件，記錄變化後再決定保留或還原。
5. 問題解決後，恢復自動連線與紀錄層級，並保存已去識別的結論。

需要進一步查閱時，簡短問題請看常見問題；規則名稱與協定欄位請查閱術語表；首次操作請返回使用說明。若已確認是伺服器資料或帳號狀態問題，請聯絡自己既有服務的提供者確認，不要繼續修改客戶端中無關的設定。本手冊說明設定方法，不提供線路或訂閱。

維護完成的標準不是調整過所有開關，而是目前設定用途清楚、連線可以重現、敏感資料妥善保存，且臨時測試狀態已復原。日後遇到相同問題，從八個階段中相應的位置繼續查閱即可，不必從安裝重新開始。將每次變更限縮在可解釋的範圍內，能減少重複操作，也有助於在裝置或網路變動後恢復原有使用方式。