Files
runaway/docs/security.md
T
ruihan 75f4ec53ab
CI / Bash Syntax Check (push) Successful in 8s
CI / Markdown Lint (push) Failing after 8s
CI / ShellCheck (push) Failing after 1m26s
chore: migrate all URLs to git.jskdjs.cn, drop GitHub-specific distribution
2026-11-09 10:31:11 +08:00

1.8 KiB

layout, title
layout title
default Security — runaway

Security & Safety

Design Principles

No root persistence

Runaway does not install backdoors, create hidden users, or modify the system volume. All changes target the Data volume only and are fully reversible.

GPG-signed releases

Every release is signed with a GPG key. The update command verifies the signature before applying updates. If verification fails, the update is rejected.

Opt-in telemetry

Telemetry is OFF by default. If enabled, it sends only anonymous counts:

  • Command name executed
  • macOS version
  • Success/failure status

No serial numbers, IPs, or personally identifiable information.

No internet dependency

Core commands (bypass, suppress, heal) work entirely offline. Only update, firewall (DNS resolution), and discord-bot need network access.


Safety Guarantees

  • No SSV writes — all changes target the Data volume
  • Reversible — backup saves state, restore reverts
  • No data erasure — never runs profiles renew or erase commands
  • Idempotent — running multiple times is harmless
  • Prompts for confirmation before destructive actions

Risk Levels

Level Description Commands
Safe Read-only, no changes status, check, doctor, audit, predict, report
Low Writes hosts file only suppress, heal
Medium Creates/modifies system files bypass, dualboot, persist, whitelist
High Kernel-level firewall firewall, vpn-kill
Destructive Full removal uninstall, reinstall

Responsible Disclosure

Found a security issue? See the Security Policy.