官方手冊 · 系統查閱

Shadowrocket 完整使用手冊

從 App Store 取得、完成首次授權,到匯入訂閱、設定規則分流與日常維護。可依階段閱讀,也可直接跳至目前需要查閱的章節。

第一次連線可先閱讀使用教學,依照快速入門流程完成操作;本頁補充各步驟的前提、判斷依據與特殊情況,適合在設定前核對、連線後複查,以及遇到問題時逐步排查。本手冊主要說明 iPhone 與 iPad 的操作,介面名稱保留英文原文。

  • 已有自己的訂閱或伺服器資訊
  • 取得管道:App Store
  • 先驗證連線,再調整規則

01 / APP STORE

正版取得與購買紀錄

先確認應用程式身分,再完成購買。Shadowrocket 是 Apple 平台付費用戶端,唯一取得管道為 App Store。本網站的取得應用程式頁面整理了商店入口、正版核對與已購項目復原說明;本章則說明為什麼應在匯入設定前完成這些檢查。購買應用程式與準備伺服器是兩回事,商店交易成功只代表取得應用程式使用資格,不表示已備妥可連線的伺服器。

核對開發者、圖示與應用程式 ID

在 App Store 搜尋時,不要只憑「小火箭」這個別稱或相近名稱判斷。開啟產品頁面,核對產品名稱 Shadowrocket、開發者 Shadow Launch Technology Limited,以及產品連結中的應用程式 ID 932747118。圖示應與本站頁首顯示的官方圖示一致。名稱、圖示與開發者資訊都要一併確認;尤其搜尋結果中有相似名稱時,應進入詳細資訊頁閱讀完整內容,不要只看搜尋結果就付款。

應用程式 ID 是辨識產品的重要依據,產品頁網址末尾的 id932747118 對應本手冊所述的應用程式。商店中的介紹、相容性、購買資訊與更新紀錄,應以目前的產品頁面為準。本手冊不以固定版本號取代這項檢查,因為應用程式顯示內容與系統設定可能隨裝置實際狀態而變動。若頁面上的開發者或應用程式 ID 不符,請返回取得應用程式頁面重新核對入口。

了解一次買斷的適用範圍

Shadowrocket 採一次買斷方式,付款金額、幣別與購買適用性以 App Store 頁面標示為準。特別注意:用戶端一次買斷 ≠ 連線服務方案。應用程式負責讀取伺服器資訊、建立連線並執行分流設定;伺服器位址、驗證資料與訂閱連結則由你的服務供應商提供。應用程式的購買紀錄無法用來判斷訂閱是否有效;訂閱失效也不代表需要再次購買用戶端。

付款前確認目前 App Store 使用的帳號。日後重新安裝或更換裝置時,尋找應用程式需要核對原購買帳號的紀錄。系統中用於其他功能的帳號不一定等同商店購買帳號,不能只看裝置設定頂端顯示的姓名就判定購買歸屬。若商店按鈕顯示的內容與預期不同,請先檢查購買紀錄與帳號,再決定下一步;不要為了測試復原而反覆付款。

裝置相容性與復原範圍

本手冊主要說明 iPhone 與 iPad 的操作;Mac、Apple TV、Apple Vision 的相容性也可在同一個商店頁面查看,系統需求與購買適用性皆以 App Store 頁面標示為準。不要因為某部裝置可以下載,就推定另一部裝置也一定符合需求。準備換機時,請分別檢查目標裝置的相容性、商店帳號,以及是否能找到原購買紀錄。

復原應用程式與復原設定也要分開考慮。重新取得應用程式,不代表原有伺服器、訂閱及規則檔案都已復原。解除安裝前,應記錄必要設定並妥善保存設定檔;重新開啟後,請從 Home 和 Config 檢查實際內容。家人共享是否適用、產品目前在商店的供應狀態,以及商店要求的驗證步驟,皆以頁面與系統提示為準;不要把一次成功復原當成所有帳號與裝置都適用的通用條件。

