Proxi
/ˈprɒk.si/ —— 还是 proxy,只是 y 换成了 i。
一键把系统代理、终端、git 和 npm 指向你自己的代理服务器:公司代理、内网网关,或者 Charles 这样的调试代理。再点一下,全部恢复。Proxi 只负责切换设置,自己不提供代理服务,也不转发流量。
一个开关,四个地方
代理往往要在系统设置、终端、git 和 npm 里各设一遍,换个网络又得挨个改回来。Proxi 的每套配置自己选作用在哪里;打开开关全部设好,关掉就全部恢复。
- 系统代理(通过
networksetup),浏览器和大多数软件都走它 http_proxy、https_proxy、all_proxy、no_proxy,之后新开的终端生效;已经打开的终端复制一行命令就行- git 的全局
http.proxy,以及 npm、pnpm 和 yarn 1 都读的~/.npmrc
指向你自己的代理
每套配置就是一个你已经在用的代理服务器:公司代理、内网网关,或者本机的调试代理。支持 HTTP、SOCKS5 和 PAC,可以填登录信息,每套配置有自己的例外列表。
- 「自动检测」能找出本机正在运行的 Charles(8888)、Proxyman(9090)、mitmproxy(8080)等
- 密码只存在这台 Mac 的钥匙串里
- 「测试连接」经代理访问苹果的检测页,显示延迟
脚本、AI 助手,换网络自动切
proxi 命令、给 AI 助手用的 MCP 服务器和 proxi:// URL 命令,共用一个本机控制接口,权限由你决定。换了网络,规则会替你切换。
proxi on、proxi use <配置名>、proxi off、proxi status、proxi test- 连上公司 Wi-Fi 自动开公司代理,回家自动关掉
- AI 助手只能查看状态、切换配置和测试连接,别的都做不了
每台 Mac,始终最新
配置和设置通过你自己的 iCloud 云盘在多台 Mac 之间同步;密码不会离开输入它的那台 Mac。有新版本,点一下就装好。
- 第二台 Mac 加入时,可以合并、用本机的或者用 iCloud 的
- 更新先校验 SHA-256 和代码签名,再替换程序
积少成多的小细节
⌃⌥P
在任何程序里开关代理。点菜单栏图标打开面板,右键弹出简洁菜单。
连接检查
代理开着时,Proxi 会定期看看代理服务器还能不能连上,连不上就提醒你。
别的程序改了代理
系统代理被别的程序改了,Proxi 会发现,还能把它存成一套配置。
诊断
系统代理、环境变量、git 和 npm 现在的设置,以及 Proxi 的日志。
菜单栏网速
开关旁边显示上传和下载速度,代理开着时用配置的颜色。
中文或英文
界面跟着系统语言,也可以在设置 › 通用里选。
系统要求
- macOS
- 14 Sonoma 或更新;macOS 26 上为 Liquid Glass
- Mac
- 通用:Apple 芯片与 Intel(也提供单一架构版本)
- 权限
- 安装命令行工具需要管理员密码,修改系统代理时 macOS 也可能要求输入。定位权限只用于读取 Wi-Fi 名称、按网络自动切换。不需要辅助功能权限。
- 语言
- English、简体中文
- 下载
Proxi-macos.zip(通用版),或-arm64/-x86_64版- 许可证
- GPL-3.0
安装与更新
- 从最新版本下载
Proxi-macos.zip并解压。 - 把 Proxi.app 拖进“应用程序”文件夹,双击打开。发布的版本都用 Developer ID 签名并通过苹果公证。
- 在设置 › 代理配置里添加你的代理服务器(或者点“自动检测”),选好生效范围,打开开关。
也可以用 Homebrew 代替第 1、2 步:
brew install --cask whrss9527/tap/proxiProxi 在启动时和之后每 6 小时检查一次 GitHub Releases(可以关闭)。点“更新”会下载适合你芯片的版本,比对 SHA-256,替换 Proxi 并重新打开;只会安装同一开发者签名的更新。配置和设置都会保留。
常见问题
免费吗?
免费。Proxi 以 GPL-3.0 开源。它不提供代理服务,也不转发任何流量:它只修改你 Mac 上的设置,让它们指向你已经在用的代理服务器。
它具体会改哪些设置?
只改配置的生效范围里选中的:各个网络服务的系统代理、登录会话里的 http_proxy / https_proxy / all_proxy / no_proxy 环境变量、git 全局的 http.proxy 和 https.proxy,以及 ~/.npmrc 里的代理设置。关闭代理时把它们清掉;系统代理也可以选择恢复成开启前的样子。
代理密码存在哪里?
存在这台 Mac 的钥匙串里,不写进 Proxi 的配置文件,也不跟 iCloud 同步;别的 Mac 第一次用时会请你输入一次。配置开启期间,密码会按这些工具的要求写进 Proxi 设置的代理地址里。
需要辅助功能权限吗?
不需要。全局快捷键用的是标准热键接口。安装命令行工具时 Proxi 会请求管理员密码;修改系统代理时 macOS 也可能要求输入。
为什么要定位权限?
只用于按 Wi-Fi 网络自动切换:从 macOS 14 起,读取 Wi-Fi 名称需要定位权限。Proxi 不读取也不保存你的位置,你也可以改为按路由器切换。
有 Windows 版吗?
有,Windows 上是 ProxySwitch。两者各自独立发展。
更多帮助:GitHub 上的 Proxi issue · 支持 · Proxi 隐私政策