Kazeta镜像构建指南Docker冻结软件源打造可复现的Arch游戏OS ISO【免费下载链接】kazetaRetro 90s style gaming operating system项目地址: https://gitcode.com/gh_mirrors/ka/kazetaKazeta 是一款复古 90s 风格的游戏操作系统Gaming OS基于 Arch Linux 构建开箱即玩老游戏。本文带你用 Docker 与冻结的软件归档源亲手复现构建 Kazeta 的 Arch 游戏 OS ISO 镜像保证每次构建结果完全一致。为什么需要“冻结软件源”Arch Linux 是滚动发行版软件包每天都在更新。如果直接拉取最新源打包今天和明天构建出的 ISO 内容完全不同出了问题还难以排查。Kazeta 的解法很巧妙锁定到昨天的归档快照。构建脚本会读取归档日期把 pacman 的镜像地址改写为官方归档站Serverhttps://archive.archlinux.org/repos/ARCHIVE_DATE/$repo/os/$arch这样无论何时构建拿到的都是同一个时间点的软件包版本——这就是“可复现构建Reproducible Build”的核心。归档日期由manifest文件中的ARCHIVE_DATE默认取“昨天”决定相关逻辑位于Dockerfile第 45-49 行。上图为 Kazeta 复古 BIOS 启动界面的背景纹理最终 ISO 开机即见这套 640×360 的低分辨率像素 UI一键 Docker 构建步骤 整个构建环境本身就是一个 Docker 镜像步骤如下第 1 步获取源码git clone https://gitcode.com/gh_mirrors/ka/kazeta cd kazeta第 2 步构建构建环境镜像docker build -t kazeta-builder .这一步会基于archlinux:base-devel完成以下工作详见Dockerfile安装arch-install-scripts、pyalpm、wget等打包必备工具从 AUR 编译安装pikaurAUR 包管理器用一个“假的 systemd-run 脚本”绕过 pikaur 对 systemd 的依赖容器里没有 systemd关闭 check 依赖与 debug 包生成加快构建速度改写 mirrorlist 指向归档站冻结软件源第 3 步运行构建并导出 ISO构建镜像内定义了OUTPUT_DIR/output环境变量把该目录挂载到宿主机即可拿到成品docker run -v $PWD/output:/output -it kazeta-builder容器内按manifest声明的包清单执行装机流程最终 ISO 输出到宿主机output/目录。核心文件与目录速览路径作用Dockerfile构建环境定义装工具、冻结软件源、配置 pikaurmanifest系统“配方”包清单、开机服务、装机后钩子rootfs/预置的系统配置文件覆盖层bios/Rust 编写的复古 BIOSRust 依赖见bios/Cargo.tomlUI 逻辑在bios/src/main.rsaur-pkgs/本地 AUR 包存放目录manifest是整份“配方”的灵魂它声明了系统基础包greetd、gamescope、nvidia-open、vulkan-intel/radeon、pipewire全家桶等游戏栈组件AUR 包downgrade、frzr、udev-media-automountU 盘游戏卡带自动挂载开机服务greetd登录界面、inputplumber手柄映射postinstallhook 钩子自动挂载存储、禁用 SPDIF 输出、把所有手柄强制模拟成 Xbox 360 控制器、持久化游戏存档到/var/kazeta 装机体验同样复古登录由rootfs/etc/greetd/config.toml配置启动kazeta-sessionBIOS 支持手柄操作、8-bit 音效bios/下的move.wav、select.wav等并能将游戏存档打包成“卡带”存到 U 盘。常见构建问题与解决方法1. 容器内pacman报空间检查错误rootfs/etc/pacman.conf中保留了CheckSpace项但Dockerfile会先将其注释掉chroot 内无法检查宿主机磁盘空间不要手动还原这一行。2. 构建时拉到了“新”的软件包检查manifest的ARCHIVE_DATE——它默认为构建当天减一天属于正常行为若需完全锁定可将其硬编码为固定日期如2026-08-01再构建。3. AUR 包安装失败构建环境已预装pikaur且配置了 PGP key 自动获取/etc/gnupg/gpg.conf。若仍失败多半是 AUR 包依赖变动可参考Dockerfile中PACKAGE_OVERRIDES机制把预先编译好的.pkg.tar.zst覆盖安装进来。小结冻结归档源archive.archlinux.org 固定ARCHIVE_DATE是 Kazeta 镜像可复现的关键Dockerfile 即构建环境一条docker build即可还原完整打包沙箱manifest 即系统配方改包、改服务、改钩子都从它入手️ 构建产物是一张开箱即玩的 Arch 游戏 OS ISO配合bios/的复古 BIOS 与卡带存档系统复刻 90 年代掌机体验动手构建一张属于自己的 Kazeta ISO把复古游戏体验装进任意硬件吧【免费下载链接】kazetaRetro 90s style gaming operating system项目地址: https://gitcode.com/gh_mirrors/ka/kazeta创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考