OpenBMC REST API完全指南：手把手教你用Redfish管理服务器（含常见命令速查表）

原创

于 2026-02-13 08:03:33 发布 · 68 阅读

OpenBMC REST API完全指南：手把手教你用Redfish管理服务器（含常见命令速查表）

在数据中心和服务器机房里，基板管理控制器（BMC）早已超越了简单的电源开关角色，成为了现代服务器硬件管理的神经中枢。对于系统管理员和运维工程师而言，能否高效、精准地驾驭BMC，直接关系到大规模基础设施的运维效率与稳定性。OpenBMC，作为一款开源的BMC固件堆栈，以其开放性和强大的API接口，为我们提供了前所未有的灵活控制能力。然而，面对其丰富的REST API和遵循DMTF标准的Redfish接口，许多工程师常常感到无从下手，或是仅仅停留在基础操作，未能充分挖掘其自动化管理的潜力。

这篇文章正是为你——那些每天与服务器硬件打交道，渴望将重复性运维工作自动化，并希望深入理解底层管理逻辑的同行们——准备的。我们将抛开晦涩的理论，直接从实战出发，一步步拆解OpenBMC的REST API和Redfish接口。无论你是想批量获取上百台服务器的健康状态，还是希望通过编程实现固件的无缝升级，亦或是构建自定义的监控面板，这里都将提供清晰的路径和可直接复用的代码示例。我们会结合官方文档中的核心速查表，但绝不局限于简单的命令罗列，而是深入探讨其背后的设计思想、常见陷阱以及高阶应用场景，让你不仅能“用”，更能“懂”和“创”。

1. 环境准备与基础概念扫盲

在开始发送第一个API请求之前，搭建一个合适的测试环境并理解几个关键概念至关重要。这能避免很多后续的弯路。

测试环境搭建建议 理想的环境是拥有一台搭载了OpenBMC的物理服务器，但对于学习和初步开发，使用仿真环境是更经济便捷的选择。OpenBMC社区提供了QEMU仿真器，可以在一台性能足够的Linux机器上完整模拟出BMC和主机环境。

# 示例：克隆OpenBMC代码并启动一个QEMU仿真环境（以Rainier机型为例）
git clone https://github.com/openbmc/openbmc
cd openbmc
. setup rainier
bitbake obmc-phosphor-image
./runqemu rainier

启动后，仿真BMC的IP地址通常是 192.168.7.2，你可以通过SSH（用户root，密码0penBmc）或直接访问Web界面（HTTPS）进行连接。对于API测试，我们主要使用IP地址。

核心概念：REST API vs. Redfish

OpenBMC原生REST API：这是OpenBMC项目自行定义的一套API接口，通常以 /xyz 或 /org/openbmc 等为路径前缀。它更贴近OpenBMC自身的实现，功能直接，但可能在不同版本或厂商定制中存在差异。
Redfish API：这是一套由DMTF（分布式管理任务组）制定的标准化RESTful API规范，旨在统一数据中心硬件管理。其路径通常以 /redfish/v1 开头。使用Redfish意味着你的脚本或工具在理论上可以兼容不同厂商的支持Redfish的设备，可移植性更强。

提示：在新项目中，尤其是考虑多厂商环境兼容性时，优先推荐使用Redfish接口。OpenBMC原生REST API可以作为Redfish尚未完全覆盖的功能的补充。

必备工具 你将需要一款得心应手的HTTP客户端工具。curl 是命令行下的瑞士军刀，而 Postman 或 Insomnia 则提供了更友好的图形化界面，适合探索和调试。

# 一个最简单的curl测试，检查BMC的Redfish服务根目录
curl -k -u root:0penBmc https://192.168.7.2/redfish/v1/

如果一切正常，你会收到一个JSON格式的响应，其中包含了Redfish API的入口链接。

2. 身份认证、会话管理与安全实践

与OpenBMC的API交互，第一步就是安全地“敲门”。这里涉及到认证方式的选择和会话的管理，不同的选择会对脚本的复杂性和安全性产生影响。

主要认证方式

基本认证（Basic Authentication）：最简单的方式，将用户名和密码以Base64编码后放在HTTP请求头中。如上文的 curl -u 参数。其缺点是密码在每个请求中明文传输（尽管有HTTPS加密），且无法注销会话。
```
# 显式使用Basic Auth的curl命令
curl -k -H "Authorization: Basic $(echo -n 'root:0penBmc' | base64)" https://192.168.7.2/redfish/v1/
```

会话认证（Session Authentication）：更安全的方式。首先通过登录API创建一个会话，服务器返回一个会话令牌（Token），后续请求使用此令牌而非密码。会话可管理，可超时，可主动注销。

# 1. 创建会话 (以Redfish为例)
curl -k -X POST https://192.168.7.2/redfish/v1/SessionService/Sessions \
     -H "Content-Type: application/json" \
     -d '{"UserName": "root", "Password": "0penBmc"}' \
     -v # 使用-v查看响应头，其中`X-Auth-Token`就是会话令牌

# 假设返回的Token是 `abc123def456`
# 2. 使用Token进行后续请求
curl -k -H "X-Auth-Token: abc123def456" https://192.168.7.2/redfish/v1/Systems/system

安全配置要点 在生产环境中，使用默认的root用户和密码是极不安全的。OpenBMC允许你创建和管理多个用户，并分配不同的权限角色。