文档中心
环境准备简介
更新时间： 2026/07/22
在Gitcode上查看源码

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 身份执行初始化，否则可能因权限不足导致失败。

请使用 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 仓库 完成一键环境初始化。

  1. 克隆 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

  2. 准备 社区账号，初始化过程中需要输入 Conan 用户名和密码。

  3. 下载 bmcsdk 并执行初始化。

    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

IMPORTANT

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

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

至此，环境搭建完成。

问题排查 ​

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

总结 ​

本文档涵盖：

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

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

上一篇探索openUBMC
下一篇构建你的BMC