ll-killer-go

README

ll-killer-go - 玲珑杀手Go

项目简介

本项目是Linglong Killer Self-Service (ll-killer 玲珑杀手)的重写版本，去除了构建阶段的shell脚本，全部采用go实现，并添加了一些增强功能。

ll-killer-go 是一款专为解决玲珑容器应用构建问题而设计的命令行工具。它帮助开发者快速创建、构建和生成玲珑容器应用项目，同时提供一整套辅助构建与调试功能。使用该工具，用户可以在玲珑容器中获得与传统容器（如 docker）类似的构建体验，包括对特权命令的支持和 apt 安装等功能，免去了手动解压软件包（如 deb）和修复依赖库查找路径的繁琐操作。ll-killer-go 通过重建自由的容器环境，确保构建过程的一致性与可靠性，极大地提高了开发效率和可维护性。

⚠️文档滞后，新功能请查看 更新日志 或命令帮助

功能概述

• 创建项目：自动创建项目所需的配置文件和辅助脚本，初始化项目环境。
• 构建项目：进入构建环境，支持以 root 权限执行各种命令。
• 提交内容：将构建后的文件提交到玲珑容器，确保文件路径和图标等修复。
• 辅助构建工具：包括缺失库检查、符号链接修复、图标文件修复等多种实用功能。
• 运行与调试：提供一个一致的运行时环境，支持容器应用的调试和测试。

特色功能

• 隔离的 APT 环境：提供独立的 APT 环境，让你可以轻松查找和安装所需的软件包，而无需担心宿主机环境的干扰和权限问题。
• 可重用的构建环境：构建环境在命令执行结束后依然保留，你可以多次进入容器进行调整，直到完全满足需求，避免重复创建环境的麻烦。
• root 权限模拟：尽管在构建环境中能够执行特权命令（如 apt install），但无需担心安全问题。工具使用宿主机用户权限进行操作，避免了实际 root 权限的风险。
• 全局可写容器环境：在构建环境中，你可以自由修改任何位置，提供灵活的操作空间，方便调试和调整。
• 自动修复图标和快捷方式：build-aux 工具集内置了多种自动修复脚本，帮助你快速修复常见问题，如图标和快捷方式的更新。
• 自动检查缺失库：使用 ll-killer script build-aux/build-and-check.sh 命令可以自动检测并修复构建过程中缺失的运行时库，确保容器应用能顺利运行。

目录

• 快速教程
  • 1. 获取与配置 ll-killer
    • 全局安装 ll-killer（可选）
  • 2. 开始打包一个应用
    • 创建打包环境
    • 配置软件源
    • 创建 config.mk 配置构建参数
    • 指定依赖（可选）
    • 开始构建
    • 测试构建结果
    • 安装构建结果
    • 清理构建缓存（可选）
  • 3. 挂载模式说明
    • fuse-overlayfs 模式
    • merge 模式（默认回退）
    • 模式对比
    • 构建过程中遇到目录写入问题？
• 安装与配置
  • 获取 ll-killer
  • 获取静态fuse-overlayfs（可选）
  • 环境要求
• 命令概览
• 各命令详细介绍
  • 1. apt — 进入隔离的 APT 环境
  • 2. create — 创建玲珑项目
    • 从APT元数据创建项目
  • 2. build — 构建或进入构建环境
  • 3. exec — 进入运行时环境
  • 4. run — 启动容器
  • 5. commit — 提交构建内容
  • 6. clean — 清除构建内容
  • 7. build-aux — 创建辅助构建脚本
  • 8. ptrace — 修正系统调用
  • 9. script — 执行自定义构建脚本
  • 注意事项
• 挂载相关功能
  • 1. 进入运行时环境并挂载文件系统
  • 例 1: 使用 merge 合并文件系统
  • 例 2: 挂载源路径到目标路径，指定用户和组
  • 例 3: 使用自定义的 Unix 套接字和合并根目录路径
  • 例 4: 使用不同的挂载选项
  • 2. 挂载选项详解
    • 基本语法
    • 支持的挂载标志
    • 合并挂载（Merge Mount）
  • 例：使用合并挂载
  • 3. 注意事项
