# wenmai-proxy Windows 服务部署包

本目录提供 Windows Server 2022 的代理服务部署包。推荐使用 GUI 一键安装版，普通用户不需要输入 PowerShell 命令。

## 推荐：GUI 一键安装

1. 将 `wenmai-proxy-windows-v2.0.2.zip` 复制到服务器并完整解压。
2. 双击 `安装-wenmai-proxy.vbs`。
3. Windows 权限提示中点击“是”。
4. 在安装窗口点击“开始安装”。
5. 安装完成后，双击桌面的“wenmai-proxy”查看代理账号和密码。

详细教程见 [docs/GUI_INSTALL_GUIDE.md](docs/GUI_INSTALL_GUIDE.md)。

## 安装内容

默认安装目录：

```text
C:\app\my-proxy
```

安装后包含两个自动启动的 Windows 服务：

```text
my-proxy          代理服务
my-proxy-manager  更新和管理接口服务
```

GUI 安装器会自动下载证书、安装并启动服务、创建桌面管理图标，并放行用户需要的 Windows 防火墙 TCP 端口：

```text
9001   SOCKS
9002   HTTP
18080  管理接口
```

云服务器的安全组需要另外放行实际使用的端口。普通 HTTP 代理通常使用 `9002`。

## wenmai-proxy 常驻管理程序

安装后，`wenmai-proxy` 会在用户登录服务器时自动启动并常驻右下角系统托盘。关闭或最小化窗口只会隐藏到托盘；双击托盘图标或桌面快捷方式可以重新打开。

管理界面可以：

- 查看两个服务的运行状态。
- 查看本机 IP、HTTP 端口和 SOCKS5 端口。
- 查看 `proxy-users.txt` 中的代理账号、密码和绑定出口 IP。
- 一键复制 HTTP 地址：`http://服务器IP:9002:账号:密码`。
- 一键复制 SOCKS5 地址：`socks5://服务器IP:9001:账号:密码`。

桌面程序仅提供查看和复制功能，服务更新继续由管理员通过管理接口执行。

## 命令行安装

GUI 之外仍保留命令行安装方式。管理员 PowerShell 执行：

```powershell
Set-ExecutionPolicy -Scope Process Bypass -Force
.\Install-MyProxy.ps1 -EnableManagerFirewallRule -EnableProxyFirewallRule
```

## 测试代理

在另一台电脑执行：

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

返回服务器出口 IP 即表示代理工作正常。

## 管理接口

管理接口默认监听所有网卡的 TCP `18080`：

```text
GET  /health
GET  /version
POST /update
POST /rollback
POST /restart
```

完整说明见 [docs/API.md](docs/API.md)，curl 示例见 [docs/CURL_API.md](docs/CURL_API.md)。

## 更新与备份

无论选择的新版文件叫什么，最终都安装为：

```text
C:\app\my-proxy\my-goproxy-win64.exe
```

更新前的版本备份在：

```text
C:\app\my-proxy\releases
```

当前回滚接口只回滚到最近一次备份。

## 卸载

管理员 PowerShell 执行：

```powershell
C:\app\my-proxy\Uninstall-MyProxy.ps1
```

同时删除安装文件：

```powershell
C:\app\my-proxy\Uninstall-MyProxy.ps1 -RemoveFiles
```
