Webfunny Monitor 项目部署与配置完全指南

前言

Webfunny Monitor 是一款功能强大的前端监控系统，能够帮助开发者实时监控网站性能、错误日志和用户行为。本文将详细介绍如何从零开始部署和配置 Webfunny Monitor 系统，包括基础环境准备、数据库配置、生产环境部署以及高级功能设置等完整流程。

基础环境准备

在开始部署前，请确保您的系统满足以下基本要求：

1. Node.js 环境：版本需在 10.6.0 及以上
2. PM2 进程管理器：用于管理 Node.js 应用进程
3. MySQL 数据库：用于存储监控数据

第一步：获取项目代码并初始化

1. 通过版本控制工具获取最新代码
2. 在项目根目录下执行以下命令完成初始化：

   npm install && npm run bootstrap
   

3. 检查并安装 PM2（如未安装）：

   npm install pm2 -g
   

第二步：MySQL 数据库配置

数据库创建要求

1. 创建名为 webfunny_db 的数据库
2. 字符集设置：
   • Default Character set: utf8
   • Default Collation: utf8_bin

数据库连接配置

修改 bin/mysqlConfig.js 文件，配置数据库连接信息：

module.exports = {
  write: {
    ip: '数据库服务器IP',         // 数据库服务器地址
    port: '3306',                // 默认MySQL端口
    dataBaseName: 'webfunny_db', // 数据库名称
    userName: '用户名',          // 数据库用户名
    password: '密码'             // 数据库密码
  }
}

第三步：本地运行与测试

1. 启动服务：

   npm run prd
   

   （后续重启可使用 npm run restart）

2. 访问初始化页面：

   http://localhost:8010/webfunny/register.html?type=1
   

   完成管理员账号注册并登录

3. 创建项目后，系统会提供探针部署指南

第四步：生产环境部署

域名/IP 配置

修改 bin/domain.js 文件，配置生产环境访问地址：

// IP地址配置示例
module.exports = {
  localServerDomain: '服务器IP:8011',    // 日志上报地址
  localAssetsDomain: '服务器IP:8010',    // 前端访问地址
  localServerPort: '8011',              // 日志上报端口
  localAssetsPort: '8010'               // 前端访问端口
}

// 域名配置示例
module.exports = {
  localServerDomain: 'yourdomain.com:8011',
  localAssetsDomain: 'yourdomain.com:8010',
  localServerPort: '8011',
  localAssetsPort: '8010'
}

脚本权限设置

在 Linux/Mac 系统中，需为关键脚本添加执行权限：

chmod 755 createTable.sh
chmod 755 restart.sh

注意：不设置权限可能导致数据库表无法自动创建

第五步：报警通知配置

Webfunny 支持通过钉钉机器人发送报警通知：

1. 执行 npm run init 命令生成拦截器目录
2. 修改 /interceptor/config/dingRobot.js 文件配置钉钉机器人
3. 系统还支持其他通知方式，可根据需求自行扩展

高级功能配置（可选）

消息队列（RabbitMQ）集成

对于高并发场景，建议启用消息队列：

1. 安装 RabbitMQ 服务
2. 修改 bin/messageQueue.js 文件，设置 messageQueue 为 true
3. 如需连接远程队列，调整 lib/RabbitMq.js 中的配置

数据库读写分离

提升系统性能的数据库配置：

module.exports = {
  write: {
    // 主库配置...
  },
  read: [
    { host: "从库1IP", username: "用户名", password: "密码" },
    { host: "从库2IP", username: "用户名", password: "密码" }
  ]
}

数据生成说明

系统启动后，监控数据通常需要约1小时才会开始显示在分析页面中，请耐心等待。

结语

通过以上步骤，您已经完成了 Webfunny Monitor 系统的完整部署和配置。系统提供了从基础监控到高级功能的全面解决方案，可以根据实际需求灵活配置。对于生产环境，建议在完成基础部署后，根据业务规模逐步启用高级功能以确保系统稳定性和性能。