使用 APT

APT 仓库

RadxaOS 是基于 Debian / Ubuntu 基础上进行二次开发而获得的系统。我们的系统里不仅包含了上游系统的 APT 仓库，同时也为 RadxaOS 独有的软件包提供了额外的仓库。

APT 仓库配置文件

APT 仓库的配置文件一般保存在以下两个地方：

1. /etc/apt/sources.list：主仓库
2. /etc/apt/sources.list.d/*.list：额外仓库

以下是 RadxaOS 中常见的额外仓库：

$ ls /etc/apt/sources.list.d/
bookworm-backports.list  bookworm-updates.list  radxa.list
bookworm-security.list   radxa-amlogic.list

确认系统版本代号

在更改仓库配置之前，请先确认系统的版本代号（VERSION_CODENAME）。执行以下命令：

grep VERSION_CODENAME /etc/os-release

输出示例：

VERSION_CODENAME=bookworm

根据版本代号选择合适的仓库源。

bookworm-*.list

这些文件提供了上游的一些额外仓库。其中 bookworm 是操作系统代号。

radxa.list

此文件提供了 RadxaOS 主仓库，包含由瑞莎开发的通用软件包。

radxa-*.list

此文件提供了 RadxaOS Vendor 仓库。这个仓库里面包含了 Vendor SDK 里提供的私有软件包。

由于这些软件包大多是由第三方制作的，不能保证遵守 Debian Policy，因此本软件仓库在 CLI 版本上是默认不安装的，以避免系统自动解析并安装此软件仓库里面的软件，并导致系统无法正常运行。

提示

如果需要使用此仓库中的软件，瑞莎建议使用桌面版本 RadxaOS。

RadxaOS Vendor 仓库

开启

注意

在非桌面版本 RadxaOS 上开启 RadxaOS Vendor 仓库是不受支持的，请谨慎使用。

请执行以下命令来添加 RadxaOS Vendor 仓库：

VENDOR="$(tr $"\0" $"\n" < /proc/device-tree/compatible | tail -n 1 | cut -d "," -f 1)"
source /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME $VENDOR-$VERSION_CODENAME main" | \
     sudo tee "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

备注

Rockchip Vendor 仓库仅支持基于 Debian 的 RadxaOS。Ubuntu 上无法正常使用此仓库中包含的软件包。

同时，Rockchip Vendor 仓库需要额外的配置，从而保证此仓库中的软件包会被系统优先使用。

你可以在执行完以上命令后，执行以下操作，从而配置并安装绝大多数 Rockchip Vendor 软件包：

sudo apt-get dist-upgrade --allow-downgrades task-rockchip
sudo apt-get dist-upgrade --allow-downgrades

关闭

如需禁用此仓库，直接删除对应的配置文件即可：

VENDOR="$(tr $"\0" $"\n" < /proc/device-tree/compatible | tail -n 1 | cut -d "," -f 1)"
sudo rm "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

备注

删除 Vendor 仓库并不会删除已安装的软件包。但这些软件包也无法再次获得更新，并有被其他仓库中的软件包覆盖的可能性。

为了确保操作系统的正常使用，请勿随意更改系统默认的仓库配置。

RadxaOS 测试仓库

开启

注意

测试源中的软件未经验证，请谨慎使用。

请执行以下命令来使用 RadxaOS 测试仓库：

VENDOR="$(tr $"\0" $"\n" < /proc/device-tree/compatible | tail -n 1 | cut -d "," -f 1)"
source /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME-test $VERSION_CODENAME-test main" | \
     sudo tee "/etc/apt/sources.list.d/radxa.list"
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME-test $VENDOR-$VERSION_CODENAME-test main" | \
     sudo tee "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

关闭

VENDOR="$(tr $"\0" $"\n" < /proc/device-tree/compatible | tail -n 1 | cut -d "," -f 1)"
source /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME $VERSION_CODENAME main" | \
     sudo tee "/etc/apt/sources.list.d/radxa.list"
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME $VENDOR-$VERSION_CODENAME main" | \
     sudo tee "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

中国仓库镜像

请执行以下命令来使用由第三方提供的 RadxaOS 仓库镜像：

备注

瑞莎无法保证第三方镜像的可用性或下载速率。

aghost

本镜像由 aghost 提供。

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.aghost.cn/radxa-deb|g" /etc/apt/sources.list.d/radxa*.list
sudo apt-get update

cqu

本镜像由 重庆大学开源软件镜像站 提供。

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.cqu.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

LZUOSS

本镜像由 LZUOSS 提供。

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.lzu.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

HUST

本镜像由 HUST 提供。

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.hust.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

SDU

本镜像由 SDU 提供。

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.sdu.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

NJU

本镜像由 NJU 提供。

sudo sed -i "s|https://radxa-repo.github.io|https://mirror.nju.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

NYIST

本镜像由 NYIST 提供。

sudo sed -i "s|https://radxa-repo.github.io|https://mirror.nyist.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

恢复默认

sudo sed -e "s|https://mirrors.aghost.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.cqu.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.lzu.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.hust.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.sdu.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirror.nju.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirror.nyist.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -i /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

请执行以下命令来使用由第三方提供的 Debian / Ubuntu 仓库镜像：

备注

瑞莎无法保证第三方镜像的可用性，或下载速率。

ustc

本镜像由中国科学技术大学开源软件镜像站提供。

sudo sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list.d/*
sudo sed -i 's/deb.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list.d/*
sudo apt-get update

tuna

本镜像由清华大学开源软件镜像站提供。

sudo sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list.d/*
sudo sed -i 's/deb.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list.d/*
sudo apt-get update

cqu

本镜像由 重庆大学开源软件镜像站 提供。

sudo sed -i 's/deb.debian.org/mirrors.cqu.edu.cn/g' /etc/apt/sources.list.d/*
sudo sed -i 's/deb.ubuntu.com/mirrors.cqu.edu.cn/g' /etc/apt/sources.list.d/*
sudo apt-get update

恢复默认

sudo sed -i 's/mirrors.ustc.edu.cn/deb.debian.org/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.ustc.edu.cn/deb.ubuntu.com/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.tuna.tsinghua.edu.cn/deb.debian.org/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.tuna.tsinghua.edu.cn/deb.ubuntu.com/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.cqu.edu.cn/deb.debian.org/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.cqu.edu.cn/deb.ubuntu.com/g' /etc/apt/sources.list.d/*
sudo apt-get update

更多镜像站请参考 Debian 镜像列表 和 Ubuntu 镜像列表。