按产品分类浏览文章 关于本站

使用 Kiro IDE 的 Universal ZIP 压缩包在 Ubuntu 24.04 上运行时候遇到 App Armor 报错的解决办法

本文介绍在 Ubuntu 24.04 及以上版本中,使用 Kiro IDE 的 Universal ZIP 压缩包启动时因 AppArmor 限制非特权用户命名空间而报出 SUID sandbox 错误的原因与处理方法。文中先给出两种不推荐的临时方案,即使用 --nosandbox 参数跳过沙盒、关闭 AppArmor 的用户命名空间限制,随后说明推荐做法:为 Kiro 可执行文件编写独立的 AppArmor 配置文件并加载生效,在保留系统安全防护的前提下使 Kiro 正常运行。

一、背景

在 Ubuntu 22.04 上,下载 Kiro IDE 的 Universal ZIP 压缩包,解压缩可直接运行。

在 Ubuntu 24.04 或者更高版本操作系统上,您可以选择下载 deb 安装包,也可以下载 Universal ZIP 压缩包。如果是 deb 安装包,安装后启动 Kiro IDE,一切正常。如果是下载的 Universal ZIP 压缩包,解压缩后启动 Kiro IDE 时候会遇到 App Armor 的报错。报错信息如下:

[7188:1010/151223.009261:FATAL:sandbox/linux/suid/client/setuid_sandbox_host.cc:166] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /home/lxy2/Documents/Kiro/chrome-sandbox is owned by root and has mode 4755.
Trace/breakpoint trap (core dumped)

这是由于 Ubuntu 24.04 默认开启 App Armor 安全防护拦截了 Kiro 的运行。解决办法如下:

二、跳过 App Armor 的沙盒启动 Kiro IDE(不推荐)

1、按报错信息给特定目录配置 root 权限

在报错信息中,提到目录 owner 需要是 root,权限需要是 4755

You need to make sure that /home/lxy2/Documents/Kiro/chrome-sandbox is owned by root and has mode 4755.

由此我们修正 Kiro IDE 坐在的目录和其中 chrome-sandbox 的权限。执行如下命令:

sudo chown root:root /home/lxy2/Documents/Kiro/chrome-sandbox
sudo chmod 4755 /home/lxy2/Documents/Kiro/chrome-sandbox

2、跳过 App Armor 沙盒

启动 Kiro IDE 时候,加参数跳过 sandbox。

./kiro --nosandbox

即可启动成功。

3、彻底关闭本机 App Armor 保护(不推荐)

本机完全关闭 App Armor,执行如下命令:

sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0

重启生效。

三、正确的配置 App Armor 使其允许 Kiro 运行

1、配置规则

执行如下命令写入 Kiro 配置文件。注意替换其中的文件路径和可执行文件名。

sudo tee /etc/apparmor.d/kiro > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>

profile kiro /home/lxy2/Documents/Kiro/kiro flags=(unconfined) {
  userns,

  # 本地扩展规则(可选)
  include if exists <local/kiro>
}
EOF

执行如下命令让配置生效。

sudo apparmor_parser -r /etc/apparmor.d/kiro
sudo aa-status | grep kiro

再次启动 Kiro,即可正常运行。


最后修改于 2026-10-12