Skip to content

README.ru.md

Latest commit

 

History

History
98 lines (70 loc) · 4.4 KB

README.ru.md

File metadata and controls

98 lines (70 loc) · 4.4 KB

K1OS - Linux-based Operating System

Язык: English (основной) | Русский

WARP теперь развивается в отдельном репозитории KEYTRON/WARP. K1OS подтягивает WARP из этого репозитория во время make warp. Если оба репозитория лежат рядом, packages/warp/build.sh возьмёт соседний checkout ../WARP. Путь можно переопределить через WARP_SOURCE_DIR=/path/to/WARP.

K1OS также публикует container image в GHCR как ghcr.io/keytron/k1os. Workflow для контейнера smoke-test'ит сам образ и встроенный warp.

K1OS Container

Точка интеграции K1OS:

Обзор

K1OS - это Linux-based операционная система для разработки.

Проект использует Linux kernel как надежную основу (драйверы, планировщик, память, сеть), чтобы не тратить годы на создание собственного ядра с нуля. Основная разработка K1OS сосредоточена на пользовательском пространстве, процессе загрузки, инструментах и интеграции компонентов системы.

K1OS - это не "еще один клон дистрибутива", а самостоятельная операционная система, построенная на базе Linux kernel.

Основные компоненты

  • Linux kernel (kernel/linux-7.0) как базовый системный слой.
  • Минимальный initramfs (stage 1) для инициализации ранней загрузки и подготовки real root.
  • system.squashfs как read-only базовый rootfs.
  • overlayfs поверх squashfs:
    • tmpfs (RAM mode), или
    • ext4 раздел с меткой K1OS-DATA (persistent mode).
  • runit как init stage 2 (/sbin/init внутри rootfs).
  • Собранный userspace: busybox, fish, curl, git, dropbear, tmux, nano, python3, htop.
  • warp (пакетный менеджер на C из отдельного репозитория KEYTRON/WARP) для установки и управления пакетами.

Архитектура загрузки

  1. GRUB загружает vmlinuz и initramfs.gz.
  2. Stage 1 (rootfs/init) монтирует system.squashfs.
  3. Stage 1 настраивает overlayfs (persistent или RAM mode).
  4. switch_root передает управление в /sbin/init (stage 2).
  5. Stage 2 запускает сервисы и shell-окружение K1OS.

Структура репозитория

K1OS/
├── kernel/              # Linux kernel source/config
├── rootfs/              # Базовый rootfs и init-скрипты
├── packages/            # Сборка userspace-пакетов + warp
├── scripts/             # Скрипты сборки rootfs/ISO/persist
├── docs/                # Документация проекта
├── custom/              # Опциональные расширения (модули/патчи/утилиты)
├── build/               # Промежуточные артефакты/конфиги
└── Makefile             # Основные цели сборки и запуска

Быстрый старт

# 1) Ядро
make kernel

# 2) RootFS
make rootfs

# 3) ISO
make iso

Полная сборка:

make all-build

Тест в QEMU:

# RAM mode
make qemu

# persistent storage
make make-persist
make qemu-persist

Дополнительная документация

Лицензия

Apache License 2.0 - см. LICENSE.