官方手冊 / 常見問題
Shadowrocket 常見問題
先確認問題發生在哪個階段：商店購買、首次開啟、匯入資料，或連線後的存取。以下依這四個階段整理，每個項目都可展開閱讀。
排查前記下錯誤訊息、目前網路與剛才調整的項目。一次只變更一個條件；App 已安裝、訂閱已匯入、系統顯示已連線，分別代表不同階段，不能互相取代。
App Store
核對正版與購買
先確認產品，再處理帳號與購買紀錄。帳號地區、裝置相容性與線路狀態是不同問題。
App Store 搜尋不到 Shadowrocket，該先檢查什麼？
先從下載指南開啟 Shadowrocket 的 App Store 產品頁，分辨搜尋結果未顯示與目前商店地區無法購買。網頁連結中的 us 不代表帳號使用該地區商店，實際購買店面由登入帳號決定。前往系統 Settings 的 Apple 帳號，進入 Media & Purchases 查看帳號的 Country/Region；選單名稱以系統顯示為準。若確實需要更改地區，請沿官方路徑確認餘額、現有訂閱與付款方式等要求，符合條件後再操作。一般網路故障不必反覆切換商店地區。
如何確認商店中的應用程式是正版 Shadowrocket？
請在產品頁核對名稱 Shadowrocket、開發者 Shadow Launch Technology Limited，以及產品連結中的 id932747118。再將 App 圖示與本站頁首的官方圖示比對，不要只憑搜尋結果中的名稱或排序判斷。核驗重點為開發者、官方圖示與 App ID，任何一項不符都應重新檢查產品頁。Shadowrocket 是閉源商業應用程式，唯一取得管道為 App Store；價格、相容性與購買適用範圍以 App Store 頁面標示為準。
一次買斷包含哪些內容？購買後就能連線嗎？
App 一次買斷不等於線路方案。購買取得的是 Shadowrocket App 的使用資格，不代表已有可連線的伺服器資訊。美國商店定價約為 2.99 美元，其他商店以當地貨幣顯示，實際金額以 App Store 購買確認頁為準。連線前，使用者需已有自己的訂閱或伺服器資訊，並確認服務狀態與參數。本站不提供、不販售也不推薦節點或訂閱。遇到連線問題時，請分別檢查 App 是否已安裝、匯入內容是否有效，以及目前網路能否連上目標伺服器。
更換裝置或重新安裝後，需要再次購買嗎？
先使用原購買帳號登入 App Store，在帳號的 Apps 或已購項目中尋找 Shadowrocket，再依頁面提供的重新下載入口操作；選單名稱可能因系統版本而異。若頁面仍顯示價格，先確認目前用於 Media & Purchases 的帳號與原購買紀錄，不要立刻再次付款。App 購買紀錄與 App 內資料是兩回事：重新取得 App 不代表原有訂閱、規則與自訂設定也會一併還原。更換裝置前請妥善備份自己的設定資料，還原後逐項檢查；購買適用範圍以 App Store 頁面標示為準。
能否使用家人共享？其他 Apple 裝置的支援情況要在哪裡確認？
先查看同一個 App Store 產品頁的家人共享說明與相容性欄位，再確認家庭群組的購買共享設定。是否適用取決於商店頁面標示、購買項目與帳號狀態，不能只因加入家庭群組就認定能夠重新取得。除了 iPhone、iPad，Mac、Apple TV、Apple Vision 的相容性、系統需求與購買適用範圍也以 App Store 頁面標示為準。共享 App 購買項目不代表訂閱資料或伺服器存取權限也能共享；使用者仍須確認既有服務允許的裝置範圍與連線條件。
Installation / Home
安裝與首次開啟
先區分 App Store 下載問題與 App 連線問題，再檢查系統權限。授權與伺服器設定需要分別完成。
iPhone 下載停住或無法完成購買，該怎麼處理？
先記下 App Store 顯示的完整錯誤訊息，分辨付款未完成、下載等待或裝置不相容。檢查裝置剩餘儲存空間、目前網路，以及 App Store 帳號是否需要完成付款驗證或接受新的帳號條款。下載停住時，可在網路穩定後暫停再重試；購買狀態不明時先查看購買紀錄，避免連續確認付款。系統需求以 App Store 頁面標示為準。若其他 App 也無法下載，應優先處理商店帳號或系統網路問題；只有 Shadowrocket 無法下載時，再檢查產品頁的供應情況與相容性。
iPad 可以安裝嗎？如何使用既有購買項目？
在 iPad 開啟同一個 Shadowrocket App Store 產品頁，先查看相容性與系統需求，並以 App Store 頁面標示為準。若已購買，請使用原購買帳號查看已購項目，再透過商店提供的入口下載；通用購買的適用範圍也以頁面標示為準。iPad 的畫面配置可能與 iPhone 不同，但尋找功能時仍請認明 Home、Config、Settings 等介面名稱。安裝完成後，請另外確認訂閱、伺服器參數與目前設定，不要把重新下載 App 視為 App 內資料也已轉移完成。
首次連線時出現新增 VPN 設定提示，代表什麼？
這是系統在為 App 建立網路連線設定時顯示的授權提示，不是購買確認，也不會自動填入伺服器資訊。請先確認安裝的是正版 Shadowrocket、已核對匯入內容，並由自己啟動連線，再閱讀提示並依系統要求完成授權與裝置身分驗證。若先前取消授權，可返回 App 再試一次；仍有提示時，請查看系統 VPN 設定狀態。受組織管理的裝置可能限制新增設定，此時請洽詢裝置管理員。完成授權僅代表允許建立連線，實際能否使用仍取決於伺服器、設定與目前網路。
Home 的連線開關無法開啟，應依什麼順序檢查？
先確認已匯入並選取有效伺服器，再留意開啟開關時是否出現系統授權要求、錯誤訊息，或短暫連線後立即中斷。若尚未完成系統授權，先處理 VPN 設定權限；若裝置上有其他正在使用的 VPN 設定，可先中止連線再測試。不要為了嘗試而直接刪除所有系統設定，尤其是受組織管理的裝置。接著檢查伺服器必填參數、既有服務狀態與目前網路。記下錯誤訊息後再重新啟動 App 或裝置，每次只調整一個條件，方便確認是哪個步驟讓連線恢復。
介面是英文，如何對照教學找到設定？
本手冊保留介面的英文名稱，請先依名稱尋找，不要只按截圖中的固定位置操作。Home 可查看連線入口與伺服器列表，Add Server 用來新增資訊，Config 是設定檔，Settings 用於其他設定；Global Routing 用來選擇路由模式。若要調整 App 語言，可在系統 Settings 查看 Shadowrocket 是否提供 Language 選項，並以裝置實際可選項目為準。若沒有對應選項，仍可依英文名稱操作。介面位置可能因裝置版面而異，遇到差異時先確認目前頁面，再比對所需功能名稱。
Add Server / Subscribe
訂閱與伺服器資訊匯入
以下僅處理使用者已有的資料。先辨認輸入內容類型，再區分請求失敗、格式解析失敗與連線失敗。
匯入既有訂閱失敗，應先檢查哪些項目？
先確認複製的是既有服務提供的完整訂閱連結，而非帳戶網頁網址、說明頁面或單一伺服器分享資訊。檢查連結前後是否有空格、換行或遺漏參數，並確認服務仍有效。在 Add Server 中選擇 Subscribe，貼上連結後儲存並查看取得結果。若顯示網路請求失敗，先檢查目前網路是否連得上；若顯示解析失敗，則確認回傳內容是否為支援的訂閱格式。向原服務提供者求助時，提供錯誤訊息即可，切勿公開含個人 Token 的完整連結、QR Code 或設定檔。
單一伺服器連結、QR Code 與 Subscribe 有什麼不同？
單一伺服器連結通常包含建立一條連線所需的協定與參數；QR Code 只是承載這些資訊的方式之一，內容也可能是訂閱網址。Subscribe 則用來取得並管理來源提供的一組伺服器資訊。匯入前先判斷內容類型：已有伺服器參數，可在 Add Server 中依對應協定填寫；QR Code 可透過 Scan QR Code 讀取；已有訂閱則使用 Subscribe。掃描成功不代表參數一定有效，儲存後仍須檢查位址、連接埠、驗證與傳輸設定。不要把訂閱網址填入伺服器位址欄位，也不要只因名稱相似就猜測協定。
訂閱匯入成功，但列表空白或項目變少，可能是什麼原因？
先確認目前查看的是剛匯入的訂閱群組，而非其他群組或篩選後的列表。接著查看更新結果，確認是否真的取得空內容，或是上次更新未成功。訂閱回傳的項目可能因原服務狀態、帳戶權限、格式支援或來源調整而變動，不能只憑項目數量判定 App 故障。保留現有資訊，再向來源確認目前應回傳的內容；不要反覆刪除並重新加入同一個網址。若列表中已有項目但無法使用，請改為檢查單一伺服器的參數與連線狀態；列表有項目與連線可用是不同階段。
如何更新既有訂閱？更新前要注意什麼？
在 Home 找到對應的訂閱群組，使用該群組的更新功能並查看結果提示；實際入口以 App 目前顯示為準。更新前記下正在使用的伺服器，以及曾對項目所做的本機修改。訂閱更新會依據來源回傳資料，部分本機修改可能被覆蓋，既有項目也可能遭到取代或移除。更新後請再次確認所選伺服器仍在列表中，再測試連線。更新失敗時，先保留目前列表並檢查網址、服務狀態與網路；不要連續重複匯入，以免同一來源產生多個群組，增加排查難度。
提供錯誤資訊給他人時，哪些內容需要遮蔽？
保留錯誤發生時間、操作步驟、協定類型、錯誤訊息，以及當時使用 Wi-Fi 或行動網路，這些資訊通常有助於找出問題。請遮蔽完整訂閱連結中的個人 Token、驗證密碼、私密金鑰及可直接匯入的 QR Code；公開設定檔前也要確認其中沒有相同資料。只遮住帳戶名稱並不足夠，連結參數與記錄內容仍可能洩露存取憑證。若敏感資料已公開，請透過原服務提供者的帳戶管理入口辦理更換，再更新 App 中的相關資訊。本站僅說明匯入與管理方式，不會收取使用者完整的存取憑證。
Global Routing / Connectivity Test
規則分流與疑難排解
固定測試目標，逐層檢查本機網路、伺服器、路由與設定。連線狀態與測試結果都需要透過實際存取確認。
Global Routing 中的 Config、Proxy、Direct 要怎麼選？
Config 會依目前生效設定中的規則選擇策略，適合已確認規則內容後使用；Proxy 會讓由 App 接管的連線採用所選代理路徑，方便比對伺服器；Direct 則讓由 App 接管的連線直接連線，可用來比較本機網路狀況。這三種模式只會改變路由方式，不會修正錯誤的伺服器參數，也不保證一定能連上目標。日常分流時先確認 Config 已啟用預期的檔案；排查時固定同一個目標，只切換路由模式並重新連線，避免同時更換伺服器與規則，失去比較基準。
顯示已連線，但網頁無法開啟，如何分層排查？
顯示已連線通常代表系統連線設定已啟動，不代表已成功存取目標。先暫停連線，確認本機網路是否能正常開啟原本可瀏覽的頁面；再恢復連線，使用 Connectivity Test 檢查所選伺服器，並確認驗證資訊、連接埠與服務狀態。測試結果只反映該測試目標，仍須實際開啟需要瀏覽的頁面。如果 Proxy 可用但 Config 不行，優先檢查目前設定的規則、最終策略與 DNS；若兩者都失敗，再比較 Wi-Fi 與行動網路。每次調整後重新發出請求並記錄狀況，不要同時修改多項設定。
規則已加入 Config，為什麼連線結果沒有改變？
依序確認 Global Routing 設為 Config、修改的檔案已儲存並啟用，以及規則順序符合預期。規則通常由上而下比對，前面的廣泛規則可能先於後面的特定規則生效；FINAL 應負責處理未命中的連線。接著檢查比對對象：DOMAIN-SUFFIX 用於網域後綴，IP-CIDR 用於 IP 位址範圍，兩者不能互相取代。修改後重新建立目標連線，既有連線可能仍沿用原路徑。若結果依然不符預期，可參考 App 的連線記錄，核對實際網域、位址與命中策略，再針對特定規則縮小範圍排查。
啟用 On Demand 後會自動連線，該如何調整？
On Demand 會依已設定的條件觸發連線，不會先檢查伺服器是否可用再自動修復。若手動關閉後又自動重新連線，先確認是否啟用 On Demand，並檢查與目前網路相關的觸發條件。需要暫時手動排查時，可先停用 On Demand，固定伺服器與路由模式進行測試，完成後再依需求恢復。調整前記下原有條件，避免同時修改多處而無法還原。自動連線不代表流量一定經過代理，實際路徑仍由 Global Routing 與目前設定決定；確認開關狀態後，也要檢查實際路由結果。
使用後耗電增加或速度變慢，如何判斷原因？
先在相近的網路環境、使用時間與瀏覽內容下比較，避免將影片串流、雲端同步或行動訊號微弱造成的耗電全歸咎於 App。查看系統的電池用量，並留意是否頻繁重新連線、持續測試或長時間開啟詳細記錄。若速度變慢，先比較本機網路，再檢查所選伺服器與既有服務狀態；協定參數應依來源資料核對，不要隨意更改。排查時一次只變更網路、伺服器或設定其中一項，完成後停止不再需要的測試與詳細記錄。單憑耗電百分比或一次測速，無法判斷故障發生在哪一層。