logo
0
0
Login
ForkfromDragonOS-Community/playground, behind:main1 commits
docs: 更新README文档,添加Fork项目和云原生开发按钮说明

DragonOS Playground

DragonOS Playground - 一键启动DragonOS操作系统的便捷工具

项目简介

本项目提供了一个简单易用的方式来快速启动和体验DragonOS操作系统。通过自动化脚本下载最新的DragonOS制品,并使用QEMU虚拟机启动系统,让用户无需复杂的配置即可开始使用DragonOS。

🌟 特别推荐云原生开发体验! 在cnb.cool平台上,您可以零配置、一键启动DragonOS,享受云端开发的便利性。

🆕 每日更新体验! 本项目每天晚上会自动进行nightly build,确保您能够体验到最新开发版本的DragonOS,包括最新功能、性能优化和bug修复。

🌟 一键启动! DragonOS社区仓库:https://github.com/DragonOS-Community/DragonOS

功能特性

  • ☁️ 🌟 云原生优先 - 在cnb.cool平台零配置一键体验
  • 🆕 每日构建 - nightly build确保体验最新开发版本
  • 🚀 一键启动 - 运行单个命令即可启动完整的DragonOS系统
  • 📦 自动下载 - 智能检测并自动下载最新的DragonOS制品
  • 🌐 云端开发 - 随时随地访问,不占用本地资源

快速开始

🌟 方法一:云原生开发(推荐)

cnb.cool云原生开发平台上体验DragonOS是最简单快捷的方式,无需本地安装任何依赖!

  1. 访问DragonOS Playground

  2. 一键启动

    ./run.sh --clean ./run.sh
  3. 退出系统

  • 按下 Ctrl+X 组合键退出 QEMU

为什么推荐云原生开发?

  • 零配置 - 无需安装QEMU、Docker等依赖
  • 即时体验 - 几秒钟内即可运行DragonOS
  • 云端环境 - 随时随地访问,不占用本地资源
  • 自动更新 - 每日nightly build,始终使用最新开发版本

方法二:本地运行

如果您希望在本地环境中运行,请按以下步骤操作:

  1. 访问项目

    git clone https://cnb.cool/DragonOS-Community/playground cd playground
  2. 安装依赖

    # Ubuntu/Debian sudo apt update sudo apt install qemu-system-x86 docker.io bridge-utils dnsmasq iptables # CentOS/RHEL sudo yum install qemu-kvm docker bridge-utils dnsmasq iptables
  3. 启动系统

    ./run.sh

    脚本会自动:

    • 检查本地是否存在DragonOS制品
    • 如果不存在,自动下载最新制品
    • 启动QEMU虚拟机运行DragonOS

系统要求

基础要求

  • Linux 操作系统
  • Bash shell 环境
  • 足够的磁盘空间(用于下载制品)

依赖软件

  • QEMU - 虚拟机软件
  • Docker - 用于下载制品(仅下载时需要)
  • bridge-utils - 网络工具
  • dnsmasq - DHCP/DNS服务
  • iptables - 防火墙工具

Ubuntu/Debian 安装依赖

sudo apt update sudo apt install qemu-system-x86 docker.io bridge-utils dnsmasq iptables

CentOS/RHEL 安装依赖

sudo yum install qemu-kvm docker bridge-utils dnsmasq iptables

详细使用说明

主要脚本说明

run.sh - 主启动脚本

  • 自动检测和下载DragonOS制品
  • 启动QEMU虚拟机
  • 支持彩色输出和错误处理
  • 支持清理选项,方便更新到最新版本
    • ./run.sh --clean - 清理本地制品文件后退出
    • ./run.sh --help - 显示帮助信息
    • 清理后再次运行 ./run.sh 会自动下载最新版本

scripts/download.sh - 制品下载脚本

  • 从Docker镜像拉取最新nightly build制品
  • 自动解压和验证文件完整性
  • 支持强制重新下载选项
  • 每天自动获取最新的开发版本

scripts/run-qemu.sh - QEMU启动脚本

  • 配置QEMU虚拟机参数
  • 支持多种架构和启动模式
  • 提供网络和设备配置

环境变量配置

内核日志级别

export DRAGONOS_LOGLEVEL=4 # 只显示WARN及以上级别日志 # 日志级别:0=EMERG, 1=ALERT, 2=CRIT, 3=ERR, 4=WARN, 5=NOTICE, 6=INFO, 7=DEBUG

项目结构

. ├── run.sh # 主启动脚本 ├── scripts/ # 脚本目录 │ ├── download.sh # 制品下载脚本 │ └── run-qemu.sh # QEMU启动脚本 ├── bin/ # 制品目录(运行时生成) │ ├── kernel/ # 内核文件 │ │ └── kernel.elf │ ├── disk-image-x86_64.img # 磁盘镜像 │ └── ... # 其他架构文件 ├── serial_opt.txt # 串口输出日志 └── README.md # 本文档

常见问题

Q: 下载制品失败?

A: 检查Docker是否正常运行,以及网络连接是否正常:

docker --version docker pull docker.cnb.cool/dragonos-community/playground/artifacts:nightly-latest

Q: 网络连接问题?

A: 检查网络相关工具是否安装:

sudo apt install bridge-utils dnsmasq iptables

自定义QEMU参数

可以直接修改 scripts/run-qemu.sh 文件中的QEMU配置参数,包括:

  • 内存大小:QEMU_MEMORY
  • CPU核心数:QEMU_SMP
  • 网络配置:QEMU_DEVICES

技术支持

许可证

本项目遵循GPLv2进行发布。


🌙 Nightly Build 说明

什么是Nightly Build?

  • 每天晚上自动构建的最新开发版本
  • 包含最新功能、性能优化和bug修复
  • 让您第一时间体验DragonOS的最新进展

更新时间:

  • 🕙 构建时间:每天晚上(北京时间01:00)自动进行
  • 🔄 更新频率:每日更新
  • 📦 制品版本:使用 nightly-latest 标签

注意事项:

  • ⚠️ Nightly build是开发版本,可能包含不稳定的功能
  • 🔧 适合开发者、测试者和希望体验最新功能的用户
  • 📋 如需稳定版本,请查看DragonOS官方发布版本

🎉 立刻开启你的DragonOS探索之旅!

About

一键在cnb拉起DragonOS体验环境!

Language
Shell99%
Dockerfile1%