PS5 Y2JB Autoloader构建系统拆解:Makefile、CI生成download0.dat与Git子模块依赖管理

原创2026-10-22 15:39:192,468 阅读
文章标签:应用安全逆向工程

PS5 Y2JB Autoloader构建系统拆解:Makefile、CI生成download0.dat与Git子模块依赖管理

PS5 Y2JB Autoloader 是一款面向已越狱 PS5 主机的自动化 payload 加载工具,支持固件 4.03–13.60,能自动运行内核漏洞利用并加载你的 elf 载荷。本文拆解它的构建系统:Makefile 如何生成版本号与更新包、build.sh 如何一站式打包、Git 子模块如何锁定依赖版本,以及 CI 如何用 FreeBSD 虚拟机产出 PS5 能识别的 download0.dat 磁盘镜像。

PS5 Y2JB Autoloader运行界面:内核漏洞利用完成后自动加载elf载荷并提示Autoload finished

🗂 项目结构与构建流程一览

构建体系由四个角色协作完成,各自职责如下:

文件 职责
Makefile 版本号生成、占位符替换、打包 y2jb_update.zip
build.sh 构建入口:准备依赖二进制 → 调用 make
scripts/download_deps.sh 按子模块锁定版本下载预编译依赖
.github/workflows/dev.yml / stable.yml CI:打包 → 制作 UFS2 镜像 → 发布 Release

整体流程:

build.sh(准备 elfldr/kexp 依赖二进制到 src/)
    ↓
make all → 替换占位符 → y2jb_update.zip
    ↓
CI 解压 zip 到 download0/cache/splash_screen/
    ↓
FreeBSD 虚拟机制作 UFS2 磁盘镜像 download0.dat
    ↓
gh release 发布 y2jb_update.zip + download0.dat

Makefile 拆解:版本号从哪来

版本号 = 基础版本 + Git Commit 哈希

在 Makefile 中,版本由三部分拼成:

  • 基础版本:VERSION := 1.0.3
  • GIT_HASH:当前 HEAD 的短哈希(如 185cdf8)
  • 脏检查:git status --porcelain 非空时(有未提交改动),用时间戳代替哈希,避免本地脏构建与 CI 版本混淆

由此得到版本号示例:

构建类型 干净工作区 有未提交改动
stable v1.0.3-185cdf8 v1.0.3-20261022052708
dev(默认) v1.0.3-dev-185cdf8 v1.0.3-dev-20261022052708

随时可以用 make print-version 查看当前版本,CI 正是靠这一步给 Release 打标签。

构建动作:替换占位符再打包

源码中埋了三个"占位符",构建时用 sed 替换为真实值:

all 目标(Makefile)的执行顺序:

  1. 把 src/ 整体拷贝到 build_dir/
  2. sed 替换上述占位符
  3. 调用 third_party/y2jb-updater/create_update_package.py 将 build_dir 打包为 y2jb_update.zip(这就是用户放进 U 盘根目录即可完成更新的文件)
  4. 清理 build_dir/

构建产物(zip、依赖二进制、镜像)都写入了 .gitignore,不会污染仓库。

build.sh:一站式构建入口

build.sh 是本地和 CI 共用的入口,支持以下参数:

参数 作用
--stable / --dev 选择构建类型,决定版本号格式
--build-deps(-b) 从子模块源码编译依赖
--download-deps(-d) 从依赖仓库的 Releases 下载预编译二进制
(不传) 自动模式

自动模式的决策逻辑非常实用:

  1. src/ 下三个二进制(kexp-*.bin、elfldr-ps5-*.elf、ps5-unified-autoloader.elf)齐全 → 直接跳过依赖准备
  2. 子模块已检出(存在 .git 标记)→ 编译源码,并用 git describe --tags 取得版本名
  3. 子模块未初始化 → 走 scripts/download_deps.sh 下载预编译版本

最后统一执行 make all BUILD_TYPE=... 完成打包。CI 中固定使用 --download-deps,保证每次构建的依赖版本与子模块锁定的提交完全一致。

Git 子模块依赖管理:如何锁定第三方版本