完成本章後,應能回答三個問題:應用程式身分是否核對無誤、購買紀錄屬於哪個商店帳號,以及自己的伺服器資訊保存在哪裡。若其中任何一項仍不確定,請先釐清再匯入訂閱。商店顯示與重新安裝的情況,可繼續查閱已購項目復原說明;辨識搜尋結果時,可參考正版三項資訊核對文章。

02 / FIRST LAUNCH

首次啟動與系統權限

首次開啟後,先熟悉各頁面的用途,不必立刻調整所有設定。Home 用於查看伺服器並啟動連線,Config 用於管理規則設定,Data 用於查看流量,Settings 用於調整用戶端選項。不同裝置、顯示語言及應用程式目前狀態,可能影響項目排列;本手冊保留英文名稱以方便尋找功能,不以按鈕的固定位置作為唯一依據。先確認目前所在頁面,再執行新增、切換或刪除操作。

了解新增 VPN 設定的授權

首次啟動連線時,系統可能會要求允許新增 VPN 設定。這是用戶端建立系統網路連線所需的授權,不代表訂閱已成功匯入。請在自行開啟連線開關後閱讀系統提示,確認要求來自 Shadowrocket,再依系統流程完成驗證。若選擇取消,返回應用程式後,開關可能無法維持連線狀態;此時應先檢查是否已完成授權,而不是立刻修改伺服器密碼或重新匯入相同訂閱。

系統儲存的 VPN 設定與 Home 中的伺服器列表並非同一層內容。前者讓系統呼叫連線功能,後者提供連線目標與協定參數。刪除系統 VPN 設定不等於刪除伺服器;刪除伺服器也不一定會移除系統已儲存的設定。排查時應先確認要處理哪一層,避免把「重新授權」誤做成「清除所有伺服器」,讓問題範圍擴大。

相機、剪貼簿與本機內容的使用條件

使用 Scan QR Code 掃描時,系統可能會要求相機權限;只有需要即時掃描時才會用到這項權限。拒絕後可前往系統設定檢查 Shadowrocket 的相機權限;若已有文字資訊,也可以改用手動新增。不要把相機權限問題當成伺服器故障,因為此時尚未進入連線流程。QR Code 本身可能包含完整驗證資訊,掃描前應確認來源,掃描後仍要檢查匯入的類型與位址。

從剪貼簿讀取設定時,應先確認複製的是完整連結或設定文字,而非網頁標題、說明段落或遭截斷的位址。系統是否出現貼上提示,取決於目前操作與系統行為,依提示確認即可。若沒有出現預期項目,請返回原始資訊核對格式,不要因為反覆點選匯入,就直接假設新增成功。應以 Home 或 Config 中實際新增的內容,判斷是否匯入完成。

首次使用時建立可追溯的起點

第一次設定時,建議先保留一個明確的測試目標。先新增一筆自己確認有效的伺服器資訊,記錄目前的 Global Routing 選項,再開啟連線開關。此時先不要同時修改 DNS、On Demand 或複雜規則。如此即使連線失敗,也能將問題範圍限縮在授權、伺服器參數與基礎網路,不會受到多項未驗證設定交互影響。一次只變更一項,是後續所有排錯步驟的共同原則。

若裝置上已有其他 VPN 設定,連線前先確認系統目前啟用哪一項,避免多個連線設定互相影響。請一併查看系統設定中的連線狀態與應用程式開關;只看到狀態列圖示,無法證明目標網站已依預期策略連線。也不要在系統與應用程式之間快速反覆切換開關,否則連線、斷線與介面更新可能交錯,難以判斷哪次操作產生了結果。

完成首次授權後,返回 Home 確認伺服器仍在且選取項目正確,再進入下一章。若開關立刻關閉,請記錄是否出現權限提示、是否已有系統設定,以及是否顯示具體錯誤。記下這些現象,比只說「完全不能用」更有助於排查。若要快速完成第一次操作,可前往使用教學;權限與系統狀態的常見問題可查閱FAQ。本章的完成標準是了解授權用途,而不只是看到開啟狀態。

03 / SERVER & SUBSCRIBE

新增伺服器與匯入訂閱

