导航：首页 > 服务器 >

WGCLOUD-v2.3分布式监控系统的安装和配置

发表于：2026-11-03 作者：千家信息网编辑

千家信息网最后更新 2026年11月03日，WGCLOUD基于java语言开发，是微服务架构的分布式监控系统，核心模块包括：服务器集群监控，ES集群状态监控，CPU监控，内存监控，数据监控，服务心跳检测，应用进程管理，磁盘IO监控，系统负载监控

千家信息网最后更新 2026年11月03日WGCLOUD-v2.3分布式监控系统的安装和配置

WGCLOUD基于java语言开发，是微服务架构的分布式监控系统，核心模块包括：服务器集群监控，ES集群状态监控，CPU监控，内存监控，数据监控，服务心跳检测，应用进程管理，磁盘IO监控，系统负载监控，监控告警信息推送。比起zabbix监控工具，它更轻量，界面更友好，可轻松支持数百台主机监控。

1. 下载

官网地址：

https://www.wgstart.com/docs.html

若上述地址下载慢，使用百度网盘地址

https://pan.baidu.com/s/1L0yxDBjnvcgR6sqjoPFxLw

GITHUB仓库：

https://github.com/tianshiyeben/wgcloud

2. 数据库初始化

本产品数据库使用mysql，版本5.6或以上就可以。

创建数据库，名称为wgcloud，字符集设置为UTF-8 Unicode即可

导入sql脚本wgcloud-v2.3.sql，sql文件在压缩包里，解压后可以看到

创建完成

3. JDK1.8环境安装

因本产品使用微服务架构springboot开发，所以主机需要安装JDK1.8环境，如已安装则忽略。如下命令，检测是否安装

java -version

输出类似下面结果，证明已安装，openjdk也可以使用。

java version "1.8.0_152"Java(TM) SE Runtime Environment (build 1.8.0_152-b16)Java HotSpot(TM) 64-Bit Server VM (build 25.152-b16, mixed mode)

安装JDK1.8过程不在此描述，请在百度搜索资料。

4. 安装包解压

linux解压命令

tar -xvf wgcloud-server-v2.3.tar.gz

1.wgcloud-servrer为服务端，负载收集监控服务器各种数据，综合处理后，负责展现给用户。

2.wgcloud-agent为客户端，负载将服务器内存，cpu等指标数据发送给服务端

3.server端只部署一个。有多少台主机需要监控部署多少个agent，在每个监控主机分别部署agent，所有agent将数据主动上报到server

4.wgcloud-agent负责收集服务器内存，cpu，进程状态，系统和磁盘指标。如果不需要监控此类指标，可不安装wgcloud-agent。

5.监控主机信息由agent自动上报，无需在server端管理页面添加主机。

5. 修改server配置文件

wgcloud-server配置，config/application.yml

server:  port: 9999  servlet:    session:      timeout: 30m    context-path: /wgcloudlogging:  path: ./log# 数据库 相关设置spring:  application:    name: wgcloud-server  datasource:    driver-class-name: com.mysql.jdbc.Driver    url: jdbc:mysql://localhost:3306/wgcloud?characterEncoding=utf-8&characterSetResults=utf8&autoReconnect=true&useSSL=false&allowMultiQueries=true    username: root    password: 123456    # hikari连接池的参数 相关设置    hikari:      validationTimeout: 3000      connectionTimeout: 60000      idleTimeout: 60000      minimumIdle: 10      maximumPoolSize: 10      maxLifeTime: 60000      connectionTestQuery: select 1  mvc:    static-path-pattern: /static/**  thymeleaf:    cache: falsemybatis:  config-location: classpath:mybatis/mybatis-config.xml  mapper-locations: classpath:mybatis/mapper/*.xml  #自定义配置参数base:  #登陆账号admin的密码  admindPwd: 111111  #通信token，agent端和此保持一致  wgToken: wgcloud  #监控主机内存使用率%报警值，超过此值即发送邮件报警  memWarnVal: 98  #监控主机cpu使用率%报警值，超过此值即发送邮件报警  cpuWarnVal: 98

1.将datasource数据库连接信息，改为自己的mysql数据库信息

2.管理员admin密码也在上图修改，如标红部分111111，可以自定义自己的密码。

3.wgToken为server和agent通信密钥，相当于密码，一般保持默认即可。

4.如果想修改端口（一般保持默认即可），将9999改为自己的端口，同时访问时也用修改后的端口。

5.内存和CPU报警值（一般保持默认即可），可以按照自己的实际场景修改。

6.如上wgcloud-server修改完成，其他保持默认即可。

6. 修改agent配置文件

wgcloud-agent配置修改，config/application.yml

server:  port: 9998  servlet:    context-path: /wgcloud-agentspring:  application:    name: wgcloud-agentlogging:  path: ./log #自定义配置参数base:  #wgcloud-server端访问地址  serverUrl: http://127.0.0.1:9999  #本机ip，不要用localhost或127.0.0.1  bindIp: 192.168.1.2  #通信token，请和server端配置的wgToken保持一致  wgToken: wgcloud

serverUrl修改为wgcloud-server的访问url

bindIp为本机ip

wgToken为agent和server通信的密钥，相当于密码，可以自定义为自己的配置密码，一般保持默认即可

注意：所有配置的地方冒号后必须紧跟一个空格，注意是空格。wgToken: abc

7. 启动服务

1.wgcloud-server启动

执行start.sh启动，停止服务执行stop.sh。

win下用start.bat启动，启动后不可关闭黑窗口，要停止服务则关掉黑窗口即可。

启动后通过http://192.168.1.1:9999/wgcloud访问

默认登陆账号密码：admin/111111

2.wgcloud-agent启动

执行start.sh启动，停止服务执行stop.sh。