# wenmai-proxy GUI 一键安装教程

本版本适用于 Windows Server 2022。用户不需要输入 PowerShell 命令，双击安装即可。

## 一、把安装包复制到服务器

将 `wenmai-proxy-windows-v2.0.2.zip` 复制到 Windows 服务器，然后右键选择“全部解压”。

注意：不能直接在压缩包预览窗口里运行，必须先完整解压。

## 二、双击安装

进入解压后的目录，双击：

```text
安装-wenmai-proxy.vbs
```

Windows 弹出“用户账户控制”提示时，点击“是”。

在安装窗口点击“开始安装”，等待状态变成“安装成功”。安装程序会自动完成：

- 安装并启动 `my-proxy` 代理服务。
- 安装并启动 `my-proxy-manager` 管理服务。
- 下载并安装 TLS 证书。
- 放行 SOCKS5 端口 `9001` 和 HTTP 端口 `9002`。
- 放行管理端口 `18080`。
- 在公共桌面创建“wenmai-proxy”图标。
- 创建登录启动项，让管理程序常驻右下角系统托盘。

云服务器还需要在云平台安全组中放行实际使用的端口。普通 HTTP 代理至少放行 TCP `9002`；远程管理更新需要放行 TCP `18080`。

## 三、查看代理账号密码

安装完成后，点击安装窗口中的“打开管理界面”，或双击桌面的“wenmai-proxy”。

管理界面会显示：

- 代理服务和管理服务是否运行。
- 当前服务器的本机 IP。
- HTTP 和 SOCKS5 代理端口。
- 代理账号、密码及绑定出口 IP。

关闭或最小化窗口后，程序不会退出，而是隐藏到右下角系统托盘。双击托盘图标可以再次打开；右键托盘图标选择“退出桌面程序”才会完全退出。下次登录服务器时会自动启动。

选中账号后点击“复制 HTTP”，会复制成：

```text
http://服务器IP:9002:账号:密码
```

点击“复制 SOCKS5”，会复制成：

```text
socks5://服务器IP:9001:账号:密码
```

如果安装后账号列表暂时为空，等待几秒后点击“刷新”。账号信息来自：

```text
C:\app\my-proxy\proxy-users.txt
```

## 四、测试 HTTP 代理

在另一台电脑的命令提示符中运行：

```cmd
curl --proxy-user "账号:密码" -x http://服务器IP:9002 http://myip.ipip.net
```

能返回服务器出口 IP，说明代理可用。

## 五、覆盖安装

需要重新部署安装包时，再次双击 `安装-wenmai-proxy.vbs`，点击“覆盖安装”。安装器会先停止已有服务，再替换文件并重新启动服务，已有 `proxy-users.txt` 不会被删除。

## 六、常见问题

安装窗口提示下载证书失败：确认服务器能访问 `https://download.hitoor.com`，然后重新点击安装。

代理端口连接超时：检查 Windows 防火墙、云服务器安全组和运营商防火墙是否已经放行对应 TCP 端口。

代理返回 `407 Proxy Authentication failed`：账号或密码不正确，请从桌面管理界面重新复制。

桌面没有图标：到公共桌面 `C:\Users\Public\Desktop` 查看，或直接运行 `C:\app\my-proxy\MyProxy-GUI.ps1`。

托盘没有图标：点击任务栏右侧的向上箭头查看隐藏图标；也可以双击桌面的“wenmai-proxy”唤醒程序。