• 高级进阶玩法
  • 1. 脱离ll-builder/ll-box启动一个容器
    • 1.1 具有Root的玲珑开发环境
    • 1.2 Rootless的玲珑开发环境
    • 1.3 基于Ptrace+Rootless的玲珑开发环境
• 疑难解答
• 贡献与维护
• 许可

快速教程

本章节提供一个基于Makefile的简明的打包教程，结合实际案例帮助快速掌握流程。

---

1. 获取与配置 ll-killer

首先，确保系统已安装必要的依赖：

sudo apt install apt-file fuse-overlayfs

然后，下载 ll-killer 并赋予执行权限：

wget https://github.com/System233/ll-killer-go/releases/latest/download/ll-killer-amd64 -O ll-killer
chmod +x ll-killer

全局安装 ll-killer（可选）

为了方便使用，可将 ll-killer 安装到 ~/.local/bin：

mkdir -p ~/.local/bin
mv ll-killer ~/.local/bin

如果 ~/.local/bin 未添加至 PATH，请执行：

echo 'export PATH=$HOME/.local/bin:$PATH' >>~/.bashrc
source ~/.bashrc

---

2. 开始打包一个应用

接下来的步骤默认 ll-killer 已加入 PATH。

创建打包环境

# 创建工作目录并进入
mkdir gimp && cd gimp

# 生成辅助构建文件
ll-killer build-aux

配置软件源

创建 sources.list 并填充 Deepin V23 的软件源：

cat >sources.list <<EOF
 deb [trusted=yes] https://community-packages.deepin.com/deepin/beige beige main commercial community
 deb [trusted=yes] https://com-store-packages.uniontech.com/appstorev23 beige appstore
 deb [trusted=yes] https://community-packages.deepin.com/driver-23/ driver non-free
EOF

创建 config.mk 配置构建参数

make config PKG="gimp" KILLER_CREATE_ARGS="--base org.deepin.base/23.1.0"

参数说明：

• PKG：Deb 包名。
• APPID：玲珑包名，默认值为 ${PKG}.linyaps。
• KILLER_CREATE_ARGS：传递给 ll-killer create 的参数，应确保 base 与 sources.list 匹配。
• KILLER_BUILD_ARGS：传递给 ll-killer build 的参数，可根据需要调整。

指定依赖（可选）

可以创建 deps.list，并在其中列出依赖包名，每行一个。

开始构建

make

构建完成后，最终会生成两个 .layer 文件，仅需 *_binary.layer。

提示: 运行make -n来了解make构建流程，输出示例：

echo "[获取包元数据]"
ll-killer apt -- apt show gimp > pkg.info
echo "[创建玲珑项目]"
ll-killer create --from pkg.info --id "gimp.linyaps"  
touch deps.list
echo "[将包安装至构建环境]"
ll-killer build --ptrace -- apt install -y gimp  | tee apt-install.log
echo "[检查缺失库]"
ll-killer build -- build-aux/ldd-check.sh > ldd-check.log
echo "[搜索缺失库所在包]"
ll-killer apt -- build-aux/ldd-search.sh ldd-check.log ldd-found.log ldd-notfound.log;
echo "[安装找到的缺失库]"
ll-killer build -- apt install -y  | tee apt-install-extra.log;
echo "[提交文件到容器中]"
ll-killer commit -- --skip-output-check --skip-strip-symbols
echo "[导出layer文件]"
ll-killer export -- --layer

测试构建结果

此命令创建容器环境的shell，请结合desktop中的Exec指令来测试程序。

ll-builder run

run命令默认执行/opt/apps/APPID/files/entrypoint.sh入口点。 如需进入原始玲珑容器环境，请运行：

ll-builder run --exec bash

安装构建结果

# 玲珑 >= 1.7.x 版本需要 sudo 权限
ll-cli install *_binary.layer

清理构建缓存（可选）

如果需要清理构建过程中产生的缓存，可执行：

