---
url: https://eoht.net/serve/antiwall/egern.md
description: >-
  Egern iPhone/iPad 使用教程，区分 YAML 配置模板与节点订阅，演示模板下载、外部策略组添加订阅、VPN
  启动和日志验证，并排查策略组为空与规则未生效的问题。
---

# Egern 使用教程：客户端下载、配置模板与订阅导入 {#egern-tutorial}

**Egern** 是一款功能丰富且强大的网络工具，专为代理、拦截和修改网络流量而设计。

本文采用“导入 YAML 模板 → 填写外部订阅 → 选择策略 → 开启 VPN → 查看请求”的流程。模板提供 DNS、规则和策略组结构，节点订阅提供可用代理，两者不是同一种内容。

| 核对项 | 说明 |
| --- | --- |
| 平台 | 本文以 iPhone/iPad 为例；兼容系统与收费项目以 App Store 为准 |
| 版本范围 | 截图为既有界面示例；本次未逐版本安装实测，菜单以当前发行版为准 |
| 导入格式 | Egern YAML 配置；节点订阅填入模板的外部策略组 |
| 权限 | 连接需要系统 VPN 权限；基础代理不需要额外安装 HTTPS 解密证书 |

功能说明见 [Egern 官网](https://egernapp.com/)。本文只配置基础代理，重写与脚本功能按需另行了解。

## Egern 客户端下载 {#egern-download}

<Links
:grid="2"
:items="[
 {
   image: 'https://i.eoht.net/logo/egern.svg',
   name: 'Egern',
   desc: 'Egern 是一款功能丰富且强大的网络工具，专门用于代理、拦截和修改网络流量。',
   link: 'https://apps.apple.com/us/app/egern/id1616105820'
 }
]"
/>

## Egern 添加订阅教程 {#egern-subscription-setup}

### 获取订阅地址 {#egern-get-subscription-url}

<Links
:grid="2"
:items="[
 {
   icon: 'twemoji:airplane',
   name: 'VPN机场套餐与价格比较',
   desc: '按价格、流量和套餐类型初筛，再进入详情核对线路、解锁与优惠。',
   link: '/serve/airport/summary#vpn-airport-plan-comparison',
   linkText: '比较机场套餐'
 }
]"
/>

登录机场官网后台，复制 **订阅链接**。\
⚠️ 建议**关闭浏览器自动翻译功能**，避免订阅链接被错误处理。

### 导入配置模板 {#egern-import-config-template}

先备份当前配置，再检查 [示例模板](https://github.com/egerndaddy/quick-start/blob/main/example.yaml)中的策略组、远程规则地址和默认出口。模板会引用第三方规则；它不是订阅账号，也不是保证适合所有人的默认分流。

![Egern 导入配置模板 =688x](https://i.eoht.net/docs/20260102193938014.webp)

### 下载配置 {#egern-download-config}

1. 打开 Egern 应用，在应用界面底部的 Tab 栏中选择“工具”。
2. 在工具页面的右上角，您会看到 `...` 图标，点击该图标。
3. 在弹出的菜单中选择“下载配置”。
4. 在“下载配置”页面的 URL 输入框中，输入地址：`https://raw.githubusercontent.com/egerndaddy/quick-start/main/example.yaml`
5. 完成输入后，点击“下载”按钮。Egern 将从您提供的 URL 地址下载配置文件。

### 添加订阅 {#egern-add-subscription}

* 返回到 Egern 工具页面。
* 进入“策略组”页面。
* 在策略组页面中，找到并打开 **所有订阅**。该名称来自本文模板，不是所有 Egern 配置固定都有的菜单。
* 在此页面，您将看到一个 URL 输入栏。请在此输入您的订阅地址。
* 输入完成后，点击保存，以确保您的订阅被正确添加。

## 启动与验证 {#egern-connect-and-verify}

1. 保存订阅后更新外部策略，确认出现真实节点；若仍保留“你的订阅地址”占位文本，配置尚未完成。
2. 检查“所有代理”及地区策略组是否有可选节点。本文模板按节点名称筛选美国、日本、新加坡；订阅命名不匹配时地区组可能为空，应调整筛选或直接选择包含节点的策略。
3. 确认模板为当前生效配置，返回连接页开启代理，允许系统 VPN 配置。
4. 访问目标网站，在请求记录中查看规则和策略；管理界面显示已连接不代表目标请求必然成功。

## 模板和订阅排查 {#egern-troubleshooting}

* **模板下载失败**：先确认 GitHub 原始文件可达；从文件导入时核对内容确为 Egern YAML，而非网页 HTML。
* **外部策略为空**：检查订阅格式、授权和有效期，再检查策略组筛选条件；不要仅重复下载模板覆盖本地设置。
* **节点正常但特定服务失败**：查看该请求命中的策略组和远程规则是否更新；模板内的业务分组不保证对应服务一定可访问。
* **修改后异常**：恢复修改前的配置，逐项重新应用；停用时关闭 VPN 连接并验证普通网络恢复。