将 Docker 容器转变为 Magisk 模块的简明指南

在 Android 玩机或底层开发中，我们经常需要将一个完整的 Linux 环境带到手机上运行。通常我们会使用 Docker 来构建和测试这个环境，但手机上并不能直接运行 Docker。一个巧妙的办法是：**将 Docker 容器的文件系统导出，并打包成一个 Magisk 模块**，利用 Magisk 在开机时自动部署和挂载。

以下是具体的操作步骤。

### 1. 导出 Docker 容器文件系统

首先，在你的电脑上启动并配置好你的 Docker 容器。配置完成后，使用 `docker export` 命令将容器的完整文件系统导出为一个 tar 包。

```bash
# 查看容器 ID 或名称
docker ps

# 导出容器文件系统
docker export <容器ID或名称> -o rootfs.tar

# （可选）压缩以减小模块体积
gzip rootfs.tar
```

### 2. 构建 Magisk 模块目录结构

在本地创建一个工作目录，命名为 `docker_env_module`，并在其中构建标准的 Magisk 模块结构。

```text
docker_env_module/
├── META-INF/
│   └── com/
│       └── google/
│           └── android/
│               ├── update-binary   # Magisk 模块安装脚本
│               └── updater-script  # 占位文件
├── module.prop                     # 模块信息描述
├── rootfs.tar.gz                   # 刚刚导出并压缩的容器环境
└── service.sh                      # 开机自启动脚本
```

**关键文件说明：**

*   **module.prop**: 声明模块的名称、版本等信息。
    ```text
    id=docker_env_rootfs
    name=Docker Container Environment
    version=v1.0
    versionCode=1
    author=YourName
    description=将 Docker 容器环境部署到 Android 设备
    ```
*   **service.sh**: Magisk 会在开机后执行此脚本。我们用它来解压 rootfs 并挂载环境。
    ```bash
    #!/system/bin/sh
    MODDIR=${0%/*}
    ROOTFS_DIR=/data/local/tmp/docker_rootfs

    # 等待系统开机完成
    until [ "$(getprop sys.boot_completed)" ]; do
        sleep 1
    done

    # 如果目标目录不存在，则解压容器环境
    if [ ! -d "$ROOTFS_DIR/bin" ]; then
        mkdir -p "$ROOTFS_DIR"
        tar -xzf "$MODDIR/rootfs.tar.gz" -C "$ROOTFS_DIR"
    fi

    # 这里可以添加你需要执行的 chroot 命令或后台服务
    # chroot "$ROOTFS_DIR" /bin/sh -c "your_startup_command &"
    ```

*(注：`META-INF` 目录下的 `update-binary` 可以直接从官方 Magisk 模块模板中复制。)*

### 3. 打包与刷入

将上述 `docker_env_module` 目录内的所有文件打包成一个 ZIP 压缩包。

```bash
cd docker_env_module
zip -r ../docker_env_module.zip .
```

将生成的 `docker_env_module.zip` 传到手机上，打开 Magisk Manager，选择“模块” -> “从存储安装”，选中这个 ZIP 文件并刷入。重启手机后，Magisk 就会自动解压并准备好你的容器环境了。

### 总结

通过 `docker export` 结合 Magisk 的 `service.sh` 脚本，我们绕过了 Android 无法原生运行 Docker 的限制，实现了容器环境的无缝移植。这种方法特别适合在 Android 上部署交叉编译环境、Web 服务器或各类轻量级 Linux 后台服务。