Files
runaway/runaway
T
ruihan c2b55fc015
CI / ShellCheck (push) Failing after 12s
CI / Bash Syntax Check (push) Successful in 12s
CI / Markdown Lint (push) Successful in 15s
chore: remove remaining upstream author and origin-repo references
2026-11-09 10:45:03 +08:00

674 lines
18 KiB
Bash
Executable File

#!/bin/bash
set -euo pipefail
VERSION="2.0.0"
# shellcheck disable=SC2034 # used by lib modules
STANDALONE_BUILD=false
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
# shellcheck disable=SC2034 # used by lib modules
SCRIPT_PATH="$SCRIPT_DIR/$(basename "$0")"
LIB_DIR="$SCRIPT_DIR/lib"
for _lib in colors config detect validate dscl suppress backup status launchd heal firewall harden whitelist check monitor history doctor selfupdate uninstall report ma_detect demo vpn init suggest remediate telemetry predict discord; do
_lib_path="$LIB_DIR/$_lib.sh"
if [ -f "$_lib_path" ]; then
# shellcheck disable=SC1090 # libs live in $SCRIPT_DIR/lib
source "$_lib_path"
else
echo "ERROR: Library not found: $_lib_path" >&2
exit 1
fi
done
show_cmd_help() {
case "$1" in
bypass) echo "Bypass MDM from Recovery. Creates admin user." ;;
suppress) echo "Suppress enrollment without creating a user." ;;
admin) echo "Create an admin user without suppressing enrollment." ;;
heal) echo "Re-apply suppression after macOS updates." ;;
persist) echo "Install auto-heal LaunchDaemon." ;;
unpersist) echo "Remove auto-heal LaunchDaemon." ;;
firewall) echo "Block MDM IPs via pf (kernel-level). DoH-proof." ;;
firewall-off) echo "Remove pf MDM block." ;;
harden) echo "Kill MDM processes + remove profiles + flush DNS." ;;
audit) echo "Deep system scan with risk score." ;;
whitelist) echo "Block only MDM domains, keep iCloud/App Store." ;;
backup) echo "Save current state." ;;
restore) echo "Restore from backup." ;;
dualboot) echo "Target an external macOS install." ;;
status) echo "Show MDM enrollment status (Recovery only)." ;;
check) echo "Pre-format / pre-upgrade safety report." ;;
history) echo "Show event log from monitor/heal runs." ;;
history-clear) echo "Clear event log." ;;
monitor) echo "Start background MDM monitor (5 min interval)." ;;
monitor-install) echo "Install monitor as LaunchDaemon." ;;
monitor-uninstall) echo "Remove monitor LaunchDaemon." ;;
monitor-stop) echo "Stop the monitor daemon." ;;
monitor-status) echo "Check if monitor is running." ;;
doctor) echo "Run pre-flight diagnostics; --network reports the build and Wi-Fi state." ;;
init) echo "Interactive setup wizard." ;;
suggest) echo "Risk-based recommendations." ;;
remediate) echo "Per-org MDM cleanup." ;;
predict) echo "Look up serial number enrollment." ;;
telemetry) echo "Manage anonymous usage stats (opt-in)." ;;
discord-bot) echo "Start Discord MDM alert bot." ;;
discord-bot-stop) echo "Stop Discord bot." ;;
discord-bot-status) echo "Check Discord bot status." ;;
demo) echo "Simulated bypass flow (no changes)." ;;
update) echo "Self-update from the latest release." ;;
uninstall) echo "Remove all Runaway traces." ;;
reinstall) echo "Uninstall + clean install." ;;
report) echo "Generate full status report (markdown or --json)." ;;
config) echo "View/edit ~/.runaway.conf settings." ;;
vpn-kill) echo "Install pf kill-switch (blocks MDM outside VPN)." ;;
vpn-kill-remove) echo "Remove VPN kill-switch." ;;
vpn-kill-status) echo "Check VPN kill-switch status." ;;
version) echo "Show version and exit." ;;
help) show_help ;;
*) show_help ;;
esac
}
show_help() {
cat <<'HELP'
Usage: ./runaway <command> [options]
Bypass / suppress / monitor MDM enrollment on macOS.
COMMANDS
Core:
bypass Full MDM bypass from Recovery (creates admin user)
suppress Silence enrollment, no user created
admin Create an admin user without suppressing enrollment
heal Check + re-apply suppression after macOS updates
Persistence:
persist Install LaunchDaemon (auto-heal on every boot)
unpersist Remove the persistence LaunchDaemon
Firewall:
firewall Block Apple MDM at kernel level via pf
firewall-off Remove pf rules
whitelist Block only MDM endpoints, keep iCloud/App Store
Living System:
harden Kill MDM processes + remove profiles + flush DNS
audit Deep system scan with risk score
Monitoring:
check Pre-format / pre-upgrade safety report
history Show event log from monitor/heal runs
test Dry-run mode: simulate without changing anything
monitor Background daemon (watches MDM every 5 min)
monitor-install Install monitor as LaunchDaemon (boot persistent)
monitor-uninstall Remove monitor LaunchDaemon
monitor-stop Stop the daemon
monitor-status Check if daemon is running
State:
backup Save hosts, profiles, launchd state
restore Revert from backup
dualboot Target an external macOS install
init Interactive setup wizard
suggest Risk-based recommendations
remediate Per-org MDM cleanup
predict Look up serial number enrollment
telemetry Manage anonymous usage stats (opt-in)
Diagnostics:
doctor Run pre-flight checks on this environment
report Generate a full markdown status report
history Show event log from monitor/heal runs
test Dry-run mode: simulate without changing anything
demo Run simulated bypass flow (no real changes)
VPN:
vpn-kill Install VPN kill-switch (prevents MDM leaks outside VPN)
vpn-kill-remove Remove VPN kill-switch
vpn-kill-status Check VPN kill-switch status
Management:
config View/edit persistent settings (~/.runaway.conf)
update Self-update to the latest release
uninstall Remove all Runaway traces from the system
reinstall Uninstall + reinstall (persist + whitelist + monitor)
discord-bot Start Discord MDM alert bot
discord-bot-stop Stop Discord bot
discord-bot-status Check Discord bot status
Info:
status Show MDM enrollment status (Recovery only)
version Show version
help This message
ALIASES
st status
ls status
fw firewall
fw-off firewall-off
wl whitelist
sv suppress
by bypass
adm admin
mn monitor
mn-install monitor-install
mn-uninstall monitor-uninstall
mn-stop monitor-stop
mn-st monitor-status
doc doctor
up update
uni uninstall
rei reinstall
vk vpn-kill
vkr vpn-kill-remove
vks vpn-kill-status
OPTIONS
--verbose Show debug messages
--dry-run Simulate without making changes
--log-file <f> Write logs to file (appended)
Run without arguments for interactive menu.
HELP
}
cmd_version() {
echo "runaway v$VERSION"
exit 0
}
cmd_bypass() {
if is_recovery; then
if [ "$DRY_RUN" = true ]; then
full_bypass_mode "the selected Data volume"
return
fi
header "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() {
if [ "$DRY_RUN" = true ]; then
suppress_only_mode "the selected Data volume"
return
fi
header "Suppress Enrollment"
local data_mount
data_mount=$(resolve_data_volume)
suppress_only_mode "$data_mount"
}
cmd_backup() {
header "Backup"
local data_mount
data_mount=$(resolve_data_volume)
backup_state "$data_mount"
}
cmd_admin() {
if ! is_recovery; then
error_exit "Admin creation must run from Recovery mode."
fi
if [ "$DRY_RUN" = true ]; then
admin_only_mode "the selected Data volume"
return
fi
header "Create Local Admin User"
local data_mount
data_mount=$(resolve_data_volume)
admin_only_mode "$data_mount"
}
cmd_restore() {
header "Restore"
restore_state
}
cmd_dualboot() {
if [ "$DRY_RUN" = true ]; then
info "[DRY RUN] Would select an external macOS installation and create an admin account."
info "[DRY RUN] Would update its hosts file and enrollment markers."
return 0
fi
if ! is_root; then
error_exit "Dual-boot needs sudo: sudo ./runaway dualboot"
fi
header "Dual-Boot Mode"
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"
local realName
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"
begin "Blocking domains"
local hosts_file="$data_path/private/etc/hosts"
[ -f "$hosts_file" ] || touch "$hosts_file"
printf '%s\n' "0.0.0.0 deviceenrollment.apple.com" "0.0.0.0 mdmenrollment.apple.com" "0.0.0.0 iprofiles.apple.com" >>"$hosts_file"
end_ok
begin "Resetting config profiles"
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"
end_ok
info "User: $username"
info "Log in with the password entered above."
info "Boot the target and login."
}
cmd_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 needs sudo: sudo ./runaway heal"
fi
heal_suppress ""
fi
}
cmd_persist() {
local data_mount
if is_recovery; then
data_mount=$(resolve_data_volume)
else
if ! is_root; then
error_exit "Persistence needs sudo: sudo ./runaway persist"
fi
data_mount=""
fi
install_persist_launchdaemon "$data_mount"
}
cmd_unpersist() {
local data_mount
if is_recovery; then
data_mount=$(resolve_data_volume)
else
data_mount=""
fi
remove_persist_launchdaemon "$data_mount"
}
cmd_firewall() {
if ! is_root; then
error_exit "Firewall needs sudo: sudo ./runaway 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() {
if ! is_root; then
error_exit "Needs sudo: sudo ./runaway 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() {
if ! is_root; then
error_exit "Hardening needs sudo: sudo ./runaway harden"
fi
if is_recovery; then
info "In Recovery — will skip live-OS checks"
fi
harden_live_os
}
cmd_audit() {
if ! is_root; then
error_exit "Audit needs sudo: sudo ./runaway audit"
fi
deep_status
}
cmd_whitelist() {
if ! is_root; then
error_exit "Whitelist needs sudo: sudo ./runaway 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 works from Recovery. Try 'check' or 'audit' instead."
fi
}
cmd_check() {
if ! is_root; then
error_exit "Check needs sudo: sudo ./runaway check"
fi
run_preformat_check
echo ""
check_upgrade_safety
}
cmd_monitor() {
local webhook=""
local args=()
while [ $# -gt 0 ]; do
case "$1" in
install|uninstall) args+=("$1"); shift ;;
--webhook)
if [ $# -lt 2 ] || [ -z "$2" ]; then error_exit "--webhook requires a URL"; fi
webhook="$2"; shift 2 ;;
*) args+=("$1"); shift ;;
esac
done
set -- "${args[@]}"
if [ -n "$webhook" ]; then
# shellcheck disable=SC2034 # used by lib/discord.sh
DISCORD_WEBHOOK="$webhook"
fi
case "${1:-}" in
install) install_monitor_launchdaemon "" ;;
uninstall) uninstall_monitor_launchdaemon "" ;;
*) monitor_mdm ;;
esac
}
cmd_monitor_stop() { stop_monitor; }
cmd_monitor_status() { monitor_status; }
cmd_history() { show_history; }
cmd_history_clear() { clear_history; }
cmd_test() {
header "Dry Run Mode"
DRY_RUN=true
local cmd="${2:-suppress}"
case "$cmd" in
bypass) info "Simulating: bypass"; cmd_bypass ;;
suppress) info "Simulating: suppress"; cmd_suppress ;;
heal) info "Simulating: heal"; cmd_heal ;;
harden) info "Simulating: harden"; cmd_harden ;;
firewall) info "Simulating: firewall"; cmd_firewall ;;
whitelist) info "Simulating: whitelist"; cmd_whitelist ;;
all)
info "Simulating all available operations..."
info ""
DRY_RUN=true suppress_enrollment "/"
info ""
DRY_RUN=true full_bypass_mode "/"
info ""
info "Dry-run complete. No changes were made."
;;
*) info "Usage: ./runaway test {bypass|suppress|heal|harden|firewall|whitelist|all}" ;;
esac
}
cmd_interactive_recovery() {
header "runaway"
local data_mount
data_mount=$(resolve_data_volume)
echo ""
PS3="Choose: "
local options=(
"Full bypass (create admin + suppress MDM)"
"Suppress enrollment only"
"Create local admin user only"
"Auto-heal"
"Install pf firewall"
"Remove pf firewall"
"Install selective block (iCloud-safe)"
"Live-OS harden"
"Deep MDM audit"
"Backup state"
"Restore from backup"
"Check MDM status"
"Pre-format check"
"Reboot"
"Exit"
)
select opt in "${options[@]}"; do
case $opt in
"Full bypass (create admin + suppress MDM)")
full_bypass_mode "$data_mount"
info "Reboot to apply."
;;
"Suppress enrollment only")
suppress_only_mode "$data_mount"
;;
"Create local admin user only")
admin_only_mode "$data_mount"
;;
"Auto-heal")
heal_suppress "$data_mount"
;;
"Install pf firewall")
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")
harden_live_os
;;
"Deep MDM audit")
deep_status
;;
"Backup state")
backup_state "$data_mount"
;;
"Restore from backup")
restore_state
;;
"Check MDM status")
check_mdm_status "$data_mount"
;;
"Pre-format check")
run_preformat_check
;;
"Reboot")
info "Rebooting..."
reboot
;;
"Exit")
exit 0
;;
*)
echo -e "${RED}Invalid option $REPLY${NC}"
;;
esac
done
}
cmd_interactive_normal() {
header "runaway"
echo -e "${YEL}Not in Recovery. Limited options.${NC}"
echo " Try: sudo ./runaway heal | harden | audit | check | monitor"
echo ""
PS3="Choose: "
local options=(
"Auto-heal"
"Backup state"
"Restore from backup"
"Exit"
)
select opt in "${options[@]}"; do
case $opt in
"Auto-heal")
if ! is_root; then
error_exit "Heal needs sudo. Run: sudo ./runaway"
fi
heal_suppress ""
;;
"Backup 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 $REPLY${NC}"
;;
esac
done
}
parse_global_opts() {
PARSED_ARGS=()
while [ $# -gt 0 ]; do
# shellcheck disable=SC2034 # globals used by lib modules
case "$1" in
--verbose) VERBOSE=true; shift ;;
--dry-run) DRY_RUN=true; shift ;;
--log-file)
if [ $# -lt 2 ] || [ -z "$2" ]; then error_exit "--log-file requires a path"; fi
case "$2" in --*) error_exit "--log-file requires a path" ;; esac
LOG_FILE="$2"; shift 2 ;;
--) shift; PARSED_ARGS+=("$@"); break ;;
*) PARSED_ARGS+=("$1"); shift ;;
esac
done
}
main() {
load_config
parse_global_opts "$@"
if [ "${PARSED_ARGS[0]+present}" = present ]; then
set -- "${PARSED_ARGS[@]}"
else
set --
fi
# Per-command help
if [ "${2:-}" = "--help" ] || [ "${2:-}" = "-h" ]; then
show_cmd_help "${1:-}"
exit 0
fi
case "${1:-}" in
bypass|by) cmd_bypass ;;
suppress|sv) cmd_suppress ;;
admin|adm) cmd_admin ;;
heal) cmd_heal ;;
persist) cmd_persist ;;
unpersist) cmd_unpersist ;;
firewall|fw) cmd_firewall ;;
firewall-off|fw-off) cmd_firewall_off ;;
harden) cmd_harden ;;
audit) cmd_audit "${2:-}" ;;
whitelist|wl) cmd_whitelist ;;
backup) cmd_backup ;;
restore) cmd_restore ;;
dualboot) cmd_dualboot ;;
status|st|ls) cmd_status ;;
check) cmd_check ;;
history) cmd_history ;;
history-clear) cmd_history_clear ;;
test|dry-run) cmd_test "$@" ;;
monitor|mn) cmd_monitor "$@" ;;
monitor-install|mn-install) install_monitor_launchdaemon "" ;;
monitor-uninstall|mn-uninstall) uninstall_monitor_launchdaemon "" ;;
monitor-stop|mn-stop) cmd_monitor_stop ;;
monitor-status|mn-st) cmd_monitor_status ;;
doctor) run_doctor "${2:-}" ;;
version|-v|--version) cmd_version ;;
init) cmd_init ;;
suggest) cmd_suggest ;;
remediate) cmd_remediate "${2:-}" ;;
predict) cmd_predict "${2:-}" ;;
telemetry) telemetry_opt_in "${2:-}" ;;
demo) run_demo ;;
update) do_self_update ;;
uninstall) do_uninstall ;;
report) generate_report "${2:-}" ;;
config) cmd_config "$@" ;;
vpn-kill) vpn_kill_install "$@" ;;
vpn-kill-remove) vpn_kill_remove ;;
vpn-kill-status) vpn_kill_status ;;
reinstall)
do_uninstall
install_persist_launchdaemon ""
install_selective_block ""
install_monitor_launchdaemon ""
success "Reinstall complete"
;;
discord-bot) cmd_discord_bot_install "${2:-}" "${3:-}" ;;
discord-bot-stop) cmd_discord_bot_stop ;;
discord-bot-status) cmd_discord_bot_status ;;
help|-h|--help) show_help; exit 0 ;;
"")
if is_recovery; then
cmd_interactive_recovery
else
cmd_interactive_normal
fi
;;
*)
echo -e "${RED}Unknown: $1${NC}" >&2
show_help >&2
exit 1
;;
esac
}
main "$@"