匯入前先辨識手上的內容:單一伺服器的完整參數、單筆分享連結、訂閱連結,還是規則設定檔。這些內容對應不同物件,不能因為都只是一段文字,就放進同一個輸入欄位。伺服器描述連線目標;訂閱用於批次取得並更新伺服器項目;規則設定檔則決定請求如何分流。本手冊假設你已有自己的訂閱或伺服器資訊,相關資訊請向你的服務供應商取得。

手動新增時逐項填入參數

在 Home 使用新增入口進入 Add Server,先選擇 Type,再填入該協定所需欄位。類型選錯時,即使位址和密碼看起來正確,也無法建立預期連線。位址欄只填伺服器位址,連接埠依提供的值輸入;密碼、使用者識別碼、加密方式、傳輸設定與 TLS 參數則依原始資料填寫。備註主要用於辨識,不應以備註文字取代真正的伺服器位址。

Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 所需欄位各不相同,並沒有適用所有協定的統一參數組合。遇到不熟悉的欄位,先回到資訊來源確認,不要照抄其他項目的值。尤其要區分連線位址、TLS 使用的伺服器名稱與傳輸層 Host;這些值有時並不相同,各自用途也不同,不要為了「保持一致」就全部改成同一個內容。

參數類別核對內容常見錯誤
Type與原始協定一致依名稱或外觀猜測類型
位址與連接埠逐字核對提供的值把完整網頁網址填入位址欄
驗證資訊確認密碼或使用者識別碼完整複製時多出空格或漏掉末尾字元
TLS 與傳輸依原始參數分別填寫把 Host 與伺服器名稱當成同一項

匯入訂閱與更新後檢查

匯入訂閱時,在新增畫面選擇相應的 Subscribe 類型,將完整訂閱連結填入對應的位址欄,並設定方便辨識的名稱。儲存後等待讀取完成,再返回 Home 檢查是否建立訂閱群組,以及群組中是否出現伺服器。只有群組名稱、沒有可用項目,不能算匯入完成;請先核對連結是否完整、回應是否成功、訂閱內容是否仍有效,再進行後續連線步驟。

訂閱連結可能包含存取憑證,前後多出的空格、換行,以及被聊天軟體截斷的內容都會影響讀取。瀏覽器能開啟某個頁面,不代表該頁面就是用戶端可讀取的訂閱內容。若回傳登入頁、一般說明頁或錯誤提示,請重新確認原始連結的用途。不要把回傳文字硬當成伺服器參數逐項填寫,也不要在公開討論中貼出完整連結請他人代為判斷。

更新訂閱會重新讀取遠端內容,項目名稱、數量與順序都可能改變。更新後請檢查目前選取的伺服器是否仍存在,不要只看到更新完成就假設連線目標沒有變動。手動填寫的參數也應做好記錄,避免把臨時修改誤當成訂閱的永久內容。若要長期保留備註與設定調整,請先確認更新是否會覆寫,再決定採用何種維護方式。

掃描 QR Code、分享連結與設定檔的適用範圍

Scan QR Code 只是讀取入口,匯入後仍需檢查協定、位址與驗證欄位。QR Code 可能包含伺服器資訊,也可能是訂閱入口,不能只憑掃描成功提示判斷內容類型。分享連結同樣需要完整複製;若新增了多個項目,應逐一辨識來源與用途。匯入數量不是成功標準,最小可驗證結果是一筆參數清楚且可供選取的伺服器。

Config 中的規則檔案與 Home 中的伺服器應分開檢查。匯入規則不代表自動取得伺服器;匯入訂閱也不表示目前的 Config 已包含適合你的分流設定。第一次測試建議先確認伺服器參數,再檢查路由模式,最後驗證規則。若要進一步了解協定欄位,可參考協定與 Type 說明;連線參數仍應以你的原始資料為準,不要以文章範例取代實際驗證資訊。

04 / GLOBAL ROUTING

Global Routing 三種模式與規則順序

