Egern 使用教程：iOS 新晋代理客户端，$5.99 买断制

软件介绍

Egern

iOS 网络工具，官方定位为代理、拦截和修改网络流量，免费下载 + Egern Pro $5.99 买断

Egern 是 BYTE CROSSING LTD 出品的 iOS 网络工具。App Store 官方描述原文是 “feature-rich and powerful networking tool, designed for proxying, intercepting, and modifying network traffic”——功能丰富且强大的网络工具，专为代理、拦截和修改网络流量而设计。官方文档对自己的定位一致：详细记录 TCP、UDP、DNS 和 HTTP 流量，支持丰富的规则类型、灵活的策略组和多种代理协议，还能用 JavaScript 脚本定制请求和响应数据。

在 iOS 代理客户端里，Egern 属于新晋选手：Shadowrocket、Loon、Quantumult X（圈X）和 Surge 5 都是老牌，站内对应教程分别是 Shadowrocket 使用教程、Loon 使用教程、Quantumult X 使用教程 和 Surge 5 使用教程，Egern 是这套矩阵里最后补齐的一块。

商业模式上 Egern 和其他几款不太一样：App 本体免费下载，完整能力通过 Egern Pro 解锁，价格是 $5.99 一次性买断，官网 payment 页核验，不是订阅制。对比一下：都是美区价格：Surge 5 免费下载 + 内购、Shadowrocket $2.99 买断、Loon $7.99 买断、Quantumult X $9.99 买断，Egern 的 Pro 解锁价比 Loon 和 QX 都便宜，和 Shadowrocket 一个量级。

Egern 有中文界面，这是用户截图确认的（代理链一节有配图）；官网还提供完整的中文文档：官方中文文档，这在几款 iOS 客户端里很少见——Surge 的官方资料以英文为主，Egern 从文档到界面都面向中文用户。订阅管理工具 Sub-Store 的官方支持列表也包含 Egern（QX、Loon、Surge、Stash、Egern 和 Shadowrocket 六款），说明 Egern 已被 Sub-Store 的支持列表收录。

官方功能清单

官方介绍页列出的核心能力：

配置示例文档里还给出了 TUIC 和 WireGuard 的代理写法，协议覆盖面比介绍页列得更广。

优点与缺点

整体判断：Egern 是把 Surge 那套"代理 + 重写 + 脚本"的能力做进了买断制 + 中文界面的壳子里，对不想啃英文文档、又想要高级玩法的 iOS 用户来说，$5.99 的试错成本很低。

下载安装

在 App Store 搜索 Egern，认准开发者 BYTE CROSSING LTD，下载免费。App Store 页面显示为免费下载 + 内购 Egern Pro，不是直接付费购买。

截止到本文更新时间，App Store 最新版本为 v2.20.0，2026-07-23 更新。

Egern Pro 购买与激活

官网 payment 页提供两种购买方式：Personal 版 $5.99 一次性买断，单用户、终身包含所有更新；Team 版 $4.79/席，最少 5 席，官网标注 20% off。

设备限制：官方 FAQ 说明，每个授权支持最多 3 个 iCloud 账号，设备数量不限。

首次使用不需要先买 Pro：下载后直接进入订阅导入 → 策略组 → 分流规则 → 开启代理的流程（下一节），基础代理功能可以先用起来。

三分钟上手（先能用，再谈配置）

机场用户只需要三步，全程不用碰配置文件：

1. 复制机场给的订阅链接（机场官网"订阅/一键订阅"里复制）
2. 用下面的方式导入 Egern（见「订阅导入」，最快是 URL Scheme 一键导入）
3. 打开代理开关（见「开启代理」）

能做到这三步，代理就已经跑起来了。策略组、规则、配置文件都是后面的进阶内容——先能用，再深入。

Egern 的配置体系和其他 iOS 客户端一样，核心是规则、代理与策略组三件套。官方 FAQ 把关系讲得很清楚：

1. 规则决定策略：请求发出后按规则顺序逐一匹配，每条规则指定一个策略。
2. 策略可以是单个代理，也可以是策略组。
3. 策略组包含多个代理或其他策略组，形成层级结构。
4. 匹配到的策略最终决定流量走哪个代理、DIRECT 直连还是 REJECT 拒绝。

