开源监控神器WGCLOUD体验服务器、Docker、数据库统一监控全攻略前言服务器数量不多时通过SSH逐台检查CPU、内存、磁盘和服务状态基本能够应付日常运维。但随着业务中出现更多服务器、数据库、Docker容器和网络服务依靠人工检查不仅耗时也很难及时发现端口中断、资源占用异常或日志持续报错等问题。对于需要统一管理多种IT资源的团队来说监控系统不仅要能展示服务器状态还要覆盖数据库、端口、日志和容器等不同对象。同时部署和使用过程不能过于复杂否则监控平台本身也会增加新的维护成本。WGCLOUD是一款采用Server与Agent架构的运维监控系统。服务端负责数据存储和集中展示被监控主机运行Agent后可以将相关指标上报到统一的管理页面并进一步配置端口、日志、Docker和数据库监控。本文将完成WGCLOUD服务端安装、MySQL数据库初始化、配置文件修改和Agent节点接入并记录部署过程中遇到的数据库连接问题。完成本地监控后再通过cpolar配置公网访问方便运维人员在其他网络环境中打开管理页面。1.什么是WGCLOUDWGCLOUD 是一款由国人开发、完全开源免费的高性能 IT 基础设施监控系统专注于对服务器、网络、应用及中间件等资源进行实时、全面的监控与告警。它以轻量、易用、功能强大和对国产化环境友好而著称被誉为“国产开源监控之光”。核心特点全栈监控能力主机监控CPU、内存、磁盘、网络、负载、进程、温度等。服务/应用监控HTTP、Ping、端口存活、数据库MySQL、PostgreSQL、Oracle 等、Redis、MongoDB、FTP、SMTP 等。中间件与组件支持 Nginx、Tomcat、Docker、Kubernetes部分集成等。自定义监控可通过 Shell 脚本、API 接口扩展监控项。轻量高效资源占用低采用Java Vue技术栈服务端部署简单Agent 体积小、运行稳定适合从个人开发者到中大型企业的多种场景。可视化与告警强大提供丰富的图表展示实时曲线、历史趋势、拓扑图等。支持多通道告警通知邮件、钉钉、企业微信、飞书、Webhook 等。告警策略灵活可设置阈值、持续时间、静默期等。国产化友好完全兼容国产操作系统如统信 UOS、麒麟 Kylin、国产 CPU 架构鲲鹏、飞腾、龙芯等及国产数据库满足信创环境需求。开源免费社区活跃项目托管于Gitee码云代码公开透明文档齐全更新迭代快拥有活跃的中文社区支持。典型应用场景企业私有化部署的运维监控平台云服务器/IDC 机房资源统一管理DevOps 流程中的健康检查环节国产化替代方案中的监控组件官网 开源地址www.wgstart.comGitee 项目名wgcloud简而言之WGCLOUD是一款“开箱即用、功能全面、本土优化”的国产开源监控利器为追求安全可控、高效运维的团队提供了极具性价比的选择。2.部署WGCLOUD前提条件服务器/主机环境要求项目要求操作系统支持主流 Linux 发行版如 CentOS 7/Ubuntu 18.04/Debian 10也支持 Windows Server仅服务端✅ 特别适配国产系统统信 UOS、麒麟 Kylin、中标麒麟等CPU 架构x86_64Intel/AMD✅ 兼容国产 CPU鲲鹏ARM64、飞腾、龙芯LoongArch等需确认对应版本内存建议 ≥ 2 GB仅运行服务端若同时监控大量主机建议 ≥ 4 GB磁盘空间≥ 5 GB 可用空间含日志与数据库网络服务器需能访问被监控主机的相应端口如 SSH、数据库端口等被监控主机需能访问 WGLOUD 服务端的 Agent 注册端口默认 9999基本工具安装yuminstall-yvimwget服务端Server依赖Java 环境JDK 1.8 或 JDK 11推荐 OpenJDKjava-version# 验证是否已安装数据库H2 内嵌数据库默认适合小型部署无需额外安装MySQL 5.7 / MariaDB / PostgreSQL / Oracle生产环境推荐需提前创建数据库被监控端Agent依赖Linux 主机需安装 Java 1.8用于运行 AgentWindows 主机无需 Java直接运行 .exe 版 AgentSSH 访问权限可选若通过服务端远程部署 Agent需配置免密 SSH 登录网络与端口开放组件默认端口用途是否必须开放WGLOUD 服务端 Web8080管理界面访问✅ 是WGLOUD Agent 注册通信9999Agent 与服务端心跳/数据上报✅ 是数据库若外置如 MySQL 3306服务端连接数据库✅ 是被监控服务端口如 Redis 6379、MySQL 3306 等用于服务探测按需开放3.安装WGCLOUD下载安装文件从官网下载安装文件:上传到linux系统的/usr/local目录下解压缩安装文件后进入文件目录tar-zxvfwgcloud-v3.6.6.tar.gzcdwgcloud-v3.6.6查看文件目录4.配置mysql数据库登录:mysql-uroot-p【密码】创建数据库:create database wgcloud;使用新建的数据库wgclouduse wgcloud;执行初始化脚本你使用的是 MySQL并且已经创建了wgcloud数据库你应该使用wgcloud-MySQL.sql这是WGCLOUD项目为 MySQL 数据库专门准备的初始化脚本。source/usr/local/wgcloud-v3.6.6/sql/wgcloud-MySQL.sql验证是否导入成功SHOW TABLES;5.编辑WGCLOUD配置文件进入wgcloud的server目录并查看文件列表cdserver/ ll进入server配置文件目录:cdconfig/ ll修改application.yml配置文件主要修改mysql的密码确保可以正确连接往下面划可以看见登录wgcloud页面的账户密码进入wgcloud的server并启动server服务:cd/usr/local/wgcloud-v3.6.6/server/ ./start.sh在这里我说一下我启动的过程中遇到的问题在我启动过程中显示我的数据库一直连接不上但是我的账户名密码又全都正确这究竟是什么原因呢在这里我顺便学习到了一个知识点在 MySQL 中localhost表示 使用Unix Socket连接不是TCP/IP127.0.0.1表示 使用 TCP/IP 连接Java应用WGCLOUD通过JDBC只能走TCP/IP即使你写localhostJDBC驱动也会解析为127.0.0.1 并尝试 TCP 连接。但你的MySQL没有root127.0.0.1这个用户所以连接被拒绝你能在命令行用mysql -u root -p登录是因为它默认走的是Unix Socket匹配的是rootlocalhost所以成功。但Java程序走TCP找不到root127.0.0.1就失败了。//创建 root127.0.0.1 用户密码和你现有的一致 CREATEUSERroot127.0.0.1IDENTIFIED BYSjixin520!;//授予对 wgcloud 库的所有权限 GRANT ALL PRIVILEGES ON wgcloud.* TOroot127.0.0.1;//刷新权限 FLUSH PRIVILEGES;也可以直接前台调试看日志这是更直观的知道哪里报错java-jarwgcloud-server-release.jar启动成功后访问http:// 你的服务器IP:9999即可打开WGCLOUD管理界面。使用账户密码登录默认admin/111111登录成功后页面显示如图所示6.添加监控主机添加监控主机在server主机wgcloud-v3.5.7目录下面 进入agent目录启动start.sh即可启动指标回到WGCLOUD页面刷新新监控的主机就显示到了页面上如何添加其他监控主机只需要把server同级目录的agent打成压缩包然后复制到其他主机然后启动agent就可以了。#打包 agent 目录为 .tar 文件tar-cvfagent.tar agent/#远程上传到目标服务器root目录下面scpagent.tar root目标主机IP:/root#解压上传的 .tar 文件tar-xvfagent.tar#cd 进入agent 目录cdagent/#进入config/ 目录cdconfig/#编辑application.properties 文件 把localhost 换成server主机IPvimapplication.properties#启动agent 服务shstart.sh回到WGCLOUD页面刷新新监控的主机就显示到了页面上7.WGCLOUD浏览器配置、展示这是它的基础展示页面添加端口监控添加日志监控信息添加docker监控添加数据库信息连接前测试一下时候可以连通添加数据表还可添加很多监控参数我这里就不一一展示了主机监控拓扑图在WGCLOUD的远程监控部署场景中结合cpolar可显著简化网络穿透难题。尤其当WGCLOUD服务端或被监控主机位于内网如企业局域网、家庭NAS或无公网IP的云服务器时传统方式需配置复杂NAT映射或依赖固定公网IP而cpolar通过安全、稳定的内网穿透能力一键将本地WGCLOUD Web管理界面或Agent通信端口暴露至公网无需改动现有防火墙策略或申请额外带宽资源。这不仅提升了部署灵活性还让异地运维人员能随时随地通过cpolar提供的HTTPS隧道安全访问WGCLOUD监控平台真正实现“开箱即用”的远程可观测性。8.安装cpolar实现随时随地开发8.1 什么是cpolarcpolar是一款安全高效的内网穿透工具无需公网IP或复杂配置只需一条命令即可将本地服务器、Web服务或任意端口映射到公网让你随时随地远程访问内网应用特别适合开发调试、远程运维和应急部署等场景。8.2 部署cpolarcpolar 可以将你本地电脑中的服务如 SSH、Web、数据库映射到公网。即使你在家里或外出时也可以通过公网地址连接回本地运行的开发环境。❤️以下是安装cpolar步骤使用一键脚本安装命令sudocurlhttps://get.cpolar.sh|sh安装完成后执行下方命令查看cpolar服务状态如图所示即为正常启动sudosystemctl status cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可打开浏览器访问本地9200端口使用cpolar账户密码登录即可,登录后即可对隧道进行管理。9.配置公网地址登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道隧道名称可自定义本例使用了:wgcloud注意不要与已有的隧道名称重复协议http本地地址9999域名类型随机域名地区选择China Top创建成功后打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址接下来就可以在其他电脑或者移动端设备异地上使用地址访问。访问成功。10.保留固定公网地址使用cpolar为其配置二级子域名该地址为固定地址不会随机变化。点击左侧的预留选择保留二级子域名地区选择china Top然后设置一个二级子域名名称我使用的是wgcloud大家可以自定义。填写备注信息点击保留。登录cpolar web UI管理界面点击左侧仪表盘的隧道管理——隧道列表找到所要配置的隧道点击右侧的编辑。修改隧道信息将保留成功的二级子域名配置到隧道中域名类型选择二级子域名Sub Domain填写保留成功的二级子域名地区: China Top点击更新更新完成后打开在线隧道列表此时可以看到随机的公网地址已经发生变化地址名称也变成了保留和固定的二级子域名名称。最后我们使用固定的公网地址在任意设备的浏览器中访问可以看到成功访问的页面这样一个永久不会变化的二级子域名公网网址即设置好了。总结完成以上配置后WGCLOUD就可以集中展示多台主机的运行状态。除了基础的CPU、内存、磁盘和网络数据还可以根据实际需求继续添加端口、日志、Docker、数据库和数据表等监控项目。这次部署中比较值得注意的是MySQL连接方式。命令行能够使用rootlocalhost登录并不代表Java程序一定能够通过TCP正常连接数据库。如果WGCLOUD启动时持续提示数据库连接失败需要结合JDBC地址、MySQL用户来源和授权范围进行检查而不能只确认账号密码是否正确。通过cpolar创建公网隧道后WGCLOUD管理页面也可以在局域网外访问。继续配置固定二级子域名后远程入口能够保持不变更适合异地运维和长期使用。WGCLOUD适合需要集中查看服务器及多种基础设施状态的个人用户和团队。正式投入使用前还需要根据实际设备数量规划数据库、日志保留周期和告警规则并及时修改默认登录密码避免将未经安全配置的管理后台直接暴露在公网中。