在开始使用 openUBMC 之前，您需要先完成开发环境的快速搭建，包括操作系统安装、网络配置和初始化配置。

系统环境要求 ​

操作系统安装 ​

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

如果您已安装 Ubuntu 24.04 环境，请跳过此环节；如果还没有，请参考《开发环境准备》进行操作系统安装。

网络配置 ​

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

• 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 工具仓库

在终端中运行以下命令检查连通性。

  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

如果结果返回值为 200，即为正常连通，否则请参考《常见问题》的“网络相关失败”章节配置网络或防火墙。

GitCode 配置（可选） ​

openUBMC 社区使用 GitCode 管理代码，如果您需要为社区提交代码：

1. 请完成 GitCode SSH 密钥配置。

2. 注册并绑定邮箱，之后在终端中配置本地 git。

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

开发环境初始化 ​

启动Root用户 ​

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

配置交换分区（可选，建议） ​

openUBMC 组件数量较多，编译过程内存占用大（系统要求建议交换分区 32GB）。物理内存不足时，可通过创建 swap 文件配置交换分区，避免编译期间因 OOM 被杀进程。

通过下面的命令检查当前Swap交换分区大小，系统要求建议交换分区 32GB：

free -h

检查运行中的容器是否设置了内存上限：

# 返回 0 表示未限制，返回具体数值（字节）表示已设置上限
docker inspect <容器名> --format '{{.HostConfig.Memory}}'
# 或用 docker stats 查看内存 LIMIT 列
docker stats <容器名>

以创建 4 个 8GB swap 文件（共 32GB）为例：

# 创建 4 个 8GB swap 文件并启用
for i in 1 2 3 4; do
  sudo dd if=/dev/zero of=/swapfile${i} bs=1M count=8192
  sudo chmod 600 /swapfile${i}
  sudo mkswap /swapfile${i}
  sudo swapon /swapfile${i}
done

swapon 仅在当前会话生效，重启后失效。需写入 /etc/fstab 持久化，开机自动挂载：

for i in 1 2 3 4; do
  echo "/swapfile${i} none swap sw 0 0" | sudo tee -a /etc/fstab
done

验证配置是否生效：

sudo swapon -a
swapon --show
free -h

swapon --show 能列出 4 个 swap 文件即配置成功，再用 free -h 确认 Swap 总容量为 32G。

使用manifest一键初始化 ​

使用 manifest 仓库 完成一键环境初始化，manifest 仓库是构建的入口，管理所有子仓库的版本依赖和构建策略。

1. 克隆 manifest 仓库。

   shell

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

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

   如已有账号可直接使用，没有则先到openUBMC社区账号注册页面进行注册。

3. 预设许可证自动接受：

   shell

   # 设置环境变量，让 init.py 自动接受许可证
   export OPENUBMC_LICENSE=true

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

   shell

   # 确保当前在 /home/workspace/manifest 目录
   python3 init.py -user <用户名> -psw '<密码>'

至此，环境搭建完成。

问题排查 ​

许可证交互确认 ​

在无终端的 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

其他问题排查 ​

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

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