订阅导入

机场订阅导入有两种途径：

egern:/subscriptions/new?url=<订阅地址>

单条代理也可以手动添加：工具 → 代理 → 右上角＋，填名称、类型、服务器、端口和加密方式（界面全中文）：

图注：Egern 添加代理流程（图源：教程站「翻墙男」Egern 教程截图）：工具页 → 代理 → 右上角＋ → 填名称/类型/服务器/端口/加密方式，界面全中文

开启代理

配置完成后，主界面打开代理开关即可。官方提供开关的 URL Scheme：

图注：Egern 设置页（图源：YouTube 中文教程「Egern 限免介绍」视频画面）：配置入口（Egern.yaml）、iCloud 同步、出站模式（全局代理）、IPv6、仅 VIF 模式、劫持 DNS 服务器，界面全中文

开启代理后，有几个和体验直接相关的参数（来自官方配置示例）：

• 阻止QUIC：对应全局 block_quic，阻止 QUIC 协议、强制走 TCP。优先级是代理 > 策略组 > 全局，代理自身的 block_quic 最高；三层都没设置时按协议默认值（TCP 类协议默认阻止、UDP 类默认放行）。
• 隐藏：对应 hide_vpn_icon，隐藏状态栏 VPN 图标。
• close_connections_on_policy_change：策略组选中节点变化时（手动切换、自动测速切换、故障转移、订阅更新后回退），关闭仍在使用旧节点的连接，让流量立即通过新节点重连。
• include_all_networks：默认 false，不额外包含所有网络流量；APNs、蜂窝服务、本地网络等还受 include_apns、include_cellular_services、include_local_networks 等独立开关控制。

用快捷指令定时开关代理的例子：快捷指令 → 打开 URL → egern:/start?x-success=shortcuts://，配合自动化规则就能实现到点自动开代理。

日常使用（进阶操作）

策略组

官方配置示例定义了六种策略组类型：

| conditional | 条件策略组：按 SSID 或蜂窝制式等条件选策略 |

图注：策略组类型切换为「外部的」（图源：教程站「翻墙男」Egern 教程截图）：编辑策略组 → 类型选「外部的」→ 添加新的 URL，支持远程和本地来源

策略组可以嵌套：官方 FAQ 的例子是"手动选择"策略组包含 VmessProxy 和 ShadowsocksProxy 两个代理；子策略也可以直接是另一个策略组，规则匹配后可能经过多层策略组选择才确定最终代理。

给策略组加成员的操作路径（图源：教程站「翻墙男」的 Egern 教程截图）：

图注：Egern 策略组操作（图源：教程站「翻男」Egern 教程截图）：工具 → 策略组 → 打开 Proxy → 把可用成员（DIRECT/REJECT/SS）加入启用列表 → 保存

代理链（上一跳节点）

代理链是 Egern 的特色功能，入口在编辑策略组界面里的上一跳节点 Previous Hop Node 字段。用户截图显示，这个字段默认是**「无」**，表示当前策略组不使用代理链。

它的作用：在策略组里指定上一跳代理或策略组名称，流量会先经过上一跳，再进入当前策略组选中的节点，形成：

本机 → 上一跳 → 当前节点 → 目标网站

policy_groups:
  - select:
      name: 入口
      policies:
        - EntryProxy
  - select:
      name: 出口
      policies:
        - HKA
        - HKB

图注：用户实测截图——编辑策略组中文界面：上一跳节点（当前「无」）、订阅链接、延迟测试URL、阻止QUIC、图标、隐藏

这个功能和 Surge 的 underlying-proxy 属于同类代理链能力：Surge 官方手册把它定义为 “Use a proxy to connect to another proxy, aka proxy chain”（用代理去连另一个代理，也就是代理链），界面里叫 Through Another Proxy；两者思路一致（中转、落地、把不同区域的节点串起来），但字段、兼容范围和实现细节不能直接等同。

代理链的价值：一是中转，比如用家宽节点做入口、机场节点做出口；二是组合落地，把某个策略组当作统一入口，后面接不同区域的出口组，切换出口不影响入口链路。代价是延迟叠加——每一跳都增加一次握手和转发开销，链路过长时排查问题也更麻烦，建议链路控制在两跳以内。

