openUBMC 社区的开发环境仅支持 Ubuntu 24.04 操作系统和 x86-64 芯片组；Windows 用户可通过虚拟机或 WSL 部署 Ubuntu 环境，也可在 PC 上直接安装 Ubuntu，或者使用 Docker 部署 Ubuntu 容器。

操作系统安装

系统要求：

操作系统：Ubuntu 24.04（可通过 Docker、虚拟机、WSL 或云主机获取）
芯片组：x86-64
内存：至少 16GB（Windows 虚拟机建议 32GB）
交换分区：建议 32GB
磁盘空间：建议至少 64GB 可用空间
网络：需连接网络以下载依赖和访问社区资源

TIP

首次体验或对 Linux 不熟悉的用户，推荐采用 Docker 方式 —— 只需安装 Docker 运行时，社区预置镜像已包含所有开发工具。

建议使用纯净的 Ubuntu 系统，避免其他软件导致环境差异。

如果还没有 Ubuntu 24.04 环境，请参考以下方式部署（适用于 Windows 10 64 位及以上）：

方法	描述	搭建耗时	适用人群
Docker（推荐）	使用 openUBMC 社区研发 Docker 镜像，在 Docker Container 中进行研发	~5 分钟	期望快速搭建开发环境的开发者使用云环境进行开发的开发者大多数开发者的首选方案
Windows WSL	使用 WSL 能力在 Windows 上运行 Ubuntu 环境进行开发，其他事务仍在 Windows 上完成	~30 分钟	习惯使用 Ubuntu 研发环境，但仍需要使用 Windows 进行其他工作的开发者

IMPORTANT

如已安装 conda 等环境管理器，请确保配置正确。可执行 pip3 install conan==2.13.0 安装 conan，再运行 conan 验证。

网络配置

初始化及运行过程需要访问以下在线资源，请确保网络连通：

mirrors.huaweicloud.com - 华为云镜像
registry.npmmirror.com - npm 淘宝镜像
openubmc-apt-repo.obs.cn-north-4.myhuaweicloud.com - openUBMC apt 仓库
keyserver.ubuntu.com - Ubuntu GPG keyserver
conan.openubmc.cn - openUBMC conan 仓库
repo.openubmc.cn - openUBMC 工具仓库

在终端中运行以下命令检查连通性，返回 200 即为正常，否则需配置网络或防火墙：

bash

  for url in \
    "https://mirrors.huaweicloud.com" \
    "https://registry.npmmirror.com" \
    "https://openubmc-apt-repo.obs.cn-north-4.myhuaweicloud.com" \
    "https://keyserver.ubuntu.com" \
    "https://conan.openubmc.cn" \
    "https://repo.openubmc.cn"
  do
    echo -n "$url: "
    curl -s -o /dev/null -w "%{http_code}\n" --max-time 5 "$url"
  done

开发环境初始化

请以 root 用户 登录 Ubuntu 24.04 系统完成以下初始化。

WARNING

必须使用 root 身份执行初始化，否则可能因权限不足导致环境初始化失败，现有配置不支持通过sudo命令仅使用root权限执行。

请使用 su root 切换（不要使用 sudo su）。部分云厂商会修改 apt 源文件，如遇APT访问问题，请检查 /etc/apt/sources.list.d/ubuntu.sources。

GitCode 账户配置(可选)

openUBMC 社区使用 GitCode 管理代码。请完成 GitCode SSH 密钥配置，并配置本地 git：

shell

git config --global user.name <your username>
# 邮箱务必与 CLA 签署地址一致
git config --global user.email <your email>

IMPORTANT

提交 PR 时，CI 会基于 git config 的邮箱校验 CLA 签署状态，请确保邮箱一致。

开发者环境准备

使用 manifest 仓库完成一键环境初始化。

克隆 manifest 仓库。

shell

mkdir -p /home/workspace && cd /home/workspace
git clone https://gitcode.com/openUBMC/manifest.git
cd manifest
git checkout 26.03_2026.03.31

准备openUBMC社区账号（与 Conan 账号相同）。初始化过程中需要输入该账号的用户名和密码；如已有账号可直接使用，没有则先到注册页面注册一个。

预设许可证自动接受：

shell

# 预设 bmc-studio 许可证接受，防止安装时弹窗阻塞
echo 'bmc-studio bmc-studio/accept-license boolean true' | debconf-set-selections
# 设置环境变量，让 init.py 和 install_sdk 自动接受许可证
export OPENUBMC_LICENSE=true
export AUTO_ACCEPT_LICENSE=true

下载 bmcsdk 并执行初始化。需指定 Conan 用户名和密码（<用户名> 为注册时绑定的手机号或自定义用户名），也可在初始化过程中按提示输入。

shell

# 确保当前在 /home/workspace/manifest 目录
wget https://repo.openubmc.cn/26.03/sdk/bmc_sdk.zip -O /home/workspace/bmc_sdk_26.03.zip
python3 init.py -path /home/workspace/bmc_sdk_26.03.zip -user <用户名> -psw '<密码>'

IMPORTANT

bmcsdk 版本需与 manifest 代码版本一致。

如本地已有 manifest，执行 git pull -r origin main 同步最新代码。

至此，环境搭建完成。

问题排查

初始化可能因网络、代理、权限、SDK 版本等原因失败。遇到问题请参考初始化常见问题与排查。

许可证交互确认

在无终端的 Docker 容器环境中，init.py 的 install_sdk 步骤及 bmc-studio 安装均需交互式确认许可证协议，会导致 EOF 错误或安装失败。解决方法：

设置环境变量自动接受许可证，避免交互式确认：

bash

export OPENUBMC_LICENSE=true
export AUTO_ACCEPT_LICENSE=true
echo 'Y' | python3 init.py -user <用户名> -psw '<密码>'

若 init.py 因许可证问题中断导致 install_sdk 未完成，可单独补执行：
bash
```
echo 'Y' | bingo build -t install_sdk -b openUBMC -ucc
```

若 bmc-studio 安装中断，先预设许可证接受再修复：

bash

echo 'bmc-studio bmc-studio/accept-license boolean true' | debconf-set-selections
DEBIAN_FRONTEND=noninteractive dpkg --configure bmc-studio

总结

本文档涵盖：

操作系统安装：Ubuntu 24.04，提供 Docker（推荐）和 Windows WSL 两种方式
开发环境初始化：通过 manifest 仓库和 bmcsdk 一键初始化

完成后请参考《构建你的BMC》开始开发。

操作系统安装 ​

网络配置 ​

开发环境初始化 ​

GitCode 账户配置(可选) ​

开发者环境准备 ​

问题排查 ​

许可证交互确认 ​

总结 ​

操作系统安装

网络配置

开发环境初始化

GitCode 账户配置(可选)

开发者环境准备

问题排查

许可证交互确认

总结