01 / 權限
連線開關無法開啟,或開啟後立即關閉
開關無法維持開啟時,先確認系統是否成功建立網路延伸功能或 VPN 設定,不要直接修改伺服器密碼。Home 的連線開關代表客戶端要求接管相應網路流量;系統接受要求、延伸功能啟動、伺服器建立連線,是不同階段。開關剛開啟便回到 Not Connected,通常應先判斷問題出在權限階段還是連線階段。記下是否出現系統授權、身分驗證提示或錯誤訊息;錯誤原文比「無法開啟」更有助於診斷。
先確認系統授權與設定狀態
在 iPhone 或 iPad 首次連線時,允許系統新增 VPN 設定,並依系統要求完成身分驗證。若當時取消,請返回 Shadowrocket 再次發起連線;不要連續快速點按開關。接著前往系統 Settings 的 VPN 管理位置,確認是否有對應設定。系統版本不同,選單名稱可能略有差異,可在 Settings 搜尋 VPN。設定存在不代表伺服器可用;但設定尚未建立時,伺服器延遲測試也無法取代權限檢查。
若裝置由學校或公司管理,請確認管理政策是否限制新增 VPN、修改網路設定或執行網路延伸功能。受管理裝置的按鈕無法操作,與個人裝置的暫時性錯誤並不相同。保留限制提示並聯絡裝置管理員,不要反覆移除管理項目。若系統要求解鎖裝置後才能修改,請先解鎖再回到前景操作,避免將鎖定狀態下的失敗誤認為設定損毀。
排除連線衝突,再區分啟動與交握問題
先關閉其他正在連線的 VPN 工作階段,以及可能接管同一系統網路通道的功能,再測試 Shadowrocket。目的是減少同時變更路由的因素,並非要解除安裝所有網路工具。若停用其他工作階段後,開關能維持開啟,請逐項恢復原設定,找出衝突來源。系統狀態列的 VPN 標記只代表有系統連線,不能證明目前顯示的就是預期工作階段;請同時核對系統 VPN 清單中的名稱與連線狀態。
若開關維持數秒後中斷,請留意錯誤是否指向伺服器連線、驗證、憑證或設定解析。伺服器位址錯誤與系統拒絕授權的處理方式不同:前者應檢查伺服器與協定參數,後者則應繼續處理系統權限。不要因為開關關閉就清除所有伺服器。若開關可以正常開啟,但目標網頁無法使用,請直接前往下一章,避免重複處理已正常的權限環節。
- 中斷連線,保留目前設定與訂閱紀錄。
- 讓 Shadowrocket 保持在前景,等待系統提示完成後再檢查開關。
- 記錄錯誤原文;若開關穩定保持開啟,測試一項明確的網路要求。
- 確認系統設定異常後,才考慮移除對應 VPN 設定並重新授權。
重新授權的適用範圍與復原方式
移除系統 VPN 設定前,先確認應用程式內的伺服器資訊與 Config 副本都已保留。系統設定與應用程式內的規則檔案並非同一項目;刪除前請確認目前所在頁面,避免把訂閱清單當成系統設定清除。重新開啟 Shadowrocket 後發起連線,依系統提示新增設定;若仍然失敗,請重新啟動裝置,並在相同網路下再測試一次。重新啟動可排除暫時停滯的系統延伸功能,但不代表原設定正確。
在 Mac、Windows、Android 與 Linux 上,先確認應用程式能正常啟動,再檢查相應的網路權限。若問題其實發生在首次開啟應用程式之前,請依下載頁的安裝允許說明處理:Windows 確認來源後選擇 SmartScreen 的「更多資訊 → 仍要執行」;Mac 前往「隱私權與安全性」檢查「仍要打開」;Android 檢查「允許安裝未知應用程式」;Linux 檢查安裝格式與執行權限。不要把安裝遭攔截當成連線失敗,也不要允許來源不明的檔案執行。
02 / 路由
顯示已連線,但網頁與應用程式無法上網
連線開關維持開啟,只能表示系統連線已建立,不能直接證明每項要求都經過正確的出口。先分別記錄「全部無法存取」、「只有部分網域失敗」及「瀏覽器可用但某個應用程式失敗」等情況。這些現象可能分別與基礎網路、伺服器路徑、規則比對、DNS 或應用程式本身行為有關。選定一個平時穩定且用途明確的目標進行測試,重複相同操作;不要每次換不同網站,再籠統比較結果。
先檢查未連線時的基礎網路
關閉 Shadowrocket,透過目前的 Wi-Fi 或行動網路,前往原本可以直接存取的頁面。若此時也無法使用,請優先處理 Wi-Fi 登入驗證、行動數據權限、路由器或系統網路狀態。公共 Wi-Fi 可能要求先完成網頁驗證;出現連線圖示不代表驗證已完成。請先在 VPN 中斷狀態下完成驗證,再啟動 Shadowrocket;若驗證頁面本身無法開啟,不要繼續透過修改規則尋找原因。
基礎網路正常後,恢復原伺服器與原設定,確認 Home 中實際選取的是預期的 SERVER。清單中有多個相似名稱時,請核對位址或所屬訂閱,不要只看顯示名稱。某台伺服器剛通過測試,也不代表之後連線時自動選到它。若使用選取策略,還須確認策略最後指向哪筆可用紀錄;把策略名稱誤當成固定伺服器,會使前後兩次測試失去可比性。
用 Global Routing 三種模式進行比對
先記下原本的 Global Routing,再短暫切換模式進行診斷。Config 依目前設定處理流量;Proxy 將適用流量交由選取的代理路徑處理;Direct 用來比對直連結果。切換模式不是永久建議,而是為了區分規則問題與伺服器問題。測試完成後請恢復原模式,尤其不要忘記將診斷時暫時啟用的 Proxy 留在日常環境中。
| 模式 | 主要比對目的 | 依觀察結果採取的方向 |
|---|---|---|
| 設定 / Config | 觀察目前規則的實際效果 | 只有此模式失敗時,檢查規則順序與策略 |
| 代理 / Proxy | 減少規則分流差異 | 同樣失敗時,檢查伺服器、驗證與 DNS |
| 直連 / Direct | 觀察目標的直接網路路徑 | 同樣失敗時,繼續檢查基礎網路與目標服務 |
若 Proxy 可以存取、Config 卻不行,請查看目標符合哪條規則,以及該規則指向的策略是否存在。規則通常依序比對,前方較寬泛的項目可能會遮蔽後方較精確的項目。下方片段僅用來說明順序,並非可完整匯入的設定;實際使用時,必須確認目前設定中已定義 PROXY 對應的策略,不能只複製規則就認定出口可用。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
從單一要求繼續縮小範圍
若只有某個應用程式失敗,先用瀏覽器開啟同一服務的公開頁面,再比較應用程式登入、載入內容與上傳等不同操作。頁面可開啟但登入失敗,可能與驗證、時間或伺服器端風險控管有關;圖片載入失敗也可能來自其他網域,不能只替首頁網域新增規則。查看要求紀錄時,請留意實際失敗的網域與處理策略,避免將成功的要求當成故障證據。
若切換網路後恢復,請保存兩種網路在相同設定下的結果,再檢查區域網路限制與 DNS 差異;若所有網路都失敗,再集中檢查伺服器或設定。每次修改後都重新發起要求,必要時結束舊連線再測試;既有的長連線未必會立即套用新規則。完整匯入與連線步驟請見Config 設定教學,協定欄位相關問題請參閱協定常見問答。
03 / 伺服器與傳輸
伺服器逾時、間歇性斷線與速度緩慢
Timeout 表示某個步驟未能在等待時間內取得預期回應,不代表密碼一定錯誤,也不代表伺服器一定已停止運作。延遲測試、協定交握與實際瀏覽網頁可能採用不同測試方式,應分別記錄結果。先說明是單一伺服器逾時、同一訂閱中的伺服器全部逾時,還是只有某種網路環境逾時。範圍越明確,越容易判斷該檢查本機網路、訂閱參數或遠端服務。
區分測試失敗與實際使用失敗
執行 Connectivity Test 時,先確認測試對象與方式,再用瀏覽器發出一次實際要求。有些伺服器不回應特定探測,但仍能完成一般代理連線;反過來說,探測成功也不代表之後連往目標的路徑正常。不要把單一延遲數值直接當成下載速度,也不要只憑一次測試就長期判定伺服器狀態。在相同條件下連續測試的結果是否穩定,比單次讀數更有參考價值。
在設定不變的情況下,切換 Wi-Fi 與行動網路測試同一台伺服器。若只有 Wi-Fi 失敗,請檢查路由器、公共網路限制與 DNS;若只有行動網路失敗,請檢查應用程式的行動數據權限與目前數據網路狀態。測試會使用數據流量,尤其在傳輸大型檔案前應確認可用額度。若有另一台已確認可用的伺服器,可作為比對,但不要為了排查而匯入來源不明的紀錄。
依協定逐項核對參數
伺服器位址、連接埠與驗證資訊是第一組檢查項目;TLS、SNI、傳輸類型與路徑則是第二組。匯入成功只代表客戶端能辨識內容,不代表每個欄位都與伺服器相符。不要把伺服器位址直接填入所有名稱欄位,也不要因為連接埠相同就假設傳輸方式也相同。請優先與自己的服務商提供的原始資訊逐項核對,並在修改前保留原始紀錄。
| 協定或功能 | 主要核對項目 | 常見誤判 |
|---|---|---|
| Shadowsocks | 位址、連接埠、加密方式、密碼 | 只修正密碼,忽略加密方式 |
| VMess / VLESS | 身分欄位、傳輸方式、TLS 與相關參數 | 認為協定名稱相同,其他欄位就能通用 |
| Trojan | 驗證資訊、TLS、SNI | 混淆連線位址與憑證名稱 |
| Hysteria2 / WireGuard | UDP 可連通性,以及各自的驗證與金鑰參數 | 以一般網頁可存取,推斷 UDP 也能使用 |
出現憑證相關錯誤時,先確認裝置日期、時間與時區正確,再核對伺服器憑證名稱和 SNI。不要把停用憑證驗證當成通用修復方法,這會掩蓋名稱錯誤、憑證異常或連線目標不符等問題。若服務商已更換連線參數,請先更新自己的訂閱,再比對新舊項目的差異,不要憑經驗補填欄位。
將速度問題拆分為不同測量環節
連線建立緩慢、首頁載入緩慢與持續下載緩慢,是不同的瓶頸。建立連線慢可能發生在 DNS 或交握階段;首頁載入慢可能與目標網站及多個附屬網域有關;持續下載慢則還會受本地頻寬、伺服器負載與遠端線路影響。請使用相同目標、相近時段與同一檔案進行比較,每輪只變更伺服器或網路其中一項。也應將背景系統更新與雲端同步納入觀察。
若小型頁面正常,但大型檔案頻繁停頓,請記錄問題是否只出現在某種網路或傳輸方式,再請自己的服務商確認伺服器端狀態。沒有證據時不要任意調整 MTU 或並行參數,錯誤設定可能擴大故障範圍。恢復原值後能否穩定重現,是判斷參數影響的必要條件。回報問題時,請提供失敗時間、網路類型、錯誤原文及已遮蔽敏感資訊的參數,不要傳送完整密碼或私密金鑰。
04 / 訂閱資料
訂閱匯入或更新失敗,或清單沒有變化
訂閱更新分為「取得內容」與「解析內容」兩個程序。前者與訂閱網址可否連線、驗證及伺服器回應有關;後者則涉及格式、協定欄位與客戶端是否能辨識。先確認錯誤發生在下載階段還是匯入階段:連線逾時、驗證失敗、回傳空內容與格式錯誤應分別處理。自己使用的訂閱網址通常包含存取憑證,請勿將完整網址放在公開截圖、聊天紀錄或瀏覽器同步筆記中。
確認取得的是訂閱內容,而不是網頁
從自己的服務商帳戶頁面重新複製訂閱網址,注意不要複製到說明頁、管理後台或分享頁面。複製時檢查網址首尾是否混入空格、換行或中文標點,尤其留意通訊軟體自動換行後是否仍完整。網址中的參數有時用於驗證,不可為了縮短顯示而自行刪除。成功掃描 QR Code 只代表內容已讀取,不代表內容一定是客戶端所需的訂閱格式。
若回報驗證失敗或連結失效,先到服務商帳戶確認訂閱是否已重設、到期或受存取條件限制。之前保存的舊網址可能在重設後立即失效;客戶端反覆更新也無法還原已失效的憑證。若取得的是登入頁或驗證頁,表示下載到的不是伺服器清單,應取得正確的訂閱入口。不要手動將網頁內容改成幾行位址後,當成完整訂閱使用。
檢查取得路徑,並保護現有清單
有些訂閱網址在目前直連網路下無法存取,但透過已可用的連線可以取得;也可能情況相反。先記錄原本的連線狀態,再分別測試中斷連線與使用已確認可用的連線時,更新是否成功。不要使用正等待該次訂閱更新才能恢復的失效伺服器作為取得路徑,否則會形成排查循環。若所有伺服器都失效,請先向自己的服務商確認訂閱入口與伺服器狀態。
更新失敗時保留原有清單,避免先刪除整組訂閱。原有項目若仍可連線,有助於判斷問題僅限於訂閱介面,還是伺服器本身也無法使用。更新完成後核對伺服器數量與項目欄位,但不要只依數量相同就認定沒有更新;名稱可能不變,位址、驗證或傳輸參數卻已更改。反過來,清單數量增加也不代表新增項目一定能連線。
辨別解析問題與覆蓋範圍
若已取得內容但出現解析失敗,請確認服務商提供的格式是否與選用的匯入方式相符。Add Server、Subscribe、Scan QR Code 與 Import from Cloud JSON 適用的內容類型並不完全相同,不可將完整設定檔、單筆連線資訊與訂閱網址視為同一種輸入。先透過相符的入口匯入副本,確認結果後再取代舊紀錄;詳細操作請見訂閱匯入教學。
訂閱中的單筆紀錄若曾在本機手動修改,後續更新可能會重新寫入服務商提供的參數。若要保留臨時修正,應另存為獨立紀錄並清楚命名,同時向服務商核對原始資訊;不要長期依賴每次更新後再手動補改。若某些項目消失,請檢查篩選條件與群組顯示,再確認訂閱回傳內容是否真的包含這些項目,避免將顯示篩選誤認為資料遺失。
重試時請間隔一段時間;連續點按無法修復驗證或格式問題,還可能觸發介面存取限制。整理問題時,記錄失敗階段、錯誤原文、當時網路與連線是否開啟,並只提供已遮蔽敏感資訊的網址結構。若對方要求提供記錄,請先檢查其中是否含有訂閱憑證、伺服器密碼與私人網域。訂閱內容是否可用由對應伺服器端決定,客戶端付費狀態不能取代訂閱帳戶狀態。
05 / 名稱解析
DNS 失敗、網域無法開啟與規則比對異常
DNS 會將網域轉換成連線所需的位址。伺服器可以連線,但部分網域無法開啟,可能是解析失敗,也可能是解析成功後目標連線失敗;單憑瀏覽器的一則錯誤訊息,無法區分兩者。先記錄失敗網域、發生時間與 Global Routing 模式,再查看要求或診斷紀錄是否有解析錯誤。只看到空白頁面時,不應立即新增更多 DNS 位址;同時變更太多設定,會讓後續結果難以解讀。
區分解析失敗與目標拒絕連線
若紀錄顯示未取得位址,請優先檢查 DNS 伺服器是否可連線、所用傳輸是否依賴目前網路,以及相關設定是否生效。若已取得位址,但後續連線逾時,請繼續檢查路由、出口與目標服務。不要只用目標 IP 取代 HTTPS 網址作為唯一判斷;HTTPS 還依賴網域、憑證與伺服器名稱,直接連線 IP 失敗不能反證 DNS 一定正常或異常。
同一網域在 Wi-Fi 與行動網路下結果不同時,先保持伺服器與設定相同,再比較兩種網路。若只有區域網路內部名稱失敗,請檢查該名稱是否需要由目前路由器或公司內部 DNS 解析。公共解析服務通常無法辨識私人區域網路中的裝置名稱;將所有要求都交給同一個遠端解析入口,可能改善外部存取,卻使內部服務無法使用。內部網域應依目前網路設定處理,而非套用通用位址。
檢查 DNS 設定與規則順序的交互影響
在 Config 中確認目前使用的檔案,再檢查 DNS 相關設定,避免編輯未啟用的副本。記錄系統 DNS、設定檔中的 DNS 與可能存在的加密解析設定,逐項確認目前由哪一項處理要求。不要假設設定欄位中的每個位址都會同時生效,也不要混淆系統層的名稱解析結果與代理伺服器端的解析結果。不同處理路徑可能取得不同位址,應搭配實際要求紀錄判斷。
檢查規則時,應從最早可能符合的項目開始。DOMAIN 用於比對完整網域,DOMAIN-SUFFIX 用於比對網域後綴,IP-CIDR 與 GEOIP 用於比對位址條件,FINAL 則處理前面都未符合的要求。位址條件可能涉及解析結果,因此同一目標的 DNS 變化也可能影響後續分流。下方僅展示規則類型,不含完整策略定義,不能直接取代目前使用的設定。
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
若某個網域原本應走 PROXY,卻提前符合範圍較廣的 DIRECT 項目,應調整規則位置或條件,不要只在檔案末尾不斷新增相同網域。也要確認應用程式實際發出的網域是否與預期相同:登入、圖片、介面與推播可能使用不同網域。只看網址列,無法涵蓋所有背景要求;應從失敗紀錄找出需要檢查的對象。
快取、IPv6 與復原測試
修改 DNS 後,舊連線與快取可能持續影響結果。先儲存設定、中斷後重新連線,再重新發出目標要求;必要時關閉目標應用程式後再開啟。尚未等待新要求完成前,不要只重新整理診斷頁面就判定設定無效。重新啟動裝置可排除部分快取與工作階段因素,但應先記錄原始結果,以免失去可重現條件。
若只有部分網路出現 IPv6 相關連線失敗,請比較紀錄中的 IPv4 與 IPv6 位址,以及目前設定對兩類位址的處理方式。不要一遇到逾時就永久停用 IPv6,也不要預設啟用後一定更快。先確認失敗是否穩定與某類位址相關,再短暫進行比對,完成後恢復原值。若涉及路由器或公司網路的解析策略,請向網路管理員確認,不要覆寫受管理的設定。
06 / 背景執行與連線策略
背景耗電、發熱與 On Demand 反覆連線
排查耗電時,先查看系統電池用量統計,再判斷 Shadowrocket 是否為主要因素。電池頁面的占比是統計時段內各應用程式的相對耗電,不代表電池總容量按相同比例減少;裝置使用時間較短時,某項背景活動的占比可能看起來很高。先選擇具代表性的觀察時段,記錄螢幕使用、網路類型、訊號強度與背景下載情況,不要只用剛開啟應用程式後短時間的讀數下結論。
建立可比較的觀察條件
在系統 Settings 的電池頁面查看 Shadowrocket 的前景與背景活動,再與相同時段內的瀏覽器、影片、雲端同步及系統工作進行比較。透過系統 VPN 通道的流量,不一定是由客戶端主動產生;其他應用程式在背景持續傳輸,也會使網路延伸功能保持運作。Data 頁的流量紀錄有助於找出活躍項目,但流量大小與耗電量並非固定比例,還須搭配連線次數、無線訊號與裝置溫度判斷。
先暫停可明確辨識的大量背景傳輸,再觀察問題是否仍存在。若只在行動訊號微弱時發熱,行動網路重新連線與無線發射可能是重要因素;若在穩定 Wi-Fi 下仍持續發生,再檢查客戶端連線策略。測試時盡量保持相同螢幕亮度、相近使用方式與同一網路;不要一邊充電、一邊下載大型檔案,再與待機狀態直接比較。
On Demand 不一定是固定的省電開關
On Demand 會依設定條件觸發連線,但啟用後不代表一定省電,停用後也不代表一定更穩定。若條件與日常網路切換情況不符,裝置可能在 Wi-Fi、行動網路或喚醒時反覆嘗試連線。先記錄連線發生的情境:鎖定螢幕後、離開 Wi-Fi 時、加入某個網路後,或開啟某個應用程式後。將觸發時間與設定條件對照,才能判斷是否有重複觸發。
若要暫時關閉連線進行觀察,先確認 On Demand 是否會立即重新建立連線。若只點選 Home 的開關,卻未處理自動連線條件,可能會誤以為開關失效。短時間停用 On Demand 後,在相同網路與相近使用情況下觀察,再恢復原設定進行比較。這項測試是為了排除觸發因素,不代表建議所有使用者長期停用;若需要自動連線,應依實際網路條件整理規則。
- 記錄原有的 On Demand 條件與目前連線狀態。
- 暫停自動觸發,手動建立一次穩定連線。
- 觀察是否仍持續重新連線、網路中斷或出現異常背景活動。
- 逐項恢復條件,確認哪項條件會伴隨異常出現。
從持續重新連線追查伺服器與網路
若停用自動觸發後,手動連線仍頻繁中斷,請回到伺服器、網路與 DNS 章節檢查,不要只繼續調整電池選項。伺服器端連線不穩、驗證失敗或解析逾時,都可能讓客戶端反覆嘗試建立連線。背景耗電有時是連線故障的結果,而非獨立的效能問題。先讓連線恢復穩定,再評估待機影響,通常比單獨限制背景活動更容易找出原因。
若只在某個 Wi-Fi 下反覆重新連線,請檢查該網路是否需要定期驗證、閒置後是否會中斷,以及裝置是否頻繁切換基地台。系統低耗電模式、應用程式背景行為與網路策略也可能影響觀察結果,應一併記錄。不要為了降低耗電讀數而關閉與需求無關的系統保護;若工作情境需要長連線,請說明測試時是否保留相關背景工作。
詳細記錄與大量診斷測試若只為排查而暫時開啟,結束後應恢復日常狀態,避免觀察過程本身持續增加工作負載。若問題仍可重現,請整理出盡量簡單的情境:固定網路、單一伺服器、明確的 On Demand 狀態與一項可重複操作。流量面板相關資訊請閱讀Data 頁統計說明;連線策略取捨請參閱On Demand 與背景耗電排查。
07 / 更新與復原
應用程式或系統更新後,原有設定出現異常
「更新後發生」只是時間上的先後關係,不代表已證明更新是直接原因。應用程式更新、系統更新、訂閱更新、規則修改與伺服器端參數變更,可能在相近時間發生。先列出近期實際變更的項目,再使用保留的設定檔副本重新測試。不要同時重新安裝應用程式、重新匯入訂閱並更換 DNS;否則即使問題恢復,也無法確認是哪項變更有效,下次遇到相同問題仍缺乏依據。
先保存現況,再核對目前使用的項目
保留目前的 Config、伺服器資訊與錯誤原文,確認更新後是否仍選取原伺服器與原設定檔。清單順序、群組或名稱改變可能造成選錯項目,看似「舊設定失效」,實際連線的卻是另一筆紀錄。若使用自動選取策略,請確認最後選中的項目;若有本機修改,則比對訂閱更新後是否被遠端內容覆蓋。先核對使用項目,通常比立即還原所有預設值更有效。
請區分應用程式無法啟動、連線開關無法維持、伺服器交握失敗與部分規則未生效等情況。應用程式可開啟,但再次出現連線權限提示時,依系統提示完成授權,再回到第一章;若開關穩定但無法存取,請依路由與伺服器章節檢查。系統更新後若網路延伸功能暫時異常,可先重新啟動裝置,再以相同條件測試;但請在重新啟動前記錄現有提示,不要遺失唯一的錯誤資訊。
用最精簡設定判斷相容性與引用問題
在副本中移除非必要規則與策略,保留一台已核對參數的伺服器,先測試基本連線。最精簡設定有助於判斷問題是否來自複雜策略引用或特定設定項目,不代表應永久刪除所有分流規則。若基本連線可用,逐組恢復規則,每次確認儲存後重新發出要求;恢復到某一組後再次失敗,就繼續檢查該組的條件與策略名稱。
設定解析錯誤應依實際行與欄位處理。策略名稱變更、引用不存在的群組、段落位置錯誤,或貼上時混入不可見字元,都可能使檔案無法如預期載入。先確認編輯的是目前啟用的檔案,再核對是否已成功儲存。不要直接以整份舊檔覆蓋新環境,接著立刻刪除備份;保留修改前後兩份檔案,才能區分是舊內容本身有問題,還是搬移過程造成變化。
重新取得應用程式時的管道與允許設定
iPhone / iPad 請透過 App Store 更新或重新取得;系統要求以 App Store 頁面標示為準。請核對開發者 Shadow Launch Technology Limited、官方圖示與應用程式 ID 932747118。Mac、Windows、Android 與 Linux 的更新取得方式請見全平台下載頁;安裝檔僅透過本站 /dl/shadowrocket/ 路徑提供。不要用來源不明的同名程式覆蓋目前的應用程式。
桌面版與 Android 版首次執行或替換安裝後,可能再次遭到系統攔截。Windows 確認來源後選擇「更多資訊 → 仍要執行」;Mac 前往「隱私權與安全性 → 仍要打開」,若明確提示應用程式已損毀,請依下載頁說明核對路徑後再處理隔離屬性;Android 為實際開啟安裝檔的應用程式授予安裝權限;Linux 依發行版選擇安裝格式,AppImage 需要執行權限。受管理裝置的限制應交由管理員處理。
重新取得應用程式前,先確認備份是否真的可用:只有伺服器名稱截圖,通常無法還原驗證欄位;只儲存訂閱名稱,也不能取代完整網址。備份應存放在自己可控的位置,不要上傳到公開空間。若相同設定在更新前後的行為仍有穩定差異,請提供重現步驟、錯誤訊息、系統環境與已遮蔽敏感資訊的設定片段;避免附上完整存取歷史,減少與問題無關的個人資料。
08 / iPad 使用情境
iPad 橫向、換機與網路切換專項檢查
iPad 的排查順序與前文一致:依序檢查系統權限、基礎網路、伺服器、規則與 DNS。另外須留意橫向與多視窗版面、Wi-Fi 與行動網路機型差異、鍵盤輸入,以及從其他裝置移轉後的設定完整性。即使相同訂閱在 iPhone 上可用,也不要跳過 iPad 目前網路與所選伺服器的核對;兩台裝置的連線條件可能不同。
橫向與多視窗時,先確認操作對象
橫向版面可能同時顯示清單與詳細資料;點選某筆紀錄進入編輯,不一定代表已將它選為目前連線伺服器。編輯完成後返回 Home,確認選取狀態與實際連線對象,再開始測試。使用多視窗或分割畫面時,若看不到完整按鈕,請先將 Shadowrocket 調整為較寬的視窗或全螢幕,再匯入並儲存,避免將版面空間不足誤認為功能不存在。
使用外接鍵盤貼上訂閱網址時,請確認輸入欄位已取得焦點、內容完整,且未誤觸 Enter 送出。長網址在較窄的輸入欄位中可能無法完整顯示,不代表字串遭截斷;應檢查首尾與參數,不要只依畫面長度判斷。複製設定片段時,請保留英文標點與實際換行,避免文字編輯工具自動替換逗號、引號或連字號。儲存後重新開啟相應項目,確認修改確實寫入。
比對兩台裝置時,控制網路與設定條件
比對 iPhone 與 iPad 時,先讓兩台裝置連上同一個 Wi-Fi,使用同一台伺服器與相同的 Global Routing 模式,測試同一個目標。若此時只有 iPad 失敗,再比較系統 VPN 權限、目前 Config、DNS 與 On Demand。不要讓一台使用行動網路、另一台使用公共 Wi-Fi,卻把差異直接歸因於裝置型號。比對條件一致,結果才有助於定位問題。
Wi-Fi 機型沒有內建行動網路,可透過自己可用的個人熱點比對第二種網路。熱點本身也有上游網路與數據額度,請說明測試實際使用的連線路徑。支援行動網路的 iPad 則應檢查應用程式的行動數據權限、數據連線狀態與切換至 Wi-Fi 的結果。離開 Wi-Fi 後連線中斷時,先確認基礎網路已成功切換,再觀察 Shadowrocket 是否重新建立連線;不要將網路尚未就緒時的瞬間失敗視為持續故障。
鎖定螢幕後重新開啟應用程式時短暫載入,可能與舊工作階段重建、網路切換或目標應用程式恢復有關。記錄恢復後是否能自行重新發出要求,以及 Home 的連線狀態是否真的改變。若只有某個應用程式需要重新整理,先檢查該應用程式的工作階段;若系統連線反覆中斷,再回到連線開關與 On Demand 章節。公共 Wi-Fi 休眠後需要重新驗證的情況,也應納入檢查。
分別確認已購項目與設定移轉
iPhone / iPad 版於 App Store 一次性付費 $2.99,Mac / Windows / Android / Linux 版免費。iPad 請使用購買時相同的 Apple ID,在已購項目中尋找 Shadowrocket;系統要求以 App Store 頁面標示為準。若仍顯示價格,先確認登入帳戶與購買紀錄,不要急著再次付款。取得應用程式與移轉連線設定是兩個步驟;完成前者不代表後者也已完成。
從其他裝置移轉後,請分別檢查訂閱網址、伺服器參數、Config、DNS 與自動連線條件。不要只因伺服器名稱相同就認定內容完全一致,也不要假設所有本機設定都會隨系統移轉完整還原。先匯入自己的訂閱並驗證一條連線,再還原分流設定,最後啟用 On Demand;依此順序操作,若發生問題便較容易確認是哪個步驟造成差異。
需要同步檔案時,只使用自己可控的儲存位置,並確認檔案內容不是舊副本。含有驗證資訊的設定不適合透過公開連結傳送;向他人求助前請先移除憑證。若問題最後只會在 iPad 的特定版面、網路切換或鎖定螢幕情境中出現,請記錄操作順序與重現條件;取得相關說明請見iPad 已購下載與橫向使用要點;基本操作仍可返回快速入門教學逐步核對。