Add a configuration
The app does nothing until a configuration is added. There is no account and no list of servers to pick from. If you do not have a configuration yet, where to get servers is the page for that.
What you are adding
A subscription address
One https:// URL that returns a list. Added
once. The app fetches it and refreshes on the schedule the
panel asks for.
A share link
A single server:
vless://, hysteria2://,
hy2://, or wireguard://.
Several links at once
Paste them together, one per line. They arrive as one group.
A WireGuard file
The whole wg-quick text, not a single line. The
add screen recognises a [Interface] block.
In the app
- On first launch, the welcome screen takes whatever is on the clipboard if you allow the paste.
- Later, open Add a server. If a link is already on the clipboard, the app offers it rather than making you paste.
-
You can type or paste into the field:
https://…,vless://…, ortunelly://e/….
Nothing you add leaves the device except to reach the server it names. The privacy policy lists those requests.
When a link does not open the app
iOS only hands a tap to tunelly when the app is installed and the
scheme is one it registered — vless,
hysteria2, hy2, wireguard,
tunelly, and a few others it recognises in order to
refuse them cleanly. Mail, Messages and some browsers keep the
URL as text. Copy it, open tunelly, and paste.
If iOS asks to allow the paste and you decline, the clipboard reads as empty. Choose Allow Paste, or type the link into the field.
When the app refuses the link
A configuration the engine cannot carry is refused at import, and the app says why. It will not keep an entry that parses and then carries no traffic.
- VLESS, Hysteria2 and WireGuard are what this build speaks.
- VMess, Trojan, Shadowsocks, TUIC, SOCKS and HTTP are recognised and stopped.
- Hysteria2 obfuscation, Hysteria2 port hopping, and WireGuard reserved bytes (the WARP shape) are refused by name.
- An empty UUID, password or key is an incomplete record, not a protocol this build has skipped.
After it is in
Pick the server and tap Connect. The tunnel runs in its own process. Close the app and the connection stays up. iOS is on the App Store if you have not installed it yet.