rename project to runaway

This commit is contained in:
2026-11-09 10:13:51 +08:00
parent 5857081832
commit c9feb8c05a
95 changed files with 1034 additions and 1034 deletions
+11 -11
View File
@@ -1,20 +1,20 @@
---
layout: default
title: Architecture Guide — unleash
title: Architecture Guide — runaway
---
# Architecture Guide
## The Five Layers of MDM
Apple's MDM enrollment works through five independent mechanisms. Blocking just one or two is why bypass tools fail over time. Unleash addresses all five.
Apple's MDM enrollment works through five independent mechanisms. Blocking just one or two is why bypass tools fail over time. Runaway addresses all five.
```
Layer 1: DEP markers ─── /var/db/ConfigurationProfiles/Settings/.cloudConfig*
Layer 2: Hosts block ─── /etc/hosts → 0.0.0.0 deviceenrollment.apple.com
Layer 3: Daemons ─── launchd disabled → ManagedClient.enroll, activationd
Layer 4: User data ─── ~/Library/Preferences/com.apple.mdm.*
Layer 5: pf firewall ─── pf anchor com.unleash/mdm → kernel-level drop
Layer 5: pf firewall ─── pf anchor com.runaway/mdm → kernel-level drop
```
### Layer 1: DEP Enrollment Markers
@@ -100,8 +100,8 @@ pf (packet filter) operates at the kernel networking layer, below DNS resolution
## Script Architecture
```
unleash/
├── unleash # Main entry point — loads libs, dispatches commands
runaway/
├── runaway # Main entry point — loads libs, dispatches commands
├── lib/
│ ├── colors.sh # Logging, colors, prompts, show_cmd_help()
│ ├── detect.sh # Recovery detection, volume mounting
@@ -138,28 +138,28 @@ unleash/
### Dispatch Flow
1. `unleash` loads all `lib/*.sh` modules
2. `load_config()` reads `~/.unleash.conf` (if exists)
1. `runaway` loads all `lib/*.sh` modules
2. `load_config()` reads `~/.runaway.conf` (if exists)
3. Command argument is matched against the `case` dispatch in main
4. Handler function is called (e.g., `cmd_bypass`, `cmd_firewall`)
5. Each handler calls lib functions that do the actual work
### Standalone Build
`examples/build-standalone.sh` concatenates all lib modules + main script body into a single file (`unleash-standalone.sh`, ~3200 lines). No external dependencies — runs on any macOS system with bash.
`examples/build-standalone.sh` concatenates all lib modules + main script body into a single file (`runaway-standalone.sh`, ~3200 lines). No external dependencies — runs on any macOS system with bash.
## Build Process
1. **Source**: Individual `lib/*.sh` modules + `unleash` entry point
1. **Source**: Individual `lib/*.sh` modules + `runaway` entry point
2. **Test**: 78 Bats tests covering all modules
3. **Build**: `bash examples/build-standalone.sh` → `unleash-standalone.sh`
3. **Build**: `bash examples/build-standalone.sh` → `runaway-standalone.sh`
4. **Sign**: `scripts/sign-release.sh` → GPG detached signature
5. **Release**: GitHub release with standalone + signature + checksums
## Security Design
### No root persistence
Unleash does not install a backdoor, create hidden users, or modify the system volume. All changes are reversible.
Runaway does not install a backdoor, create hidden users, or modify the system volume. All changes are reversible.
### GPG-signed releases
Releases are signed with a GPG key. `selfupdate` verifies the signature before applying updates. Signature verification must pass or the update is rejected.