服务器部署助手 v2.0.3 测试版

# 服务器部署助手 · 使用说明

粤冲科技 · 国际站：https://www.gzyc.org.cn

## 启动

完整解压后双击 WireGuardAssistant.exe。请保留同目录的 _internal 文件夹。无需安装 Python。

## 使用

1. 添加服务器，填写 SSH 地址、端口和账号，设置密码或私钥。
2. 连接服务器，首次连接时核对 SSH 主机指纹。
3. 选择 WireGuard、VLESS + REALITY 或 OpenVPN 页面，刷新状态。
4. 新服务器先检查部署条件，再安装、添加客户端并导出配置。
5. 在云安全组放行对应端口，并使用客户端实测连接。

## REALITY 客户端导出

Clash Verge / Mihomo 用户选择“保存 Clash Verge YAML”，将导出的 .yaml 文件作为本地配置导入或拖入 Clash Verge 的订阅页面，再启用该配置并选择节点。这是独立完整配置，所有匹配流量通过节点，不会自动合并原有订阅或分流规则。

“保存 Xray JSON”用于 Xray 客户端。分享链接和二维码供支持 VLESS 链接的客户端使用，不能作为 Clash Verge 的订阅文件地址填写。IPv6 节点需要电脑所在网络支持 IPv6。

WireGuard 功能免费。REALITY 与 OpenVPN 需要有效扩展授权，已有本电脑授权继续使用；当前测试版暂停新购买。

## 支持范围

- SSH 支持 IPv4 / IPv6。REALITY / OpenVPN 自动安装支持 Ubuntu 22.04、24.04 和 Debian 12、13 的原生 systemd 环境，amd64 / arm64；Ubuntu 26.04、26.10 提供兼容测试支持，安装前仍检查依赖及环境，完整部署和客户端连接需实机验证。
- WireGuard 与 OpenVPN 当前自动安装配置依赖 IPv4 出口，不支持纯 IPv6 出口服务器的完整上网部署。
- REALITY 默认由服务器下载官方 Xray 并核对 SHA256。下载失败时会询问是否改用电脑下载、校验后经 SSH 上传。选择“否”会停止安装；选择“是”需要电脑能访问官方下载源。上传后服务器再次校验，操作结束后尝试清理临时安装包。
- 不自动覆盖或接管其他工具、面板、容器创建的扩展服务。检测通过不等于客户端连接已验证。
- 修改端口后，请同步调整客户端及云安全组。

优先建议使用有 IPv4 出口的服务器或 IPv4/IPv6 双栈服务器。纯 IPv6 节点即使连接成功，也可能无法访问仅支持 IPv4 的网站；需要广泛访问网站时，应优先使用 IPv4 出口。SSH 或客户端通过 IPv6 连接，不代表服务器具备 IPv4 上网能力。

## 数据与备份

服务器列表和授权保存在当前 Windows 用户的 %LOCALAPPDATA%\WireGuardAssistant 文件夹。服务器密码、私钥和授权缓存使用 Windows DPAPI 加密。

可在授权管理中导出本电脑授权备份。备份带数字签名、绑定本电脑，不能用于换机；请妥善保存。导出的客户端配置及二维码包含连接凭据，请勿公开分享。

## 测试反馈

遇到问题请提供操作名称、系统版本及界面错误/日志。不要发送 SSH 密码、私钥或完整客户端配置。

应用左侧“帮助”提供系统与网络支持范围、客户端导入方法和常见报错说明。联系邮箱：2922988@qq.com。