监控平台/phoenix: “phoenix”是一个灵活可配置的开源监控平台，主要用于监控应用程序、服务器、网络设备、docker、数据库、网络、tcp端口和http接口，在发现异常时实时推送告警信息，并且提供了可视化系统进行配置、管理、查看。
phoenix: “phoenix”是一个灵活可配置的开源监控平台，主要用于监控应用程序、服务器、网络设备、docker、数据库、网络、tcp端口和http接口，在发现异常时实时推送告警信息，并且提供了可视化系统进行配置、管理、查看。 登录 注册 - 开源 - 企业版 - 高校版 - - 搜索 - 帮助中心 - 使用条款 - 关于我们 开源 企业版 高校版 私有云 模力方舟 AI 队友 登录 注册 【大赛通知】开源中国「2026上海开源软件应用创新大赛」火热报名中，百万奖池等你的项目 代码拉取完成，页面将自动刷新
社区作者 · zZz
它解决什么问题
phoenix: “phoenix”是一个灵活可配置的开源监控平台，主要用于监控应用程序、服务器、网络设备、docker、数据库、网络、tcp端口和http接口，在发现异常时实时推送告警信息，并且提供了可视化系统进行配置、管理、查看。
登录 注册
-
开源
-
企业版
-
高校版
-
-
搜索
-
帮助中心
-
使用条款
-
关于我们
开源 企业版 高校版 私有云
模力方舟
AI 队友
登录 注册
【大赛通知】开源中国「2026上海开源软件应用创新大赛」火热报名中，百万奖池等你的项目
代码拉取完成，页面将自动刷新
开源项目 > DevOps/运维/网管 > 监控系统 &&
Watch
不关注
关注所有动态
仅关注版本发行动态
关注但不提醒动态
161
Star 1.5K
Fork 382
监控平台 / phoenix
代码
Issues
6
Pull Requests
0
Wiki
统计
流水线
服务
JavaDoc
质量分析
Jenkins for Gitee
腾讯云托管
腾讯云 Serverless
悬镜安全
阿里云 SAE
Codeblitz
SBOM
开发画像分析
我知道了，不再自动展开
加入 Gitee
与超过 1400万 开发者一起发现、参与优秀开源项目，私有仓库也完全免费 ：）
免费加入
已有帐号？ 立即登录
返回
master
分支 (2)
标签 (33)
管理
管理
master
develop
v1.2.7.RELEASE
v1.2.6.RELEASE-CR5
v1.2.6.RELEASE-CR4
v1.2.6.RELEASE-CR3
v1.2.6.RELEASE-CR2
v1.2.6.RELEASE-CR1
v1.2.5.RELEASE-CR1
v1.2.6.RELEASE
v1.2.5.RELEASE
v1.2.4.RELEASE-CR8
v1.2.4.RELEASE-CR7
v1.2.4.RELEASE-CR6
v1.2.4.RELEASE-CR5
v1.2.4.RELEASE-CR4
v1.2.4.RELEASE-CR3
v1.2.4.RELEASE-CR2
v1.2.4.RELEASE-CR1
v1.2.4.RELEASE
v1.2.3.RELEASE
v1.2.2.RELEASE
克隆/下载
克隆/下载
HTTPS SSH SVN SVN+SSH
下载ZIP
提示
下载代码请复制以下命令到终端执行
为确保你提交的代码身份被 Gitee 正确识别，请执行以下命令完成配置
git config --global user.name userName 
git config --global user.email userEmail初次使用 SSH 协议进行代码克隆、推送等操作时，需按下述提示完成 SSH 配置
1 生成 RSA 密钥
2 获取 RSA 公钥内容，并配置到 SSH公钥 中
在 Gitee 上使用 SVN，请访问 使用指南
使用 HTTPS 协议时，命令行会出现如下账号密码验证步骤。基于安全考虑，Gitee 建议 配置并使用私人令牌 替代登录密码进行克隆、推送等操作
Username for 'https://gitee.com': userName
Password for 'https://[email protected]': #
私人令牌
新建文件
新建 Diagram 文件
新建子模块
上传文件
分支 2
标签 33
贡献代码
同步代码
创建 Pull Request
了解更多
对比差异
通过 Pull Request 同步
同步更新到分支
通过 Pull Request 同步
将会在向当前分支创建一个 Pull Request，合入后将完成同步
流玄青夏
Merge remote-tracking branch 'origin/devel...
9c0945a
1024 次提交
提交 取消
提示: 由于 Git 不支持空文件夾，创建文件夹后会生成空的 .keep 文件
.mvn/ wrapper
保存 取消
.qoder/repowiki/ zh
保存 取消
doc
保存 取消
mvn
保存 取消
phoenix-agent
保存 取消
phoenix-client
保存 取消
phoenix-common
保存 取消
phoenix-server
保存 取消
phoenix-ui
保存 取消
.gitattributes
保存 取消
.gitignore
保存 取消
CLAUDE.md
保存 取消
LICENSE
保存 取消
README.md
保存 取消
README_EN.md
保存 取消
license.txt
保存 取消
mvnw
保存 取消
mvnw.cmd
保存 取消
pom.xml
保存 取消
Loading...
README
GPL-3.0

 <div align="center">

