根因:InfluxDB 写点用真实 UTC(_get_utc_now),但流量接口 用 naive 本地时间 datetime.now() 算窗口。容器时区是 Asia/Shanghai(UTC+8),查询层又把 naive 时间当作 UTC,于 是 1 小时窗口被整体推后 8 小时、落在未来,永远查不到点。 接口表能显示最新值(aquery_latest 不用时间窗口),只有带时 间范围的流量图受影响。 修法:改用代码库已有的 utc_now_naive()(naive UTC),与 monitor 趋势接口保持一致。验证:18:34 CST 时旧窗口为 17:34Z (未来,无数据)、新窗口为 09:34Z(覆盖最近 1h,60 个点全在 窗口内)。后端 69/69 测试通过。
IPMI Monitor
基于 Web 的 IPMI 服务器硬件监控系统,定时采集服务器温度、风扇转速、电压、电源功耗等传感器指标,支持按规则告警(邮件 / 飞书通知)与历史数据查询、CSV 导出。
功能特性
- 🖥️ 多服务器管理 — 添加、管理多台 IPMI 服务器,按分组组织,支持连接测试与启用开关
- 🌐 网络设备监控 — 通过 SNMP 采集 H3C 交换机 / 路由器(CPU、内存、温度、接口流量与状态),与 IPMI 采集共用同一轮询、存储与告警链路
- 📊 定时采集 — 每 60 秒(可配)用
ipmitool sdr elist轮询 BMC,写入 InfluxDB(无 WebSocket/SSE 实时推送) - 📈 历史趋势 — 基于 InfluxDB 时序数据,仪表盘提供温度 / 功耗趋势图(ECharts),支持多主机历史查询与 CSV 导出
- ⚠️ 智能告警 — 逐条配置告警规则(条件 gt/lt/eq/gte/lte、持续时长、冷却 3 小时、恢复通知),按主机 / 分组 / 全局生效
- 📧 通知渠道 — 邮件(SMTP)与飞书群机器人;配置存在数据库中,页面设置里维护
- 🐳 一键部署 — Docker Compose 一键部署(InfluxDB 2.7 + 后端),开箱即用
- 📱 响应式界面 — Vue 3 单页应用(SPA),由 FastAPI 托管
frontend/dist构建产物 - 🔌 API 驱动 — 完整的 RESTful API(JWT 鉴权),支持二次开发
技术栈
| 组件 | 技术 |
|---|---|
| 后端 | Python 3.11 + FastAPI + Uvicorn |
| 数据库 | SQLite(SQLAlchemy:用户 / 主机 / 分组 / 告警规则 / 告警历史 / 系统设置)+ InfluxDB 2.7(时序数据) |
| 前端 | Vue 3.4 + Vue Router 4.3 + Element Plus 2.7 + ECharts 5.5 + Vite 5.4 |
| 监控采集 | ipmitool(sdr elist)采集 IPMI 服务器;pysnmp 7.1(SNMP v2c/v3)采集网络设备 |
| 容器化 | Docker + Docker Compose |
页面一览
| 路由 | 页面 | 说明 |
|---|---|---|
/ |
仪表盘 | 主机在线统计、总功耗 / 最高温度汇总、温度与功耗趋势图 |
/sensors |
传感器 | 各主机最新传感器值(温度 / 风扇 / 电压 / 功耗) |
/components |
组件 | CPU / 内存 / PCIe / 硬盘 / 风扇 / 电源在位状态与总功耗 |
/network |
网络设备监控 | H3C 设备健康摘要、接口列表与流量图(点接口行切换) |
/hosts |
主机管理 | 主机增删改、分组筛选、连接测试(IPMI / SNMP 分流) |
/groups |
分组管理 | 分组增删改 |
/alert-rules |
告警规则 | 规则增删改(阈值、条件、持续时长、通知渠道) |
/alert-history |
告警历史 | 分页查询、按主机 / 确认状态筛选、确认 |
/settings |
系统设置 | 飞书 Webhook 与 SMTP 配置、测试邮件 / 测试飞书消息 |
/login |
登录 | 用户名 + 密码登录(JWT) |
快速开始(Docker Compose 一键部署)
前置要求
- Docker >= 20.10
- Docker Compose >= 2.0
部署步骤
- 克隆项目
git clone <repository-url> /opt/ipmi-monitor
cd /opt/ipmi-monitor
- 配置环境变量
cp .env.example .env
# 编辑 .env 文件,填写首次启动必填项(见下表)与 InfluxDB 凭据
vim .env
- 一键启动
# 使用启动脚本(推荐)
chmod +x start.sh
./start.sh
# 或手动启动
docker compose up -d
- 首次登录并改密
首次启动时用户表为空,后端用 ADMIN_INITIAL_PASSWORD 创建初始管理员账号(默认用户名 admin,见启动日志)。登录后立即改密:
# 登录取 token 后调用改密接口(新密码至少 12 位;改密后此前签发的所有 token 失效,需重新登录)
curl -X POST http://your-server:8000/api/auth/change-password \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"old_password": "<初始密码>", "new_password": "<新密码>"}'
- 访问系统
- 前端界面: http://your-server:8000
- API 文档(仅非生产环境): http://your-server:8000/docs
- InfluxDB 管理界面: http://your-server:8086
- 添加第一台主机
在 Web 界面「主机管理」中点击「添加主机」,填写 IPMI 连接信息:主机名称、IPMI 地址、端口(默认 623)、用户名 / 密码。
生产环境注意
- 生产关闭 API 文档:
ENVIRONMENT=production(docker-compose 默认值)时/docs、/redoc、/openapi.json均不可用;开发环境(ENVIRONMENT=development)才开启。 - 前端改动后需自行构建:
frontend/src改动后不会自动生效,需在frontend/下执行npm run build重新生成frontend/dist(后端以 SPA 方式托管该目录),再重启后端容器。
手动部署步骤
1. 安装依赖
# 安装 ipmitool
apt-get install -y ipmitool
# 安装 Python 依赖
cd backend
pip install -r requirements.txt
2. 安装并配置 InfluxDB
# 参考 InfluxDB 官方文档安装 InfluxDB 2.7
# 配置组织、Bucket 和 API Token
3. 配置环境变量
cp .env.example .env
# 编辑 .env,填写首次启动必填项(JWT_SECRET_KEY、ADMIN_INITIAL_PASSWORD)与 InfluxDB 连接信息
vim .env
4. 启动后端服务
cd backend
uvicorn app.main:app --host 0.0.0.0 --port 8000
5. 使用 systemd 管理(可选)
# /etc/systemd/system/ipmi-monitor.service
[Unit]
Description=IPMI Monitor Backend
After=network.target
[Service]
Type=simple
WorkingDirectory=/opt/ipmi-monitor/backend
EnvironmentFile=/opt/ipmi-monitor/.env
ExecStart=/usr/bin/uvicorn app.main:app --host 0.0.0.0 --port 8000
Restart=always
[Install]
WantedBy=multi-user.target
环境变量说明
与 backend/app/config.py 逐项对齐。标记 首次启动必填 的两项缺失时后端拒绝启动(JWT_SECRET_KEY 至少 32 位;ADMIN_INITIAL_PASSWORD 至少 12 位,仅用户表为空时使用,此后改动无效)。
| 变量名 | 默认值 | 说明 |
|---|---|---|
JWT_SECRET_KEY |
—(首次启动必填) | JWT 签名密钥,至少 32 位随机字符串 |
ADMIN_INITIAL_PASSWORD |
—(首次启动必填,仅首次建管理员时用) | 初始管理员密码,至少 12 位;首次登录后立即改密 |
ENVIRONMENT |
development |
development 或 production;production 关闭 /docs、/redoc、/openapi.json |
DATABASE_URL |
sqlite+aiosqlite:///./data/ipmi_monitor.db |
后端 SQLite 地址,Docker 部署时位于 /app/data 命名卷中 |
REQUIRE_EXISTING_DATABASE |
false |
生产保护:为 true 时数据库文件不存在则拒绝启动 |
MIN_EXPECTED_HOSTS |
0 |
生产保护:主机数低于该下限则拒绝启动(如 50) |
INFLUXDB_URL |
http://localhost:8086 |
InfluxDB 地址(Docker Compose 中为 http://influxdb:8086) |
INFLUXDB_TOKEN |
— | InfluxDB API Token |
INFLUXDB_ORG |
ipmi-monitor |
InfluxDB 组织名称 |
INFLUXDB_BUCKET |
metrics |
InfluxDB 存储桶名称 |
COLLECT_INTERVAL |
60 |
数据采集间隔(秒);兼容旧名 POLL_INTERVAL 别名 |
LOG_LEVEL |
INFO |
日志级别 |
CORS_ORIGINS |
—(空) | 逗号分隔的跨域白名单;为空表示不启用 CORS(同源部署) |
JWT_ALGORITHM |
HS256 |
JWT 签名算法 |
JWT_EXPIRATION_HOURS |
8 |
JWT 有效期(小时) |
CREDENTIAL_ENCRYPTION_KEY |
—(空) | 可选:加密入库口令(BMC 口令 / SMTP 口令 / 飞书 URL)的 Fernet 密钥;为空时后端首次启动自动生成并以 0600 权限保存在数据库目录旁 |
SMTP_HOST |
—(空) | SMTP 服务器地址(环境变量兜底;告警实际用数据库「系统设置」里的 SMTP 配置) |
SMTP_PORT |
587 |
SMTP 端口 |
SMTP_USER |
—(空) | SMTP 用户名 |
SMTP_PASSWORD |
—(空) | SMTP 密码 |
SMTP_FROM |
—(空) | 发件人地址(留空则用 SMTP 用户名) |
FEISHU_WEBHOOK_URL |
—(空) | 飞书机器人 Webhook(环境变量兜底;通知实际用数据库「系统设置」里的值) |
Docker Compose 专用变量(不在 config.py 中,由 compose / InfluxDB 容器使用):INFLUXDB_USERNAME、INFLUXDB_PASSWORD、INFLUXDB_PORT(默认 8086)、COMPOSE_PROJECT_NAME(默认 ipmi-monitor,影响命名卷名称,生产环境保持稳定)、BACKEND_PORT(默认 8000)。
说明:
- 告警阈值在页面告警规则里逐条配置(条件、阈值、持续时长、通知渠道);不存在全局
ALERT_*环境变量,旧文档中的ALERT_TEMP_THRESHOLD/ALERT_FAN_THRESHOLD/ALERT_POWER_THRESHOLD、ALERT_EMAIL_FROM/ALERT_EMAIL_TO、WEBHOOK_URL均已被删除,无人读取。 - BMC 口令、SMTP 口令、飞书 Webhook URL 入库前用 Fernet 加密存储;API 永不返回这些秘密的明文(主机列表只返回
has_password,设置接口只返回smtp_password_set与feishu_webhook_masked后 4 位掩码),更新时秘密字段留空表示不改。
数据持久化与生产环境保护
本项目有两类持久化数据:
- 后端 SQLite 数据库:保存用户、主机、分组、告警规则、告警历史等配置数据。Docker 部署时默认存放在 backend 的
/app/data/ipmi_monitor.db,对应 Docker 命名卷backend-data。 - InfluxDB 时序数据:保存传感器历史指标。Docker 部署时默认挂载
./data/influxdb到容器/var/lib/influxdb2。
新环境首次部署
新环境请保持默认配置:
COMPOSE_PROJECT_NAME=ipmi-monitor
REQUIRE_EXISTING_DATABASE=false
MIN_EXPECTED_HOSTS=0
含义:
- 允许后端自动创建 SQLite 数据库和表结构
- 允许自动创建默认管理员账号
- 适合测试环境、新服务器首次初始化、还没有导入生产数据的环境
启动:
cp .env.example .env
vim .env
bash scripts/preflight-data.sh
docker compose up -d --build
已有数据的生产环境
当环境已经导入真实主机、分组、告警规则后,建议开启生产保护:
COMPOSE_PROJECT_NAME=ipmi-monitor
REQUIRE_EXISTING_DATABASE=true
MIN_EXPECTED_HOSTS=50
MIN_EXPECTED_HOSTS 请按你的生产规模设置为合理下限。例如生产应有 100 台左右主机,可以设置为 50;如果只有 10 台,可以设置为 5。
开启后:
- 如果 SQLite 数据库文件不存在,后端会拒绝启动
- 如果数据库里的主机数量低于
MIN_EXPECTED_HOSTS,后端会拒绝启动 - 可以防止由于 Docker Compose 项目名、项目目录或 volume 变化导致挂载到空数据库后仍然正常启动
更新生产环境前的检查流程
生产环境更新前建议先检查数据挂载:
cd /path/to/ipmi-monitor
bash scripts/preflight-data.sh
确认输出里的数据库统计符合预期,例如:
hosts: 107
host_groups: 41
alert_rules: 4
alert_history: 244
再更新:
git fetch origin
git pull --ff-only origin master
bash scripts/preflight-data.sh
docker compose up -d --build backend
docker compose ps
避免数据丢失的注意事项
不要在生产环境随意执行以下命令,除非已经确认备份并明确知道后果:
docker compose down -v
docker system prune --volumes
docker volume rm ...
rm -rf data/
COMPOSE_PROJECT_NAME 会影响 Docker 命名卷名称。生产环境请保持稳定,不要随意修改,否则可能会创建新的空 volume,导致页面看起来像“数据没了”。
网络设备监控(H3C / SNMP)
除 IPMI 服务器外,系统还支持通过 SNMP 采集网络设备,优先支持 H3C(新华三)交换机 / 路由器。网络设备与 IPMI 服务器共用同一套链路:同一张主机表(device_type 区分)、同一轮询节奏(COLLECT_INTERVAL,默认 60 秒)、同一 InfluxDB 存储与同一告警引擎。
支持的型号与版本
- 已验证逻辑的 MIB:标准 MIB(RFC 1213 MIB-II、RFC 2863 IF-MIB)适用于所有支持 SNMP 的 H3C 设备;H3C 私有 MIB(HH3C-ENTITY-EXT-MIB)适用于运行 Comware V5/V7 的 H3C 交换机与路由器。
- 型号差异:H3C 私有 MIB 的支持程度因产品与实体类型而异——CPU / 内存利用率只在模块(MODULE)类实体上有值,温度只在模块 / 风扇 / 电源类实体上有值;风扇转速没有对应的私有 MIB 列,风扇与电源的健康状态通过实体的 oper 状态反映。采集时取不到的指标记为缺失(null),不会让整台设备的采集失败;不支持私有 MIB 的设备仍可正常采集标准 MIB 指标(在线状态、uptime、接口状态与流量)。
- SNMP 版本:v2c(团体名)与 v3(USM 用户,认证 MD5/SHA/SHA-224/256/384/512,加密 DES/AES-128/192/256)。生产环境建议用 SNMPv3(authPriv)。
设备端配置(H3C)
以 Comware 为例,在设备上开启 SNMP(以下为示例,请按实际管理策略替换团体名与 ACL):
system-view
# 启用 SNMP Agent(默认关闭)
snmp-agent
# 允许的 SNMP 版本
snmp-agent sys-info version v2c
# 只读团体名(建议同时绑定 ACL,只允许监控服务器访问)
snmp-agent community read <community-name>
# 可选:限制管理站
# snmp-agent community read <community-name> acl <acl-number>
quit
save force
SNMPv3(推荐)示例:
system-view
snmp-agent
snmp-agent sys-info version v3
# 用户组:认证+加密
snmp-agent group v3 <group-name> privacy
# 用户:SHA 认证 + AES-128 加密(密码请用强口令,不要用示例值)
snmp-agent usm-user v3 <user-name> <group-name> authentication-mode sha <auth-password> privacy-mode aes128 <priv-password>
quit
save force
网络与防火墙
- 监控服务器到设备放行 UDP 161(SNMP 查询方向);设备无需主动连接监控服务器。
- 设备侧建议用 ACL 限制 SNMP 访问源为监控服务器地址;团体名 / v3 密码只在系统后台以 Fernet 加密存储,接口不返回明文,编辑时留空表示不改。
在系统里添加网络设备
- 「主机管理 → 添加主机」,设备类型选「网络设备 (SNMP)」。
- 填地址与 SNMP 端口(默认 161),v2c 填团体名,v3 填用户名、认证协议/密码、加密协议/密码。
- 点「测试」:后端对设备做一次 SNMP GET(sysDescr/sysObjectID/sysUpTime/sysName),返回在线状态、往返延迟与设备描述;失败时显示错误原因(如超时、无响应、认证失败)。
- 添加后即进入同一轮询:每
COLLECT_INTERVAL采集一次,可在「网络设备监控」页查看健康摘要、接口列表与流量图。
采集的指标
| 指标(InfluxDB measurement) | 内容 | 来源 |
|---|---|---|
network_uptime |
设备运行时间(秒) | 标准 MIB sysUpTime |
network_cpu |
CPU 利用率 %(各模块最大值) | H3C 私有 HH3C-ENTITY-EXT-MIB .6 |
network_memory |
内存利用率 %(各模块最大值) | H3C 私有 HH3C-ENTITY-EXT-MIB .8 |
network_temperature |
各实体温度(°C) | H3C 私有 HH3C-ENTITY-EXT-MIB .12 |
network_entity_status |
各实体健康(1 正常 / 0 异常,oper 状态) | H3C 私有 HH3C-ENTITY-EXT-MIB .3 |
network_if_in_bps / network_if_out_bps |
接口入 / 出流量(bps,由 64 位计数器算速率) | 标准 MIB ifXTable(无 64 位计数器时回退到 ifTable 32 位) |
network_if_status |
接口 up/down(1/0,含 admin/oper 状态、速率、别名 tag) | 标准 MIB ifTable/ifXTable |
network_if_in_error_rate / network_if_out_error_rate |
接口错包率(个/秒) | 标准 MIB ifTable |
OID 清单(含来源)见 backend/app/services/snmp_collector.py 文件头的注释;速率计算处理了 64/32 位计数器回绕与设备重启(sysUpTime 回退)后的基线重置,首轮采集没有速率(需两次计数才能算出)。
告警
告警规则支持以下网络指标类型(与 IPMI 指标用法相同):network_cpu(指标名 cpu_usage)、network_memory(memory_usage)、network_temperature(指标名为实体标签,如 Slot 1)、network_if_status(指标名为接口名,如 GE1/0/1,值 1=up、0=down)、network_if_in_bps / network_if_out_bps、network_if_in_error_rate / network_if_out_error_rate、network_uptime。另有合成类型 offline(指标名固定为 offline,值 1=离线、0=在线;离线判定为 last_seen 超过 2 倍采集间隔,与仪表盘在线统计一致;典型规则:条件 eq、阈值 1、持续 300 秒)。
API 文档概览
启动服务后,非生产环境访问 http://your-server:8000/docs 查看完整的 Swagger UI 文档。除登录外所有接口均需 JWT 鉴权(Authorization: Bearer <token>)。
主要 API 端点
健康检查
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/health |
健康检查,返回 {"status": "ok"} |
认证(backend/app/routers/auth.py)
| 方法 | 路径 | 说明 |
|---|---|---|
POST |
/api/auth/login |
用户名 + 密码登录,返回 JWT |
POST |
/api/auth/verify |
校验 token 是否有效 |
POST |
/api/auth/logout |
吊销当前 token |
POST |
/api/auth/change-password |
改当前用户密码(新密码至少 12 位;成功后此前所有 token 失效) |
GET |
/api/auth/me |
取当前登录用户信息 |
主机(backend/app/routers/hosts.py)
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/hosts |
主机列表(不返回口令明文,只返回 has_password;可用 `device_type=ipmi |
POST |
/api/hosts |
添加主机(device_type 为 snmp 时需 SNMP 配置,见上节) |
PUT |
/api/hosts/{host_id} |
更新主机(口令留空表示不改) |
DELETE |
/api/hosts/{host_id} |
删除主机 |
POST |
/api/hosts/{host_id}/test |
IPMI 连接测试 |
POST |
/api/hosts/{host_id}/test-snmp |
SNMP 连通性测试(返回在线 / 延迟 / sysDescr) |
GET |
/api/hosts/{host_id}/status |
主机状态 |
网络设备(backend/app/routers/network.py)
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/network/{host_id}/health |
设备健康摘要(在线、CPU/内存、运行时间、温度、接口 up/down 统计) |
GET |
/api/network/{host_id}/interfaces |
接口列表(状态、速率、别名、错包率) |
GET |
/api/network/{host_id}/interfaces/traffic?interface=GE1/0/1&hours=6 |
单接口入 / 出流量历史(接口名放 query 参数,因接口名含 /) |
分组(backend/app/routers/groups.py)
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/groups |
分组列表 |
POST |
/api/groups |
新建分组 |
PUT |
/api/groups/{group_id} |
更新分组 |
DELETE |
/api/groups/{group_id} |
删除分组 |
监控数据(backend/app/routers/monitor.py)
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/monitor/dashboard |
仪表盘汇总(主机数、在线数、未确认告警数) |
GET |
/api/monitor/dashboard/totals |
各主机总功耗 / 最高温度汇总(可按分组筛选) |
GET |
/api/monitor/history/{host_id} |
单主机历史指标 |
GET |
/api/monitor/history/multi |
多主机历史指标(host_ids 逗号分隔,最多 50 个) |
GET |
/api/monitor/summary/{metric_type} |
指定类型传感器的最新值列表 |
GET |
/api/monitor/sensors/{host_id} |
单主机全部传感器最新值 |
GET |
/api/monitor/realtime/{host_id} |
单主机最新指标(按类型分组) |
GET |
/api/monitor/trend |
分组趋势数据(时间范围 1m–30d) |
GET |
/api/monitor/components/{host_id} |
单主机组件在位状态 |
GET |
/api/monitor/components/{host_id}/grouped |
单主机组件在位状态(按在位 / 缺失分组) |
GET |
/api/monitor/export |
历史指标 CSV 导出(host_ids、metric_type、start、end;列:time,host_id,metric_type,metric_name,value,unit) |
告警(backend/app/routers/alerts.py)
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/alerts/rules |
告警规则列表(可按主机 / 分组 / 指标类型筛选) |
POST |
/api/alerts/rules |
新建告警规则 |
PUT |
/api/alerts/rules/{rule_id} |
更新告警规则 |
DELETE |
/api/alerts/rules/{rule_id} |
删除告警规则 |
GET |
/api/alerts/history |
告警历史(分页,可按主机 / 规则 / 确认状态筛选) |
PUT |
/api/alerts/history/{history_id}/acknowledge |
确认一条告警 |
系统设置(backend/app/routers/settings.py)
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/settings |
取系统设置(秘密只返回掩码 / 是否已配置) |
PUT |
/api/settings |
更新系统设置(秘密字段留空表示不改) |
POST |
/api/settings/test-email |
发送测试邮件 |
POST |
/api/settings/test-feishu |
发送飞书测试消息 |
告警配置说明
告警触发条件
阈值在「告警规则」页面逐条配置,每条规则指定:指标类型(IPMI:temperature / fan / voltage / power / component / status;网络设备:network_cpu / network_memory / network_temperature / network_if_status / network_if_in_bps / network_if_out_bps / network_if_in_error_rate / network_if_out_error_rate / network_uptime,另有合成类型 offline 表示设备离线)、传感器名、条件(大于 / 小于 / 等于 / 大于等于 / 小于等于)、阈值、持续时长(超标持续满该时长才触发)、适用范围(单主机 / 分组 / 全部主机)、通知渠道(邮件、飞书)与收件邮箱。触发后 3 小时内不重复通知;指标恢复正常后发送恢复通知(仅当该告警此前确实触发过)。
告警通知渠道
邮件通知
在「系统设置 → 邮件通知」中配置 SMTP 信息(服务器、端口、用户名、密码、发件人、TLS),保存后用「发送测试邮件」验证。告警按规则的收件邮箱列表发送。
飞书通知
在「系统设置 → 飞书通知」中配置群机器人 Webhook 地址(可配安全关键词),保存后用「发送测试消息」验证。告警以交互式卡片推送到飞书群。
仅支持以上两种渠道。Slack / 钉钉 / 企业微信没有实现,不要按旧文档配置。
常见问题
ipmitool 无法连接服务器
- 确认目标服务器 IPMI/BMC 已启用
- 确认网络连通性:
ping <ipmi-ip> - 确认 IPMI 凭据正确
- 检查防火墙规则(默认端口 623/UDP)
Docker 部署后无法访问
- 检查容器状态:
docker compose ps - 查看日志:
docker compose logs backend - 确认端口未被占用:
ss -tlnp | grep 8000
数据采集失败
- 确认后端容器已安装 ipmitool
- 确认容器网络可达 IPMI 地址
- 查看后端日志排查具体错误
组件页提示原始数据文件缺失
组件在位状态读取采集时写下的 /tmp/ipmi_raw_{host_id}.txt;该文件丢失(如容器重启)时组件接口会报 404,等待下一轮采集(60 秒)后恢复。
前端改了代码页面没变化
后端托管的是 frontend/dist 构建产物,改 frontend/src 后需在 frontend/ 下执行 npm run build 重新生成 dist,再重启后端。
License
This project is licensed under the MIT License. See the LICENSE file for details.
MIT License
Copyright (c) 2024 IPMI Monitor Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.