ProxyLauncher

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #llm #golang #android #docker #nodejs #awesome #cli #kubernetes #vue #openai

(★ 32)

macOS 代理启动器：为指定应用注入代理环境变量启动，无需 TUN 模式

ProxyLauncher 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 代理启动器（ProxyLauncher）

> 本项目已链接认可 [LINUX DO](https://linux.do) 社区。

一个 macOS 原生小工具：设置好代理地址后，把应用添加进列表，从这里启动的应用会自动注入
`HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` / `NO_PROXY` 环境变量，让 Antigravity、Claude
等应用的后台进程（如 language_server）直接走 Clash 本地端口，**无需开启 TUN 模式**。

原理：应用启动前注入标准代理环境变量，只影响被启动的应用，不修改系统全局代理。

## 下载安装

从 [Releases](https://github.com/ZhjGo/ProxyLauncher/releases) 下载最新的
`ProxyLauncher-x.x.zip`，解压后把 `代理启动器.app` 拖进「应用程序」文件夹。
支持 Apple Silicon 和 Intel（Universal），需要 macOS 13 或更高。

**首次打开**：本应用没有 Apple 开发者签名，直接双击会提示"无法验证开发者"。
解决方法（任选其一）：

- 打开「系统设置 → 隐私与安全性」，在底部找到被拦截的提示，点「仍要打开」；
- 或在终端执行：`xattr -cr /Applications/代理启动器.app`，之后正常双击即可。

不想用现成包的话，克隆仓库跑 `./build.sh` 自己构建（只需 Xcode 命令行工具）。

## 使用

1. 先打开 Clash Verge 等代理软件（默认混合端口 7890）。
2. 双击 `dist/代理启动器.app` 打开。顶部绿点表示代理端口已连通。
3. 点「添加应用」或**直接把 App 拖进窗口**添加（可多选）。
4. 点某个应用的「启动」即可带代理启动。若该应用已在运行，会提示「退出并重新启动」
   （环境变量只在启动那一刻生效）；若代理端口不通，会先提醒。
5. 建议把 `代理启动器.app` 拖进「应用程序」文件夹，方便从启动台打开。

## 功能

- **独立启动器生成**：应用行悬停的 ⬇ 图标（或右键菜单）可生成 `XXX（代理）.app`，
  用原应用图标，放进 Dock / 启动台后**双击即带代理启动**，不用先开本工具。
  启动器从 `~/Library/Application Support/ProxyLauncher/proxy.env` 读取代理地址，
  在主界面改了设置后所有启动器自动同步，无需重新生成。
- **测出口**：经代理查询出口 IP、国家/城市和运营商，快速判断节点地区是否符合要求
  （如「当前地区不支持」类报错）。依次尝试 ipwho.is / api.ip.sb / ip-api.com，
  单个接口限流会自动换下一个。
- **自动探测端口**：扫描 7890 / 7897 / 7891 / 1080 / 2080 / 8889 / 8118 / 10808 / 10809，
  找到可连通的端口自动填入。启动时端口连不通会自动探测；运行中每 6 秒复查，
  发现断开（如代理软件换了端口）也会自动重新探测切换。当前设置的端口优先，
  能用就不会被改掉。
- **菜单栏常驻**：勾选后菜单栏出现 ✈️ 图标，关掉窗口不退出、从 Dock 隐藏，
  随时从菜单栏一键启动任意应用。
- **全部启动**：一键带代理启动列表里所有未运行的应用。
- 右键应用行：带代理启动、生成启动器、复制等效终端命令、在访达中显示、移除。
- 所有设置自动保存；只影响由本工具（或生成的启动器）启动的应用，不修改系统全局代理。

## 重新构建

```bash
./build.sh        # 产物在 dist/代理启动器.app
```

只需要 Xcode Command Line Tools（swiftc），不需要完整 Xcode。

## 文件说明

- `Sources/main.swift` — 全部应用代码（SwiftUI）
- `Info.plist` — 应用包信息
- `make-icon.swift` — 构建时生成图标
- `build.sh` — 编译 + 打包 + ad-hoc 签名

## 注意

- 目标应用更新后路径不变，启动器继续可用；若应用被移动/改名，需重新生成启动器。
- 代理环境变量只对「从本工具或启动器启动」的进程生效，从 Dock 直接打开不走代理。

ProxyLauncher

ProxyLauncher 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ProxyLauncher

ProxyLauncher 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README