make clean-ll   # 删除玲珑缓存
make clean-fs   # 删除构建缓存
make clean-apt  # 删除 apt 缓存
make clean      # 删除所有缓存

---

3. 挂载模式说明

ll-killer 运行时支持 fuse-overlayfs 和 merge 两种根文件系统挂载模式。

fuse-overlayfs 模式

• 需确保 fuse-overlayfs 为 静态编译 或能直接在容器中运行。
• 需要将 fuse-overlayfs 二进制文件复制到 build-aux 目录。
• 启动速度快，但要求宿主机支持 fuse 内核模块。

merge 模式（默认回退）

• 若 fuse-overlayfs 不可用或运行失败，则自动回退至 merge 模式。
• 需要计算合并目录，目录冲突越多，合并时间越长。
• 兼容性好，作为兜底方案。

模式对比

模式	启动速度	依赖 fuse	兼容性
fuse-overlayfs	快	是	低
merge	慢	否	高

构建过程中遇到目录写入问题？

请参考 疑难解答 章节，并根据需要调整 make 传递的 KILLER_BUILD_ARGS 参数。

---

安装与配置

获取 ll-killer

你可以下载预编译的二进制，或手动编译本项目。

使用预编译二进制

在项目 Release 页下载预编译的二进制文件，一般使用amd64版本，下载后改名为ll-killer，并添加执行权限。
上述步骤可使用以下命令一键完成：

wget https://github.com/System233/ll-killer-go/releases/latest/download/ll-killer-amd64 -O ll-killer
chmod +x ll-killer

./ll-killer -h

你可以将命令安装至~/.local/bin，以便随时使用。

mkdir -p ~/.local/bin
mv ./ll-killer ~/.local/bin

手动编译

1. 克隆或下载项目源码。

   git clone https://github.com/System233/ll-killer-go.git
   cd ll-killer-go
   

2. 安装 Golang 环境。

   sudo apt install golang
   

3. 使用 make 命令编译并生成可执行文件，默认生成主机架构的二进制。

获取静态fuse-overlayfs（可选）

如需启用fuse-overlayfs模式，需要使用以下命令静态编译fuse-overlayfs。

git clone https://github.com/containers/fuse-overlayfs.git
cd fuse-overlayfs
autoreconf
automake --add-missing
autoreconf
LIBS="-ldl" LDFLAGS="-static" ./configure 
make -j8

环境要求

• Linux 系统（支持多种发行版）
• Go 编译环境
• 主机必须安装 fuse-overlayfs/linglong-bin
• 主机可选安装：apt/apt-file，用于apt相关和依赖查找功能。

命令概览

ll-killer-go 提供了一些核心命令来帮助构建和管理玲珑容器应用：

• apt：进入隔离的 APT 环境。
• build：构建或进入构建环境。
• exec：进入运行时环境。
• run：启动容器，执行应用。
• commit：提交构建内容到玲珑容器。
• clean：清除构建内容。
• build-aux：创建辅助构建脚本。
• ptrace：修正系统调用（目前仅支持 chown 调用）。
• script：执行自定义构建流程。
• help：显示帮助信息。

各命令详细介绍

1. apt — 进入隔离的 APT 环境

应用场景：此命令用于在构建环境中隔离 APT 操作，确保不会污染宿主机环境。在隔离环境中，你可以使用 apt-file 或内置工具（如 ldd-search.sh）来查找包依赖。

用法：

ll-killer apt -- <command> [arguments...]

例如：

ll-killer apt -- bash

注意事项：

• 当前目录下的 apt.conf, apt.conf.d, sources.list, 和 sources.list.d 文件会被挂载到 /etc 目录，可以在这些文件中自定义 APT 配置。
• 隔离环境中的 APT 缓存会被构建容器重用。

2. create — 创建玲珑项目

应用场景：create 命令用于创建新的玲珑容器应用项目。你可以通过此命令生成一个基础项目框架，并根据需要自定义项目的构建命令、应用描述、运行时环境等。此命令还支持从APT Package元数据创建项目，并自动生成相关配置，省去手动查找和配置依赖包的麻烦。

用法：

ll-killer create [flags]

示例：

ll-killer create --name "MyApp" --version "1.0.0""

从APT元数据创建项目

ll-killer create 支持通过apt show输出的包元数据创建项目，以下是创建GIMP图像处理应用项目的示例：

# 将 gimp 包的信息保存到 package.info
apt show gimp > package.info

# 从 package.info 提取信息并在当前目录创建玲珑项目
ll-killer create --name "MyApp" --version "1.0.0" --from "package.info"

该命令会根据 apt show <pkg> 输出的元数据创建应用项目，自动填充包名、描述、版本等信息。

注意事项

• 使用 --from 参数时，可以通过 apt show <pkg> 输出的元数据自动生成项目的基础配置信息。这对于从现有的APT包创建容器应用项目非常有用。
• 默认情况下，ll-killer create会在创建项目时自动构建一次。
• 若指定 --no-build，则只会生成项目的基本模板，而不会自动进行构建步骤。您可以手动根据需求运行构建命令。
• 在从未对项目进行构建(如ll-builder build)的情况下，使用ll-killer build时必须关闭严格模式。

2. build — 构建或进入构建环境

应用场景：构建项目的核心命令。此命令可以进入构建环境，执行各种构建任务，确保以 root 权限执行命令，如 apt 安装等。你还可以自定义构建命令。

用法：

ll-killer build [flags] -- <build command> [arguments...]

例如：

ll-killer build -- make install

注意事项：

• 构建环境在退出后不会消失，你可以多次进入环境进行调整。
• 使用 --strict 标志可以启动严格模式，确保与运行时环境一致，但此模式下不包括开发工具（如 gcc）。
• 使用 --strict 标志启用严格模式时，项目必须至少使用ll-builder build构建一次
• 构建环境会挂载主机根文件系统，也支持临时根目录和自定义 fuse-overlayfs 配置。
• 主机必须安装fuse-overlayfs

3. exec — 进入运行时环境

应用场景：在项目构建完成后，此命令用于启动和测试容器环境。你可以根据需要进行调试，甚至自定义挂载和权限设置。

用法：

ll-killer exec [flags]

例如：

ll-killer exec -- bash

挂载选项：

• 支持多种挂载选项，例如：--mount /source:/target:options，其中 options 包括支持的挂载标志（如 rw, nosuid 等）和文件系统类型。
• 额外支持 merge 挂载类型，用于在无overlayfs支持下的堆叠文件系统。
• 额外支持 fuse-overlayfs 挂载类型，用于支持基于fuse的堆叠文件系统。
• 当应用运行在不支持fuse的环境中，或fuse-overlayfs不可用时，自动回退merge挂载模式。 详细信息参见挂载相关功能

注意事项：

• 你可以使用 --rootfs 指定不同的根目录路径，支持合并多个目录。
• --uid 和 --gid 可用来指定使用的用户和组 ID。
• 此命令在ll-box容器/ll-builder run/build内部使用，你不应该在主机上运行此命令。

4. run — 启动容器

应用场景：启动构建后的容器进行应用的测试和运行。

用法：

ll-killer run [flags]

此命令等同于 ll-builder run，可用于提供一致的CLI体验。

5. commit — 提交构建内容

应用场景：将构建完成的应用提交到玲珑容器中，确保文件复制、快捷方式和图标修复等操作已完成。

用法：

ll-killer commit [flags]

此命令等同于 ll-builder build，可在 linglong.yaml 文件中对构建指令进行调整。

注意事项：

• 你可以在项目根目录提供一个fuse-overlayfs文件以启用fuse-overlayfs挂载模式

6. clean — 清除构建内容

应用场景：用于清除当前项目的构建环境内容，确保后续的构建不会受到先前内容的影响。

用法：

ll-killer clean [flags]

7. build-aux — 创建辅助构建脚本

应用场景：用于生成一系列辅助构建脚本，帮助开发者修复符号链接、图标路径、依赖问题等。

用法：

ll-killer build-aux [flags]

包含的辅助脚本：

