Proxi 应用图标

Proxi

/ˈprɒk.si/ —— 还是 proxy,只是 y 换成了 i。

一键把系统代理、终端、git 和 npm 指向你自己的代理服务器:公司代理、内网网关,或者 Charles 这样的调试代理。再点一下,全部恢复。Proxi 只负责切换设置,自己不提供代理服务,也不转发流量。

开源免费macOS 14 或更新Apple 芯片与 IntelEnglish、简体中文

一个开关,四个地方

代理往往要在系统设置、终端、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

安装与更新

  1. 从最新版本下载 Proxi-macos.zip 并解压。
  2. 把 Proxi.app 拖进“应用程序”文件夹,双击打开。发布的版本都用 Developer ID 签名并通过苹果公证。
  3. 在设置 › 代理配置里添加你的代理服务器(或者点“自动检测”),选好生效范围,打开开关。

也可以用 Homebrew 代替第 1、2 步:

brew install --cask whrss9527/tap/proxi

Proxi 在启动时和之后每 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 隐私政策

Proxi

开发者的代理开关:系统代理、终端、git 和 npm,一键切换。

开源免费macOS 14 或更新Apple 芯片与 IntelEnglish、简体中文