# Phoenix 监控平台

**灵活可配置的开源监控平台，集监控、告警、通知于一体**

[](https://www.gnu.org/licenses/gpl-3.0.txt)
[](https://www.oracle.com/java/)
[](https://spring.io/projects/spring-boot)
[](https://mvnrepository.com/artifact/com.gitee.pifeng)
[](https://github.com/709343767/phoenix)
[](https://gitee.com/monitoring-platform/phoenix/stargazers)
[](https://gitee.com/monitoring-platform/phoenix/releases)

[在线演示](http://1.14.155.72/phoenix-ui/index) |
[微信公众号](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&__biz=MzYzMzgzNzQ5OQ==&scene=1&album_id=4442806491825356807&count=3#wechat_redirect) |
[GitCode](https://gitcode.com/monitoring-platform/phoenix) |
[Gitee](https://gitee.com/monitoring-platform/phoenix) |
[GitHub](https://github.com/709343767/phoenix)

中文 | [English](README_EN.md)

</div>

---

## 📖 目录

- [项目简介](#-项目简介)
- [核心特性](#-核心特性)
- [功能对比](#-功能对比)
- [系统架构](#-系统架构)
- [技术栈](#-技术栈)
- [工程结构](#-工程结构)
- [快速开始](#-快速开始)
- [客户端接入](#-客户端接入)
- [功能截图](#-功能截图)
- [技术博客](#-技术博客)
- [在线演示](#-在线演示)
- [贡献指南](#-贡献指南)
- [版权许可](#-版权许可)
- [联系我们](#-联系我们)
- [捐赠支持](#-捐赠支持)
- [Star 历史](#-star-历史)

## 💡 项目简介

**Phoenix** 是一个灵活可配置的开源监控平台，主要用于监控应用程序、服务器、网络设备、Docker、数据库、网络、TCP端口和HTTP接口。通过实时收集、汇聚和分析监控信息，实现在发现异常时立刻推送告警信息，并且提供了可视化系统进行配置、管理和查看。

> 开源不等同于免费，允许基于 Phoenix 进行二次开发，但不得修改 logo、名称、版权等。

### 🏆 G-Star 认证

Phoenix 已通过 **GitCode G-Star 毕业项目认证**。

<img src="doc/其它/Phoenix GitCode G-Star 毕业项目认证.jpg" alt="G-Star认证" width="500"/>

## ✨ 核心特性

- **🖥️ 全栈监控** — 从应用到基础设施的一站式监控，详见[功能对比](#-功能对比)
- **⚡ 实时告警** — 多渠道通知 + 四级告警机制（INFO/WARN/ERROR/FATAL）
- **🔧 灵活配置** — 灵活的告警定义引擎，监控策略可动态调整
- **🌐 分布式架构** — 支持集群部署，代理端可部署于跳板机打通网络壁垒
- **🔒 数据安全** — 支持数据加密传输，保障监控数据安全
- **🐳 容器化部署** — Docker / Docker Compose 一键部署，10分钟完成安装
- **📱 多端支持** — Web界面同时支持PC端和移动端
- **🔄 动态线程池** — 运行时查看和修改线程池参数，支持7种队列类型、6种拒绝策略 + SPI扩展
- **📡 拓展性强** — 多协议通信架构，可拓展监控其它编程语言编写的程序

## 🔍 功能对比

Phoenix 提供两个版本：**开源版（1.x）** 和 **商用版（2.x）**。开源版包含核心监控能力，适合个人学习和小型项目；商用版在此基础上扩展了 Docker 监控、网络设备管理、在线诊断、动态线程池、慢SQL监控、企业通知渠道、业务异常日志采集等高级功能，适合企业级生产环境。

> 💰 标记表示商用版专属收费功能。

| 功能模块 | 功能 | 监控内容 | 开源版(1.x) | 商用版(2.x) |
|:---------|:-----|:---------|:----------:|:----------:|
| **服务器监控** | 服务器资源监控 | 在线状态、操作系统、CPU、平均负载、内存、磁盘、网卡、电池、传感器、进程 | ✅ | ✅ |
| **Java应用监控** | JVM监控 | JVM概要、内存、线程、类加载、GC | ✅ | ✅ |
| | 应用实例状态监控 | 在线状态 | ✅ | ✅ |
| | 业务埋点监控 | 业务埋点 | ✅ | ✅ |
| | 动态线程池监控与管理 | 线程池参数查看与动态修改 | ❌ | 💰 |
| | Arthas在线JVM诊断 | JVM在线诊断 | ❌ | 💰 |
| **网络监控** | HTTP接口监控 | 接口可用性 | ✅ | ✅ |
| | TCP端口监控 | Telnet端口状态 | ✅ | ✅ |
| | Ping网络连通性监控 | 网络连通性 | ✅ | ✅ |
| | 网络设备SNMP监控 | 交换机、路由器等：在线状态、系统信息、接口信息 | ❌ | 💰 |
| **数据库监控** | 数据库连接状态监控 | MySQL、Oracle、Redis、MongoDB在线状态与会话 | ✅ | ✅ |
| | 数据库慢SQL监控 | MySQL慢SQL、Oracle慢SQL与表空间 | ❌ | 💰 |
| **Docker监控** | Docker完整监控 | 服务状态、容器、镜像、事件、资源统计 | ❌ | 💰 |
| **告警系统** | 告警通知（邮件 / 短信） | 四级告警（INFO/WARN/ERROR/FATAL） | ✅ | ✅ |
| | 告警通知（钉钉 / 企业微信 / 飞书） | 多渠道企业通知 | ❌ | 💰 |
| | 告警次数配置（故障 / 恢复） | 故障与恢复告警次数阈值 | ❌ | 💰 |
| **日志管理** | 操作日志管理 | 操作日志记录、查看、管理 | ✅ | ✅ |
| | 异常日志管理 | 异常日志记录、查看、管理 | ✅ | ✅ |
| | 业务异常日志采集 | 客户端异常日志采集 | ❌ | 💰 |
| **通信架构** | HTTP通信 | 基础HTTP通信 | ✅ | ✅ |
| | WebSocket通信 | WebSocket实时通信 | ❌ | 💰 |
| **可视化界面** | 基础监控仪表盘 | PC端和移动端监控面板 | ✅ | ✅ |
| | Docker管理界面 | Docker管理与监控页面 | ❌ | 💰 |
| | 网络设备管理界面 | 网络设备管理与监控页面 | ❌ | 💰 |
| | 网络拓扑图 | 拓扑图展示 | ❌ | 💰 |
| | Web终端仿真 | 在线终端 | ❌ | 💰 |
| | Arthas诊断界面 | Arthas诊断操作页面 | ❌ | 💰 |

> 📮 **获取商业版**：如需获取商业版授权或了解更多详情，请查看[《商用版定价方案》](doc/商用版定价方案.pdf)或联系作者（微信：pifengeclipse），更多联系方式详见[联系我们](#-联系我们)。

## 🏗️ 系统架构


## 🛠️ 技术栈

| 类别 | 技术 |
|:-----|:-----|
| **核心框架** | Spring Boot 、Netty |
| **安全框架** | Spring Security 、Spring Session |
| **持久层** | MyBatis-Plus 、Alibaba Druid |
| **任务调度** | JUC 、Spring Task 、Quartz |
| **服务器监控** | Sigar / OSHI |
| **网络设备监控** | SNMP4J |
| **Docker监控** | docker-java |
| **JVM诊断** | Alibaba Arthas |
| **加密** | Bouncy Castle |
| **前端框架** | Layui 、ECharts 、jtopo（拓扑图）、xterm（终端仿真） |
| **工具库** | Hutool 、FastJSON 、Jackson 、Apache Commons（IO/Collections/Net） |
| **其他** | EasyPOI（导出）、Knife4j（API文档）|

## 📦 工程结构

``
phoenix（监控平台）
├── phoenix-common（公共模块）
│ ├── phoenix-common-core -- 核心公共：线程池、数据模型、工具类、加解密
│ ├── phoenix-common-netty -- Netty通信：WebSocket、长连接、断线重连
│ └── phoenix-common-web -- Web公共：REST API 基础设施
├── phoenix-client（客户端SDK）
│ ├── phoenix-client-core -- 核心：数据收集、心跳、业务埋点
│ ├── phoenix-client-spring-boot-starter -- Spring Boot 自动配置
│ └── phoenix-client-spring-mvc-integrator -- Spring MVC 适配
├── phoenix-agent -- 代理端：服务器/Docker/SNMP 数据采集
├── phoenix-server -- 服务端：数据处理、告警引擎、配置下发
├── phoenix-ui -- 可视化UI：Web 管理界面
├── doc -- 文档：架构图、截图、数据库脚本、部署脚本、技术博客
└── mvn -- Maven打包脚本
``

## 🚀 快速开始

> 一键安装：**10 分钟**即可完成自动安装 
> 最低资源需求：**1核 CPU / 2 GB 内存 / 5 GB 磁盘**

### Docker 安装（推荐）

软件依赖：
Docker 20.10.14+

```bash
bash -c "$(curl -fsSL https://gitee.com/monitoring-platform/phoenix/raw/master/doc/Docker/install.sh)"
```

### Docker Compose 安装

软件依赖：Docker Compose 2.0.0+

```bash
bash -c "$(curl -fsSL https://gitee.com/monitoring-platform/phoenix/raw/master/doc/DockerCompose/install.sh)"
```

### 安装 Agent（监控服务器时需要）

``bash
bash -c "$(curl -fsSL https://gitee.com/monitoring-platform/phoenix/raw/master/doc/Docker/phoenix-agent/install_agent.sh)"


### 配置说明

**phoenix-server 配置：**
1. 从源码目录 phoenix-server/src/main/resources/ 复制 application-prod.yml
2. 放置于 /data/phoenix/phoenix-server/config/
3. 编辑该文件，配置邮件等告警渠道
4. 重启 phoenix-server 容器

**phoenix-agent 配置：**
1. 从源码目录 phoenix-agent/src/main/resources/ 复制 monitoring-prod.properties
2. 放置于 /data/phoenix/phoenix-agent/config/
3. 将 monitoring.comm.http.url 配置为 http://<server-ip>:16000/phoenix-server
4. 重启 phoenix-agent 容器

安装完成后访问：http://<ui-ip>/phoenix-ui/index，初始账号 admin / admin123、guest / guest123

## 📥 客户端接入

Maven Central 最新稳定版本：**1.2.7.RELEASE**

**普通 Java 程序：**
xml
<dependency>
 <groupId>com.gitee.pifeng</groupId>
 <artifactId>phoenix-client-core</artifactId>
 <version>1.2.7.RELEASE</version>
</dependency>


**Spring Boot 程序：**
xml
<dependency>
 <groupId>com.gitee.pifeng</groupId>
 <artifactId>phoenix-client-spring-boot-starter</artifactId>
 <version>1.2.7.RELEASE</version>
</dependency>


**Spring MVC 程序：**
xml
<dependency>
 <groupId>com.gitee.pifeng</groupId>
 <artifactId>phoenix-client-spring-mvc-integrator</artifactId>
 <version>1.2.7.RELEASE</version>
</dependency>


## 📸 功能截图

<details>
<summary><b>🏠 首页总览</b></summary>
<br/>

</details>

<details>
<summary><b>🖥️ 服务器监控</b></summary>
<br/>

</details>

<details>
<summary><b>☕ 应用程序监控</b></summary>
<br/>

</details>

<details>
<summary><b>🗄️ 数据库监控</b></summary>
<br/>

</details>

<details>
<summary><b>🌐 网络 / TCP / HTTP 监控</b></summary>
<br/>

</details>

<details>
<summary><b>🐳 Docker 监控</b></summary>
<br/>

</details>

<details>
<summary><b>🗺️ 拓扑图</b></summary>
<br/>

</details>

<details>
<summary><b>🔔 告警管理</b></summary>
<br/>

</details>

<details>
<summary><b>⚙️ 系统管理</b></summary>
<br/>

</details>

## 📚 技术博客

共 **60+** 篇深度技术文章（持续更新中），涵盖架构设计与核心实现：

| 系列 | 篇数 | 内容 |
|:-----|:----:|:-----|
| 通信与数据安全 | 7 | 全景概览、HTTP通信、WebSocket通信、Netty服务端、Netty客户端、加解密、数据压缩 |
| 客户端SDK | 8 | Monitor入口、心跳机制、配置加载、JVM采集、线程池采集、Spring Boot集成、Spring MVC集成、业务埋点 |
| 代理端 | 7 | 整体架构、服务器采集（上）、服务器采集（下）、Docker采集、Docker Stats、SNMP采集、数据转发 |
| 服务端核心 | 10 | 数据接收、并行处理、实例管理、服务器监控、Docker监控、数据库监控、慢SQL检测、网络监测、分布式锁、实时监控表 |
| 告警引擎 | 7 | 告警定义、触发流程、邮件通道、钉钉通道、企业微信通道、飞书通道、告警收敛 |
| UI端与安全 | 7 | UI架构、SpringSecurity认证、CAS单点登录、验证码、日志、前端交互、拓扑图 |
| 线程池监控 | 3 | 注册体系、动态调参、历史趋势 |
| 公共模块与工程化 | 4 | DTO体系、Domain模型、HTTP加解密切面、Maven多模块管理 |
| 部署与运维 | 4 | Docker部署、Docker Compose、服务化部署、集群高可用 |
| 数据库设计 | 3 | 表分域与索引策略、实时+历史双表模式、Quartz调度表 |

👉 阅读博客：[个人博客](https://kacper.fun/types/28) | [微信公众号](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&__biz=MzYzMzgzNzQ5OQ==&scene=1&album_id=4442806491825356807&count=3#wechat_redirect)

👉 扫码关注微信公众号，获取更多技术干货

<img src="doc/其它/wx_gzh.jpg" width="300" />

## 🖥️ 在线演示

| 演示地址 | 账号 | 密码 |
|:---------|:-----|:-----|
| [http://1.14.155.72/phoenix-ui/index](http://1.14.155.72/phoenix-ui/index) | guest | guest123 |

> **提示：** 演示环境仅提供查看权限，访问速度受限于服务器带宽。

## 🤝 贡献指南

欢迎提出更好的意见，帮助完善 Phoenix！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/your-feature)
3. 提交更改 (git commit -m 'Add your feature')
4. 推送到分支 (git push origin feature/your-feature)
5. 提交 Pull Request

💡 [升级日志](https://gitee.com/monitoring-platform/phoenix/wikis/pages?sort_id=4420016&doc_id=935794)

## 📄 版权许可

[](https://www.gnu.org/licenses/gpl-3.0.txt)

本项目基于 [GPLv3](https://www.gnu.org/licenses/gpl-3.0.txt) 协议开源，请遵守协议要求。

## 📬 联系我们

| 方式 | 信息 |
|:-----|:-----|
| 作者微信 | pifengeclipse |
| 作者QQ | 709343767` |
| QQ交流群 | [](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=qEfrXWBpzslfYc9QrTQJwx1Kty0sC3Ee&authKey=0GQGNvA5G0SLWZgRyn9EjX3Uta0WLAGuzSmrGqNWAnaUTU5LzRTZovcB2ivgE%2BFm&noverify=0&group_code=773127639) |

## 💰 捐赠支持

如果 Phoenix 对你有帮助，欢迎捐赠支持项目持续发展！

<img src="doc/其它/donate.jpg" alt="捐赠" width="400"/>

## ⭐ Star 历史

### GitHub

[](https://star-history.com/#709343767/phoenix&Date)

### GitCode

[](https://gitcode.com/monitoring-platform/phoenix) 
 


 


 GNU GENERAL PUBLIC LICENSE
 Version 3, 29 June 2007

 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.
org/>
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.


 Preamble

 The GNU General Public License is a free, copyleft license for
software and other kinds of works.


 The licenses for most software and other practical works are designed
to take away your freedom to share and change the works.
By contrast,
the GNU General Public License is intended to guarantee your freedom to
share and change all versions of a program--to make sure it remains free
software for all its users.
We, the Free Software Foundation, use the
GNU General Public License for most of our software; it applies also to
any other work released this way by its authors. You can apply it to
your programs, too.


 When we speak of free software, we are referring to freedom, not
price.
Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.


 To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights.
Therefore, you have
certain responsibilities if you distribute copies of the software, or if
you modify it: responsibilities to respect the freedom of others.


 For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received.
You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.


 Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.


 For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software.
For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.


 Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the manufacturer
can do so.
This is fundamentally incompatible with the aim of
protecting users' freedom to change the software.
The systematic
pattern of such abuse occurs in the area of products for individuals to
use, which is precisely where it is most unacceptable.
Therefore, we
have designed this version of the GPL to prohibit the practice for those
products.
If such problems arise substantially in other domains, we
stand ready to extend this provision to those domains in future versions
of the GPL, as needed to protect the freedom of users.


 Finally, every program is threatened constantly by software patents.

States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish to
avoid the special danger that patents applied to a free program could
make it effectively proprietary.
To prevent this, the GPL assures that
patents cannot be used to render the program non-free.

 The precise terms and conditions for copying, distribution and
modification follow.


 TERMS AND CONDITIONS

 0. Definitions.

 "This License" refers to version 3 of the GNU General Public License.


 "Copyright" also means copyright-like laws that apply to other kinds of
works, such as semiconductor masks.

 "The Program" refers to any copyrightable work licensed under this
License.
Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.


 To "modify" a work means to copy from or adapt all or part of the work
in a fashion requiring copyright permission, other than the making of an
exact copy.
The resulting work is called a "modified version" of the
earlier work or a work "based on" the earlier work.

 A "covered work" means either the unmodified Program or a work based
on the Program.


 To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on a
computer or modifying a private copy.
Propagation includes copying,
distribution (with or without modification), making available to the
public, and in some countries other activities as well.


 To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user through
a computer network, with no transfer of a copy, is not conveying.


 An interactive user interface displays "Appropriate Legal Notices"
to the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to the
extent that warranties are provided), that licensees may convey the
work under this License, and how to view a copy of this License.
If
the interface presents a list of user commands or options, such as a
menu, a prominent item in the list meets this criterion.

 1. Source Code.


 The "source code" for a work means the preferred form of the work
for making modifications to it. "Object code" means any non-source
form of a work.


 A "Standard Interface" means an interface that either is an official
standard defined by a recognized standards body, or, in the case of
interfaces specified for a particular programming language, one that
is widely used among developers working in that language.


 The "System Libraries" of an executable work include anything, other
than the work as a whole, that (a) is included in the normal form of
packaging a Major Component, but which is not part of that Major
Component, and (b) serves only to enable use of the work with that
Major Component, or to implement a Standard Interface for which an
implementation is available to the public in source code form.
A
"Major Component", in this context, means a major essential component
(kernel, window system, and so on) of the specific operating system
(if any) on which the executable work runs, or a compiler used to
produce the work, or an object code interpreter used to run it.


 The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts to
control those activities.
However, it does not include the work's
System Libraries, or general-purpose tools or generally available free
programs which are used unmodified in performing those activities but
which are not part of the work.
For example, Corresponding Source
includes interface definition files associated with source files for
the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require,
such as by intimate data communication or control flow between those
subprograms and other parts of the work.


 The Corresponding Source need not include anything that users
can regenerate automatically from other parts of the Corresponding
Source.


 The Corresponding Source for a work in source code form is that
same work.

 2. Basic Permissions.


 All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met.
This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its
content, constitutes a covered work.
This License acknowledges your
rights of fair use or other equivalent, as provided by copyright law.


 You may make, run and propagate covered works that you do not
convey, without conditions so long as your license otherwise remains
in force.
You may convey covered works to others for the sole purpose
of having them make modifications exclusively for you, or provide you
with facilities for running those works, provided that you comply with
the terms of this License in conveying all material for which you do
not control copyright.
Those thus making or running the covered works
for you must do so exclusively on your behalf, under your direction
and control, on terms that prohibit them from making any copies of
your copyrighted material outside their relationship with you.


 Conveying under any other circumstances is permitted solely under
the conditions stated below. Sublicensing is not allowed; section 10
makes it unnecessary.

 3.
Protecting Users' Legal Rights From Anti-Circumvention Law.


 No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under article
11 of the WIPO copyright treaty adopted on 20 December 1996, or
similar laws prohibiting or restricting circumvention of such
measures.


 When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such circumvention
is effected by exercising rights under this License with respect to
the covered work, and you disclaim any intention to limit operation or
modification of the work as a means of enforcing, against the work's
users, your or third parties' legal rights to forbid circumvention of
technological measures.


 4. Conveying Verbatim Copies.


 You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the code;
keep intact all notices of the absence of any warranty; and give all
recipients a copy of this License along with the Program.


 You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.

 5. Conveying Modified Source Versions.

 You may convey a work based
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用

 <div align="center">

# Phoenix 监控平台

**灵活可配置的开源监控平台，集监控、告警、通知于一体**

[](https://www.gnu.org/licenses/gpl-3.0.txt)
[](https://www.oracle.com/java/)
[](https://spring.io/projects/spring-boot)
[](https://mvnrepository.com/artifact/com.gitee.pifeng)
[](https://github.com/709343767/phoenix)
[](https://gitee.com/monitoring-platform/phoenix/stargazers)
[](https://gitee.com/monitoring-platform/phoenix/releases)

[在线演示](http://1.14.155.72/phoenix-ui/index) |
[微信公众号](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&__biz=MzYzMzgzNzQ5OQ==&scene=1&album_id=4442806491825356807&count=3#wechat_redirect) |
[GitCode](https://gitcode.com/monitoring-platform/phoenix) |
[Gitee](https://gitee.com/monitoring-platform/phoenix) |
[GitHub](https://github.com/709343767/phoenix)

中文 | [English](README_EN.md)

</div>

---

## 📖 目录

- [项目简介](#-项目简介)
- [核心特性](#-核心特性)
- [功能对比](#-功能对比)
- [系统架构](#-系统架构)
- [技术栈](#-技术栈)
- [工程结构](#-工程结构)
- [快速开始](#-快速开始)
- [客户端接入](#-客户端接入)
- [功能截图](#-功能截图)
- [技术博客](#-技术博客)
- [在线演示](#-在线演示)
- [贡献指南](#-贡献指南)
- [版权许可](#-版权许可)
- [联系我们](#-联系我们)
- [捐赠支持](#-捐赠支持)
- [Star 历史](#-star-历史)

## 💡 项目简介

**Phoenix** 是一个灵活可配置的开源监控平台，主要用于监控应用程序、服务器、网络设备、Docker、数据库、网络、TCP端口和HTTP接口。通过实时收集、汇聚和分析监控信息，实现在发现异常时立刻推送告警信息，并且提供了可视化系统进行配置、管理和查看。

> 开源不等同于免费，允许基于 Phoenix 进行二次开发，但不得修改 logo、名称、版权等。

### 🏆 G-Star 认证

Phoenix 已通过 **GitCode G-Star 毕业项目认证**。

<img src="doc/其它/Phoenix GitCode G-Star 毕业项目认证.jpg" alt="G-Star认证" width="500"/>

## ✨ 核心特性

- **🖥️ 全栈监控** — 从应用到基础设施的一站式监控，详见[功能对比](#-功能对比)
- **⚡ 实时告警** — 多渠道通知 + 四级告警机制（INFO/WARN/ERROR/FATAL）
- **🔧 灵活配置** — 灵活的告警定义引擎，监控策略可动态调整
- **🌐 分布式架构** — 支持集群部署，代理端可部署于跳板机打通网络壁垒
- **🔒 数据安全** — 支持数据加密传输，保障监控数据安全
- **🐳 容器化部署** — Docker / Docker Compose 一键部署，10分钟完成安装
- **📱 多端支持** — Web界面同时支持PC端和移动端
- **🔄 动态线程池** — 运行时查看和修改线程池参数，支持7种队列类型、6种拒绝策略 + SPI扩展
- **📡 拓展性强** — 多协议通信架构，可拓展监控其它编程语言编写的程序

## 🔍 功能对比

Phoenix 提供两个版本：**开源版（1.x）** 和 **商用版（2.x）**。开源版包含核心监控能力，适合个人学习和小型项目；商用版在此基础上扩展了 Docker 监控、网络设备管理、在线诊断、动态线程池、慢SQL监控、企业通知渠道、业务异常日志采集等高级功能，适合企业级生产环境。

> 💰 标记表示商用版专属收费功能。

| 功能模块 | 功能 | 监控内容 | 开源版(1.x) | 商用版(2.x) |
|:---------|:-----|:---------|:----------:|:----------:|
| **服务器监控** | 服务器资源监控 | 在线状态、操作系统、CPU、平均负载、内存、磁盘、网卡、电池、传感器、进程 | ✅ | ✅ |
| **Java应用监控** | JVM监控 | JVM概要、内存、线程、类加载、GC | ✅ | ✅ |
| | 应用实例状态监控 | 在线状态 | ✅ | ✅ |
| | 业务埋点监控 | 业务埋点 | ✅ | ✅ |
| | 动态线程池监控与管理 | 线程池参数查看与动态修改 | ❌ | 💰 |
| | Arthas在线JVM诊断 | JVM在线诊断 | ❌ | 💰 |
| **网络监控** | HTTP接口监控 | 接口可用性 | ✅ | ✅ |
| | TCP端口监控 | Telnet端口状态 | ✅ | ✅ |
| | Ping网络连通性监控 | 网络连通性 | ✅ | ✅ |
| | 网络设备SNMP监控 | 交换机、路由器等：在线状态、系统信息、接口信息 | ❌ | 💰 |
| **数据库监控** | 数据库连接状态监控 | MySQL、Oracle、Redis、MongoDB在线状态与会话 | ✅ | ✅ |
| | 数据库慢SQL监控 | MySQL慢SQL、Oracle慢SQL与表空间 | ❌ | 💰 |
| **Docker监控** | Docker完整监控 | 服务状态、容器、镜像、事件、资源统计 | ❌ | 💰 |
| **告警系统** | 告警通知（邮件 / 短信） | 四级告警（INFO/WARN/ERROR/FATAL） | ✅ | ✅ |
| | 告警通知（钉钉 / 企业微信 / 飞书） | 多渠道企业通知 | ❌ | 💰 |
| | 告警次数配置（故障 / 恢复） | 故障与恢复告警次数阈值 | ❌ | 💰 |
| **日志管理** | 操作日志管理 | 操作日志记录、查看、管理 | ✅ | ✅ |
| | 异常日志管理 | 异常日志记录、查看、管理 | ✅ | ✅ |
| | 业务异常日志采集 | 客户端异常日志采集 | ❌ | 💰 |
| **通信架构** | HTTP通信 | 基础HTTP通信 | ✅ | ✅ |
| | WebSocket通信 | WebSocket实时通信 | ❌ | 💰 |
| **可视化界面** | 基础监控仪表盘 | PC端和移动端监控面板 | ✅ | ✅ |
| | Docker管理界面 | Docker管理与监控页面 | ❌ | 💰 |
| | 网络设备管理界面 | 网络设备管理与监控页面 | ❌ | 💰 |
| | 网络拓扑图 | 拓扑图展示 | ❌ | 💰 |
| | Web终端仿真 | 在线终端 | ❌ | 💰 |
| | Arthas诊断界面 | Arthas诊断操作页面 | ❌ | 💰 |

> 📮 **获取商业版**：如需获取商业版授权或了解更多详情，请查看[《商用版定价方案》](doc/商用版定价方案.pdf)或联系作者（微信：pifengeclipse），更多联系方式详见[联系我们](#-联系我们)。

## 🏗️ 系统架构


## 🛠️ 技术栈

| 类别 | 技术 |
|:-----|:-----|
| **核心框架** | Spring Boot 、Netty |
| **安全框架** | Spring Security 、Spring Session |
| **持久层** | MyBatis-Plus 、Alibaba Druid |
| **任务调度** | JUC 、Spring Task 、Quartz |
| **服务器监控** | Sigar / OSHI |
| **网络设备监控** | SNMP4J |
| **Docker监控** | docker-java |
| **JVM诊断** | Alibaba Arthas |
| **加密** | Bouncy Castle |
| **前端框架** | Layui 、ECharts 、jtopo（拓扑图）、xterm（终端仿真） |
| **工具库** | Hutool 、FastJSON 、Jackson 、Apache Commons（IO/Collections/Net） |
| **其他** | EasyPOI（导出）、Knife4j（API文档）|

## 📦 工程结构

``
phoenix（监控平台）
├── phoenix-common（公共模块）
│ ├── phoenix-common-core -- 核心公共：线程池、数据模型、工具类、加解密
│ ├── phoenix-common-netty -- Netty通信：WebSocket、长连接、断线重连
│ └── phoenix-common-web -- Web公共：REST API 基础设施
├── phoenix-client（客户端SDK）
│ ├── phoenix-client-core -- 核心：数据收集、心跳、业务埋点
│ ├── phoenix-client-spring-boot-starter -- Spring Boot 自动配置
│ └── phoenix-client-spring-mvc-integrator -- Spring MVC 适配
├── phoenix-agent -- 代理端：服务器/Docker/SNMP 数据采集
├── phoenix-server -- 服务端：数据处理、告警引擎、配置下发
├── phoenix-ui -- 可视化UI：Web 管理界面
├── doc -- 文档：架构图、截图、数据库脚本、部署脚本、技术博客
└── mvn -- Maven打包脚本
``

## 🚀 快速开始

> 一键安装：**10 分钟**即可完成自动安装 
> 最低资源需求：**1核 CPU / 2 GB 内存 / 5 GB 磁盘**

### Docker 安装（推荐）

软件依赖：
Docker 20.10.14+

```bash
bash -c "$(curl -fsSL https://gitee.com/monitoring-platform/phoenix/raw/master/doc/Docker/install.sh)"
```

### Docker Compose 安装

软件依赖：Docker Compose 2.0.0+

```bash
bash -c "$(curl -fsSL https://gitee.com/monitoring-platform/phoenix/raw/master/doc/DockerCompose/install.sh)"
```

### 安装 Agent（监控服务器时需要）

``bash
bash -c "$(curl -fsSL https://gitee.com/monitoring-platform/phoenix/raw/master/doc/Docker/phoenix-agent/install_agent.sh)"


### 配置说明

**phoenix-server 配置：**
1. 从源码目录 phoenix-server/src/main/resources/ 复制 application-prod.yml
2. 放置于 /data/phoenix/phoenix-server/config/
3. 编辑该文件，配置邮件等告警渠道
4. 重启 phoenix-server 容器

**phoenix-agent 配置：**
1. 从源码目录 phoenix-agent/src/main/resources/ 复制 monitoring-prod.properties
2. 放置于 /data/phoenix/phoenix-agent/config/
3. 将 monitoring.comm.http.url 配置为 http://<server-ip>:16000/phoenix-server
4. 重启 phoenix-agent 容器

安装完成后访问：http://<ui-ip>/phoenix-ui/index，初始账号 admin / admin123、guest / guest123

## 📥 客户端接入

Maven Central 最新稳定版本：**1.2.7.RELEASE**

**普通 Java 程序：**
xml
<dependency>
 <groupId>com.gitee.pifeng</groupId>
 <artifactId>phoenix-client-core</artifactId>
 <version>1.2.7.RELEASE</version>
</dependency>


**Spring Boot 程序：**
xml
<dependency>
 <groupId>com.gitee.pifeng</groupId>
 <artifactId>phoenix-client-spring-boot-starter</artifactId>
 <version>1.2.7.RELEASE</version>
</dependency>


**Spring MVC 程序：**
xml
<dependency>
 <groupId>com.gitee.pifeng</groupId>
 <artifactId>phoenix-client-spring-mvc-integrator</artifactId>
 <version>1.2.7.RELEASE</version>
</dependency>
``

## 📸 功能截图

<details>
<summary><b>🏠 首页总览</b></summary>
<br/>

</details>

<details>
<summary><b>🖥️ 服务器监控</b></summary>
<br/>

</details>

<details>
<summary><b>☕ 应用程序监控</b></summary>
<br/>

</details>

<details>
<summary><b>🗄️ 数据库监控</b></summary>
<br/>

</details>

<details>
<summary><b>🌐 网络 / TCP / HTTP 监控</b></summary>
<br/>

</details>

<details>
<summary><b>🐳 Docker 监控</b></summary>
<br/>