分流规则

官方配置示例列出了 14 种规则类型：

匹配顺序遵循官方 FAQ 的说明：从上到下逐一匹配，第一个符合条件的规则生效。每条规则的策略可以是代理名称、策略组名称、DIRECT 或 REJECT。

规则集：官方 FAQ 说明，Egern 支持导入 Surge 的规则集，路径是工具 → 规则 → + → 类型选择 rule-set，然后添加 Surge 规则集 URL。规则集同样支持 update_interval 定时更新——注意是符合 Egern 兼容范围的 Surge 规则集，具体字段兼容性装完检查一下。

深入配置（进阶篇）

配置示例详解

Egern 的所有参数都在 Profile.yaml 文件里配置，官方 configuration example 文档给出了完整示例。顶层结构如下：

policy_groups:
  # 手动选择
  - select:
      name: Select
      policies:
        - MyShadowsocks
        - MyTrojan
      icon: globe
  # 自动测试
  - auto_test:
      name: AutoTest
      policies:
        - MyShadowsocks
        - MyTrojan
      interval: 600      # 测速间隔，秒
      tolerance: 100     # 延迟容忍度
      timeout: 5
  # 故障切换
  - fallback:
      name: Fallback
      policies:
        - MyShadowsocks
        - MyTrojan
      interval: 600
      timeout: 5
  # 负载均衡
  - load_balance:
      name: LoadBalance
      policies:
        - MyShadowsocks
        - MyTrojan
  # 外部资源策略组
  - external:
      name: MyExternal
      type: select
      urls:
        - "https://example.com/proxies.yaml"
      filter: ".*"
      interval: 600
      tolerance: 100
      timeout: 5
      update_interval: 86400
  # 条件策略组：在家 Wi-Fi 直连，蜂窝走自动测试
  - conditional:
      name: NetworkSwitch
      rules:
        - ssid:
            match: "Home-*"
            policy: DIRECT
        - cellular:
            match: "LTE"
            policy: AutoTest
      default_policy: Select

rules:
  - domain_keyword:
      match: ads
      policy: REJECT          # 广告域名直接拒绝
  - domain_suffix:
      match: google.com
      policy: Select          # Google 走手动选择组
  - geoip:
      match: CN
      policy: DIRECT          # 国内 IP 直连
      no_resolve: true
  - ip_cidr:
      match: 192.168.0.0/16
      policy: DIRECT          # 内网直连
  - default:
      policy: Select          # 其余全部走策略组

订阅内容的自动更新在配置里用 auto_update 控制：

auto_update:
  url: http://example.com/        # 订阅配置地址
  interval: 86400                 # 更新间隔，单位秒

dns:
  bootstrap:
    - system                # 用系统 DNS 作引导
  upstreams:
    google:
      - https://8.8.8.8/dns-query
      - https://8.8.4.4/dns-query
  forward:
    - domain_suffix:
        match: "cn"
        value: bootstrap     # .cn 域名走引导 DNS
    - wildcard:
        match: '*'
        value: google        # 其余走 Google DoH
  hosts:
    example.com: www.example.com
    localhost: 127.0.0.1
  block_ips:
    - 1.2.3.4

dns 段支持 DoH、DoT、DoQ 上游，forward 规则可以按域名后缀、通配符、正则、规则集分别指定 DNS 策略，hosts 做域名映射，block_ips 直接屏蔽 IP。

代理协议：proxies 段支持 Shadowsocks、Trojan、Vless、Vmess、Hysteria2、TUIC、SOCKS5、HTTP、WireGuard，官方示例覆盖各协议的基础配置字段（加密方式、TFO、UDP 转发、传输层等），实际参数按对应协议文档和服务端配置来。Shadowsocks 的 server 为域名时，用 ip_version 控制解析策略（dual_stack / v4_only / v6_only / v4_prefer / v6_prefer）。

脚本（JavaScript 扩展）

官方 javascript-api 文档规定，脚本用 export default 导出一个 async 函数，运行时注入 ctx 对象：

export default async function(ctx) {
  // ...
}

支持五种脚本类型：

