Stash User Guide

Stash Subscription Setup and Proxy Modes on iOS

Stash uses an independent engine compatible with the Clash configuration format. This guide follows the iOS and iPadOS interface to download a profile, choose a policy group and node, start the proxy, and check the outbound mode.

Guide details
Platforms
iOS / iPadOS
Core
Stash independent engine
Last updated

Step 01Get a subscription

Copy a configuration URL supported by Stash from your provider, then return to the app to download the profile. This guide uses 畅连 as an example.

Copy the subscription URL

Step 02Add a profile

Tap Settings at the bottom of the app, then open Profiles.

Settings page in Stash

On the profile list, tap Download from URL.

Profile list in Stash

Paste the subscription URL into the dialog and tap Download.

Download a Stash profile from a URL

Step 03Select the profile

After the import succeeds, select the new profile from the list and return to the home screen.

Select a profile in Stash

Step 04Select a node

Open Policy Groups from the bottom menu, then choose a node from the relevant group.

Switch nodes in Stash

Step 05Start the proxy

Return to Home, confirm that the new profile is active in the upper-left corner, and tap Start. Traffic is now routed according to the active Stash configuration.

Start the proxy in Stash

Step 06Understand outbound modes

Stash supports three outbound modes:

  • Rule: routes requests according to the profile rules.
  • Global: sends every request through the proxy server.
  • Direct: connects every request directly without a proxy.

Global mode can proxy traffic that would otherwise connect directly, slowing local services and using plan data. Rule mode preserves direct access where appropriate, so it is usually the best default.

Verify the Connection Before Troubleshooting

Take a minute to confirm the connection after completing the guide. If it still fails, open the FAQ that matches the symptom.

  • Confirm the profile is active
  • Test the selected node
  • Check the matched rule
Troubleshoot Connection and Setup