macOS · 基础配置流程
Clash Mac 配置教程
从导入订阅到验证连接,按四步完成首次配置。已有客户端和有效订阅时,可按约十分钟安排基础操作;订阅下载与系统授权的等待时间取决于实际环境。
开始前:确认客户端与配置来源
先在苹果菜单中打开「关于本机」。显示「芯片」和 Apple 系列名称的 Mac,应选择 Apple 芯片安装包;显示 Intel 处理器的 Mac,应选择 Intel 安装包。安装包还需符合客户端当前要求的 macOS 版本。若尚未安装,前往Mac 安装包列表选择客户端。打开磁盘映像后,按窗口提示将应用拖入「应用程序」,弹出映像,再从「应用程序」启动,避免长期从下载目录或磁盘映像中运行。
首次打开时,macOS 可能要求确认应用来源。只对来源可信且符合预期的应用继续操作;若系统提示阻止打开,可查看「系统设置 → 隐私与安全性」中的具体原因。不要为了完成教程而关闭系统整体安全保护,也不要忽略恶意软件警告。客户端若请求通知权限,可以按使用习惯决定,这不是浏览器代理生效的必要条件。
本教程假定已经持有有效的 Clash 或 mihomo 兼容订阅地址,也可以使用准备好的本地 YAML 配置。安装客户端本身不会生成节点、账号或订阅。订阅通常包含服务器与访问凭据,应当像账号信息一样保存,不要放进公开截图、聊天记录或在线转换页面。准备好后,先完成导入,暂时不要开启系统代理或 TUN,避免把配置问题与系统接管问题混在一起。
一、导入订阅并启用当前配置
打开客户端主窗口,在侧栏找到「订阅」或「配置」。点击「新增」「导入」或加号入口,选择从 URL 导入。如果界面要求填写名称,可以使用便于辨认的本地名称;在地址栏粘贴服务提供方给出的完整订阅链接,再点击确认或下载。粘贴后检查首尾是否多出空格,链接是否被聊天软件截断,带参数的部分是否完整保留。不要把网站登录页面地址或账号后台首页误当作订阅地址。
导入过程中,客户端会请求远端文件并解析内容。成功后,配置页面通常会出现一张新配置卡片或一条列表记录。点击这条配置,将其设为当前使用项;部分客户端在导入后自动启用,另一些需要再点击「使用」「激活」或对应的选择标记。看到列表里有配置,只能说明它已被保存,不能据此判断内核正在使用它。继续打开代理页面,确认能看到此配置提供的策略组和出站项。
如果使用本地文件,在同一页面选择「从文件导入」,选取扩展名为 .yaml 或 .yml 的配置文件。某些客户端会复制文件,另一些可能保留文件关联,后续编辑前应查看客户端说明。文件导入不会自然获得远端更新能力;若配置引用外部规则或节点提供器,首次加载仍可能需要联网下载。不要因为文件已在本地,就直接认定所有依赖都已可用。
若提示格式错误,先确认订阅明确支持 Clash 或 mihomo。只有一串编码文本、单个协议链接,或面向其他内核的 JSON 文件,不一定能在 YAML 配置入口直接使用。优先向配置提供方获取匹配格式,不要连续更换多个转换工具。订阅链接有时会返回登录页、过期提示或访问错误页面,这些内容即使下载成功,也不是有效配置。可在客户端日志中查看错误类型,但分享日志前要遮住链接参数、账号和服务器凭据。
若提示下载失败,先确认 Mac 在未开启代理时能正常访问普通网页,再尝试更新一次。不要反复开启尚未配置完成的系统代理来解决订阅下载,这可能使请求指向一个还不能工作的本地端口。订阅成功加载且策略组显示后,再进入下一步。自动更新周期可以稍后设置;首次配置先确保手动更新与启用流程都能正常完成。格式与内核的深入区别见协议手册。
二、选择规则模式与策略组
切换到「代理」页面,找到「出站模式」或「运行模式」,首次使用选择「规则」。规则模式会按当前配置中的规则决定每个请求的出站方式,可能使用代理,也可能直连或拒绝连接。这个选项不是自动识别所有网站用途的开关,最终结果取决于订阅提供的规则内容。若页面仍然空白,应返回上一步确认当前配置已启用,而不是直接切换到全局模式尝试。
接着查看策略组。配置可能包含手动选择、自动选择、故障回退等不同类型,组名由配置作者定义,不同订阅不会完全一致。对于需要手动选择的组,点开后选择一个实际出站项;如果组内引用的是另一个策略组,应继续检查其选择状态。保留自动选择组原有的运行方式即可,不必为了完成教程把每个组都改成手动。客户端若提供可用性测试,可以辅助排查,但一次测试成功不代表所有网站和协议都能正常访问。
注意区分「策略组名称」「组内选项」和「运行模式」。名为「自动」的组不一定正被当前规则引用;选中了某个节点,也不意味着全部流量都会使用该节点。若组内显示 DIRECT,通常表示直连;REJECT 通常表示拒绝连接,它们不是远端代理服务器。日常配置应先按订阅说明选好默认出站组,再根据实际连接记录确认请求是否走到预期位置。
「全局」通常将进入内核的连接交由全局策略处理,适合在明确目标的情况下做短时对照;它不等于接管 Mac 上全部应用。「直连」则通常让进入内核的连接直接出站,也不等于关闭了 macOS 系统代理。首次上手无需轮流尝试所有模式,保持规则模式并记住当前选择即可。想进一步了解策略组的引用关系,可以查阅术语表;此处先完成可复现的一套基础配置。
三、启动内核并开启系统代理
配置和策略选好后,检查客户端首页或状态区的内核运行状态。有的客户端打开应用后会自动启动内核,有的需要点击启动或连接。如果出现端口占用、配置加载失败等错误,应先处理错误再接管系统流量。仅仅看到菜单栏图标,并不能证明内核已经成功监听本地代理端口。此时也应暂停其他会设置代理的客户端,避免多个应用轮流覆盖 macOS 的代理设置。
进入「设置 → 通用」或「设置 → 网络」,开启「设置为系统代理」。某些客户端也会在菜单栏菜单中提供同名开关。这个操作会让遵循 macOS 系统代理的应用把请求发送到本机客户端,再由内核按规则处理。若 macOS 弹出辅助程序安装或授权提示,应核对发起请求的应用名称与用途后再确认。授权失败时,查看客户端的具体提示,不要在不清楚原因的情况下反复输入系统密码。
首次验证建议保持「增强模式(TUN)」关闭,也不要同时开启「允许局域网连接」。前者涉及虚拟网卡、路由和额外权限,后者用于让其他设备访问本机代理;两者都不是本机浏览器基础测试的前提。先用系统代理完成一条清晰的连接路径,之后若终端、游戏或其他应用不读取系统代理,再根据需要了解 TUN,而不是把所有网络开关一次性打开。
本地端口以客户端当前显示的值为准。混合端口常见示例是 7890,但不同客户端或配置可以使用其他端口,不应照着示例强行修改。系统代理通常应由客户端自动填写;如果此前手动配置过,可以在「系统设置 → 网络 → 当前网络服务 → 详细信息 → 代理」中核对是否残留旧地址。企业管理的设备若限制修改代理,请遵循管理策略,不要覆盖组织要求的设置。
开启后,客户端应继续保持运行。关闭主窗口通常只是收起界面,是否继续驻留菜单栏取决于客户端设置;选择「退出」则可能停止内核,二者需要区分。现在先不要测试终端,也不要叠加浏览器专用代理扩展,直接使用遵循系统代理的浏览器进入下一步。若需要接管不读取系统代理的应用,可在基础验证完成后阅读协议手册中的网络与内核说明,避免同时排查两种接管方式。
四、验证连接与规则是否生效
打开 Safari 或其他采用系统代理设置的浏览器,新建标签页,访问一个此前就能正常打开的网站,确认基本网络没有中断;随后访问需要验证代理路径的目标网站。不要只看客户端开关的颜色,也不要只凭一个网页能否打开下结论。浏览器可能使用缓存,网站本身也可能临时故障,验证应同时包含实际请求和客户端侧的处理记录。
保持客户端的「连接」页面打开,然后重新加载测试页面,查看是否出现对应域名或目标地址的连接。若界面提供规则、策略链或出站信息,检查它是否符合预期:应该直连的请求是否直连,需要代理的请求是否经过已选策略组。短连接可能很快消失,可以改看日志或重新发起请求。日志输出级别各客户端不同,不要把没有详细域名记录直接等同于请求没有经过内核。
若能看到请求,但目标网站打不开,说明请求可能已进入内核,下一步应检查所选出站是否可用、订阅是否有效,以及是否有规则将该请求拒绝或分配到了其他策略。只改变一个条件,例如在相同策略组中切换一个出站,再重新测试;不要同时修改端口、DNS、模式和订阅,否则无法判断哪个改动产生作用。也不必先删除整个配置,已有记录往往能缩小问题范围。
若浏览器请求完全没有出现,先确认系统代理仍处于开启状态,浏览器有没有单独的代理扩展或自定义代理设置,再检查内核是否运行。系统设置里残留的旧端口、另一款客户端重新接管代理,都可能让请求没有到达当前应用。可以关闭系统代理后重新开启一次,让客户端重新写入设置;若仍失败,按「当前配置 → 内核运行 → 本地端口 → 系统代理」的顺序核对。常见现象与处理路径集中在帮助中心。
如果浏览器已正常而终端命令仍然失败,不应据此推断整套配置无效。许多命令行工具不读取 macOS 系统代理,需要自己的代理参数或环境变量;具体支持的协议也不相同。首次验证到浏览器与连接记录一致即可,终端需求另行处理。类似地,查看出口地址只能证明该次查询请求的路径,不能证明所有应用都经过同一出口。完成验证后保留规则模式,并记录当前启用的配置与策略组,便于下次更新后对照。
结束使用:关闭代理与恢复网络
准备退出客户端时,先在菜单栏或设置中关闭「系统代理」,若后来启用了 TUN,也先将其关闭,再选择退出。这样可以避免系统仍把请求交给已经停止的本地端口。不同客户端可能提供退出时自动恢复设置的功能,但首次使用仍建议手动确认一次。只是关闭窗口而继续让客户端驻留时,可以按实际需要保留代理,不必每次都重新导入订阅。
如果应用异常退出后网页全部打不开,先重新打开客户端并关闭系统代理。无法启动时,进入当前网络服务的代理设置,检查是否还指向本机回环地址与旧端口,只移除确认由该客户端写入且不再使用的项目。工作设备上的组织代理不要随意删除。恢复普通联网后,再查看客户端日志处理启动问题,不需要一开始就重置整个 Mac 的网络设置。
以后日常使用通常只需三件事:确认订阅更新成功、确认当前策略符合需要、按需开启系统代理。更新订阅可能改变组名与默认选择,因此更新后遇到访问差异,先核对策略组,再考虑其他设置。基础流程到此完成;协议选型、内核兼容与订阅格式等长篇说明留在协议手册,不必为了日常浏览提前修改所有高级参数。