• entrypoint.sh：玲珑容器的入口点。
• env.sh：环境配置脚本。
• ldd-check.sh：检查容器内缺失的库。
• ldd-search.sh：查找缺失库的所在包。
• relink.sh：修复容器内的符号链接。
• setup-desktop.sh：修复桌面文件中的图标和执行指令。
• setup-filesystem.sh：从构建环境复制文件到目标目录。
• setup-icon.sh：将图标文件按尺寸放置到指定位置。
• setup.sh：调用上述工具，将构建环境内容复制到玲珑容器中，并执行相关补丁。

8. ptrace — 修正系统调用

应用场景：此命令用于拦截并修正构建过程中的系统调用，目前仅支持修正 chown 调用，避免权限问题。

用法：

ll-killer ptrace -- <command> [arguments...]

例如：

ll-killer ptrace -- chown root:root /path/to/file

无论chown设置所有者为谁，都只会设置成自己，以确保该命令成功。
此功能用于忽略apt安装某些库过程中可能出现的权限问题。

注意事项：

• 此模式将极大降低目标的性能

9. script — 执行自定义构建脚本

应用场景：用于执行自定义的构建流程，确保环境能够找到 ll-killer 二进制文件。

用法：

ll-killer script -- <build script> [arguments...]

此命令等同于：

KILLER_EXEC=path/to/ll-killer <build script> [arguments...]

注意事项

• 使用 --help 参数可以查看每个子命令的详细帮助信息。
• 确保在项目创建和构建阶段，linglong.yaml 配置文件已经正确设置。
• 严格模式下，构建环境中不会包含开发工具，如编译器等，仅包含运行时环境所需的最小工具集。

挂载相关功能

ll-killer 提供了强大的挂载功能，使你能够灵活地管理和调整容器中的文件系统。通过挂载选项，你可以将主机上的目录或文件与容器内的目录进行绑定、合并或覆盖。本文将详细介绍如何使用 ll-killer 的挂载功能以及常见的用法和注意事项。

ll-killer的--mount支持常见的mount挂载标志，支持的文件系统包括overlay、tmpfs、devpts，支持额外的merge和fuse-overlayfs文件系统挂载类型。

1. 进入运行时环境并挂载文件系统

你可以使用 --mount 参数来挂载主机文件系统到容器内。以下是几个常见的挂载用法示例。

例 1: 使用 merge 合并文件系统

在运行时环境中，使用当前用户的 UID 和 GID，合并挂载文件系统并使用 /myrootfs 的内容覆盖容器根文件系统。合并文件系统使你能够在没有内核 overlayfs 或 fuse 模块的支持下，堆叠多个源目录。

ll-killer exec --mount /+/myrootfs:/rootfs::merge -- bash

解释：

• /+/myrootfs: 这是合并挂载的源目录。多个源目录使用 + 符号分隔。
• /rootfs: 这是目标目录，即容器内的根文件系统将会被合并到此目录。
• ::merge: 指定合并挂载类型。

例 2: 挂载源路径到目标路径，指定用户和组

将主机上的 /path/to/source 目录挂载到容器内的 /path/to/target 目录，同时指定容器中运行进程的 UID 和 GID。

ll-killer exec --mount /path/to/source:/path/to/target --uid 2000 --gid 2000 --chroot=false

解释：

• /path/to/source:/path/to/target: 源路径与目标路径的映射关系。
• --uid 2000 --gid 2000: 指定容器内进程的 UID 和 GID。
• --chroot=false: 禁用 chroot 环境。

例 3: 使用自定义的 Unix 套接字和合并根目录路径

挂载自定义的 Unix 套接字文件和合并根文件系统路径。该命令支持将 /etc 目录挂载到容器内。

ll-killer exec --socket /tmp/myapp.sock --rootfs /tmp/myapp.rootfs --mount /etc:/etc

解释：

• --socket /tmp/myapp.sock: 指定自定义的 Unix 套接字文件。
• --rootfs /tmp/myapp.rootfs: 指定合并后的根文件系统路径。
• --mount /etc:/etc: 挂载主机的 /etc 目录到容器的 /etc。

例 4: 使用不同的挂载选项

