Maoge 用户手册与技术文档

官方技术指南

Maoge for Mac 用户手册与技术文档

深度兼容 Surge 规范的高性能 macOS 原生网络分流引擎与抓包调试工具箱。本文档提供完整的配置语法说明、流量接管机制原理解析与进阶实战指引。

架构原则提示
Maoge 采用 Swift/AppKit 原生界面，核心基于受保护的 Node/C++ 协议核心守护进程与独立特权助手运行。所有语法规范与出站逻辑严格遵循标准 Surge 配置协议，您可以直接将现有的 Surge 配置文件或模块无缝导入 Maoge。

章节目录导航

CHAPTER 01
认识 Maoge 与核心接管原理
探索网络数据包在 macOS 中的完整生命周期：系统代理、增强模式 (utun) 与局域网网关模式的工作原理与技术选型。
阅读此章节 →
CHAPTER 02
快速上手与节点配置
应用安装、特权助手安全授权、导入 Surge 配置文件，以及 Shadowsocks、VMess、VLESS、Trojan 等协议节点的快速添加与连通性测试。
阅读此章节 →
CHAPTER 03
配置文件规范与通用指令
深入解析 .conf 配置文件的分段结构：[General]、[Proxy]、[Proxy Group]、[Rule]、[Host]、[URL Rewrite] 与 [MITM] 的详细语法字段。
阅读此章节 →
CHAPTER 04
策略组机制与出站路由
掌握 select（手动选择）、url-test（自动延迟测试）、fallback（故障可用转移）、load-balance（负载均衡）及 ssid 智能切换策略。
阅读此章节 →
CHAPTER 05
智能规则系统与匹配算法
掌握自上而下的规则链：DOMAIN、IP-CIDR、PROCESS-NAME 进程追踪与 FINAL 兜底规则，以及 no-resolve 防 DNS 泄漏机制。
阅读此章节 →
CHAPTER 06
增强模式、Utun 网卡与 Fake-IP
接管终端命令行、Docker 容器与全局 UDP 流量。解析 Fake-IP 虚拟地址池与物理出口绑定（Egress Binding）防回环原理。
阅读此章节 →
CHAPTER 07
局域网网关接管与内置 DHCP 服务
将你的 Mac 化身为局域网旁路由网关，为 Switch、PS5、Apple TV 及手机提供免客户端智能加速，支持 IPv6 RA/NDP 与多设备独立策略。
阅读此章节 →
CHAPTER 08
HTTPS 解密与 MITM 抓包调试
本地生成自签名 CA 根证书、macOS 系统钥匙串信任配置、解密主机名白名单（hostname）以及 API 请求体重写与抓包解密。
阅读此章节 →
CHAPTER 09
原生仪表盘、抓包分析与故障排查
使用 macOS 原生仪表盘监控实时连接、每秒吞吐量、命中规则详情；提供异常断网、DNS 缓存污染与特权服务未就绪的快速恢复排查方案。
阅读此章节 →
当前文档版本：v0.5.x (兼容 macOS 12.0+) 快速下载：获取 Maoge for Mac 最新版 →

最新文章

热门标签