---
title: "快速入门"
description: "在 iPhone 或 iPad 上安装 Potatso，通过链接、订阅、文件或二维码添加第一台服务器，允许 VPN 并连接。"
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速入门

Potatso 可在 iOS 17 或更高版本的 iPhone 和 iPad 上运行。要使用它，你至少需要一台代理服务器：服务商提供的分享链接、订阅 URL 或配置文件，或者你自己搭建的服务器的设置。

第一次打开 Potatso 时，它会分四步带你完成设置：为配置命名、添加服务器、选取路由、允许 VPN。本页依次介绍这些步骤，然后说明如何连接。

## 安装 Potatso {#install}

下载[App Store 上的 Potatso](https://apps.apple.com/app/id1239860606)并打开它。轻点**开始使用**。

## 为配置命名 {#name}

配置包含你的服务器、代理组、规则和 DNS 设置。输入一个名称，或轻点其中一个建议名称，然后轻点**继续**。之后你可以修改名称。

## 添加服务器 {#add-servers}

**添加你的服务器**这一步提供四种方式：

| 选项 | 作用 |
| --- | --- |
| **粘贴链接** | 轻点**粘贴**，立即导入剪贴板上的链接。它可以是 `vless://…` 这样的分享链接、订阅 URL 或配置 URL。 |
| **扫描二维码** | 扫描包含分享链接或订阅 URL 的二维码。要读取图片中的二维码，请轻点扫描器角落的照片按钮。 |
| **导入链接或文件** | 打开导入器：粘贴链接或整份配置，或选择一个配置文件。见[从文件导入](#file)。 |
| **手动输入服务器** | 打开一个空白的服务器表单。见[手动输入服务器](#manual)。 |

Potatso 会自动识别格式。它能读取分享链接、订阅、Shadowsocks JSON 和 SIP008、Mihomo / Clash YAML、V2Ray / Xray JSON、Surge 配置和规则列表。通过 URL 导入的订阅会持续更新。各种格式的详情见[导入订阅和配置](/docs/zh/guides/import-subscriptions/)。

导入内容后，这一步会变为**已添加服务器**，并显示导入了多少台服务器、多少个代理组和多少条规则。你可以用同样的方式继续添加。轻点**继续**。

如果导入失败，原因会显示在这些选项下方。

还没有服务器？轻点**我还没有服务器**，跳过服务器直接完成设置。你可以之后在[首页添加服务器](#add-more)。

### 从文件导入 {#file}

1. 轻点**导入链接或文件**。
2. 在**来源**下选择**文件**，然后轻点**选择文件…**。
3. 选取 YAML、JSON、CONF 或文本文件。文件必须是 UTF-8 文本，且不超过 5 MB。
4. 轻点**继续**，查看预览，然后轻点**添加**。

文件没有可供更新的来源，所以其内容之后不会更新。如果服务商提供了 URL，请改为导入该 URL。

### 手动输入服务器 {#manual}

1. 轻点**手动输入服务器**。
2. 输入**名称**，然后选择服务器的**协议**。
3. 填写**地址**和**端口**，再填写所选协议需要的设置，如密码或用户 ID。
4. 轻点**存储**（对勾）。

各协议页面列出了 Potatso 支持的设置：[Shadowsocks](/docs/zh/protocols/shadowsocks/)、[ShadowsocksR](/docs/zh/protocols/shadowsocksr/)、[Trojan](/docs/zh/protocols/trojan/)、[VLESS](/docs/zh/protocols/vless/)、[VMess](/docs/zh/protocols/vmess/)、[HTTP 和 HTTPS](/docs/zh/protocols/http/)、[SOCKS5](/docs/zh/protocols/socks5/)、[Hysteria 2](/docs/zh/protocols/hysteria2/)、[AnyTLS](/docs/zh/protocols/anytls/) 和 [Snell](/docs/zh/protocols/snell/)。

## 选取路由 {#route}

**选取路由**这一步决定配置如何路由流量，以及使用哪台服务器。你选择的同时，Potatso 会测试每台服务器的延迟。

1. 选择出站模式（如果这一步提供不止一种）：
   - **规则**：由配置中的规则决定流量去向。导入内容带有规则时才会提供。
   - **全局**：所有流量都经过你选择的出站。
   - **直连**：不经过任何代理。
2. 在模式下方的卡片中选择出站：轻点其中一个快捷选项，或打开完整列表。
3. 轻点底部的按钮。按钮上显示你的选择，如**使用 Tokyo 01**，或**继续**。

第四种模式**智能**不在这里提供。你可以之后在首页开启它。见[出站模式](/docs/zh/guides/outbound-modes/)。

## 允许 VPN {#allow-vpn}

Potatso 通过设备上的 VPN 配置进行连接。在 Potatso 添加它之前，iOS 会询问你一次。

1. 轻点**添加 VPN 配置**。
2. iOS 询问时，轻点**允许**。

此时还不会连接。配置添加完成后，这一步会显示**一切就绪**。如果 iOS 没有添加成功，请轻点**重试**并选择**允许**。

你可以轻点**以后再说**跳过这一步，iOS 会在你第一次连接时询问。如果你的设备上已有 Potatso 的 VPN 配置（例如来自之前的安装），Potatso 会跳过这一步。

随后 Potatso 会展示它的 Pro 方案，已有 Pro 则不会。关闭后即进入首页。

## 连接 {#connect}

1. 打开**首页**。顶部的状态卡片显示**未连接**。
2. 打开状态卡片上的开关。

状态会先变为**正在连接…**，再变为**已连接**。要断开连接，请关闭开关。

如果规则模式下没有可以发送流量的服务器，Potatso 会提示**选择要连接的服务器**并打开出站列表。选择一台服务器，然后再次连接。

连不上？请参阅[故障排除](/docs/zh/troubleshooting/)。

## 切换模式 {#mode}

首页的**出站模式**一行显示配置当前的模式。轻点它，可选择**全局**、**智能**、**规则**或**直连**。各模式的作用见[出站模式](/docs/zh/guides/outbound-modes/)。

## 添加更多服务器 {#add-more}

在**首页**，轻点右上角的 **+** 按钮。它提供：

- **添加代理**：手动输入服务器，方法同[手动输入服务器](#manual)。
- **通过链接/文件导入**：粘贴链接或配置，或选择文件，然后查看导入预览。
- **扫描二维码**：扫描分享链接或订阅 URL，然后查看导入预览。

预览会显示导入内容及其去向。见[导入订阅和配置](/docs/zh/guides/import-subscriptions/)。

Source: https://potatso.com/docs/zh/guides/getting-started/index.mdx