你可以为挂载操作指定多个选项，例如读写权限、禁用某些功能等。

ll-killer exec --mount /data:/data:rw+nosuid --uid 1000 --gid 1000 --rootfs /var/run/myapp.rootfs

解释：

• --mount /data:/data:rw+nosuid: 将 /data 目录挂载为读写模式，并禁用 setuid 位。
• --uid 1000 --gid 1000: 指定 UID 和 GID。
• --rootfs /var/run/myapp.rootfs: 使用自定义根文件系统路径。

2. 挂载选项详解

基本语法

挂载选项使用 --mount 参数，语法如下：

--mount 源目录:目标目录:挂载标志:文件系统类型:额外数据

• 源目录：挂载的源目录，支持多个源目录时，使用 + 符号分隔。
• 目标目录：容器内的目标目录，文件系统将被挂载到此位置。
• 挂载标志：类似于系统的 mount 命令，支持多种挂载选项（如 bind、rbind 等）。
• 文件系统类型：默认为 none，可以指定特定的文件系统类型。
• 额外数据：可以指定排除某些目录等附加信息。

支持的挂载标志

ll-killer 支持以下挂载标志，具体的标志根据你的需求选择使用：

• bind、rbind：常用的挂载标志，表示源目录和目标目录的绑定。
• noexec：禁止在挂载的文件系统上执行二进制文件。
• nosuid：禁止设置 setuid 位。
• rw、ro：指定文件系统的读写模式。
• async、sync：指定挂载时的异步或同步操作。
• private、shared：指定挂载的共享类型。

具体可以参考 Linux mount 命令的挂载标志，ll-killer 提供了大部分常见的挂载选项。

合并挂载（Merge Mount）

ll-killer 提供了一种特殊的挂载类型——合并挂载（merge）。这使你能够将多个目录堆叠在一起，在不依赖内核的 overlayfs 或 fuse 模块的情况下实现文件系统层叠。

语法：

--mount 源目录1+源目录2+源目录N:目标目录:挂载标志:merge:排除目录1+排除目录2+排除目录N

• 源目录：支持多个源目录，多个源目录之间用 + 分隔。
• 目标目录：合并文件系统挂载的目标位置。
• 挂载标志：指定挂载类型，默认为 bind 或 rbind。
• 文件系统类型：必须为 merge。
• 排除目录：防止合并特定目录，默认为 /proc、/dev、/tmp、/run 等目录。

例：使用合并挂载

ll-killer exec --mount /dir1+/dir2:/mnt/merged:merge

解释：

• /dir1+/dir2: 将两个目录合并在一起，dir2 中的文件将覆盖 dir1 中的冲突文件。
• /mnt/merged: 合并后的文件系统将挂载到这个目标目录。

3. 注意事项

• 在进行合并挂载时，文件系统的优先级按从右到左的顺序决定，越靠后的目录优先级越高，后挂载的目录中的冲突文件会覆盖前面挂载的文件。
• 如果某目录只在一个源目录中出现，它将直接绑定到目标目录。如果该目录是只读的，那么挂载后的文件夹也会保持只读属性。
• 合并挂载对于没有内核 overlayfs 或 fuse 模块支持的系统仍然有效，适用于跨平台的使用场景。

通过 ll-killer 的挂载功能，你可以灵活地管理容器环境中的文件系统，使得容器的构建和运行更加高效和隔离。

高级进阶玩法

1. 脱离ll-builder/ll-box启动一个容器

在最新的ll-killer中，可以使用ll-killer exec子命令直接启动容器环境，从而绕过玲珑容器的一系列限制，同时支持root和rootless权限。

此功能与传统的容器工具（如runc、podman等）有异曲同工之妙，但ll-killer不依赖OCI标准配置，直接通过命令行传递参数，避免了shell处理JSON配置文件难的问题，也避免了显式配置CAP，允许从当前环境继承各类权限。

1.1 具有Root的玲珑开发环境

此容器中的root具有和宿主机相同的权限，主要用于解决文件系统权限相关的问题，在基于内核的idmap挂载实现之前，不失为一种解决办法。

