Linux 下安装与运行 checkra1n 全流程指南（含依赖修复与系统检测）

Linux 下安装与使用 checkra1n 完整指南（含依赖修复）

checkra1n 是一款基于 checkm8 硬件漏洞 的 iOS 越狱工具，支持 iPhone 5s ～ iPhone X 等设备，常用于 iOS 逆向、安全研究与系统调试。

本文完整记录在 Linux 系统 下安装、修复依赖、验证以及运行 checkra1n 的全过程，适合 Debian / Ubuntu / Linux Mint 等发行版，也可作为排错参考。

零、先确认你的系统信息（uname -a，强烈推荐）

在安装 checkra1n 或手动下载依赖包之前，强烈建议先确认自己的系统信息与 CPU 架构，避免下错架构或错误判断系统环境。

使用 uname -a 查看系统信息

bash 复制代码

uname -a

示例输出（本文环境）

text 复制代码

Linux jet-pc 6.14.0-37-generic #37~24.04.1-Ubuntu SMP PREEMPT_DYNAMIC Thu Nov 20 10:25:38 UTC 2 x86_64 x86_64 x86_64 GNU/Linux

关键信息解读

Linux：操作系统内核类型
6.14.0-37-generic：当前内核版本
Ubuntu 24.04.1：发行版（可判断新旧系统）
x86_64：CPU 架构（64 位）

为什么这一步很重要

判断应下载 x86_64 / arm / arm64 哪个 checkra1n 版本
判断是否为 新内核 / 新系统，提前预期依赖问题
对逆向、越狱、USB 驱动兼容性排查非常关键

✅ 像 Ubuntu 22.04 / 24.04 + 新内核环境，更容易遇到 libncurses5 缺失问题，本文后续提供了完整解决方案。

一、checkra1n Linux 版本说明

checkra1n 提供多种 Linux 构建版本，适配不同：

Linux 发行版
CPU 架构

支持的 CPU 架构

CLI（命令行）版本支持：

x86_64
arm
arm64
i486

如果不是 Debian 系发行版，可直接下载对应架构的 CLI 二进制文件运行。

二、Debian / Ubuntu 推荐安装方式（APT 仓库）

官方推荐在 Debian 系发行版中使用 APT 仓库 安装，优点包括：

安装与更新方便
依赖管理规范
系统集成度高

三、通过官方 APT 仓库安装 checkra1n

1️⃣ 导入官方 GPG 密钥

bash 复制代码

wget -O - https://assets.checkra.in/debian/archive.key \
| gpg --dearmor \
| sudo tee /usr/share/keyrings/checkra1n.gpg >/dev/null

2️⃣ 添加 checkra1n 软件源

bash 复制代码

echo 'deb [signed-by=/usr/share/keyrings/checkra1n.gpg] https://assets.checkra.in/debian /' \
| sudo tee /etc/apt/sources.list.d/checkra1n.list

3️⃣ 更新软件源

bash 复制代码

sudo apt-get update

4️⃣ 安装 checkra1n（可能失败）

bash 复制代码

sudo apt-get install checkra1n

在较新的 Debian / Ubuntu 系统中，这一步可能会失败，常见报错如下。

四、APT 安装失败：libncurses5 依赖问题

典型错误信息：

text 复制代码

checkra1n : 依赖: libncurses5 (>= 6.0) 但无法安装它
E: 无法修正错误，因为您要求某些软件包保持现状

原因说明

新系统默认只提供 libncurses6
libncurses5 已被移除
checkra1n 仍依赖旧版 ncurses ABI

因此需要 手动安装依赖库。

五、手动安装 checkra1n 依赖库（推荐方案）

1️⃣ 下载依赖包

下载 libncurses5

bash 复制代码

wget http://ftp.de.debian.org/debian/pool/main/n/ncurses/libncurses5_6.4-4_amd64.deb

下载 libtinfo5（前置依赖）

bash 复制代码

wget http://archive.ubuntu.com/ubuntu/pool/universe/n/ncurses/libtinfo5_6.3-2_amd64.deb

⚠️ 注意：libncurses5 依赖 libtinfo5，必须先安装

2️⃣ 先安装 libtinfo5

bash 复制代码

sudo dpkg -i libtinfo5_6.3-2_amd64.deb

3️⃣ 再安装 libncurses5

bash 复制代码

sudo dpkg -i libncurses5_6.4-4_amd64.deb

4️⃣ 重新安装 checkra1n

bash 复制代码

sudo apt-get install checkra1n

至此，依赖问题通常可以解决。

六、验证 checkra1n 是否安装成功

查看版本号

bash 复制代码

sudo checkra1n --version

正常输出示例

text 复制代码

Checkra1n beta 0.12.4
b8f4b6618c4408f58f0f9b5053443bdb4da994bc

判断标准

能正常显示版本号
无 command not found
无依赖库报错

即表示安装成功。

七、运行 checkra1n 程序

启动命令

bash 复制代码

sudo checkra1n

⚠️ 必须使用 sudo，否则无法访问 USB 与 DFU 接口。

GUI / CLI 两种运行模式

有桌面环境：弹出图形界面
无桌面 / SSH：命令行模式

可强制使用 CLI：

bash 复制代码

sudo checkra1n -c

常用参数

参数	说明
`-c`	强制命令行模式
`--help`	查看帮助
`--version`	查看版本

八、使用注意事项

使用主板 USB 接口，避免 Hub
使用稳定数据线
虚拟机需开启 USB 直通
正确进入 DFU 模式
建议关闭 USB 省电策略

九、总结

Debian / Ubuntu：优先 APT 安装
依赖错误：手动安装 libtinfo5 + libncurses5
成功标志：checkra1n --version 正常输出
Linux 是非常适合 checkra1n 与 iOS 逆向的环境

建议将本文作为 Linux 下 checkra1n 的完整安装与排错参考文档保存。