WgCloud监控系统从零部署指南（服务器与客户端监控完整教程）

第一步 准备工作与环境要求

在开始部署 WgCloud监控系统 之前，请确保你具备以下条件：

• 一台 Linux 服务器（推荐 Ubuntu 20.04+ 或 CentOS 7+），用于安装服务端。
• 至少一台 Linux 客户端机器（同样支持主流发行版），用于安装客户端 agent。
• 服务器需要开放指定端口（默认 51820 UDP 用于 WireGuard，以及 8080 TCP 用于 Web 面板）。
• 具备 root 或 sudo 权限。

第二步 安装 WgCloud 服务端

WgCloud监控系统 的服务端负责收集监控数据并提供可视化面板。执行以下命令一键安装：

    wget -O install.sh https://wgcloud.io/install-server.sh && sudo bash install.sh  

安装脚本会自动配置 WireGuard 网络、安装依赖（如 Python3, Redis）并启动服务。安装完成后，你会看到类似下面的输出：

    ✅ WgCloud 服务端安装成功！Web 面板地址: http://你的服务器IP:8080默认管理员账号: admin密码: 随机生成的密码已保存到 /etc/wgcloud/admin.pass  

请立即登录面板并修改默认密码。如果需要自定义配置，可以编辑 /etc/wgcloud/server.conf 文件。

第三步 部署 WgCloud 客户端监控 agent

客户端监控部署 是让被监控的机器上报数据。在每一台需要监控的 Linux 客户端上运行以下命令：

    curl -fsSL https://wgcloud.io/install-client.sh | sudo bash -s -- --server 你的服务端IP --token 你的接入令牌  

其中 --token 参数可以在服务端 Web 面板的“客户端管理”页面生成。如果一切顺利，客户端会自动建立 WireGuard 隧道并与服务端通信。你也可以手动检查客户端状态：

    sudo systemctl status wgcloud-client  

第四步 访问监控面板与数据可视化

现在打开浏览器访问 http://你的服务端IP:8080，使用之前的管理员账号登录。你将看到实时的 Linux服务器监控 仪表盘，包括 CPU、内存、磁盘、网络流量等关键指标。WgCloud 还内置了告警规则，可以在“告警配置”中设置阈值，通过邮件或 Webhook 发送通知。

此外，WgCloud 提供了强大的 WireGuard监控工具 功能，可以查看每个客户端的连接状态、延迟和流量使用情况，非常适合 VPN 网络的管理。

第五步 常见问题与故障排除

• 客户端无法连接服务端： 检查服务器防火墙是否放行 UDP 51820 端口，以及客户端能否 ping 通服务端 IP。
• 面板数据显示不全： 尝试重启客户端服务 sudo systemctl restart wgcloud-client，并查看日志 journalctl -u wgcloud-client -f。
• 忘记管理员密码： 在服务端执行 sudo wgcloud reset-admin 即可重置密码。

总结

通过以上五个步骤，你已经成功搭建了一套完整的 WgCloud监控系统，实现了对 Linux 服务器和客户端的全面监控。这套方案不仅部署简单，而且基于 WireGuard 加密，数据传输更安全。希望本教程能帮助你轻松搞定 客户端监控部署，让运维工作更加高效。如果你在部署中遇到问题，欢迎访问 WgCloud 官方社区寻求帮助。

—— 你的 Linux 监控好帮手，WgCloud 团队 ——