# 填写玲珑base的存储地址，在这个目录中：~/.cache/linglong-builder/layers/main/中
# 格式： {BASE名称}/{BASE版本}/{架构}/{binary运行时版本/develop开发版本}
# export KILLER_DEBUG=1 # ll-killer调试模式
BASE_DIR="/home/uos/.cache/linglong-builder/layers/main/org.deepin.base/23.1.0.2/arm64/binary/files/"
CWD=$(pwd)
FS="$CWD/linglong/filesystem"
ROOTFS=$FS/merged
mkdir -p $FS/{merged,diff,work}
ll-killer exec \
--mount "overlay:$FS/merged::overlay:lowerdir=$BASE_DIR,upperdir=$FS/diff,workdir=$FS/work" \
--mount "/proc:$ROOTFS/proc:rbind" \
--mount "/dev:$ROOTFS/dev:rbind" \
--mount "/tmp:$ROOTFS/tmp:rbind" \
--mount "/sys:$ROOTFS/sys:rbind" \
--mount "/etc/resolv.conf:$ROOTFS/etc/resolv.conf:rbind" \
--rootfs $ROOTFS \
--root \
-- ${@:-sh}

使用root权限执行上述命令即可获得一个具有真实root权限的玲珑容器运行时环境，你可以在其中安装所需的软件，文件系统差异由overlay文件系统自动捕获到$FS/diff中。

若已在当前项目使用ll-killer创建并初始化玲珑项目，可以直接使用ll-killer commit命令打包本应用。

注意事项：

• 此模式下会产生root所属的文件。

1.2 Rootless的玲珑开发环境

Rootless环境中的用户身份仍然是root，但该root不是真实的root，它的权限与运行命令时用户的权限相同。
使用非root用户执行之前的shell脚本即可进入rootless玲珑开发环境，可以在环境中正常运行任何不影响文件权限的命令，包括apt安装等，只是一旦应用使用的chown等命令，则会遇到权限问题。

注意事项：

• 由于尚未实现内核idmap挂载，存在文件权限问题，这个问题请看下一节。

1.3 基于Ptrace+Rootless的玲珑开发环境

在上一个章节中已经讲述了如何启动rootless开发环境，但是存在一些权限问题，本章节提供了一种权限问题的缓解办法。

ll-killer提供了一个ptrace子命令，该命令在amd64、arm64和loong64(未测试)架构上可用。 该命令可以拦截子命令的chown系统调用，使其重定向到当前用户，可以避免出现权限问题。

示例： 在rootless容器中执行此命令，可规避apt install时出现的chown错误。

ll-killer ptrace -- apt install <deb>

# 即便当前UID不是1234，也没有ROOT权限，此命令也不会错误。
ll-killer ptrace -- chown 1234:1234 test

# 直接进入一个屏蔽chown错误的命令行环境。
ll-killer ptrace -- bash

注意事项：

• 此模式将极大降低程序性能，请仅在开发环境使用。

疑难解答

build环境内使用apt安装出现chown权限问题
可以添加--ptrace参数解决。

build环境内某些目录写入出现Permission denied
是因为系统仓库内置的fuse-overlayfs有bug所致，需要重新编译最新版本，参考获取静态fuse-overlayfs章节。

build环境内某些文件写入出现Operation not permitted，但可读取
因为内核没有启用EVM，需要启用内核EVM，或使用make ENABLE_NO_EVM=yes重新编译ll-killer-go。

使用root模式构建后，ll-killer commit/ll-builder build出现错误
删除linglong文件夹，或chown -R $(id -u):$(id -g) linglong将文件所有者改为自己。

apt安装某些包时总是提示依赖不满足
请确保sources.list中列出的源与玲珑base兼容。

贡献与维护

欢迎对 ll-killer-go 提交问题报告、特性请求和贡献代码。请遵循项目的贡献指南来提交你的代码或文档改进。

许可

ll-killer-go 项目采用 MIT License 进行开源。

Documentation

Overview

* Copyright (c) 2025 System233 * * This software is released under the MIT License. * https://opensource.org/licenses/MIT