ctx 提供的能力包括：ctx.http（发起 HTTP 请求）、ctx.storage（持久化键值存储）、ctx.notify（发送通知）、ctx.lookupIP（查询 IP 归属地/ASN）、ctx.compress（gzip/deflate/brotli 压缩）、ctx.ssh（SSH 远程执行和 SFTP 文件操作）、ctx.respond（请求脚本直接返回响应）、ctx.abort（中止请求/响应）。

export default async function(ctx) {
  return { url: ctx.request.url.replace('http://', 'https://') };
}

export default async function(ctx) {
  const data = await ctx.response.json();
  data.ads = [];
  return { body: data };
}

export default async function(ctx) {
  const resp = await ctx.http.get('https://api.example.com/data');
  const data = await resp.json();
  ctx.storage.set('latest', JSON.stringify(data));
  ctx.notify({ title: 'Updated', body: `${data.length} items` });
}

scriptings:
  - request:
      name: MyScript
      env:
        API_KEY: "your_key"

URL Scheme

官方 url-scheme 文档列出的入口：

所有 Scheme 都支持 x-success 参数，操作完成后回调指定应用。自动化玩法：快捷指令里把这些 URL 串起来，实现一键导入订阅、到点开关代理、按 SSID 切换配置。

重写与拦截

App Store 描述里的 “intercepting and modifying network traffic”（拦截和修改网络流量）对应官方配置示例里的四类能力：

URL 重写：把匹配的 URL 重定向到新地址，支持正则捕获组：

url_rewrites:
  - match: "(.*google)\\.cn"
    location: $1.com
    status_code: 307

头部重写：header_rewrites 支持 add / replace / delete 三种动作，分别作用于 request / response：

header_rewrites:
  - add:
      match: "^https://example\\.com"
      name: X-Custom-Header
      value: custom-value
      type: request
  - replace:
      match: "^https://example\\.com"
      name: Cache-Control
      value: no-cache
      type: response

内容重写：body_rewrites 支持响应体正则替换 response_regex 和请求体 jq 过滤器 request_jq：

body_rewrites:
  - response_regex:
      match: "^https://example\\.com"
      find: old_content
      replace: new_content

抓包与本地模拟：http_captures 列出要抓取的域名；map_locals 把匹配的 URL 请求映射到本地自定义响应，可以用来 Mock API：

map_locals:
  - match: "^https://api\\.example\\.com/mock$"
    status_code: 200
    headers:
      Content-Type: application/json
    body: '{"code": 0, "message": "ok"}'

MitM：mitm 段配置中间人解密，用于修改 HTTPS 流量（URL 重写、头部/内容重写、脚本都依赖它）：

mitm:
  ca_p12: ""                # CA 证书
  ca_passphrase: "123456"
  hostnames:
    includes:
      - "*.example.com"
    excludes:
      - "*.internal.example.com"

hostnames.includes 控制解密哪些域名，excludes 排除敏感域名。

其他功能

• 本地代理服务器：http_port（默认 3080）和 socks_port（默认 3090）提供本地 HTTP/SOCKS5 代理，allow_external_connections 开启后局域网设备也能连。
• 小组件：widgets 段把 Generic 脚本渲染成主屏幕/锁屏小组件，官方示例返回 Widget DSL JSON，可以显示节点状态、服务器信息。
• 模块：官方 FAQ 说明支持 Surge 模块，在工具 → 模块里添加模块 URL，modules 段可设更新间隔和开关。
• iCloud 同步：官方介绍页说明通过 iCloud 跨设备同步配置。
• 流量记录：详细记录 TCP、UDP、DNS 和 HTTP 流量，配合 http_captures 可以做抓包排查。分析页把连接数、实时速率、策略流量占比、规则命中都可视化了：

图注：Egern 分析页（图源：YouTube 中文教程「Egern 限免介绍」视频画面）：全部/活跃连接数、实时上下行速率、各策略流量占比（Final/GitHub/国内直连/TikTok/Apple 等）、规则命中统计（AdBlock/Speedtest/Default），界面全中文

常见问题

免费下载的 Egern 和 Egern Pro 有什么区别？ App 本体免费下载，Egern Pro 是 $5.99 一次性买断的完整功能解锁，买断后终身包含更新。免费版和 Pro 的具体功能边界，本文素材无法可靠划分全部配置项——看 App 内当前的 Pro 页面和 App Store 内购页说明；先跑通基础代理流程再决定是否解锁。

