# minimal_ubuntu_system

**Repository Path**: dahogn/minimal_ubuntu_system

## Basic Information

- **Project Name**: minimal_ubuntu_system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-17
- **Last Updated**: 2025-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Minimal Ubuntu System

本项目旨在为 RISC-V K1 平台构建一套精简、高效、可运行 ROS 2 的 Ubuntu 24.04 最小系统。该系统镜像基于官方发布的 `bianbu-24.04-minimal-k1-v2.2` 版本构建，经过深度裁剪与优化，保留 ROS 2 Humble 基本运行环境，系统镜像体积约为 460 MB，并保留调试接口，适用于边缘设备、移动机器人等资源受限场景。

---

## 项目目标

- **系统体积最小化**：尽可能减小镜像大小，控制在 450MB 左右
- **启动加速优化**：剥离非必要服务，提高系统启动速度
- **支持 ROS 2 运行**：保留 ROS 2 Humble 必需组件，可运行 `talker` / `listener` 等基本节点
- **清理无关内容**：移除 GUI、字体、手册、输入法、bash 补全等
- **方便后续部署**：保持 apt 源、用户空间、日志功能可用，支持二次开发与调试

---

## 镜像构建基础

| 项目         | 内容                                 |
| ------------ | ------------------------------------ |
| 开发板       | Banana Pi BPI-F3（RISC-V K1 SoC）    |
| 系统基础     | bianbu-24.04-minimal-k1-v2.2-release |
| 内核版本     | linux-6.6                            |
| ROS 2 版本   | ROS2 Humble                          |
| 镜像文件名   | k1_clean.img.gz                      |
| 最终压缩体积 | 456MB                                |

---

## 裁剪关键点

- 移除以下组件：
  - man 手册、bash 补全、系统文档
  - 字体及字体配置
  - libreoffice、图形界面、音频子系统
- 保留以下组件：
  - `ros-humble-ros-base` 核心包
  - `demo_nodes_cpp` / `demo_nodes_py`
  - `systemd` / `networkd` / `udev` 基础服务
  - `ssh`, `sudo`, `vim`, `net-tools` 等常用工具

---

## 仓库结构说明

```text
├── docs/
│   ├── overview.md     ← 当前文件：项目背景与说明
│   └── usage.md        ← 镜像使用与烧录说明
├── images/             ← 裁剪后系统镜像切片
├── scripts/            ← 合并/校验镜像的辅助脚本
├── README.md           ← 项目首页介绍
├── RELEASE.md          ← 每版镜像发布变更说明
├── LICENSE             ← 木兰开源协议（Mulan PSL v2）
└── SHA256SUMS          ← 镜像完整性校验值
```

- 项目概览：docs/
- 系统镜像：images/  
- 合并与校验脚本：scripts/  
- 发布说明：RELEASE.md