Skip to content

Aioneas/Surge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Surge by Aioneas

Surge

Personal Surge configuration, modules, and self-hosted assets for iPhone.

Remote Config · Modules · Principles · Structure

Tip

面向长期使用整理的一套个人 Surge 配置:减少外部依赖、保持目录清晰,把常用能力拆成可维护、可复用、可按需组合的模块。

Quick Start

Remote Config

https://raw.githubusercontent.com/Aioneas/Surge/main/Conf/surge.conf

Replace your subscription

打开 Conf/surge.conf,找到:

policy-path=请替换为你自己的Surge订阅地址

把占位符替换为你自己的 Surge 订阅链接,保存并重新导入即可。

Important

本仓库为公开仓库,主配置默认只保留安全占位符,不会写入私人订阅地址、证书口令或其他敏感信息。

Highlights

  • 独立策略组覆盖 Apple / Google / OpenAI / Claude / GitHub / YouTube / Netflix / Disney / Telegram / Spotify / Steam / PayPal / Speedtest 等常用场景
  • 已内置 Claude 独立分流,并使用自托管图标 Icon/claude.png
  • Rewrite 与 MITM 范围保持克制,优先降低副作用与误伤概率
  • 配置、模块、脚本、图标分目录维护,适合作为长期迭代的个人主配置基底
  • 关键资源尽量自托管,减少外链失效带来的不可控问题

Repository at a glance

路径 说明
Conf/ 主配置
Module/ Surge 模块
List/ 外部广告模块使用的远程 DOMAIN-SET 列表
Script/ 自托管脚本
tools/ 规则生成与维护脚本
Icon/ 图标资源
loon/ Loon 适配版
quantumultx/ Quantumult X 适配版

Modules

Core modules

模块 功能 安装链接 备注
adblock.sgmodule 常规广告过滤 Install 基础模块
youtube.aioneas.hide-shorts.sgmodule YouTube 去广告 + PIP / 后台播放 + 隐藏 Shorts Install 当前仅保留 hide-Shorts 版
kanlixiang.sgmodule 看理想 VIP 解锁 + 资料页清理 Install 脚本自托管
sanlianzhongdu.sgmodule 三联中读匿名登录自动 7 天会员 + 去推广 Install 脚本自托管

External ad filter modules

Important

以下 4 个模块把 EasyList / EasyPrivacy / uBlock filters / AdGuard Mobile Ads 中可稳定映射到 Surge 网络层的域名级规则拆成独立模块,适合按需安装、单独更新。

  • 适合“拆开装,避免单模块过大”的使用方式
  • 不包含 元素隐藏、脚本替换、参数移除等浏览器扩展专属能力
  • easylist.sgmodule 体量最大,首次下载与更新会更慢一些
模块 来源 安装链接 当前规模
easylist.sgmodule EasyList Install 55,138 条拦截域名 / 0 条放行域名
adguard.mobile-ads.sgmodule AdGuard/uBO – Mobile Ads Install 923 条拦截域名 / 2 条放行域名
ublock.filters.sgmodule uBlock filters – Ads, trackers, and more Install 416 条拦截域名 / 4 条放行域名
easyprivacy.sgmodule EasyPrivacy Install 6,380 条拦截域名 / 4 条放行域名
展开查看外部广告模块实现说明
  • 模块本体放在 Module/,实际域名列表放在 List/
  • 采用 DOMAIN-SET + 远程列表的方式,便于后续持续更新上游规则
  • 规则生成脚本为 tools/build_surge_adlists.py
  • 当前仅提取 ||domain^ 这类纯域名网络规则及其 allowlist / exception,刻意跳过:
    • 元素隐藏(## / #@#
    • 参数移除 / replace / redirect / scriptlet
    • 复杂 URL 正则与依赖扩展语法的规则
  • 目标不是“100% 复刻浏览器扩展效果”,而是优先保证 Surge 下可用、可维护、可更新

News redirect modules

Warning

注意:镜像站(best.viatl.de / best.998888.best 系列)为私域付费站,内容非免费;一般情况不建议使用。如确有需求请自行安装,镜像站页面底部有 TG 联系方式。作者仅做 Surge / Loon / QX 适配,非镜像站运营方。

模块 支持范围 Surge Loon Quantumult X 说明
news.redirect.aioneas.sgmodule 财新主站 / FT 中文 / FT 英文 / WSJ / Bloomberg / Economist / NYT / 端传媒 Install Install Install 跳转目标:best.viatl.de
news.redirect.caixin.sgmodule 财新 DeepView / Entities / 三联生活周刊 / 混沌 / 三联中读 Install Install Install 跳转目标:best.998888.best 系列
展开查看新闻模块补充说明
  • news.redirect.aioneas.sgmodule 已兼容 www.ftchinese.com / ftchinese.com / m.ftchinese.com 下的 story/<id>interactive/<id> 页面
  • news.redirect.caixin.sgmodule 覆盖财新周边产品线与三联生活周刊 / 混沌 / 三联中读等站点
  • 三联生活周刊属于 SPA 页面,站内跳转后通常需要手动刷新一次才能触发跳转
  • 两个模块覆盖站点互补,可同时安装,也可单独使用
  • Loon 版位于 loon/,Quantumult X 版位于 quantumultx/

Principles

  • Stability first:优先保证日常可用性,而不是盲目堆积规则与功能;Rewrite、MITM 与策略组尽量维持在够用、可控、低副作用的范围内。
  • Self-host where it matters:脚本与图标尽可能放回仓库自托管,避免外部图标库、脚本源、第三方站点失效后牵连主配置。
  • Modular by default:主配置负责提供稳定骨架,功能通过独立模块按需叠加;这样更清晰,也更方便长期维护与问题定位。
  • Public repo hygiene:公开版仓库始终坚持脱敏原则:私人订阅、凭据、证书等信息不进入公开仓库,避免误传与泄漏风险。

Structure

Surge/
├── assets/        # README 视觉资源
│   └── hero-surge.svg
├── Conf/          # 主配置
│   └── surge.conf
├── Module/        # Surge 模块
├── List/          # 模块引用的远程 DOMAIN-SET 列表
├── loon/          # Loon 适配版
├── quantumultx/   # Quantumult X 适配版
├── Script/        # 模块自托管脚本
├── Icon/          # 策略组与模块图标
├── tools/         # 规则生成与维护脚本
└── README.md

Usage Notes

Maintainer

Aioneas

About

Personal Surge / Sugar config with self-hosted modules, clean routing, and stability-first maintenance.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors