proxyman-download-setup

Proxyman 下载与设置

指导用户安装并启动 Proxyman。此技能以 Shell 操作为主，因为 Proxyman 和它的 MCP 工具可能尚不可用。

操作规则

1. 在 Proxyman 安装、启动并配置好 MCP 之前，不要使用 Proxyman MCP 工具。
2. 不要硬编码应用版本。使用 Proxyman 的最新版本重定向链接。
3. 在 Windows 上优先使用 PowerShell。如果当前 Shell 不是 PowerShell，请使用 powershell.exe -Command '...' 包装 PowerShell 代码片段。
4. 仅在需要自动配置系统代理或用户提出要求时，才安装 macOS Helper Tool。
5. 仅在用户需要解密 HTTPS 时，才安装根证书。基本 HTTP 抓包和应用安装都不需要安装证书。
6. 在 Windows 和 Linux 上，先至少启动一次 Proxyman，再设置 MCP，这样应用才能公开或准备内置的 MCP 桥接程序。

阶段 1：检查是否已安装

macOS

if [ -d "/Applications/Proxyman.app" ]; then
  VERSION=$(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "/Applications/Proxyman.app/Contents/Info.plist" 2>/dev/null)
  echo "INSTALLED: ${VERSION:-unknown}"
elif mdfind 'kMDItemCFBundleIdentifier == "com.proxyman.NSProxy"' | grep -q "Proxyman.app"; then
  echo "INSTALLED: found via Spotlight"
else
  echo "NOT_INSTALLED"
fi

Windows（PowerShell）

$installed = Get-ItemProperty `
  "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
  "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
  "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*" `
  -ErrorAction SilentlyContinue |
  Where-Object { $_.DisplayName -like "*Proxyman*" }

if ($installed) {
  Write-Host "INSTALLED: $($installed.DisplayVersion)"
} else {
  Write-Host "NOT_INSTALLED"
}

Linux

if command -v proxyman >/dev/null 2>&1; then
  echo "INSTALLED: $(command -v proxyman)"
elif ls "$HOME"/Downloads/Proxyman*.AppImage "$HOME"/Downloads/proxyman*.AppImage >/dev/null 2>&1; then
  echo "INSTALLED: AppImage in Downloads"
else
  echo "NOT_INSTALLED"
fi

如果已安装 Proxyman，请启动它并继续准备步骤。如果用户需要最新版本，请通过下方对应平台的重定向链接下载。

阶段 2：下载并安装

macOS：优先使用 Homebrew

如果已安装 Homebrew，请使用 cask：

brew install --cask proxyman

如果没有 Homebrew，或用户更喜欢直接下载，请使用最新 DMG 重定向链接：

curl -L "https://proxyman.com/release/osx/Proxyman_latest.dmg" -o "$HOME/Downloads/Proxyman.dmg"
hdiutil attach "$HOME/Downloads/Proxyman.dmg" -nobrowse
cp -R "/Volumes/Proxyman/Proxyman.app" /Applications/
hdiutil detach "/Volumes/Proxyman"

如果卷名称不同，请列出已挂载的卷，并从已挂载的 Proxyman 卷中复制：

ls /Volumes

Windows

Windows 端点名称以 .dmg 结尾是历史遗留原因，但它会重定向到最新的 Windows 安装程序。 该安装程序是 NSIS 一键安装程序，通常会在安装完成后启动 Proxyman。

$installer = "$env:USERPROFILE\Downloads\ProxymanSetup.exe"
Invoke-WebRequest "https://proxyman.com/release/windows/Proxyman_latest.dmg" -OutFile $installer -MaximumRedirection 5
Start-Process $installer -ArgumentList "/S" -Wait

如果静默安装失败，请以交互方式运行安装程序：

Start-Process $installer -Wait

Linux

下载最新 AppImage 重定向链接，使其可执行，然后启动：

curl -L "https://proxyman.com/release/linux/proxyman_latest" -o "$HOME/Downloads/Proxyman.AppImage"
chmod +x "$HOME/Downloads/Proxyman.AppImage"
nohup "$HOME/Downloads/Proxyman.AppImage" >/dev/null 2>&1 &

打包的 Linux 应用会在首次启动时准备 MCP 桥接程序。Proxyman 打开后，稳定的桥接程序路径应为：

BRIDGE_PATH="${XDG_CONFIG_HOME:-$HOME/.config}/Proxyman/bin/mcp-server"
test -x "$BRIDGE_PATH" && echo "MCP_BRIDGE: $BRIDGE_PATH"

阶段 3：启动 Proxyman

macOS

open -a "Proxyman"
sleep 10

Windows（PowerShell）

$candidates = @(
  "$env:LOCALAPPDATA\Programs\Proxyman\Proxyman.exe",
  "C:\Program Files\Proxyman\Proxyman.exe",
  "C:\Program Files (x86)\Proxyman\Proxyman.exe"
)
$proxymanExe = $candidates | Where-Object { Test-Path $_ } | Select-Object -First 1
if ($proxymanExe) {
  Start-Process $proxymanExe
  Start-Sleep 10
} else {
  Write-Host "Proxyman executable not found. Launch Proxyman from the Start menu, then continue."
}

启动后，内置 MCP 桥接程序应位于应用可执行文件旁边。对于默认的当前用户安装：

$bridge = "$env:LOCALAPPDATA\Programs\Proxyman\mcp-server.exe"
if (Test-Path $bridge) { Write-Host "MCP_BRIDGE: $bridge" }

Linux

if command -v proxyman >/dev/null 2>&1; then
  nohup proxyman >/dev/null 2>&1 &
else
  nohup "$HOME/Downloads/Proxyman.AppImage" >/dev/null 2>&1 &
fi
sleep 10

如果启动后找不到 Linux MCP 桥接程序路径，请让用户打开 Settings > MCP 并启用 MCP Server，然后重新启动 Proxyman，以便 AppImage 将桥接程序复制到配置文件夹并对其运行 chmod。

Windows 和 Linux MCP 桥接程序说明

Windows 和 Linux 版 Proxyman 使用与 macOS 相同的 MCP 模式：AI Agent 通过 stdio 启动内置的 mcp-server 进程，该桥接程序通过经过身份验证的 localhost 握手与正在运行的本地 Proxyman 应用通信。

继续进行 proxyman-mcp-setup 时，请使用以下桥接程序路径：

平台	桥接程序路径
Windows 默认安装	%LOCALAPPDATA%\Programs\Proxyman\mcp-server.exe
Windows 自定义安装	与 Proxyman.exe 位于同一文件夹的 mcp-server.exe
Linux AppImage	${XDG_CONFIG_HOME:-$HOME/.config}/Proxyman/bin/mcp-server

不要将 Proxyman.exe 或 .AppImage 配置为 Agent 使用的 MCP 命令。该命令必须是 stdio 桥接程序可执行文件。

阶段 4：准备代理抓包

Proxyman 可以通过不同方式捕获不同目标。更改系统状态前，请先询问用户要捕获什么。

• 桌面应用和浏览器通常使用系统代理。
• Node.js、Python、Ruby 和 Go 等命令行运行时可能需要 Proxyman Automatic Setup 或 Manual Setup。
• 许多客户端会绕过系统代理访问 localhost，因此 localhost 流量可能需要 Reverse Proxy。
• 使用 VPN 的 iOS 应用可能需要 Atlantis，而不是经典代理抓包。

请使用 proxyman-https-capture 完成针对目标的路由、证书、SSL Proxying、验证和回滚工作流。仅安装应用并不会配置所有目标。

macOS Helper Tool

Helper Tool 仅适用于 macOS。当用户希望 Proxyman 在不同网络接口上可靠地覆盖系统代理设置，或者由于需要特权网络设置而导致系统代理自动化失败时，请安装它。

告知用户，macOS 可能会显示密码或授权对话框，然后运行：

open -a "Proxyman" --args --install-privileged-components

如果 macOS 在“系统设置”中显示授权提示，请让用户授权 Proxyman 的 Helper Tool，然后重试系统代理操作。

根证书

HTTPS 解密需要设置根证书，但仅安装 Proxyman 不需要。

推荐步骤：

1. 完成应用安装。
2. 如果用户希望实现 Agent 自动化，请使用 proxyman-mcp-setup 配置 MCP。
3. 使用 get_certificate_status。
4. 如果需要 HTTPS 解密，且证书缺失或不受信任，请通过 MCP 或 Proxyman 的“证书”菜单使用 install_certificate。

如果不使用 MCP，请引导用户前往 Proxyman 应用内的“证书”菜单，并选择适用于目标平台的设置方式。请使用 proxyman-https-capture，不要将桌面根证书不加区分地应用于所有目标。

在 Windows 上，自动安装证书可能会显示 UAC 提示，并可使用提升权限的 certutil 流程。在 Linux 上，自动安装到信任存储区适用于 Ubuntu/Debian、Fedora/RHEL、openSUSE/SUSE 和 Arch 系列系统；不受支持的发行版可能需要从 Proxyman UI 获取手动配置信任存储区的命令。

部分 Proxyman 版本提供 proxyman-cli。只有在使用 command -v proxyman-cli 或 Get-Command proxyman-cli 确认其存在后，才使用它。仅对于自定义根证书，支持导入根证书的 CLI 版本可以使用：

proxyman-cli install-root-cert /path/to/custom-root.p12 --password "password" --trust

不要对 Proxyman 默认生成的根 CA 使用自定义根证书 CLI 命令。

阶段 5：建议配置 MCP

安装并运行 Proxyman 后，主动提出配置 MCP：

Proxyman is installed and running. The next step is to connect your AI agent to Proxyman MCP so it can inspect traffic, manage rules, install certificates when needed, and use Proxyman setup guidance. Use the proxyman-mcp-setup skill next.

如果用户接下来的目标是激活，请使用 proxyman-license-management。不要要求用户在聊天中粘贴许可证密钥。

故障排除

问题	操作
macOS DMG 卷名称不同	运行 ls /Volumes，找到 Proxyman 卷，并从中复制 Proxyman.app。
macOS 应用无法打开	运行 xattr -cr "/Applications/Proxyman.app"，然后重新启动应用。
Windows SmartScreen 阻止安装程序	请用户在显示的 Windows 提示中批准安装程序。
Linux AppImage 无法运行	确保其具有可执行权限，并且已安装所需的 AppImage/FUSE 依赖项。
无法在 macOS 上启用系统代理	安装或批准 Helper Tool，然后重试。
HTTPS 流量仍无法解密	安装并信任根证书，然后为目标主机启用 SSL Proxying。