2026版本openUBMC Studio FAQ
Q1:登录到社区时提示无法识别OS keyring,登录保持功能无法正常生效
问题现象: 登录到社区时,右下角弹窗提示An OS keyring couldn't be identified for storing the encryption related data in your current desktop environment.,登录保持功能无法正常生效,开启新页面或重启openUBMC Studio时仍为未登录状态
问题原因: 该问题可能与主机的凭证管理服务无法正常工作有关,请确认当前使用的主机是否支持凭证管理
首先确保Windows凭据管理器服务正在运行:
- 按下
Win + R,输入services.msc并回车。 - 在服务列表中找到
Credential Manager(凭据管理器),确保其状态为“正在运行”,启动类型建议为“手动”或“自动”。 - 如果服务未运行,右键单击选择“启动”。
如果服务是启动的,则有可能当前主机没有权限管理凭证,请确认是否能够管理凭据:
- 打开“控制面板”>“用户账户”>“凭据管理器”>“Windows 凭据”。
- 确认是否能够正常打开,少数场景下,打开会报错,此时当前用户无权限管理凭据,请尝试提升用户权限
2025版本BMC Studio FAQ
Q1:通过apt源安装仓颉工具链时,执行apt install cangjie-runtime命令报错trying to overwrite '/usr/share/bmc_studio/server/libsecurec.so', which is also in package bmc-studio 1.1.95.250628
**问题现象:**运行apt install cangjie-runtime安装仓颉工具链时报错,报错信息如下
dpkg: error processing archive /var/cache/apt/archives/cangjie-runtime_1.0.0_amd64.deb (--unpack):
trying to overwrite '/usr/share/bmc_studio/server/libsecurec.so', which is also in package bmc-studio 1.1.95.250628
Errors were encountered during processing:
/var/cache/apt/archives/cangjie-runtime_1.0.0_amd64.deb
E: Sub-process /usr/bin/dpkg returned an error code (1)**可能原因:**安装仓颉工具时,旧版本 BMC Studio (1.1.95.250628版本)未卸载。 **处理建议:**请先运行代码
apt update
apt install bmc-studio安装最新BMC Studio,然后再执行
apt install cangjie-runtimeQ2:安装完成后,运行提示error while loading shared libraries: libcangjie-std-ast.so: cannot open shared object file: No such file or directory
**问题现象:**安装完成后,提示 error while loading shared libraries: libcangjie-std-ast.so: cannot open shared object file: No such file or directory
**可能原因:**未安装 cangjie-runtime
**处理建议:**参考本文安装方式3配置 apt 源,然后在命令行输入命令:
apt install cangjie-runtime然后重新启动 BMC Studio 即可。
Q3:安装完成后,使用bingo studio命令无法正常拉起BMC Studio窗口
**问题现象1:**安装完成后,使用bingo studio命令,但是没有界面被唤起。
**可能原因1:**您使用的 linux 环境并非 wsl
**处理建议:**非 wsl 环境需要手动输入地址打开。 在 windows 中的 web 浏览器中(edge、Internet Explorer、chrome 任意均可)输入图中所示位置的地址,即可打开 BMC Studio 前端页面。
**问题现象2:**日志无异常,有浏览器窗口被打开,但窗口白屏,一段时间后显示无连接。
**可能原因2:**您曾经在配置过 netsh 转发规则
**处理建议:**打开管理员权限的 powershell ,输入命令
netsh interface portproxy show all如果发现有您的端口号相关的设置,请清除它。
netsh interface portproxy delete v4tov4 listenport=10000 listenaddress=x.x.x.x请自行替换命令中的listenaddresss
**问题现象3:**现象同问题现象2,但netsh interface portproxy show all没有发现回显
**可能原因3:**有进程在占用您的端口号 处理建议:
# 在wsl终端里输入以下命令查找是否有进程在占用10000端口
sudo netstat -tlnp | grep :10000
# 如果发现占用进程,结束它
sudo kill -9 <PID>请自行替换命令中的端口号和 pid 此外,windows 端中也有可能有进程占用 10000 端口。 您可以使用命令:
netstat -ano | findstr :10000如果看到如下回显:
请在任务管理器中使用回显中最后的数字查找该进程,如果您认识且认为不重要,您可以在任务管理器中右键点击这个进程并点击"结束进程"
如果该应用对您很重要,可以修改我们的脚本,将/usr/share/bmc_studio/load_nginx.sh中的第46行从
FRONTEND_PORT=$((10000 + USER_ID % 10000))修改为
FRONTEND_PORT=$((10001 + USER_ID % 10000))**问题现象4:**日志报错"Failed to auto-open in WSL"
**可能原因4:**您在 /etc/wsl.conf 这个文件中配置了 default=root ,wslu 的 bug 会将这个配置误识别为 windows 挂载点配置,导致无法获取到正确的 windows 目录地址。
**处理建议:**打开文件 /usr/bin/wslview,删除114~119行内容:
if [ -f /etc/wsl.conf ]; then
tmp="$(awk -F '=' '/root/ {print $2}' /etc/wsl.conf | awk '{$1=$1;print}')"
[ "$tmp" == "" ] || win_location="$tmp"
[[ "$win_location" =~ ^.*/$ ]] || win_location="$win_location/" # make sure it always end with slash
unset tmp
fi删除完成后,重新打开 BMC Studio 。
Q4:BMC Studio 上传文件/文件夹报错 fail to post /studio-tool/csr/folder
问题现象: 在 csr 页面选择导入代码仓或导入单个 csr 报错,信息为
fail to post /studio-tool/csr/folder可能原因: 您的系统磁盘剩余空间不足
处理建议: 清理您的系统,获得更多的磁盘剩余空间。
Q5:BMC Studio 一键仓库部署超时
问题现象: 使用 manifest 创建完工作空间后,按照文档流程在仓库管理页面点击一键仓库部署,然而超时失败
可能原因: 您没有登陆 conan 账号
处理建议: 在命令行输入命令
conan remote login openubmc_dev 您的账号 -p 您的密码登录 conan 账号后,重新一键仓库部署即可。
Q6:BMC Studio 的 QEMU 在线调试过程中,资源协作接口获取不全
问题现象: 拉起 QEMU 后,使用 BMC Studio 连接上 QEMU ,点开在线调试的资源协作接口窗口后,接口显示很少。
可能原因: QEMU 性能较慢,获取全量接口需要时间。
处理建议: 请耐心等待,并通过刷新按钮查看新增接口。
Q7:BMC Studio 连接真机后,无法进行在线调试
问题现象: BMC Studio 连接真机后,无法进行在线调试。
可能原因: BMC Studio 的在线调试能力尚未支持真机,存在破坏环境的风险,目前暂时仅支持基于 QEMU 的调试。
处理建议: 建议使用 QEMU 进行替代。QEMU 每次启动都会重置,调试导致环境出现问题后只需要重启 QEMU 即可。
Q8:无法使用插件进行调试文件
问题现象: 使用 VsCode 修改文件后,无法进行调试或右上角没有调试图标
可能原因: 不是所有文件都支持调试,支持的文件主要是 /opt/bmc/apps/ 组件名路径下的 lua 文件、北向接口配置文件以及 /opt/bmc/sr 路径下的内置CSR文件。且 mdb_interface 这种模型定义仓暂时也不支持直接通过 VsCode 调试。
处理建议: 使用出整包的方式调试。
Q9:运行 BMC Studio 时闪退
问题现象: 运行 BMC Studio 时闪退,报错信息为
xxxxxx E Thread "bmc_studio_serv" catched unhandled SIGILL /(Illegal instruction) from managed frame. signal pc: 0xxxxxxxxxxxxx
/usr/share/bmc_studio/bmc_studio.sh: line 96: xxxxxx Segmentation fault ./bmc_studio_server "$1"
Failed to start foreground service可能原因: BMC Studio 使用仓颉语言开发,目前仓颉语言依赖 avx2 指令集。您使用的电脑 CPU 可能不支持 avx2 指令集。可以通过在 linux 命令行中执行命令
lscpu | grep avx2来进行判断。如果没有出现结果,那么您的 cpu 可能就不支持 avx2 指令集。
解决方案: 如果您的 cpu 不支持 avx2 指令集,可能暂时无法使用 BMC Studio。请期待未来仓颉更新后解除对 avx2 指令集的依赖。
Q10:运行 BMC Studio 的终端被关闭了,如何查看日志?
问题现象: 在命令行唤起 BMC Studio 后,终端被误关闭,导致没法看日志。
解决方案: BMC Studio 的日志会保存在 ~/bmc_studio/var/log/debug.log 中,可以手动打开这个文件进行查看。