連線前先確認 Global Routing。設定、代理、直連三種模式分別對應 Config、Proxy、Direct,決定請求依何種方式處理。它們不是伺服器協定,也不是速度等級。切換模式不會自動修正錯誤密碼、失效訂閱或無法連線的伺服器;改變的是路由判斷方式。排錯時必須記錄目前模式,否則同一個請求前後經過不同路徑,容易被誤認為伺服器狀態時好時壞。

選擇 Config、Proxy 或 Direct

Config 會依目前啟用的設定與規則處理請求,適合已明確設定分流目標的日常使用。規則可讓部分請求使用代理、部分直接連線,也可拒絕指定請求。Proxy 以代理為主要處理方向,適合在檢查伺服器能否處理請求時,減少規則造成的影響。Direct 則以直連方式處理,不應以其連線結果證明代理伺服器已正常運作。三種模式都必須搭配目標請求與系統實際狀態判讀。

介面選項主要判斷依據適用的核對問題
Config目前設定中的規則與策略這個請求符合哪一條規則?
Proxy代理處理方向與實際代理目標排除分流差異後,請求能否完成?
Direct本機網路的直連條件基礎網路能否直接連線至此目標?

從 Proxy 切回 Config 後結果不同,應優先檢查規則與策略目標,不要立刻認定伺服器突然失效。反過來說,Config 下某個網站可用,也不一定代表代理可用,因為該網站可能命中了 DIRECT。合理的測試方式是先確認請求預期經過的路徑,再觀察實際命中的策略。測試結束後記得恢復日常模式,避免為了排錯而臨時變更的選項一直保留。

依照由上而下的順序理解規則

規則通常依序檢查,由第一個符合的項目決定後續處理,因此精確規則應放在範圍較廣的規則之前。DOMAIN 比對完整網域,DOMAIN-SUFFIX 比對網域後綴,DOMAIN-KEYWORD 依網域中的關鍵字判斷,IP-CIDR 與 IP-CIDR6 用於位址網段,GEOIP 依位址所屬地區判斷,FINAL 則處理前面都未符合的請求。規則關鍵字描述比對條件,末尾策略描述處理方向,兩者應分開閱讀。