.gitmodules 声明了 4 个子模块,全部位于 third_party/:

子模块 提供的二进制 用途
third_party/ps5-elfldr/ elfldr-ps5-*.elf 仅接受本机连接的自定义 ELF Loader(更安全)
third_party/ps5-kexp/ kexp-*.bin PS5 越狱后 shellcode
third_party/ps5-unified-autoloader/ ps5-unified-autoloader.elf 统一 autoloader 载荷
third_party/y2jb-updater/ create_update_package.py 生成更新包 zip

锁定与解析机制

  • 锁定:Git 通过 gitlink 把每个子模块钉在某个 commit 上,git submodule update --init --recursive 即可还原确定状态
  • 解析:scripts/download_deps.sh 的 resolve_dep_release_url 会先查子模块 HEAD 对应的 tag,再调 GitHub API 找到该 tag 的 Release 下载 URL;若 tag 解析失败,回退为用锁定 commit 的前 7 位哈希去所有 Release 中匹配
  • 回传版本:脚本把解析出的 elfldr_ver / kexp_ver / unified_autoloader_ver 写入 GITHUB_OUTPUT,CI 随后将其写进 Release 说明的 "Bundled Binaries" 区块,用户一眼可见本次打包集成的是哪些依赖版本

💡 这套"子模块钉 commit + 按 commit 反查 Release"的设计,保证了源码构建与预编译下载两条路径产出一致的依赖版本。

CI 生成 download0.dat:为什么需要 FreeBSD 虚拟机?

这是整个构建系统最巧妙的部分。download0.dat 是 PS5 主机的原生 UFS2 文件系统磁盘镜像,YouTube 应用(PPSA01650 等)会自动下载它;Autoloader 正是藏身于其中的 cache/splash_screen/ 目录下(参见 README.md 的 Setup 说明)。

而 Linux 构建机没有 UFS2 的完整工具链,所以 CI 在 dev.yml 中拉起一台 FreeBSD 14.2 虚拟机(vmactions/freebsd-vm action)来完成制盘:

步骤 命令 说明
1 truncate -s 336789504 download0.dat 创建约 321 MB 的空镜像
2 mdconfig -a -t vnode 挂为内存虚拟磁盘
3 newfs -O 2 -b 32768 -f 4096 创建 UFS2(块 32K、片 4K)
4 mount + cp -R 把 download0/ 内容拷入
5 chmod -R 777 保证主机侧权限可读
6 umount + mdconfig -d 卸载并释放镜像

制盘前的准备工作(dev.yml):将 y2jb_update.zip 解压到 download0/cache/splash_screen/aHR0cHM6Ly93d3cueW91dHViZS5jb20vdHY=/(该 Base64 目录名模拟 YouTube 应用的下载缓存路径),并删除 update-info.txt。

dev 与 stable 双通道发布

两个 workflow 结构几乎相同,区别只在版本号与发布形态:

  • dev(dev.yml):./build.sh --dev --download-deps,gh release create --prerelease 发布为预发布
  • stable(stable.yml):./build.sh --stable --download-deps,发布正式 Release

Release 附带两个资产:y2jb_update.zip(U 盘热更新用)和 download0.dat(FTP 部署用),Release 说明还自动生成相对上一个 stable 版本的变更对比链接。

❓ 常见问题

Q:为什么不在 Linux 上直接制作镜像? A:UFS2 是 FreeBSD 原生文件系统,Linux 侧缺乏可靠的写盘工具链,用 FreeBSD 虚拟机是保真度最高的方案。

Q:如何在本地构建? A:克隆仓库(git clone https://gitcode.com/gh_mirrors/ps/ps5-y2jb-autoloader)后执行:

git submodule update --init --recursive   # 检出子模块
./build.sh --dev                          # 自动选择构建或下载依赖
file download0.dat                        # CI 同款校验命令

Q:如何确认构建出的版本号? A:make print-version BUILD_TYPE=dev(或 stable),CI 的 Get Version 步骤用的就是它。

📁 关键文件路径汇总

登录后查看全文
ps5-y2jb-autoloader