What is egern?

This repository contains a ready-made configuration file for Egern, a proxy app available on iOS and macOS. The configuration handles smart network routing: it decides which internet traffic goes through a proxy server and which connects directly, based on the type of content, the destination service, and the user's own subscription of proxy nodes. The setup file defines eight regional node groups (Hong Kong, Taiwan, Japan, Singapore, the United States, the United Kingdom, Korea, and Other) that are automatically populated from a subscription URL the user provides. Services like Netflix, Disney+, YouTube, TikTok, Bilibili, Telegram, Twitter, Apple, and Microsoft each get their own routing rule that picks from the most suitable region. AI tools including ChatGPT, Claude, Gemini, and Bing are grouped together and routed through US, Japan, or Singapore nodes by default. Ad blocking is layered: one layer uses AdGuard DNS to filter requests at the DNS level, and another rejects traffic matching a ruleset. DNS resolution uses a forwarding system that sends Chinese-domain queries to Alibaba, Tencent, and ByteDance servers, while international domains go through Cloudflare and Google DNS. Traffic rules are applied in a defined priority order with 15 layers: unblocking rules for sites that break behind proxies come first, then ad and tracker rejection, then Chinese apps, Apple services, AI tools, streaming, regional sources, social networks, and finally generic China and global rules, with local network traffic always going direct. Installing the configuration requires downloading a single YAML file and importing it into the Egern app. Only one field needs editing: replacing the placeholder subscription URL with a real one. The repository does not include any proxy servers, users supply their own subscription.