第 2 章:快速上手与节点配置

首页 > Maoge 技术手册 > 第 2 章:快速上手与节点配置

第 2 章:快速上手与节点配置

本章将带领您在几分钟内完成 Maoge 的安装、特权初始化、节点导入以及首个策略组的运行与延迟检测。

一、 系统环境与安装部署

  • 操作系统要求:macOS 12.0 (Monterey)、macOS 13 (Ventura)、macOS 14 (Sonoma) 或 macOS 15 (Sequoia) 及更高版本。
  • 芯片架构:原生编译支持 Apple Silicon 架构芯片(M1 / M2 / M3 / M4 系列)以及 Intel x86_64 处理器。
  • 安装步骤:
    1. 从官网下载 Maoge.dmg 安装镜像。
    2. 双击打开 DMG 磁盘映像,将 Maoge.app 拖拽至 /Applications (应用程序) 目录中。
    3. 在访达或启动台中打开 Maoge。

二、 配置文件导入与管理

Maoge 原生支持标准 Surge 格式的配置文件导入。您可以通过以下几种方式快速载入配置:

方式 1:Surge 文本直接导入 (快捷键 ⇧⌘I)

按下快捷键 Shift + Command + I,在弹出的文本窗口中粘贴您完整的 Surge 配置文件文本(.conf 内容),点击「解析并保存」,Maoge 会即时完成语法校验、持久化存储并热重载分流引擎。

方式 2:配置文件磁盘目录与 iCloud 同步

Maoge 的所有配置文件均采用纯文本格式持久化在以下目录中:

~/Library/Application Support/Maoge/profiles/
iCloud 漫游提示: 若您的 Mac 已登录个人 Apple ID,Maoge 会自动将配置文件备份同步至个人 iCloud 云盘专属安全沙盒目录(CloudDocs/Maoge)。在多台 Mac 上登录相同 Apple ID 即可实现配置的无缝多端漫游。

三、 支持的代理协议节点语法

Maoge 内置了多协议运行时核心,支持主流的出站加密协议。在配置文件的 [Proxy] 段或图形化「节点」面板中,您可以添加以下类型的节点:

协议类型 配置示例 (Surge 语法) 主要特性说明
Shadowsocks (SS) HK-01 = ss, 1.2.3.4, 8388, encrypt-method=aes-256-gcm, password=SecretKey 工业级加密,支持 AEAD 加密算法(aes-128-gcm, chacha20-ietf-poly1305 等)。
VLESS (原生支持) US-01 = vless, us.example.com, 443, username=uuid, tls=true, ws=true, ws-path=/vless Maoge 突破性原生拓展支持 VLESS 协议,兼顾轻量无状态与极高吞吐速率。
VMess SG-01 = vmess, sg.example.com, 443, username=uuid, tls=true, ws=true, ws-path=/vmess 兼容标准 VMess 协议与 WebSocket + TLS 传输模式。
Trojan JP-01 = trojan, jp.example.com, 443, password=TrojanPassword, sni=jp.example.com 仿冒标准 HTTPS 流量,具备高隐蔽性与稳定性。
Snell TW-01 = snell, tw.example.com, 1324, psk=MySnellPSK, version=4 极低资源开销的代理协议,完整支持版本握手。
SOCKS5 / HTTP Local-01 = socks5, 127.0.0.1, 1080
Http-01 = http, proxy.corp.internal, 8080, username=user, password=pass
标准局域网或企业内部代理中继接入。

四、 节点健康检查与延迟测试

在 Maoge 侧边栏的「节点」页面(快捷键 Shift + Command + N),您可以实时对单个或所有出站节点发起并发测速:

  • 真实握手延迟(TCP Handshake + TLS + HTTP Round Trip):测试并非简单的 ICMP Ping,而是通过建立真实代理隧道向目标测试 URL(默认 http://cp.cloudflare.com/generate_204)发起轻量探测,返回真实可用延迟。
  • 异常节点标记:超时或握手失败的节点会自动标记为红色警告状态,并在故障转移(fallback)策略组中被自动剔除,保障网络的持续连通。