Stash Setup Tutorial

Stash is an iOS and macOS client for iOS / macOS. Follow these steps to import a subscription URL, update the profile, choose a node and enable proxy mode.

01

Get subscription

Nodes are the core of proxy access, so Stash needs a subscription or profile before it can route traffic.

The recommended workflow is URL import: copy the subscription URL from your provider. The screenshots use Changlian subscription provider as the example.

Stash Get subscription screenshot 1
02

Add profile

Open the profile, configuration or subscription entry in Stash. Paste the copied subscription URL into the URL field, then save, download or import the profile according to the client prompt.

If the client also supports local files, use that only when URL import is unavailable or your provider explicitly gives a YAML file.

Stash Add profile screenshot 1
Stash Add profile screenshot 2
Stash Add profile screenshot 3
03

Select profile

Select the profile you just added, then return to the main screen. The selected profile is the one Stash will use for nodes, groups and rules.

Stash Select profile screenshot 1
04

Select a node

Open the proxy or policy group view and choose an available node. Pick a node based on region, latency and the service you need to access.

Stash Select a node screenshot 1
05

Start proxy

Enable the proxy switch shown in the screenshots. Desktop clients usually use System Proxy, while mobile clients may request VPN permission the first time.

After it is enabled, traffic is forwarded through the Stash profile.

Stash Start proxy screenshot 1
06

Outbound mode notes

Stash supports different routing modes for different situations. Keep Rule Mode for everyday use unless you are troubleshooting or need a fixed behavior.

  • Rule Mode is recommended for daily use because it follows the profile rules.
  • Global Mode sends all traffic through the selected proxy and is useful for testing.
  • Direct Mode bypasses the proxy when you need local access or network debugging.
  • Script Mode is for advanced profiles that define custom routing logic.