#linuxpkg

状态：0.2.0 已发布到 mooncakes（Xpeng/linuxpkg）。deb 和 rpm 的构建、检查、校验都已可用。

#它是什么

• 用一份 linuxpkg.json，把任意程序和文件打成 Debian / Ubuntu / 统信 UOS / 麒麟用的 .deb 以及 Fedora / openEuler / 龙蜥用的 .rpm。
• 能读取、检查、校验已有的 .deb 和 .rpm（包括官方工具生成的包）。
• 不依赖 dpkg-deb、rpmbuild 等系统工具，所以在 Windows、macOS 上也能产出 Linux 包。
• 可复现构建：同样的输入逐字节产出同样的包（支持 SOURCE_DATE_EPOCH）。
• 核心库不碰文件系统，可在 wasm / wasm-gc / js / native 四个后端运行；只有命令行读写文件。

#当前功能

#安装与构建

moon add Xpeng/linuxpkg

moonx Xpeng/linuxpkg/cmd/main@0.2.0 inspect /绝对路径/hello_1.0.0-1_all.deb
moonx Xpeng/linuxpkg/cmd/main@0.2.0 verify /绝对路径/hello-1.0.0-1.noarch.rpm

git clone https://github.com/pxgt/linuxpkg
cd linuxpkg
moon build --target native cmd/main    # Windows 上请用 wasm-gc，或在 WSL 里用 native
moon run cmd/main --target wasm-gc -- --help

#快速开始

linuxpkg init                                    # 写出一份示例 linuxpkg.json
linuxpkg build examples/hello/linuxpkg.json --out dist     # 同时生成 deb 和 rpm（--format deb|rpm|all）
linuxpkg inspect dist/hello_1.0.0-1_all.deb      # 看元数据和文件列表
linuxpkg inspect dist/hello-1.0.0-1.noarch.rpm --json
linuxpkg verify dist/hello-1.0.0-1.noarch.rpm    # 退出码 0 表示通过

#配置文件

{
  "name": "hello",
  "version": "1.0.0",
  "release": "1",
  "arch": "all",
  "maintainer": "Your Name <you@example.org>",
  "description": "一行摘要\n后面几行是详细说明",
  "mtime": 1700000000,
  "depends": ["libc6 (>= 2.31)"],
  "contents": [
    { "src": "hello.sh", "dst": "/usr/bin/hello", "mode": "0755" },
    { "src": "hello", "dst": "/usr/bin/hi", "type": "symlink" },
    { "src": "hello.conf", "dst": "/etc/hello.conf", "type": "config" },
    { "dst": "/var/lib/hello", "type": "dir" }
  ],
  "scripts": { "postinstall": "scripts/postinst.sh" }
}

• 字段名参考 nFPM；contents[].type 可以是 file（默认）、config、dir、symlink； mode 写成八进制字符串（"0755"）；owner / group 默认 root； 也可以把 mode、owner、group、mtime 放进 nFPM 风格的 file_info。
• arch 接受 amd64、x86_64、arm64、aarch64、all、noarch 等写法，会自动换成 deb / rpm 各自的名字。
• 版本里的预发布用 ~（1.0~rc1），不要用 -。
• 路径必须是绝对路径，不能含 ..，不能重复；错误信息会指出出错的字段（如 contents[2].dst）。
• 没写 mtime 时，用环境变量 SOURCE_DATE_EPOCH，再没有就用 0。

#它是怎么被验证的

• 我们生成的 deb → dpkg-deb --info/--contents/--extract、dpkg -i、dpkg --verify、dpkg -r、dpkg -P 都接受，装好后程序能运行， 配置文件在 dpkg -r 时保留、dpkg -P 时清除；lintian 的结果会记录下来。
• 我们生成的 rpm → rpm -K（头部与 payload 的 SHA-256 摘要 OK）、rpm -qip、rpm -qlp、rpm -qcp、--scripts、--requires/--provides、 rpm2cpio | cpio 解出的文件与源文件逐字节相同；在私有 --root 里 rpm -i、rpm -V（无差异）、rpm -e； 在 Fedora 41、openEuler 24.03 LTS 容器里 rpm -ivh / dnf install 都能装、能跑、脚本会执行、能卸载。
• 官方工具生成的包（dpkg-deb 的 gzip / xz deb，rpmbuild 的 gzip / xz / zstd rpm）→ 我们的 inspect / verify 能正确读取， rpm 的 SHA-1 / MD5 / SHA-256 头部摘要、payload 摘要和每个文件的摘要都会核对；xz / zstd 压缩的内容会明确报“不支持的压缩”，不会崩溃。
• Fedora 官方仓库里下载的真实 rpm（zstd payload）：inspect 读到的名称、版本、release、架构、文件列表与 rpm -qp 一致。
• 我们写出的 ustar 归档与 GNU tar 1.34 逐字节一致；GNU tar 写出的 ustar / pax / gnu 三种格式我们都能读回。
• 同样的输入构建两次，结果逐字节相同；wasm、wasm-gc、native 产出相同的包。

#质量数字

• 测试：179 个，wasm-gc、wasm、js、native 四个后端全部通过。
• 核心包行覆盖率 95.7%（spec 97.6%、tar 97.3%、ar 96.4%、cpio 100%、deb 94.3%、rpm 94.1%、gunzip 88.2%），CI 强制不低于 80%（tools/check_core_coverage.py）。
• 恶意输入：tar、ar、cpio、deb、rpm 的每一种截断和每个字节翻转都只会得到结果或明确的错误，不会崩溃；gzip 炸弹在解压时就被上限截住。

#范围与不做的事

• 包签名（GPG / PGP）、软件仓库元数据（apt 的 Release/Packages、yum 的 repodata）
• xz / zstd / lzma / bzip2 压缩（只支持 gzip 和不压缩；读到其他压缩会报 unsupported）
• Alpine apk、Arch pkg、源码包（.dsc、.src.rpm）
• 自动分析二进制的动态库依赖
• 运行维护者脚本（只负责打包，不负责安装）

#相关项目与致谢

• MoonBit 生态里已有 xmyd0915/moonar（ar 归档）和 oilleelssq-wq/moon-cpio（cpio 归档）两个底层零件。 linuxpkg 自己实现了 ar / tar / cpio，是为了完全控制确定性输出，并让归档格式与打包逻辑一起被官方工具验证；对这两个项目表示尊重。
• 配置字段命名参考 nFPM（MIT）。
• rpm 的头部布局、tag 与不可变区域参考 google/rpmpack（Apache-2.0）的格式知识，以 rpm 官方工具的实测结果为准，用 MoonBit 重新实现，没有复制代码。
• gzip 来自 moonbit-community/flate，摘要来自 moonbitlang/x/crypto。

#开发

moon fmt --check
moon info && git diff --exit-code          # 公开接口 pkg.generated.mbti 要保持最新
moon check --target all --deny-warn
moon test --target wasm-gc                 # 也可以换 js、wasm；native 在 Linux/WSL 上跑
tools/oracle/run.sh                        # 需要 dpkg-deb、dpkg、sudo（可选 lintian）

#许可证