redroid-rk3588

This project is a rebuilt and reproduced image set based on the ideas and deployment route of CNflysky/redroid-rk3588. Thanks to CNflysky for the original work.

本项目基于 CNflysky/redroid-rk3588 的整体思路与部署路线，重新编译复刻而来，先感谢大佬。

RK3588 redroid images focused on LineageOS 20, Google services compatibility, and a fully working Magisk 30700 environment.

中文说明

Screenshots

Image

• Docker Hub: kingfalse/redroid-rk3588:lineage-20

Highlights

• RK3588 LineageOS 20 image for redroid
• Google services compatible user build
• Magisk 30700 integrated and enabled by androidboot.redroid_magisk=1
• Official manager package name: com.topjohnwu.magisk
• magisk --path fixed to /sbin on redroid
• Superuser and Modules pages available in Magisk manager

Compared With CNflysky Build

Relative to CNflysky/redroid-rk3588, this image currently adds or changes:

• Migrated to a verified Magisk 30700 integration flow based on in-tree patched source
• Rebuilt manager APK from source instead of only shipping an upstream runtime APK
• Official manager package name is kept as com.topjohnwu.magisk
• Fixed redroid runtime path so magisk --path returns /sbin
• Relaxed redroid environment check so manager works without the broken repair loop
• Verified Superuser and Modules tabs are enabled on first boot with Magisk enabled
• Added explicit REDROID_MAGISK=1/0 switch validation

Prerequisites

• RK3588 device with working redroid kernel/userspace
• Docker installed
• --privileged container support
• ADB reachable on port 5555

Tested Devices

• Orange Pi 5 Ultra, OS Armbian Server (Debian 13 "Trixie"), vendor kernel 6.1.115

Devices that can already run CNflysky/redroid-rk3588 should theoretically also be able to run this image.

Docker Run

Magisk enabled:

docker run -d \
  --name redroid \
  --restart unless-stopped \
  --privileged \
  -p 5555:5555 \
  -v ~/redroid-data:/data \
  kingfalse/redroid-rk3588:lineage-20 \
  androidboot.redroid_magisk=1 \
  androidboot.redroid_width=1080 \
  androidboot.redroid_height=1920 \
  ro.build.characteristics=default

Magisk disabled:

docker run -d \
  --name redroid \
  --restart unless-stopped \
  --privileged \
  -p 5555:5555 \
  -v ~/redroid-data:/data \
  kingfalse/redroid-rk3588:lineage-20 \
  androidboot.redroid_magisk=0 \
  androidboot.redroid_width=1080 \
  androidboot.redroid_height=1920 \
  ro.build.characteristics=default

Docker Compose

services:
  redroid:
    image: kingfalse/redroid-rk3588:lineage-20
    container_name: redroid
    privileged: true
    restart: unless-stopped
    ports:
      - "5555:5555"
    volumes:
      - ./data:/data
    command:
      - "androidboot.redroid_magisk=1"
      - "androidboot.redroid_width=1080"
      - "androidboot.redroid_height=1920"
      - "ro.build.characteristics=default"

Runtime Arguments

Argument	Description	Default
androidboot.redroid_magisk	Enable Magisk startup chain	0
androidboot.redroid_width	Display width	1080
androidboot.redroid_height	Display height	1920
ro.build.characteristics	Device characteristics	default

Verified Behavior

When androidboot.redroid_magisk=1:

• getprop sys.boot_completed=1
• /sbin/magisk -v returns e8a58776-alpha:MAGISK:D
• /sbin/magisk --path returns /sbin
• /sbin/su 0 sh -c id returns root
• Magisk manager home shows current version normally
• Superuser and Modules tabs are enabled

When androidboot.redroid_magisk=0:

• getprop sys.boot_completed=1
• /sbin/magisk is absent
• /sbin/su is absent
• manager is not auto-installed
• no Magisk startup chain is activated

中文说明

这是一个面向 RK3588 的 redroid + LineageOS 20 镜像仓库，提供可直接部署、可开关 Magisk 的日常使用镜像。

主要特性

• 基于 RK3588 的 redroid / LineageOS 20 镜像
• Magisk 30700 深度集成
• androidboot.redroid_magisk=1/0 控制启用和关闭
• 官方 manager 包名保持为 com.topjohnwu.magisk
• 修复 redroid 下 magisk --path，返回 /sbin
• 首次启动即可正常使用 超级用户 与 模块

相比原作者镜像的升级

相对 CNflysky/redroid-rk3588，当前版本重点做了这些升级和优化：

• 升级并固定为 Magisk 30700 方案
• manager APK 由本地源码构建，不再只依赖上游成品 APK 直接原样使用
• redroid 环境下的 Magisk 启动链、/sbin 路径、manager 环境识别全部重新打通
• Magisk / Superuser / Modules 首页状态已验证正常
• 支持显式开关：
  • 开启时有 root、有 manager、有 Magisk 启动链
  • 关闭时无 root、无 /sbin/magisk、manager 不自动安装

已测试设备

• Orange Pi 5 Ultra，OS Armbian Server（Debian 13 "Trixie"），vendor 内核 6.1.115

凡是已经可以正常运行 CNflysky/redroid-rk3588 的设备，理论上也都可以运行当前镜像。

docker run 示例

开启 Magisk：

docker run -d \
  --name redroid \
  --restart unless-stopped \
  --privileged \
  -p 5555:5555 \
  -v ~/redroid-data:/data \
  kingfalse/redroid-rk3588:lineage-20 \
  androidboot.redroid_magisk=1 \
  androidboot.redroid_width=1080 \
  androidboot.redroid_height=1920 \
  ro.build.characteristics=default

关闭 Magisk：

docker run -d \
  --name redroid \
  --restart unless-stopped \
  --privileged \
  -p 5555:5555 \
  -v ~/redroid-data:/data \
  kingfalse/redroid-rk3588:lineage-20 \
  androidboot.redroid_magisk=0 \
  androidboot.redroid_width=1080 \
  androidboot.redroid_height=1920 \
  ro.build.characteristics=default

docker compose 示例

services:
  redroid:
    image: kingfalse/redroid-rk3588:lineage-20
    container_name: redroid
    privileged: true
    restart: unless-stopped
    ports:
      - "5555:5555"
    volumes:
      - ./data:/data
    command:
      - "androidboot.redroid_magisk=1"
      - "androidboot.redroid_width=1080"
      - "androidboot.redroid_height=1920"
      - "ro.build.characteristics=default"

Contact

If this image helps you, you can follow the project and contact me here: