SSHRD_Script  by verygenericname

Shell script for creating SSH ramdisk on checkm8 devices

created 3 years ago
484 stars

Top 64.3% on sourcepulse

GitHubView on GitHub
Project Summary

This script automates the creation and booting of SSH ramdisks for checkm8-vulnerable iOS devices (A7-A11). It targets jailbreakers and security researchers seeking to gain SSH access to their devices for advanced operations like file system manipulation, debugging, and custom modifications. The primary benefit is simplifying a complex, multi-step process into a few commands.

How It Works

The script leverages a collection of specialized tools (pzb, iBoot64Patcher, img4tool, img4lib) to construct a custom ramdisk image compatible with specific iOS versions. It then uses device-specific modes (DFU, Recovery) and potentially usbmuxd to load and boot this ramdisk onto the target device, establishing an SSH connection. The approach is advantageous by abstracting the intricacies of ramdisk patching and device communication.

Quick Start & Requirements

  • Install: Clone the repository (git clone https://github.com/verygenericname/SSHRD_Script --recursive) and navigate into it (cd SSHRD_Script).
  • Requirements: macOS or Linux computer, a checkm8-vulnerable device (A7-A11). Linux users may need to restart usbmuxd (sudo systemctl stop usbmuxd then sudo usbmuxd -p -f).
  • Usage: Run ./sshrd.sh <iOS version> to create the ramdisk, ./sshrd.sh boot to boot it, and ./sshrd.sh ssh to connect.
  • Docs: Reddit Post

Highlighted Details

  • Supports booting SSH ramdisks for various iOS versions.
  • Includes commands for rebooting, erasing, and dumping SHSH blobs.
  • Offers functionality to clean up old ramdisk files.
  • Integrates contributions and fixes from notable figures in the jailbreaking community.

Maintenance & Community

  • Credits notable contributors like tihmstar, xerub, Cryptic, opa334, Ploosh, and OpenAI.
  • Community discussion likely found via the linked Reddit post.

Licensing & Compatibility

  • The script itself appears to be a collection of tools, some of which may have their own licenses. The README does not explicitly state a license for the script's aggregation. Compatibility for commercial use is not specified.

Limitations & Caveats

  • Linux users are advised against using iOS versions 16.1+ due to APFS ramdisk changes requiring different DMG libraries.
  • Users are warned not to run the script on "really old versions" of iOS.
  • The script's compatibility is tied to the checkm8 exploit, limiting it to A7-A11 devices.
Health Check
Last commit

1 month ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
1
Star History
26 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.