[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

以上是教學用的 .conf 規則片段,不是完整設定,也不代表適用所有網路。第一行只比對指定的完整網域;第二行涵蓋相應的網域後綴;第三行示範私有位址網段與 no-resolve 的寫法;最後由 FINAL 處理其餘請求。example.com 和 example.org 僅為範例網域,貼上前應先了解每條規則的用途。修改現有檔案時,也應先確認是否已有相同或範圍更廣的項目。

策略目標與規則生效檢查

PROXY、DIRECT、REJECT 分別代表代理、直連與拒絕的處理方向;若規則使用自訂策略名稱,該名稱必須在目前設定中有相應定義。不要隨意將伺服器備註當成策略名稱,並假設用戶端會自動找到正確目標。檢查規則時,既要確認比對是否正確,也要確認命中的策略最終指向何處;規則符合與連線成功是兩個獨立的驗證步驟。

修改 Config 後,請確認編輯的是目前啟用的檔案、內容已儲存,並依實際提示重新載入或重新連線,讓後續測試使用新設定。既有連線可能繼續沿用先前路徑,應用程式快取也可能掩蓋修改結果,因此請重新發出請求再觀察。更多關鍵字說明請見規則語法入門;遇到不熟悉的名稱可查閱術語表。每次調整都應保留原始檔案,確認結果後再繼續擴充規則。

05 / CONNECTIVITY

建立連線與分層驗證

連線驗證應依序檢查「基礎網路、伺服器選擇、系統授權、測試請求、規則命中」。開關維持開啟,只能表示用戶端與系統進入相應的連線狀態,不能單獨證明所有目標都可連線。Home 中有伺服器,也只代表項目已儲存。分別確認這些狀態,可以避免遇到網站無法開啟時,就直接清除設定或重新購買應用程式。

從選取伺服器開始

在 Home 找到準備測試的伺服器,點選並確認選取標記。訂閱群組中有許多項目時,應先確認本次要使用哪一個,避免把群組名稱誤認為實際連線目標。若剛更新訂閱,請重新確認所選項目是否仍有效。接著檢查 Global Routing,記下目前是 Config、Proxy 還是 Direct;若 Config 使用自訂策略,也要確認策略最終選取的目標符合預期。

開啟頂端的連線開關,完成系統要求的授權,等待狀態穩定後再測試。若開關立刻關閉,優先檢查權限、系統 VPN 狀態與應用程式顯示的錯誤提示。若開關維持開啟但請求失敗,請繼續核對伺服器與網路,不要將兩種現象視為同一故障。測試期間避免快速反覆切換開關,因為尚未結束的連線與新的連線嘗試可能交錯,讓提示與實際請求難以對應。

Connectivity Test 能說明什麼

Connectivity Test 用來檢查特定測試條件下的連線狀況。解讀結果時應一併考量目前的路由模式、測試目標與所選伺服器,不能將單次測試成功推論為所有網站與應用程式都正常。不同測試方式可能使用不同路徑與協定,單一數值也不能取代實際服務請求。第一次測試最好固定伺服器、網路與目標,只改變一個變數,以便重複比較。

先執行 Connectivity Test,再嘗試連線至一個你明確知道應可使用的目標,確認頁面是否完整載入,而不只是標題出現。若測試成功但目標失敗,可能與目標本身、DNS、規則、憑證或應用程式快取有關;若測試與多個目標都失敗,則先檢查基礎網路與伺服器參數。也要區分 TCP 類請求與其他傳輸需求,一般網頁可正常開啟,不代表所有通訊方式都已驗證。

依據現象縮小故障範圍

中斷連線後,先確認裝置本身能連線至一般目標,排除 Wi-Fi 尚未完成登入、行動網路無法使用或網路暫時中斷。基礎網路恢復後,再連線至同一部伺服器進行比較。若只有某種網路失敗,應著重檢查該網路環境與傳輸條件;若不同網路都失敗,再核對伺服器位址、連接埠、驗證資訊與 TLS 參數。切換網路代表變更一項變數,應在測試紀錄中註明,不要同時修改規則。

若 Proxy 下測試成功、Config 下失敗,應優先檢查目前的設定檔、命中規則與策略指向。若只有一個網域異常,確認它是否被排序較前的規則涵蓋,以及網域解析是否符合預期。若所有項目同時異常,也不要立刻斷定所有伺服器都失效;還要檢查基礎網路、系統時間、共用的訂閱狀態或最近修改的共用設定。多個項目可能依賴相同條件,因此項目數量多,不代表彼此完全獨立。

完成驗證後的收尾

連線測試通過後,恢復預期的日常 Global Routing,再以相同目標重測一次,確認成功不只出現在臨時模式下。前往 Data 查看新請求與策略是否一致,並確認沒有留下臨時 DNS 或除錯選項。若問題仍未解決,整理可重現的步驟,再查看FAQ 的連線排錯說明。若需要逐步操作示範,可閱讀首次連線檢查文章,但不要略過自己的參數核對。

本章的完成標準不是偶然成功一次,而是能說明目前使用哪個目標、請求依哪種模式處理,以及如何重複驗證。只有基礎狀態穩定後,後續 Data 分析與 Settings 調整才有可比較的依據;否則不斷新增設定,只會增加不確定性。

06 / DATA

Data 流量檢視與請求判讀

Data 用於查看用戶端記錄的流量活動,適合確認「測試時是否產生請求、哪些目標持續通訊、處理方向是否符合預期」等問題。它不是服務供應商的計費帳單,也不是裝置所有網路活動的完整紀錄。查看資料前,先確認統計範圍、目前連線狀態與測試時段。總量增加不代表剛開啟的頁面一定使用了這些流量,因為背景同步與既有連線也可能同時發生。

先確定觀察時段

準備測試時,先記錄目前的統計值或列表狀態,關閉暫時不需要的前景工作,接著只執行一項明確操作,例如開啟目標頁面或重新整理一次內容。回到 Data 查看新增變化,不要只看累計總量猜測。若要清除統計,先確認清除的對象與提示,並保留原紀錄中的重要資訊;清除本機統計不等於清除遠端用量,也不會改變訂閱效期或服務供應商端的紀錄。

查看上傳與下載時,應了解請求本身也會上傳資料,包括建立連線、傳送請求標頭與應用程式提交的內容。即使只是在閱讀網頁,上傳量也不一定為零。下載量與檔案標示大小之間可能因協定額外負荷、快取、重試或壓縮而有差異,因此不要以單次測試的細微數值差距判斷是否異常。比較相同條件下重複操作是否出現明顯不同的情況,通常更有參考價值。

串連檢視請求、規則與策略

若目前介面提供請求或連線詳細資訊,應優先查看目標、處理策略與時間,而不只看流量大小。Config 模式下,一個頁面可能同時請求主網域、圖片網域、API 網域與其他資源,各自符合不同規則。主頁開啟但圖片載入失敗,可能是不同資源經過不同路徑,不一定代表整部伺服器無法使用。先確認失敗資源對應的目標,再回到 Config 查找相關比對條件。

看到 DIRECT 時,先確認這是否符合預期;看到 PROXY 時,還要確認實際指向的目標。不能根據網站內容語言、頁面外觀或載入速度反推處理策略。網域資訊不一定會完整顯示,部分連線可能主要呈現位址資訊,而且已建立的連線可能沿用先前的判斷。修改規則後重新發出請求並查看新紀錄,比只盯著舊連線是否立刻變化更可靠。

觀察到的現象可以接著檢查不能直接下的結論
測試後沒有明顯新增紀錄是否實際發出新請求、是否使用快取伺服器一定已失效
單一目標持續重試目標可連線性、規則、DNS 與驗證資訊所有應用程式都無法連線
統計量持續增加背景同步與正在傳輸的工作只有目前頁面在使用網路
本機統計與遠端用量不同計量範圍、週期與計算方式任一方的紀錄一定有誤

區分流量、速度與穩定性

累計傳輸量代表已處理的資料,短時間的變化則反映某一時段的活動;兩者都不等於長期穩定性。停留在網頁上卻沒有新流量,可能只是頁面已載入完成;短時間出現大量流量,也可能來自背景工作,而非測試目標恢復正常。驗證穩定性時,應重複相同操作、觀察錯誤是否再現,並搭配連線狀態判斷,而不是只追求某個瞬間更大的數值。

不同網路下的結果也應分開記錄。Wi-Fi 與行動網路的條件不同,會影響連線建立與傳輸表現,不要將兩次測試混在同一段累計統計中直接比較。若懷疑某項設定造成反覆重新連線,先保留觀察結果,再只還原這一項進行複測。不要同時清除統計、更新訂閱與修改規則,否則即使結果改善,也無法判斷真正起作用的是哪個操作。

診斷資料的隱私範圍

流量與請求紀錄可能包含網域、路徑、裝置使用習慣及驗證相關內容。分享前只保留排錯所需部分,移除帳號、訂閱憑證、完整伺服器驗證欄位與私人請求參數。有些欄位看起來像隨機字串,也可能是可用憑證;不確定用途時不要原樣公開。測試完成後,可依需求停止額外記錄,避免長期保存與目前問題無關的資料。

本章的目標是建立完整的判斷依據:明確記錄測試操作、找出新增請求、核對處理策略,再決定要檢查伺服器、規則或目標本身。Data 提供觀察依據,不能取代這些判斷。將異常現象與上一章的基本測試紀錄合併,比只提供一張顯示累計總量的截圖更有助於定位問題。

07 / SETTINGS

Settings 常用項目與調整範圍

基礎連線驗證完成後,再逐項調整 Settings,不要第一次開啟時就把所有開關都打開。不同設定影響不同層面:有些控制連線時機,有些影響網域解析,有些則與測試及紀錄有關。調整前先寫下要解決的現象,再確認項目說明與目前值。若介面沒有本章提到的項目,請以裝置實際顯示為準;不要依相似名稱猜測功能相同,也不要直接套用另一份設定中的所有選項。

On Demand:連線條件,不是伺服器修復

On Demand 用於依條件觸發連線,實際行為也會受到系統 VPN 設定、網路變化與裝置管理狀態影響。請先確認手動連線穩定運作,再考慮啟用。否則基礎參數錯誤與自動觸發行為相互疊加,可能表現為反覆連線、開關狀態變化或切換網路後結果不一致,反而更難分辨原因。按需連線決定何時嘗試建立連線,不會修復無法使用的伺服器。

啟用前先明確設定預期:哪些網路條件下需要連線、哪些情況下需要停止,以及手動中斷後預期會如何反應。修改後,分別測試應用程式在前景、切換網路與裝置重新喚醒等實際情境,觀察系統的實際結果。設定頁上的開關顯示為開啟,不代表所有條件都已生效。排查自動重新連線問題時,先暫時改回手動連線,有助於分辨觸發條件與伺服器本身的問題。

DNS:先區分解析失敗與連線失敗

DNS 負責將網域解析為位址,解析成功只是後續連線的必要條件之一。網域無法解析,與已取得位址但無法建立連線,應分開處理。檢查時先確認故障是否只發生在網域請求,再核對目前 Config 與 Settings 是否都包含 DNS 相關設定。檔案設定與介面選項可能共同影響最終行為,應依目前項目說明與實際請求結果判斷,不能只檢查其中一處就假設另一處不存在。

DNS 選項不是數量越多越好,也不是隨意更換就能改善所有連線。解析服務本身必須可連線,回傳的位址也必須符合後續路由預期。若修改後只有部分目標異常,請記錄目標網域與修改前後的設定,再還原原值進行比較。不要因為直接連線至某個位址成功,就認定網域解析一定正常;也不要因為測試頁面能顯示內容,就忽略應用程式實際請求可能使用不同網域或快取。

測試、紀錄與憑證相關項目

連線測試目標與測試方式會影響 Connectivity Test 的解讀。若修改測試項目,請保留原始值,並使用明確了解用途的目標驗證;測試目標無法使用時,結果反映的可能是目標異常,而非伺服器異常。記錄或診斷資料應針對具體問題暫時使用;記錄時間越長、範圍越大,不一定越容易分析。測試完成後,檢查是否仍保留不必要的詳細紀錄,並依隱私需求處理既有內容。

憑證與 HTTPS 相關設定需要特別謹慎。一般伺服器連線與基本規則分流,不應成為必須啟用解密檢查的理由。遇到憑證錯誤時,先核對裝置時間、目標網域與伺服器 TLS 參數,不要把關閉驗證當成一般修復方式。若不清楚某項憑證功能的影響,請先保留原狀並閱讀目前項目的說明;不要只為了消除錯誤提示,就改變整部裝置的信任判斷。

設定的作用範圍與還原方式

每次修改後,都應清楚知道該值只適用於某部伺服器、某個 Config 檔案,還是整個應用程式。修改單一伺服器的傳輸參數,不代表訂閱中的其他項目也會同步變更;切換 Config,也不一定會還原所有應用程式設定。簡單記錄設定的作用範圍,有助於解釋為何切換伺服器後問題仍存在,或為何換用另一個設定檔後結果突然不同。排查共通故障時,先檢查共同作用的設定層。

還原時依修改的相反順序逐項復原,每次還原一項並重新測試,不要直接重設所有內容。若需要重設,先備份伺服器與設定,確認敏感資訊的保存位置,並記錄哪些值需要重新填寫。Settings 的目標是讓行為可預測,而不是堆疊更多選項。日常只保留自己能說明用途的修改;若仍不熟悉介面用語,可查閱術語表,再決定是否需要調整。

08 / MAINTENANCE

訂閱更新、備份與日常維護

日常維護的重點,是保留一個已驗證的狀態,並確保每次變更都有跡可循。應用程式更新、訂閱更新、規則修改與更換裝置是不同操作,不要在一次沒有紀錄的嘗試中全部處理。遇到問題時,先確認最近變更了什麼,再選擇最小的修復範圍。只要基礎連線仍可重複驗證,就沒有必要為了局部異常刪除所有伺服器與設定;維護應降低不確定性,而不是一再從頭開始。

分開處理應用程式更新與訂閱更新

應用程式透過 App Store 更新,目前相容性與相關說明以商店頁面為準。更新應用程式不代表訂閱仍然有效,也不保證遠端伺服器狀態不變。更新訂閱讀取的是服務供應商提供的內容,兩者來源與目的不同。建議先記錄目前的連線結果,再進行其中一種更新並重新測試;確認正常後再處理另一項,才能將異常與特定變更對應起來。

更新訂閱前,先確認需要保留的手動修改;更新後檢查群組內容、目前選取項目,以及規則引用的目標。若名稱或項目有變,原先依名稱辨識的紀錄可能不再準確,應重新核對位址與用途。更新失敗時不要立刻刪除現有群組;先確認舊項目是否仍可連線,再檢查訂閱連結、基礎網路與回傳內容。保留可用狀態,有助於分辨讀取故障與伺服器故障。

備份時區分內容與憑證

備份前先列出要保存的項目:伺服器資訊、訂閱入口、Config 檔案、必要的 Settings 原始值,以及商店購買帳號的核對紀錄。使用應用程式目前提供的匯出功能或系統檔案儲存功能時,先確認匯出範圍,不要假設某個檔案一定包含所有設定。完成後檢查檔案是否找得到、名稱是否清楚,以及保存位置是否適合長期保管。備份檔存在但無法讀取,不算完成復原準備。

設定檔與分享內容可能包含密碼、使用者識別碼或訂閱憑證,不應像一般說明文件一樣公開存放。用於討論問題的副本應先移除敏感內容;真正用於復原的備份則需保留必要欄位並妥善保護。兩者用途不同,不要將經過刪改的診斷副本當成唯一復原檔案。若憑證曾意外公開,請向你的服務供應商確認處理方式,並檢查舊資訊是否仍有效。

換機與重新安裝採分階段復原

在新裝置上先從 App Store 重新取得應用程式,系統需求與購買適用性以 App Store 頁面標示為準,接著開啟應用程式檢查實際狀態。然後復原一部伺服器或一筆訂閱、完成系統授權並驗證手動連線。基礎連線成功後,再復原 Config 與日常 Settings,最後測試 On Demand。不要一次匯入所有內容後只憑開關狀態判斷復原完成,因為部分舊設定可能只有在切換網路後才顯現影響。

舊裝置上成功的設定,也可能依賴當時的網路、系統權限與仍有效的伺服器資訊。新裝置出現差異時,先比較這些前提,不要直接認定檔案損壞。保留舊裝置上的可用紀錄,逐項比較伺服器參數、Global Routing 與目前的 Config;確認復原完成後,再處理舊裝置中的敏感內容。購買復原的詳細步驟可查閱已購項目復原,不要將商店購買復原與設定遷移混為同一步驟。

建立固定的複查與排錯流程

每次重要調整後,都重複同一組檢查:確認目前伺服器、Global Routing 設定正確、Connectivity Test 與實際目標皆可驗證、Data 中的策略符合預期,並已還原臨時除錯設定。若問題再次出現,先暫停修改,記下最後一次正常狀態與首次異常之間發生了什麼變化。這類紀錄有助於縮小範圍,也能避免幾天後忘記某個臨時選項為何開啟,導致下次排錯從錯誤前提出發。

需要協助時,請提供裝置類型、網路環境、路由模式、問題是否可重現、已進行的對照測試,以及不含憑證的錯誤提示。避免只說「連不上」或「很慢」,也不要一開始就提供完整備份。依故障階段返回本手冊相應章節:匯入異常查閱伺服器與訂閱,路徑異常查閱 Global Routing,開關或請求異常查閱連線驗證,自動觸發異常查閱 Settings。

至此,應已建立完整的使用流程:透過正版取得確認應用程式身分,首次授權建立系統條件,伺服器資訊提供連線目標,Config 決定路由,測試與 Data 提供判斷依據,Settings 調整行為,備份與紀錄則確保可復原。日常操作不必反覆重做全部流程;出現變化時,從受影響的層面開始檢查即可。快速操作可回到使用教學,常見疑問請查閱FAQ,規則細節則可繼續閱讀站內相關說明。