Files
runaway/unleash
T
ruihan b8759a2acc feat: add check and monitor commands + repo About section
- check: pre-format/pre-upgrade MDM assessment with clear SAFE/DETECTED output
- monitor: background daemon (5min interval) with osascript notifications
- monitor-stop / monitor-status: control the daemon
- Updated repo description (About) and topics
- Updated README, CHANGELOG, CI for both commands
- Bump 1.1.0 -> 1.2.0
2026-06-20 12:06:21 -03:00

409 lines
9.1 KiB
Bash
Executable File

#!/bin/bash
set -euo pipefail
# Single-script MDM bypass for macOS. Recovery mode. Apple Silicon + Intel.
VERSION="1.2.0"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
LIB_DIR="$SCRIPT_DIR/lib"
for _lib in colors detect validate dscl suppress backup status heal firewall harden whitelist check monitor; do
_lib_path="$LIB_DIR/$_lib.sh"
if [ -f "$_lib_path" ]; then
# shellcheck disable=SC1090
source "$_lib_path"
else
echo "ERROR: Library not found: $_lib_path" >&2
exit 1
fi
done
cmd_version() {
echo "unleash v$VERSION"
exit 0
}
cmd_bypass() {
if is_recovery; then
header "unleash — Full MDM Bypass"
local data_mount
data_mount=$(resolve_data_volume)
full_bypass_mode "$data_mount"
else
error_exit "Full bypass must run from Recovery mode."
fi
}
cmd_suppress() {
header "unleash — Suppress Enrollment Only"
local data_mount
data_mount=$(resolve_data_volume)
suppress_only_mode "$data_mount"
}
cmd_backup() {
header "unleash — Backup State"
local data_mount
data_mount=$(resolve_data_volume)
backup_state "$data_mount"
}
cmd_restore() {
header "unleash — Restore State"
restore_state
}
cmd_dualboot() {
header "unleash — Dual-Boot Mode"
if ! is_root; then
error_exit "Dual-boot mode requires sudo: sudo ./unleash dualboot"
fi
local volumes
volumes=$(resolve_target_volumes)
local sys_path="${volumes%%|*}"
local data_path="${volumes##*|}"
info "Target system: $sys_path"
info "Target data: $data_path"
local node
node=$(dscl_node "$data_path")
echo ""
step "Creating admin account on target"
prompt_default realName "Full name" "Apple"
local username
prompt_username username
local passw
prompt_password passw
local uid
uid=$(find_available_uid "$node")
create_admin_user "$node" "$data_path" "$username" "$realName" "$passw" "$uid"
touch "$data_path/private/var/db/.AppleSetupDone"
step "Blocking domains on target..."
local hosts_file="$data_path/private/etc/hosts"
[ -f "$hosts_file" ] || touch "$hosts_file"
echo "0.0.0.0 deviceenrollment.apple.com" >>"$hosts_file"
echo "0.0.0.0 mdmenrollment.apple.com" >>"$hosts_file"
echo "0.0.0.0 iprofiles.apple.com" >>"$hosts_file"
success "MDM domains blocked"
local config_path="$data_path/private/var/db/ConfigurationProfiles/Settings"
mkdir -p "$config_path"
rm -f "$config_path/.cloudConfigHasActivationRecord" \
"$config_path/.cloudConfigRecordFound"
touch "$config_path/.cloudConfigProfileInstalled" \
"$config_path/.cloudConfigRecordNotFound"
success "Configuration profiles reset"
echo ""
echo -e "${GRN}============================================${NC}"
echo -e "${GRN} Dual-Boot Bypass Applied ${NC}"
echo -e "${GRN}============================================${NC}"
echo ""
echo -e "${CYAN}Boot into the target installation and login:${NC}"
echo -e "${YEL} User: $username${NC}"
echo -e "${YEL} Pass: $passw${NC}"
}
cmd_heal() {
header "unleash — Auto-Heal"
if is_recovery; then
local data_mount
data_mount=$(resolve_data_volume)
heal_suppress "$data_mount"
else
if ! is_root; then
error_exit "Heal from booted system requires sudo: sudo ./unleash heal"
fi
heal_suppress ""
fi
}
cmd_persist() {
header "unleash — Install Persistence"
local data_mount
if is_recovery; then
data_mount=$(resolve_data_volume)
else
if ! is_root; then
error_exit "Persistence requires sudo: sudo ./unleash persist"
fi
data_mount=""
fi
install_persist_launchdaemon "$data_mount"
}
cmd_unpersist() {
header "unleash — Remove Persistence"
local data_mount
if is_recovery; then
data_mount=$(resolve_data_volume)
else
data_mount=""
fi
remove_persist_launchdaemon "$data_mount"
}
cmd_firewall() {
header "unleash — pf Firewall MDM Block"
if ! is_root; then
error_exit "Firewall requires sudo: sudo ./unleash firewall"
fi
if is_recovery; then
local data_mount
data_mount=$(resolve_data_volume)
install_pf_mdm_block "$data_mount"
else
install_pf_mdm_block ""
fi
}
cmd_firewall_off() {
header "unleash — Remove pf Firewall"
if ! is_root; then
error_exit "Requires sudo: sudo ./unleash firewall-off"
fi
if is_recovery; then
local data_mount
data_mount=$(resolve_data_volume)
remove_pf_mdm_block "$data_mount"
else
remove_pf_mdm_block ""
fi
}
cmd_harden() {
header "unleash — Live-OS Hardening"
if ! is_root; then
error_exit "Hardening requires sudo: sudo ./unleash harden"
fi
if is_recovery; then
info "Hardening from Recovery will skip live-OS checks"
harden_live_os
else
harden_live_os
fi
}
cmd_audit() {
header "unleash — Deep MDM Audit"
if ! is_root; then
error_exit "Audit requires sudo: sudo ./unleash audit"
fi
deep_status
}
cmd_whitelist() {
header "unleash — Selective MDM Block"
if ! is_root; then
error_exit "Whitelist requires sudo: sudo ./unleash whitelist"
fi
if is_recovery; then
local data_mount
data_mount=$(resolve_data_volume)
install_selective_block "$data_mount"
else
install_selective_block ""
fi
}
cmd_status() {
if is_recovery; then
local data_mount
data_mount=$(resolve_data_volume)
check_mdm_status "$data_mount"
else
error_exit "Status check must run from Recovery mode."
fi
}
cmd_check() {
header "unleash — Pre-Format Assessment"
if ! is_root; then
error_exit "Check requires sudo: sudo ./unleash check"
fi
run_preformat_check
echo ""
check_upgrade_safety
}
cmd_monitor() {
monitor_mdm
}
cmd_monitor_stop() {
stop_monitor
}
cmd_monitor_status() {
monitor_status
}
cmd_interactive_recovery() {
header "unleash — Recovery Mode"
local data_mount
data_mount=$(resolve_data_volume)
echo ""
PS3="Choose an option: "
local options=(
"Full bypass (create admin + suppress MDM)"
"Suppress enrollment only (no user)"
"Auto-heal (check and re-suppress)"
"Install pf firewall (blocks all Apple services)"
"Remove pf firewall"
"Install selective block (iCloud-safe)"
"Live-OS harden (kill MDM processes)"
"Deep MDM audit"
"Backup current state"
"Restore from backup"
"Check MDM status"
"Reboot"
"Exit"
)
select opt in "${options[@]}"; do
case $opt in
"Full bypass (create admin + suppress MDM)")
full_bypass_mode "$data_mount"
echo -e "${CYAN}Reboot to apply changes.${NC}"
;;
"Suppress enrollment only (no user)")
suppress_only_mode "$data_mount"
;;
"Auto-heal (check and re-suppress)")
heal_suppress "$data_mount"
;;
"Install pf firewall (blocks all Apple services)")
install_pf_mdm_block "$data_mount"
;;
"Remove pf firewall")
remove_pf_mdm_block "$data_mount"
;;
"Install selective block (iCloud-safe)")
install_selective_block "$data_mount"
;;
"Live-OS harden (kill MDM processes)")
harden_live_os
;;
"Deep MDM audit")
deep_status
;;
"Backup current state")
backup_state "$data_mount"
;;
"Restore from backup")
restore_state
;;
"Check MDM status")
check_mdm_status "$data_mount"
;;
"Reboot")
info "Rebooting..."
reboot
;;
"Exit")
exit 0
;;
*)
echo -e "${RED}Invalid option $REPLY${NC}"
;;
esac
done
}
cmd_interactive_normal() {
header "unleash"
echo -e "${YEL}Not in Recovery mode. Limited options.${NC}"
echo ""
PS3="Choose an option: "
local options=(
"Suppress enrollment only"
"Auto-heal (check and re-suppress)"
"Backup current state"
"Restore from backup"
"Exit"
)
select opt in "${options[@]}"; do
case $opt in
"Suppress enrollment only")
local data_mount
data_mount=$(resolve_data_volume)
suppress_only_mode "$data_mount"
;;
"Auto-heal (check and re-suppress)")
if ! is_root; then
error_exit "Heal from booted system requires sudo. Run: sudo ./unleash"
fi
heal_suppress ""
;;
"Backup current state")
local data_mount
data_mount=$(resolve_data_volume)
backup_state "$data_mount"
;;
"Restore from backup")
restore_state
;;
"Exit")
exit 0
;;
*)
echo -e "${RED}Invalid option $REPLY${NC}"
;;
esac
done
}
main() {
case "${1:-}" in
bypass) cmd_bypass ;;
suppress) cmd_suppress ;;
heal) cmd_heal ;;
persist) cmd_persist ;;
unpersist) cmd_unpersist ;;
firewall) cmd_firewall ;;
firewall-off) cmd_firewall_off ;;
harden) cmd_harden ;;
audit) cmd_audit ;;
whitelist) cmd_whitelist ;;
backup) cmd_backup ;;
restore) cmd_restore ;;
dualboot) cmd_dualboot ;;
status) cmd_status ;;
check) cmd_check ;;
monitor) cmd_monitor ;;
monitor-stop) cmd_monitor_stop ;;
monitor-status) cmd_monitor_status ;;
version|-v|--version) cmd_version ;;
help|-h|--help)
echo "Usage: $0 {bypass|suppress|heal|persist|unpersist|firewall|firewall-off|harden|audit|whitelist|check|monitor|monitor-stop|monitor-status|backup|restore|dualboot|status|version|help}"
exit 0
;;
"")
if is_recovery; then
cmd_interactive_recovery
else
cmd_interactive_normal
fi
;;
*)
echo -e "${RED}Unknown command: $1${NC}" >&2
echo "Usage: $0 {bypass|suppress|heal|persist|unpersist|firewall|firewall-off|harden|audit|whitelist|check|monitor|monitor-stop|monitor-status|backup|restore|dualboot|status|version|help}" >&2
exit 1
;;
esac
}
main "$@"