安装
校验发布文件,制作 x86_64 USB 安装介质,手动确认磁盘并安装;另附 ARM64 QEMU 启动方法。
本页目录
选择发布文件
本文说明 OpenXTOS v1.0.2 源码版(提交 c24e923717670c4724cdaf24c7c105caee8dc2fb)与可下载的 v1.0.2 二进制预发布版。v1.0.2 提供 x86_64 安装 ISO、ARM64 QEMU 包、分架构对应源码和 SHA256SUMS.txt;以下安装与 QEMU 步骤使用这些 v1.0.2 二进制文件,从源码构建参见系统文档。
| 文件 | 版本与用途 |
|---|---|
| v1.0.2 源码 ZIP / tar.gz | GitHub 按标签生成的项目源码归档;不替代二进制所需的第三方对应源码包。 |
| openxtos-v1.0.2-x86_64-installer.iso | v1.0.2 x86_64 BIOS/UEFI 安装 ISO。 |
| openxtos-v1.0.2-arm64.tar.gz | v1.0.2 ARM64 QEMU virt 启动包;不是通用 ARM 板卡安装器。 |
| RISC-V64 | 有源码构建与 QEMU 验证路径;当前没有发布镜像。 |
下载与校验
在普通 Linux 主机的空目录下载 v1.0.2 ISO、匹配的对应源码和校验列表。需要 curl、CA 证书与 sha256sum;此处不校验 GitHub 自动生成的项目源码归档。
set -eu
mkdir -p "$HOME/openxtos-v102"
cd "$HOME/openxtos-v102"
curl --fail --location --show-error -O 'https://github.com/Aitaide/OpenXTOS/releases/download/v1.0.2/openxtos-v1.0.2-x86_64-installer.iso'
curl --fail --location --show-error -O 'https://github.com/Aitaide/OpenXTOS/releases/download/v1.0.2/openxtos-v1.0.2-x86_64-corresponding-source.tar.gz'
curl --fail --location --show-error -O 'https://github.com/Aitaide/OpenXTOS/releases/download/v1.0.2/SHA256SUMS.txt'
sha256sum --check --ignore-missing SHA256SUMS.txtv1.0.2 ISO 的 SHA-256 为 589bf33ed91b3db27c25f987f2b7508a5e97ad3f1fa6653938be69ef43b4a68c。校验失败时停止,不要刷写。
制作 USB 并启动
以下 USB 安装流程用于 v1.0.2 x86_64 ISO,不能用于 v1.0.2 源码归档。
- 准备可清空的 USB。在可信来源安装 Rufus、balenaEtcher 或等效原始镜像写入工具。不要只把 ISO 文件复制到 USB 文件系统。
- 选择已经校验的 ISO,再核对所选 USB 的型号与容量。Rufus 选择 DD 模式;其他工具使用原始镜像写入。写入前再次确认不是主机系统盘。
- 安全弹出 USB,在目标 x86_64 机器关闭 Secure Boot,再从 USB 的 BIOS 或 UEFI 启动项启动。Secure Boot 不受支持。
- 在 GRUB 选择 OpenXTOS installer (manual installation)。VGA 本地控制台和 ttyS0、115200 波特串口均可用。启动进入 shell,不自动安装或写盘。
需要安装的是目标机器的内部磁盘,不是刚写好的 USB。若无法启动,先核对 ISO 哈希、原始写入模式、启动架构、BIOS/UEFI 选择及 Secure Boot 状态;保留屏幕或串口错误,不反复尝试未知磁盘。
核对目标整盘
以下命令只在目标机的 XTOS 安装控制台执行。先列出所有盘,依据实际型号、完整序列号和精确字节容量确认目标;设备名会变化,/dev/nvme0n1 只是示例,不是默认安全目标。
lsblk -o NAME,MODEL,SERIAL,SIZE,TYPE,MOUNTPOINTS
lsblk -dn -o SERIAL /dev/nvme0n1
blockdev --getsize64 /dev/nvme0n1
cat /proc/cmdline安装器只接受实际 /dev/nvme…n… 或 /dev/sd… 整盘路径,不接受设备别名或分区。要求容量至少 2 GiB、removable=0、非空且精确匹配的序列号与字节数;拒绝已挂载磁盘及其分区、活动 swap、holders 和身份不匹配。启动参数必须含 xtos.installer=1。它在首次写入前再次检查身份,也会检查 payload 哈希。
手动安装
xtos-install /dev/nvme0n1 'EXACT-SERIAL' EXACT-BYTES ERASE-XTOS参数顺序是整盘路径、序列号、字节容量、确认词。安装器重新分区为 GPT,创建 BIOS 引导区、FAT32 EFI 分区和 ext4 根分区,安装 BIOS/UEFI GRUB 并复制系统。等待独立行 XTOS_INSTALL=PASS;中断或错误不表示安装完成,不要立即重跑擦盘命令。
sync
poweroff -f首次启动与持久化
拔除 USB 后启动已安装磁盘。正常应显示 XTOS baremetal system,打印 XTOS_READY=1。根文件系统通过 xtos.root 指定的 UUID 挂载 ext4 并 switch_root;安装 USB 与普通 QEMU initramfs 则在内存中运行,改动不自动保存到安装盘或主机。
uname -r
/usr/bin/xtos-rt-status
cat /proc/cmdline
cat /proc/mounts
xtos-selftestxtos-selftest 返回 0 才是该次软件自检通过;XTOS_READY=1 只是就绪标记。需要验证持久化时,在确认已安装 ext4 根后,用未占用的新文件名在 /root 创建自己的测试记录,sync 并重启,再检查记录;检查后删除。不要以安装 USB 的内存文件证明磁盘持久化。
这不是加密磁盘、Secure Boot、生产升级服务或完整账户管理方案。物理硬件的存储、网络、IRQ、负载、延迟与 BCI 设备需在目标上单独验收。
恢复与失败处理
保留已校验的 USB 和备份。安装或已装系统启动失败时,先保存错误与串口日志;不要把失败理解为允许再次清空磁盘。USB 的 GRUB 第二项 OpenXTOS recovery (installation disabled) 不带 xtos.installer=1,可进入恢复控制台,xtos-install 会拒绝执行。
- 若出现 XTOS_ROOT=FAIL,系统可能已退回内存恢复根。检查 /proc/cmdline、lsblk 和 blkid,核对根 UUID 与分区;不要把此时 /root 的内容当作已安装盘数据。
- 需要检查已安装盘时先重新识别路径,优先只读挂载;ext4 只读取证还须考虑 noload 避免日志回放。先复制重要数据,不在已挂载文件系统上运行修复。
- 安装器拒绝时查序列号、精确字节数、整盘/分区、挂载、swap 和 holders。修复实际原因;不跳过身份检查,不强制格式化。
- SSH 不通先在本地检查 authorized_keys 是否已写到已安装根、Dropbear 条件、网络地址与 DHCP;不要把默认空授权文件误报为开放远程 root。
ARM64 QEMU 启动包
以下 QEMU 命令运行 v1.0.2 ARM64 包,仅验证虚拟机中的软件行为,不证明真实 ARM 板卡兼容性。
Ubuntu 24 主机先安装 qemu-system-arm 和 ipxe-qemu;后者提供默认虚拟网卡所需的 efi-virtio.rom。其他发行版按包管理器确认 QEMU 与该固件可用。
set -eu
curl --fail --location --show-error -O 'https://github.com/Aitaide/OpenXTOS/releases/download/v1.0.2/openxtos-v1.0.2-arm64.tar.gz'
curl --fail --location --show-error -O 'https://github.com/Aitaide/OpenXTOS/releases/download/v1.0.2/openxtos-v1.0.2-arm64-corresponding-source.tar.gz'
curl --fail --location --show-error -O 'https://github.com/Aitaide/OpenXTOS/releases/download/v1.0.2/SHA256SUMS.txt'
sha256sum --check --ignore-missing SHA256SUMS.txt
test ! -e arm64
tar -xzf 'openxtos-v1.0.2-arm64.tar.gz'
qemu-system-aarch64 -machine virt -cpu cortex-a57 -m 2G -smp 2 \
-kernel arm64/Image -initrd arm64/initramfs-arm64.cpio.gz \
-append 'console=ttyAMA0 panic=1' -nographicuname -m
uname -r
/usr/bin/xtos-rt-status
/bin/test_rt
/bin/test_spsc
/bin/test_signal
poweroff -f退出 QEMU 也可按 Ctrl+a 再按 x。此包包含 Image、initramfs、DTB、最终 kernel.config 与 notices;普通 initramfs 根在内存中,关机丢失未外存数据。它不是通用 ARM 板卡安装器;实板启动需要匹配固件、设备树、存储/外设驱动和独立硬件验证,不能把这个 QEMU 命令照搬为刷板流程。
更新与应用包工具
以下说明对应公开源码中的 update 与 pkg app 实现。公开 v1.0.2 安装 ISO 和 ARM64 QEMU 包不包含这些工具;包含它们的 Live 构建另有独立流程。先在目标 XTOS 控制台检查,不要在普通 Linux 主机上把同名命令当作 XTOS 工具。
command -v update
command -v pkg检查与下载更新
在已具备 update 的 XTOS 环境运行。需要可用网络、可信时间、镜像内固定公钥 /usr/share/xtos/repo-public.pem 和 CA 证书,并为下载目录预留空间。工具按配置顺序尝试镜像,先验证 release-index.json 的 Ed25519 签名,再比较 /etc/xtos-release 中的版本。
update checkcheck 返回 0 表示无需更新,1 表示有更新,2 表示错误。索引版本由镜像维护,可能滞后于 GitHub Release;本网站的发布版本不代表签名索引已经同步。镜像不可用、签名失败或索引不一致时停止,不能绕过验签。
update download --dest /xtos/downloaddownload 获取当前架构的文件,核对大小与 SHA256,并生成 download-manifest.json;不会自动安装,也不会替换运行中的根文件系统。下载成功不等于升级完成。已安装系统应备份数据后,从经过校验的新安装介质启动,再按本页安装流程操作。
源码中的 update apply --from DIR --to DEV --confirm ERASE-XTOS 会重新验证受信索引和文件,再把安装镜像写入备用整盘介质;不是运行中根文件系统的原地升级。update recover 使用相同参数,对匹配中断日志的备用介质重新认证并完整重写,没有自动回滚保证。两者会清除目标介质,必须先备份并确认目标未挂载且不是运行介质;当前核心包不包含这些工具。
安装与校验应用
仅在包含 XTOS pkg 的环境使用。先从可信发布者获取实际 xpkg 文件,并确认名称、版本和架构。以下 demo.xpkg 与 demo 均为示例,分别替换为实际文件和清单中的应用名。安装需要目标目录写入权限,默认路径为 /opt/xtos-apps/<name>/<version>/。
pkg app install demo.xpkg
pkg app list
pkg app verify demo默认安装检查归档路径、清单文件集合、逐文件大小和 SHA256。通过后才激活应用目录并更新注册表;应用与整体镜像发布的系统底座分开。哈希一致说明文件匹配清单,不单独证明发布者身份。
pkg app install demo.xpkg --pubkey /path/to/vendor-public.pem安装或 verify 失败时停止使用该包,保留错误信息并向发布者确认,不删除校验项来强行安装。应用目录隔离不等于进程沙箱,也不保证应用自行写入目录外的数据能随卸载删除。
软件源与信任
发布索引、系统构建仓库和应用包使用不同的校验对象。发布索引 release-index.json 及其 .sig 决定 update 看到的版本和文件;系统用户态仓库的 manifest.json、SHA256SUMS 及签名用于构建;xpkg 使用包内清单和可选厂商签名。不要混用。
软件源地址为 https://packages.xtos.cn/ 与 https://packages.xtos.si/。网络可达性、缓存和镜像选择不替代固定公钥验签;任一镜像的可用性和索引版本以实际检查为准。公开的 public.pem 可供核对,但不能仅因它与下载文件来自同一地址就信任它。
验签失败不使用索引;下载文件与受信清单的 SHA256 不符则拒绝使用。网站提供的 GitHub 发布附件另按前面的 SHA256SUMS.txt 流程检查;校验和不等于独立签名认证。
源码与再分发
对应源码归档与二进制按架构匹配,包含项目标签源码,以及发布中宿主工具或静态运行库的匹配包源码、清单与许可材料。只提供 GitHub 自动生成的项目源码包,不足以覆盖 ISO 中嵌入的所有第三方二进制。x86 ISO 的 /usr/share/doc/openxtos/ 和 ARM64 包的 notices/ 保留项目许可、NOTICE、软件包清单及第三方声明。
镜像使用固定源码 c24e923717670c4724cdaf24c7c105caee8dc2fb,另由构建 recipe 110048c955c71a0701f5eee04351ab7a4903b0f6 打包。x86_64 安装器修补 UEFI 引导生成,Cyton 诊断工具增加读取长度检查;对应源码包含这些 recipe 和补丁。核心镜像与首页开发 Live 候选版分别标识。
再分发时保留匹配的对应源码、构建/安装脚本、配置、补丁、许可证、版权与修改通知,并满足各组件 Apache-2.0/GPL-2.0 义务。链接和 Logo 不能替代对应源码;修改二进制后需提供与修改匹配的源码。