$5.99 值得吗？ 对比看：Shadowrocket $2.99、Loon $7.99、Quantumult X $9.99、Surge 5 免费下载 + 内购（都是美区价格）。Egern 的 Pro 解锁价比 Loon 和 QX 便宜，功能上规则、策略组、重写、脚本齐全，还带中文界面和中文文档，对中文用户性价比不错。只做基础代理的话，Shadowrocket 更便宜。

界面是中文吗？ 是。用户截图显示编辑策略组界面全中文——上一跳节点、订阅链接、延迟测试URL、阻止QUIC 等字段都是中文，官网也有完整中文文档。

代理链怎么配？ 进入编辑策略组，把上一跳节点从默认的「无」改成你要的代理名称或策略组名称即可，流量会先经过上一跳再进入当前节点。完整配置示例见上文代理链一节。

上一跳节点和 Surge 的 underlying-proxy 是一回事吗？ 是同类功能。Surge 官方手册把 underlying-proxy 定义为 “Use a proxy to connect to another proxy, aka proxy chain”，界面叫 Through Another Proxy；Egern 的上一跳节点就是中文版实现。

支持哪些代理协议？ 官方配置示例支持 Shadowsocks、Trojan、Vless、Vmess、Hysteria2、TUIC、SOCKS5、HTTP、WireGuard；官方介绍页列出的协议是 HTTP、SOCKS5、Shadowsocks、Trojan、Hysteria2、Vless、Vmess。

支持 Surge 的规则集和模块吗？ 支持。官方 FAQ 说明可以添加 Surge 规则集（工具 → 规则 → + → 类型 rule-set）和 Surge 模块（工具 → 模块），社区现成资源可以直接用。

官网买的 Pro 怎么激活？ 购买后收授权邮件（含授权码和激活链接）。点激活链接一键激活（永久有效），或在 App 里左上角 → 升级到专业版 → 恢复购买 → 通过邮箱恢复，输入邮箱和授权码。支持支付宝和微信付款。

一个 Pro 授权能用几台设备？ 官方 FAQ 说明：每个授权支持最多 3 个 iCloud 账号，设备数量不限。

订阅怎么导入和更新？ 两种方式：URL Scheme egern:/subscriptions/new?url=<地址> 一键导入；或编辑策略组里的订阅链接字段直接填机场地址。更新可以用配置里的 auto_update 或外部策略组的 update_interval 定时拉取。

能用快捷指令自动化吗？ 可以。所有 URL Scheme 支持 x-success 回调，比如 egern:/start?x-success=shortcuts:// 配合快捷指令自动化，实现到点自动开代理、一键导入订阅。

MitM 是什么？开了有风险吗？ MitM 是中间人解密，用来修改 HTTPS 流量（重写、脚本都依赖它）。风险在于所有解密流量都经过 Egern 的 CA 证书，所以要用 hostnames 收窄解密范围，只对必要域名开启，证书只导入可信来源。

配置能跨设备同步吗？ 能。官方介绍页说明支持通过 iCloud 跨设备同步配置，iPhone、iPad 之间保持一致。

脚本安全吗？ 脚本能读写你的请求响应、发起 HTTP 请求、执行 SSH 命令，能力很强。只用可信来源的脚本，密钥用 ctx.env 传递，不要运行来路不明的脚本。

对比与取舍

Egern 的定位是新秀补齐位：协议、规则、策略组、重写、脚本的覆盖面已经对齐 Loon/QX，价格卡在 $5.99 买断，比 Loon 便宜 $2、比 QX 便宜 $4，还带中文界面和中文文档。短板也明显：社区生态和第三方教程还在早期，遇到问题主要靠官方文档和 App 内摸索。

选型建议：只翻墙、图省事选 Shadowrocket；插件生态和精致界面选 Loon；愿意啃配置、要最高自由度选 Quantumult X；开发调试向、玩代理链选 Surge 5（但它是内购）；想要高级功能 + 中文界面 + 买断价格，Egern 是这套矩阵里同时满足这三点的选项。

相关教程：Shadowrocket 使用教程、Loon 使用教程、Quantumult X 使用教程、Surge 5 使用教程。