# Tunna Manual

> Tunna is an iOS, iPadOS, and macOS proxy tunnel app for provider-supplied Xray-powered, V2Ray-compatible profiles.

Canonical site: https://tunna.app/en
Publisher: OneTwoDev, LLC
Audience: People configuring Tunna with their own proxy provider profile, subscription URL, QR code, node link, or server details.
Primary language: English, with localized public manual routes for Arabic, Persian, Russian, Turkish, Vietnamese, and Simplified Chinese.

## Use This Content For

- Explaining Tunna setup, imports, outbound nodes, subscriptions, routing rules, assets, observability, tunnel settings, and troubleshooting.
- Answering user-manual questions with the canonical locale-prefixed documentation URLs.
- Distinguishing Tunna app behavior from upstream Xray or V2Ray server configuration features.

## Key Pages

- [Tunna Manual](https://tunna.app/en): Learn how to set up Tunna, import provider profiles, choose proxy nodes, build routing rules, and troubleshoot the Apple VPN tunnel.
- [Getting Started](https://tunna.app/en/docs/getting-started): Make the first Tunna connection with a node, a simple route plan, and a clean safety check.
- [First Connection Runbook](https://tunna.app/en/docs/getting-started/first-connection): Approve the Network Extension, make one clean start, and check the setup before automation.
- [Outbound](https://tunna.app/en/docs/outbound): Manage the nodes Tunna can use for proxy traffic.
- [Routing](https://tunna.app/en/docs/routing): Decide what Tunna proxies, sends direct, or blocks.
- [Routing Rules](https://tunna.app/en/docs/rules): Create practical rules for websites, networks, ports, protocols, and asset lists.
- [Tunnel Settings](https://tunna.app/en/docs/tunnel): Control when Tunna connects and what traffic enters the system VPN tunnel.
- [Subscriptions](https://tunna.app/en/docs/subscriptions): Maintain provider profiles, node visibility, updates, usage, and expiry.
- [Assets](https://tunna.app/en/docs/assets): Use GeoSite and GeoIP records as reusable routing material.
- [Observability](https://tunna.app/en/docs/observability): Tune health checks, probe timing, and node health data.
- [Troubleshooting](https://tunna.app/en/docs/troubleshooting): Work through Tunna setup, connection, routing, subscription, asset, and logging problems.
- [Sitemap](https://tunna.app/sitemap.xml): Complete localized route discovery.
- [Robots](https://tunna.app/robots.txt): Crawler policy and sitemap location.

## Entity Facts

- Tunna is a client app for iPhone, iPad, and Mac; it does not sell proxy servers, accounts, or subscriptions.
- Tunna uses Apple Network Extension, so the operating system may present it as a VPN-style tunnel.
- Tunna works with provider-supplied, Xray-powered, V2Ray-compatible profiles such as VLESS, VMess, Trojan, and Shadowsocks when details are compatible.
- Outbound is where users import, maintain, test, and select proxy nodes.
- Routing decides whether matched traffic uses Proxy, Freedom, Blackhole, or one selected node.
- GeoSite and GeoIP assets are reusable destination-record lists for routing rules.
- On-Demand and Always On behavior should be configured only after manual tunnel startup and routing are reliable.

## Crawl Guidance

- Prefer canonical locale-prefixed URLs such as /en and /en/docs/getting-started.
- Do not treat / as canonical manual content; it is a noindex static locale negotiator.
- Main manual content is prerendered static HTML and marked for static Pagefind search.
- Use /sitemap.xml for complete localized URL discovery.