Docker-eyeOS 使用教程

1、项目介绍

Docker-eyeOS 是一个开源项目，旨在通过 Docker 容器运行 iPhone 的 xnu-qemu-arm64（iOS）系统。该项目支持 KVM 和 GDB 内核调试，可以在任何设备上运行。Docker-eyeOS 提供了一个探索平台，供研究人员和对 XNU 内核感兴趣的人使用。

2、项目快速启动

安装 Docker

首先，确保你的系统上已经安装了 Docker。你可以通过以下命令来安装 Docker：

# 在 Ubuntu/Debian 系统上
sudo apt-get update
sudo apt-get install docker.io

# 在 CentOS 系统上
sudo yum install -y docker

# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker

克隆项目仓库

克隆 Docker-eyeOS 项目仓库到本地：

git clone https://github.com/sickcodes/Docker-eyeOS.git
cd Docker-eyeOS

运行 Docker-eyeOS

使用以下命令运行 Docker-eyeOS 容器：

docker run -it --privileged \
  --device /dev/kvm \
  -e RAM=6 \
  -e HFS_MAIN=/images/hfs_main \
  -e HFS_SEC=/images/hfs_sec \
  -p 2222:2222 \
  -v "$PWD:/home/arch/docker-eyeos/images" \
  -e "DISPLAY=${DISPLAY:-:0.0}" \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -p 1233:1234 \
  -e GDB_ARGS='-S -s' \
  sickcodes/docker-eyeos:latest

3、应用案例和最佳实践

内核调试

Docker-eyeOS 支持 GDB 内核调试，可以通过以下步骤进行内核调试：

1. 启动 Docker-eyeOS 容器。
2. 进入容器并启动 GDB：

docker exec -it <container_id> /bin/bash -c "cd /home/arch/docker-eyeos/xnu-qemu-arm64-tools/gdb; gdb-multiarch -q"

3. 加载 GDB 脚本并连接到远程目标：

source load.py
target remote localhost:1234

文件系统挂载

你可以通过以下命令挂载磁盘并进行文件操作：

sudo losetup -f
sudo mount /dev/loop0 /mnt

4、典型生态项目

Docker-OSX

Docker-OSX 是另一个由 Sick Codes 开发的项目，它允许在 Docker 容器中运行 macOS。你可以通过以下命令运行 Docker-OSX：

docker run --device /dev/kvm \
  --device /dev/snd \
  -e RAM=12 \
  -p 50922:10022 \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  sickcodes/docker-osx:latest

xnu-qemu-arm64

xnu-qemu-arm64 是一个用于模拟 ARM64 架构的 iOS 系统的 QEMU 项目。Docker-eyeOS 使用了这个项目来实现 iOS 系统的运行。

通过以上步骤，你可以快速启动并使用 Docker-eyeOS 项目，进行 iOS 内核调试和探索。希望你能享受这个开源项目带来的乐趣！