在 Mac 上部署美团点评开源的 CAT 监控服务端，可以按照以下步骤操作：
1. 环境准备
1.1 安装依赖
确保已安装以下工具：
-
JDK 8+（建议 OpenJDK 11）
-
MySQL 5.7+（存储监控数据）（8.0+不支持。。）
如果需要支持8.0，可以使用这个工程
https://github.com/lazeyliu/cat（最低支持tomcat-10。。）
https://github.com/carlzhangweiwen/cat（编译不通过）
-
Maven 3.6+（构建 CAT 源码）
-
Tomcat 8/9（部署 CAT Web 控制台）
通过 Homebrew 安装：
# 安装 Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装依赖
brew install openjdk@11 mysql maven tomcat@9
1.2 配置环境变量
在 ~/.zshrc 或 ~/.bash_profile 中添加：
# Java
export JAVA_HOME=/usr/local/opt/openjdk@11
export PATH=$JAVA_HOME/bin:$PATH
# Maven
export MAVEN_HOME=/usr/local/Cellar/maven/3.8.6
export PATH=$MAVEN_HOME/bin:$PATH
# Tomcat
export CATALINA_HOME=/usr/local/opt/tomcat@9/libexec
export PATH=$CATALINA_HOME/bin:$PATH
生效配置：
source ~/.zshrc
2. 初始化 MySQL 数据库
2.1 启动 MySQL
brew services start mysql
2.2 创建 CAT 数据库
登录 MySQL：
mysql -u root -p
执行以下 SQL：
-- 创建数据库
CREATE DATABASE `cat` DEFAULT CHARACTER SET utf8mb4;
-- 创建用户并授权
CREATE USER 'cat'@'localhost' IDENTIFIED BY 'cat_password';
GRANT ALL PRIVILEGES ON `cat`.* TO 'cat'@'localhost';
FLUSH PRIVILEGES;
2.3 导入 CAT 初始表结构
下载 CAT 源码并导入 SQL：
git clone https://github.com/dianping/cat.git
cd cat/script
mysql -u cat -p cat < CatApplication.sql
mysql -u cat -p cat < CatDailyReport.sql
输入密码 cat_password（与 SQL 中配置一致）。
3. 编译 CAT 服务端
3.1 下载源码
git clone https://github.com/dianping/cat.git
cd cat
3.2 修改数据库配置
在Linux系统安装时，CAT应用要求对/data/appdatas/cat和/data/applogs/cat路径有读写权限。
CAT服务端应用会对这两个目录进行读写操作，因此需要首先创建这两个目录。并且应确保启动CAT应用的用户对这两个目录有读写权限。
服务端部署/data/appdatas/cat/client.xml和 server.xml配置无用(限3.0+war包)，可以去掉
部署。
需要在data目录下创建文件夹：
# mkdir -p /data/appdatas/cat && mkdir -p /data/applogs/cat
如果提示mkdir: /data: Read-only file system，表示mac根目录无法创建文件夹，则可以通过软链解决，具体解决方法查看：
https://blog.csdn.net/youwen21/article/details/115000907
编辑文件 cat-home/src/main/resources/datasources.xml：
<?xml version="1.0" encoding="utf-8"?>
<data-sources>
<data-source id="cat">
<properties>
<driver>com.mysql.jdbc.Driver</driver>
<url>jdbc:mysql://127.0.0.1:3306/cat</url>
<user>cat</user>
<password>cat_password</password>
<connectionProperties>useUnicode=true&characterEncoding=UTF-8&autoReconnect=true</connectionProperties>
</properties>
</data-source>
</data-sources>
3.3 编译打包
mvn clean install -DskipTests
编译成功后，生成以下文件：
-
cat-home/target/cat-home.war（Web 控制台） -
cat-client/target/cat-client.jar（客户端依赖）cat-client.jar目前没有maven仓库下载，需要自己上传到自己的私服，或者存放到本地依赖目录。
自己编译的部署有问题，最好还是下载官方提供的war包吧https://github.com/dianping/cat/releases/tag/3.1.0
4. 部署到 Tomcat
4.1 复制 WAR 包到 Tomcat
cp cat-home/target/cat-home.war $CATALINA_HOME/webapps/
4.2 启动 Tomcat
catalina start
访问控制台：
http://localhost:8080/cat
默认账号：admin，密码：admin。
5. 配置 CAT 服务端
5.1 开放端口
确保以下端口可用：
- 8080：Tomcat Web 端口（CAT 控制台）
- 2280：CAT 服务端 TCP 端口（客户端上报数据）
5.2 修改服务端配置（可选）
编辑 cat-home/src/main/resources/server.xml，调整服务端参数：
<config local-mode="true">
<server id="default">
<property name="local-mode" value="true"/>
<property name="http-port" value="8080"/>
<property name="tcp-port" value="2280"/>
</server>
</config>
6. 验证部署
6.1 检查 CAT 控制台
登录后查看以下报表是否正常：
- Transaction：事务统计
- Event：自定义事件
- Heartbeat：心跳检测
6.2 客户端测试
在 Spring Boot 应用的 cat-client.xml 中配置：
<servers>
<server ip="localhost" port="2280" http-port="8080"/>
</servers>
重启应用后，观察 CAT 控制台是否有数据上报。
常见问题排查
1. 控制台无法访问
把文件cat.war (如果叫cat-home.war 重命名为cat.war)
常见问题：https://www.cnblogs.com/jingch/p/17141552.html
http://localhost:8080/cat/s/config?op=serverConfigUpdate
-
检查 Tomcat 是否启动：
ps aux | grep tomcat -
查看 Tomcat 日志：
tail -f $CATALINA_HOME/logs/catalina.out
2. 客户端数据未上报
-
验证端口连通性：
telnet localhost 2280 -
检查
cat-client.xml中的服务端 IP 和端口。
3. 数据库连接失败
-
检查 MySQL 用户权限：
SHOW GRANTS FOR 'cat'@'localhost'; -
确认 SQL 脚本已完整导入。
优化建议
-
数据清理策略
修改cat-home/src/main/resources/datasources.xml，配置自动清理历史数据：<property name="hdfs-clean-period">86400</property> <!-- 清理周期（秒） --> -
集群部署
若需高可用，可部署多个 CAT 服务端节点，并配置负载均衡。
通过以上步骤，即可在 Mac 上完成 CAT 监控服务端的部署。如果遇到问题，可根据日志和端口连通性逐步排查。
