docs: add usage guides for common mirrors

This commit is contained in:
2026-11-05 11:39:21 +08:00
parent 4c3b7ead4e
commit cbb58ae76d
15 changed files with 723 additions and 0 deletions
+2
View File
@@ -49,6 +49,8 @@ go -C backend build -o ../.local/mirrorouc .
镜像使用帮助位于 `/help/<源名>/`,在后台“镜像与任务”的“展示信息”中使用 Markdown 编辑。所有界面语言使用同一份中文帮助文章;未填写文章的镜像不显示帮助按钮。 镜像使用帮助位于 `/help/<源名>/`,在后台“镜像与任务”的“展示信息”中使用 Markdown 编辑。所有界面语言使用同一份中文帮助文章;未填写文章的镜像不显示帮助按钮。
常用镜像的帮助原稿见 [docs/help/](docs/help/README.md),可复制到后台发布;线上编辑的文章保存在数据库中,部署不会自动覆盖。
帮助正文可插入交互式 Debian 配置块,`format` 使用 `list`(传统格式)或 `deb822`: 帮助正文可插入交互式 Debian 配置块,`format` 使用 `list`(传统格式)或 `deb822`:
```mirror-config ```mirror-config
+25
View File
@@ -0,0 +1,25 @@
# 镜像使用帮助
本目录保存补充帮助文章的 Markdown 原稿,配置示例使用本站公开地址 `https://mirrors.app.itstudio.club`。部署到其他域名时,需要替换示例中的站点地址,并确认对应仓库已经同步。
发布时,在管理后台的“镜像与任务”中选择同名镜像,将全文粘贴到“展示信息 → 使用说明(Markdown)”并保存。文章显示在 `/help/<源名>/`,所有界面语言共用一份中文内容。
线上文章保存在后端数据库中;本目录不会在部署时自动导入或覆盖后台编辑的内容。已有 Debian、Ubuntu 安装镜像文章继续保留在后台。
| 文件 | 内容 |
| --- | --- |
| [anaconda.md](anaconda.md) | Conda 频道和安装器 |
| [archlinux.md](archlinux.md) | Arch Linux 官方仓库 |
| [archlinuxarm.md](archlinuxarm.md) | Arch Linux ARM 仓库 |
| [archlinuxcn.md](archlinuxcn.md) | Arch Linux 中文社区仓库 |
| [debian-cd.md](debian-cd.md) | Debian 安装镜像和校验 |
| [debian-security.md](debian-security.md) | Debian 安全更新仓库 |
| [elrepo.md](elrepo.md) | Enterprise Linux 驱动和内核仓库 |
| [jenkins.md](jenkins.md) | Jenkins 安装包和 WAR |
| [kubernetes.md](kubernetes.md) | Kubernetes DEB、RPM 仓库 |
| [openwrt.md](openwrt.md) | OpenWrt 正式版软件仓库 |
| [proxmox.md](proxmox.md) | Proxmox VE 软件仓库 |
| [tailscale.md](tailscale.md) | Tailscale Debian、Ubuntu 仓库 |
| [ubuntu.md](ubuntu.md) | Ubuntu 软件仓库 |
文章参考 TUNA 帮助和各项目官方文档编写,原始资料链接见各篇末尾。目录、版本和同步范围以本站实际提供的内容为准。
+70
View File
@@ -0,0 +1,70 @@
本站提供 Conda 软件包频道及部分安装器。频道和平台的同步范围可在 [Anaconda 目录](/mirrors/anaconda/)中查看。
## 配置文件
配置位于用户目录下的 `.condarc`:Linux 和 macOS 使用 `~/.condarc`,Windows 使用 `%USERPROFILE%\.condarc`。先备份已有文件;没有该文件时可运行:
```sh
conda config --set show_channel_urls yes
```
切换前确认所需频道的平台目录已有 `repodata.json`,例如 [conda-forge 的 linux-64 索引](/mirrors/anaconda/cloud/conda-forge/linux-64/)。索引尚未同步完成时,先保留原配置。
## 使用 conda-forge
将 `.condarc` 中相关配置改为以下内容。已有的 `channels` 应一并检查,避免意外混用不同频道的软件包:
```yaml
channels:
- conda-forge
show_channel_urls: true
channel_priority: strict
custom_channels:
conda-forge: https://mirrors.app.itstudio.club/mirrors/anaconda/cloud
bioconda: https://mirrors.app.itstudio.club/mirrors/anaconda/cloud
```
这里的 `custom_channels` 地址不包含频道名,Conda 会自动补上 `conda-forge` 或 `bioconda`。
刷新索引,并在新环境中验证:
```sh
conda clean --index-cache
conda create -n mirror-test --override-channels -c conda-forge python numpy
conda list -n mirror-test --show-channel-urls
```
`--override-channels` 让此次创建只使用指定频道。使用 Bioconda 时,可按下面的顺序指定频道:
```sh
conda create -n bio-test --override-channels -c conda-forge -c bioconda samtools
```
## 使用 defaults
如果项目需要 Anaconda 的 `defaults`,可改用下面这套配置。它是上一套配置的替代方案:
```yaml
channels:
- defaults
show_channel_urls: true
default_channels:
- https://mirrors.app.itstudio.club/mirrors/anaconda/pkgs/main
- https://mirrors.app.itstudio.club/mirrors/anaconda/pkgs/r
- https://mirrors.app.itstudio.club/mirrors/anaconda/pkgs/msys2
```
使用前请查阅 Anaconda 对相应仓库的使用条款。自定义环境文件中的完整 URL、`-c` 参数和其他配置文件可能覆盖 `.condarc`;可通过 `conda config --show-sources` 排查。
## 下载安装器
- [Miniconda 安装器](/mirrors/anaconda/miniconda/)
- [Anaconda Distribution 安装器](/mirrors/anaconda/archive/)
选择与系统、CPU 架构匹配的文件,安装前与官方发布的 SHA256 校验值比较。本站尚未同步到的文件请从官方获取。
## 参考资料
- [TUNA Anaconda 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/anaconda/)
- [Conda 频道配置](https://docs.conda.io/projects/conda/en/stable/user-guide/configuration/use-condarc.html)
- [Bioconda 频道配置](https://bioconda.github.io/user/install.html)
+39
View File
@@ -0,0 +1,39 @@
本站提供 Arch Linux 官方软件仓库。本文适用于 Arch Linux 的 x86_64 系统;ARM 设备请参阅 [Arch Linux ARM](/help/archlinuxarm/),中文社区软件包请参阅 [Arch Linux CN](/help/archlinuxcn/)。
## 配置镜像
先备份镜像列表:
```sh
sudo cp /etc/pacman.d/mirrorlist /etc/pacman.d/mirrorlist.bak
```
编辑 `/etc/pacman.d/mirrorlist`,将下面一行放在最前面:
```text
Server = https://mirrors.app.itstudio.club/mirrors/archlinux/$repo/os/$arch
```
`$repo` 和 `$arch` 是 pacman 使用的变量,请原样保留。`/etc/pacman.conf` 中相应仓库应继续通过 `Include = /etc/pacman.d/mirrorlist` 引用镜像列表。
## 刷新并完整升级
更换镜像后执行:
```sh
sudo pacman -Syyu
```
之后日常升级使用 `sudo pacman -Syu`。Arch Linux 不支持部分升级,不要仅运行 `pacman -Sy` 后单独更新某个普通软件包。
若遇到数据库或软件包 404,请检查 [本站同步状态](/status)并稍后重试。持续失败时可恢复备份,或把其他可用镜像移到前面;保持软件包签名校验开启。
## 安装镜像
安装 ISO 位于 [archlinux/iso/](/mirrors/archlinux/iso/)。选择发布目录中的 ISO 和签名文件,按官方安装指南验证签名。此仓库不提供用于任意历史版本回退的 Arch Linux Archive 服务。
## 参考资料
- [TUNA Arch Linux 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/archlinux/)
- [ArchWiki:镜像](https://wiki.archlinux.org/title/Mirrors)
- [ArchWiki:系统维护](https://wiki.archlinux.org/title/System_maintenance)
+37
View File
@@ -0,0 +1,37 @@
Arch Linux ARM 为 ARM 设备提供 Arch Linux 软件包。它与 x86_64 的 Arch Linux 仓库目录不同,请勿混用两者的镜像地址。
## 配置镜像
在已经安装好的 Arch Linux ARM 系统中,先备份:
```sh
sudo cp /etc/pacman.d/mirrorlist /etc/pacman.d/mirrorlist.bak
```
将下面一行放到 `/etc/pacman.d/mirrorlist` 的最前面:
```text
Server = https://mirrors.app.itstudio.club/mirrors/archlinuxarm/$arch/$repo
```
保留 `$arch` 和 `$repo` 原样。这里没有 Arch Linux 官方仓库路径中的 `os/`。
本站目录包含 `aarch64`、`armv7h` 等架构,具体以 [仓库目录](/mirrors/archlinuxarm/)为准。不要为了使用某个目录而修改系统的架构设置。
## 更新系统
```sh
sudo pacman -Syyu
```
后续使用 `sudo pacman -Syu` 完整升级。遇到软件包缺失时,先检查同步状态和架构;不要关闭签名校验,也不要用 x86_64 仓库补充 ARM 软件包。
## 安装文件
根文件系统等安装文件位于 [archlinuxarm/os/](/mirrors/archlinuxarm/os/)。不同板卡的分区、引导程序和安装流程各不相同,请先在官方平台列表中找到自己的设备,再按对应指南选择文件。
## 参考资料
- [TUNA Arch Linux ARM 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/archlinuxarm/)
- [Arch Linux ARM 镜像说明](https://archlinuxarm.org/about/mirrors)
- [Arch Linux ARM 支持的平台](https://archlinuxarm.org/platforms)
+41
View File
@@ -0,0 +1,41 @@
Arch Linux CN 是 Arch Linux 中文社区维护的非官方软件仓库,收录部分常用软件、工具和字体。它不替代 Arch Linux 官方仓库,也不包含 AUR 的全部软件包。
## 添加仓库
备份 `/etc/pacman.conf`,在文件末尾添加:
```ini
[archlinuxcn]
Server = https://mirrors.app.itstudio.club/mirrors/archlinuxcn/$arch
```
`$arch` 保持原样。本站提供的架构可在 [仓库目录](/mirrors/archlinuxcn/)中查看。已有 `[archlinuxcn]` 配置时,修改原来的 `Server`,不要重复添加仓库段。
## 导入签名密钥并升级
按社区仓库的安装流程,先安装密钥环,随后立即完整升级系统:
```sh
sudo pacman -Sy archlinuxcn-keyring
sudo pacman -Syu
```
第一条命令用于引导安装社区签名密钥环,之后不要停留在仅刷新数据库的状态。日常更新使用 `sudo pacman -Syu`。
如果提示密钥不受信任或签名无效,请先确认系统时间,并根据中文社区的官方说明处理密钥环问题。不要通过 `SigLevel = Never` 绕过验证,也不要从不明来源导入密钥。
## 安装软件
完成上述步骤后,可以像使用其他 pacman 仓库一样安装软件:
```sh
pacman -Sl archlinuxcn
sudo pacman -S archlinuxcn/软件包名
```
将 `软件包名` 替换为列表中实际存在的名称。若要使用官方仓库的软件包镜像,请另行配置 [Arch Linux 镜像](/help/archlinux/)。
## 参考资料
- [TUNA Arch Linux CN 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/archlinuxcn/)
- [Arch Linux 中文社区仓库说明](https://www.archlinuxcn.org/archlinux-cn-repo-and-mirror/)
+47
View File
@@ -0,0 +1,47 @@
此镜像提供 Debian 安装文件。已经安装 Debian、需要修改软件包源时,请参阅 [Debian 使用帮助](/help/debian/)。
## 选择安装文件
- [当前正式版](/mirrors/debian-cd/current/):按 CPU 架构选择安装镜像。
- [amd64 网络安装镜像](/mirrors/debian-cd/current/amd64/iso-cd/):适用于 Intel、AMD 的 64 位 x86 电脑;安装时需要联网下载所选软件。
- [当前 Live 镜像](/mirrors/debian-cd/current-live/):可以先启动桌面环境进行体验,再按需安装。
文件名中的版本号以目录实际内容为准。`amd64` 不适用于 ARM 设备,请按设备架构选择对应目录。Live 镜像可用的架构和桌面环境也以目录为准。
## 下载与完整性校验
在所选 ISO 的同一目录中,同时下载 `SHA512SUMS` 和 `SHA512SUMS.sign`,与 ISO 放在同一个本地目录。
Linux 下运行:
```sh
sha512sum --ignore-missing -c SHA512SUMS
```
确认所下载的 ISO 显示 `OK`。Windows PowerShell 可计算文件哈希后,与清单中同名文件的值逐位比较:
```powershell
Get-FileHash -Algorithm SHA512 -LiteralPath .\下载的镜像.iso
```
将示例文件名替换为实际文件名。哈希一致说明文件与校验清单一致;清单本身的来源需要通过签名确认。
## 验证签名
按 [Debian 官方验证说明](https://www.debian.org/CD/verify)获取 Debian CD 发布密钥,并通过官方资料核对指纹。然后验证校验清单:
```sh
gpg --verify SHA512SUMS.sign SHA512SUMS
```
确认签名有效且签名密钥属于 Debian 发布团队,再进行 ISO 哈希校验。不要仅因为 GPG 显示某个签名有效,就信任尚未核对身份的密钥。
## 安装
校验后可将 ISO 挂载到虚拟机光驱,或用启动盘工具写入 USB 设备。实机安装会涉及磁盘分区,请先备份数据,并参考对应架构的安装手册。
## 参考资料
- [Debian 安装镜像](https://www.debian.org/CD/)
- [Debian 镜像验证](https://www.debian.org/CD/verify)
- [Debian 安装手册](https://www.debian.org/releases/stable/installmanual)
+54
View File
@@ -0,0 +1,54 @@
`debian-security` 提供 Debian 安全更新。它需要与 [Debian 主仓库](/help/debian/)配合使用,不能代替主仓库。
安全更新对时效要求较高,通常建议保留官方 `https://security.debian.org/debian-security`。需要使用本站时,请先检查 [同步状态](/status),再按下面的方法替换安全更新条目。
## 选择发行版
运行 `cat /etc/os-release` 确认当前系统代号。常见对应关系:
| Debian 版本 | 代号 | 安全更新套件 |
| --- | --- | --- |
| Debian 13 | trixie | trixie-security |
| Debian 12 | bookworm | bookworm-security |
| Debian 11 | bullseye | bullseye-security |
目录存在不代表该版本仍处于官方安全支持期,请同时查阅 Debian 的安全支持和 LTS 公告。
## DEB822 格式
以 Debian 13 为例,备份 `/etc/apt/sources.list.d/debian.sources`,将其中安全更新段替换为:
```text
Types: deb
URIs: https://mirrors.app.itstudio.club/mirrors/debian-security/
Suites: trixie-security
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
```
保留文件中 Debian 主仓库、updates 等其他段。Debian 12 将 `trixie-security` 改为 `bookworm-security`;Debian 11 使用 `bullseye-security`,并移除 `non-free-firmware` 组件。
## 传统 sources.list 格式
如果系统仍使用传统格式,备份 `/etc/apt/sources.list` 后,将原来的安全更新行改为:
```text
deb https://mirrors.app.itstudio.club/mirrors/debian-security/ trixie-security main contrib non-free non-free-firmware
```
按系统版本调整套件和组件。两种格式选择一种即可,不要重复添加相同的安全更新源。
## 更新索引
```sh
sudo apt update
apt-cache policy
```
若本站同步延迟、索引缺失或更新失败,将安全更新 URI 改回 `https://security.debian.org/debian-security` 后重试。不要关闭 APT 签名校验。
## 参考资料
- [TUNA Debian Security 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/debian-security/)
- [Debian 安全信息](https://www.debian.org/security/)
- [Debian LTS](https://wiki.debian.org/LTS)
+50
View File
@@ -0,0 +1,50 @@
ELRepo 为 Enterprise Linux 系列系统提供额外的驱动、内核等软件包。使用前确认系统的主版本和架构:
```sh
cat /etc/os-release
uname -m
```
ELRepo 仓库版本必须与系统主版本匹配,不能将 EL9 软件包用于 EL10,也不要将其配置到 Debian、Ubuntu 等系统中。
## 安装官方仓库配置
先按 [ELRepo 官方说明](https://elrepo.org/)安装与当前系统匹配的 `elrepo-release` 软件包,并导入官方签名密钥。已经配置过 ELRepo 的系统可以跳过这一步。
备份仓库文件:
```sh
sudo cp /etc/yum.repos.d/elrepo.repo /etc/yum.repos.d/elrepo.repo.bak
```
## 替换下载地址
编辑 `/etc/yum.repos.d/elrepo.repo`:
1. 注释需要使用本站的仓库段中的 `mirrorlist=` 行。
2. 启用对应的 `baseurl=`,将其中 `http://elrepo.org/linux` 或 `https://elrepo.org/linux` 替换为 `https://mirrors.app.itstudio.club/mirrors/elrepo`。
3. 保留路径后面的系统版本、仓库名称及 `$basearch` 变量;保留官方配置中的签名检查和密钥地址。
例如 EL9 的基础仓库地址应为:
```ini
baseurl=https://mirrors.app.itstudio.club/mirrors/elrepo/elrepo/el9/$basearch/
```
这只是一行地址示例,不是完整的 `.repo` 文件。不要用它覆盖 `enabled`、`gpgcheck`、`gpgkey` 等其他设置。
## 刷新缓存
```sh
sudo dnf makecache
dnf repolist
```
`elrepo-kernel` 等可选仓库保持原有启用状态;需要额外内核时,应先阅读 ELRepo 的内核说明,再明确启用对应仓库。换镜像本身不需要更换内核。
如果元数据下载失败,检查 [ELRepo 目录](/mirrors/elrepo/)是否包含当前系统版本,并恢复备份后重试。
## 参考资料
- [TUNA ELRepo 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/elrepo/)
- [ELRepo 项目与安装说明](https://elrepo.org/)
+54
View File
@@ -0,0 +1,54 @@
本站提供 Jenkins 安装文件,包括 DEB、RPM、WAR 和插件文件。当前镜像没有 APT 的 `Release`、`Packages` 或 RPM 仓库元数据,因此不能将这些下载目录直接作为 APT、DNF 软件源。
## 选择发行通道
- [LTS DEB 安装包](/mirrors/jenkins/debian-stable/)
- [LTS RPM 安装包](/mirrors/jenkins/rpm-stable/)
- [LTS WAR](/mirrors/jenkins/war-stable/)
- [其他文件与每周版本](/mirrors/jenkins/)
生产环境通常选择 LTS。具体版本以目录为准,升级已有实例前请备份 `JENKINS_HOME`,并查阅对应版本的升级指南。
## Debian / Ubuntu 安装示例
先安装受目标 Jenkins 版本支持的 Java。以下示例使用 OpenJDK 21,需系统仓库中提供该软件包:
```sh
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
```
从 LTS DEB 目录中选择版本并下载。以下 `2.580.2` 是文件名示例,不代表最新版本:
```sh
curl -fLO https://mirrors.app.itstudio.club/mirrors/jenkins/debian-stable/jenkins_2.580.2_all.deb
sudo apt install ./jenkins_2.580.2_all.deb
sudo systemctl enable --now jenkins
```
访问服务器的 `8080` 端口,按页面提示完成首次初始化。管理员初始密码按 Jenkins 页面给出的本机文件位置获取,不要发布该文件内容。
此方式安装的是单个软件包。后续升级需再次下载并安装新版本;需要包管理器自动更新时,请按 Jenkins 官方说明配置其官方软件仓库。
## 使用 WAR 运行
需要临时运行或自行管理 Java 进程时,可以下载 LTS WAR:
```sh
curl -fL https://mirrors.app.itstudio.club/mirrors/jenkins/war-stable/latest/jenkins.war -o jenkins.war
java -jar jenkins.war --httpPort=8080
```
`latest` 会随同步变化,运行前请根据所下载版本的 Java 支持表确认运行环境。长期部署应配置适当的进程管理、访问控制和备份。
## 校验与插件
安装前核对 Jenkins 官方发布的版本及校验值;RPM 安装还应按官方说明导入并核对签名密钥。插件目录本身不是更新中心配置,不能把它当作 `update-center.json` 地址填写。
## 参考资料
- [Jenkins Linux 安装说明](https://www.jenkins.io/doc/book/installing/linux/)
- [Jenkins WAR 安装说明](https://www.jenkins.io/doc/book/installing/war-file/)
- [Jenkins Java 支持策略](https://www.jenkins.io/doc/book/platform-information/support-policy-java/)
- [Jenkins 升级指南](https://www.jenkins.io/doc/upgrade-guide/)
+75
View File
@@ -0,0 +1,75 @@
本站镜像 Kubernetes 的版本化软件包仓库,可用于安装 `kubelet`、`kubeadm` 和 `kubectl`。容器镜像、容器运行时及集群网络插件需要另行配置。
本文以 `v1.35` 仓库为例。它是示例版本,不代表最新版本;已有集群应根据官方升级流程及版本偏差策略选择次版本,并在所有仓库地址中保持一致。修改软件源不会自动完成集群升级。
## Debian / Ubuntu
安装所需工具:
```sh
sudo apt update
sudo apt install ca-certificates curl gpg
sudo install -d -m 0755 /etc/apt/keyrings
```
从 Kubernetes 官方仓库获取该通道的签名公钥。如果同名密钥文件已经存在,先核对、备份,再更新:
```sh
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.35/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
sudo chmod 0644 /etc/apt/keyrings/kubernetes-apt-keyring.gpg
```
备份已有 `/etc/apt/sources.list.d/kubernetes.list`,然后写入:
```text
deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://mirrors.app.itstudio.club/mirrors/kubernetes/core:/stable:/v1.35/deb/ /
```
更新索引并查看可安装版本:
```sh
sudo apt update
apt-cache madison kubeadm
```
新节点需要安装组件时,可执行:
```sh
sudo apt install kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
```
已有集群请按升级指南逐个处理节点,不要直接套用新节点安装步骤。
## RPM 系统
备份已有 `/etc/yum.repos.d/kubernetes.repo`,配置为:
```ini
[kubernetes]
name=Kubernetes
baseurl=https://mirrors.app.itstudio.club/mirrors/kubernetes/core:/stable:/v1.35/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.35/rpm/repodata/repomd.xml.key
exclude=kubelet kubeadm kubectl cri-tools kubernetes-cni
```
刷新缓存并查看版本:
```sh
sudo dnf makecache
dnf --disableexcludes=kubernetes list --showduplicates kubeadm
```
新节点安装组件时使用 `sudo dnf install kubelet kubeadm kubectl --disableexcludes=kubernetes`。`exclude` 用于避免普通系统更新意外升级集群组件。
## 检查地址
本站使用 `core:/stable:/v1.xx/` 目录布局,不使用旧的 `apt.kubernetes.io` 地址。其他版本请先查看 [仓库目录](/mirrors/kubernetes/core:/stable:/)是否已同步,并确认该版本仍符合项目的支持策略。
## 参考资料
- [TUNA Kubernetes 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/kubernetes/)
- [Kubernetes:安装 kubeadm](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
- [Kubernetes 版本偏差策略](https://kubernetes.io/releases/version-skew-policy/)
+45
View File
@@ -0,0 +1,45 @@
本站提供 OpenWrt 正式发行版的固件和软件包,目录位于 [openwrt/releases/](/mirrors/openwrt/releases/),不包含 `snapshots`。
## 确认版本和包管理器
登录路由器后,先查看 `/etc/openwrt_release` 和现有的软件源配置。若配置中含有 `snapshots`,请保留原地址,本文的正式版镜像不能替代它。
OpenWrt 25.12 起使用 APK;24.10 及更早版本使用 OPKG。第三方固件可能更改包管理器或仓库,应以实际系统为准。下面的命令在路由器的 root 会话中执行。
## APK:OpenWrt 25.12 及之后
备份并替换官方仓库域名:
```sh
cp /etc/apk/repositories.d/distfeeds.list /etc/apk/repositories.d/distfeeds.list.bak
sed -i 's|https\?://downloads.openwrt.org|https://mirrors.app.itstudio.club/mirrors/openwrt|g' /etc/apk/repositories.d/distfeeds.list
apk update
```
## OPKG:OpenWrt 24.10 及之前
```sh
cp /etc/opkg/distfeeds.conf /etc/opkg/distfeeds.conf.bak
sed -i 's|https\?://downloads.openwrt.org|https://mirrors.app.itstudio.club/mirrors/openwrt|g' /etc/opkg/distfeeds.conf
opkg update
```
两种方式仅替换官方地址的前缀,保留原来的版本、target、subtarget 和软件包架构路径。自定义仓库保持原样。不要复制其他路由器的整份源配置,否则可能安装不兼容的软件包。
## 更新失败时
先检查系统时间、HTTPS 证书支持和本站同步状态。缺少证书组件时,使用原来的可用仓库补齐所需组件后再切换,不要关闭证书或软件包签名验证。
404 常见于版本或架构不匹配,也可能是该发行版尚未同步到本站。可以恢复对应 `.bak` 配置后重新更新索引。
`apk update`、`opkg update` 只刷新索引,不执行固件升级;不要把更换软件源当成跨版本升级,也不要为此批量升级系统核心软件包。
## 下载固件
先在 OpenWrt 官方设备页面或 Firmware Selector 中确定型号和硬件版本,再在本站同版本的 `targets/` 目录中下载。刷入前核对文件名、设备适配和官方校验值。
## 参考资料
- [TUNA OpenWrt 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/openwrt/)
- [OpenWrt 软件包管理](https://openwrt.org/docs/guide-user/additional-software/start)
- [OpenWrt Firmware Selector](https://firmware-selector.openwrt.org/)
+58
View File
@@ -0,0 +1,58 @@
本站提供 Proxmox 软件仓库与部分安装镜像。本文说明 Proxmox VE 的非订阅仓库配置,Debian 基础软件源请另行参阅 [Debian 使用帮助](/help/debian/)。
## 确认系统版本
```sh
pveversion
cat /etc/os-release
```
Proxmox VE 9 基于 Debian 13(`trixie`),Proxmox VE 8 基于 Debian 12(`bookworm`)。仓库套件必须与当前系统一致,不要通过修改代号直接跨版本升级。
以下操作在节点的 root 终端中执行。操作前备份 `/etc/apt/sources.list` 及 `/etc/apt/sources.list.d/` 中将要修改的文件。
## Proxmox VE 9:DEB822 格式
创建或编辑 `/etc/apt/sources.list.d/proxmox.sources`:
```text
Types: deb
URIs: https://mirrors.app.itstudio.club/mirrors/proxmox/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
```
密钥环由 Proxmox 官方软件包提供;若文件缺失,请先按官方说明修复密钥环,不要移除 `Signed-By` 或关闭验证。
## Proxmox VE 8:传统格式
创建或编辑 `/etc/apt/sources.list.d/pve-no-subscription.list`:
```text
deb https://mirrors.app.itstudio.club/mirrors/proxmox/debian/pve bookworm pve-no-subscription
```
继续使用系统已有的官方签名密钥配置。两种格式按当前版本选择其一,不要重复启用相同仓库。
## 检查仓库并更新
在 Proxmox 网页端的节点“更新 → 软件仓库”中检查配置。没有订阅时,可禁用仍然启用的 enterprise 条目,避免无权限的仓库导致更新报错;有订阅的用户可继续使用官方 enterprise 仓库。
`pve-no-subscription` 面向无需订阅的用户,其验证程度与 enterprise 仓库不同,生产环境请按 Proxmox 官方建议选择。
```sh
apt update
apt-cache policy pve-manager
```
软件源切换成功后,再按自己的维护计划更新系统。Ceph 等独立仓库需要匹配相应版本,不要直接套用 PVE 仓库的路径和组件名。
## 安装镜像
ISO 可从 [Proxmox 安装镜像目录](/mirrors/proxmox/iso/)下载。安装前请核对官方公布的校验值和硬件要求。
## 参考资料
- [TUNA Proxmox 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/proxmox/)
- [Proxmox VE 软件仓库说明](https://pve.proxmox.com/pve-docs/pve-admin-guide.html#sysadmin_package_repositories)
+64
View File
@@ -0,0 +1,64 @@
本站提供 Tailscale 稳定通道的 Debian、Ubuntu APT 软件包,分别位于 `tailscale/debian/` 和 `tailscale/ubuntu/`。镜像地址中不含上游的 `stable/` 路径;本站未提供对应的 RPM 仓库。
先运行 `cat /etc/os-release` 确认发行版和代号。下面两套配置择一使用,不能在 Ubuntu 上使用 Debian 仓库,反之亦然。
## 准备工具
```sh
sudo apt update
sudo apt install ca-certificates curl
sudo install -d -m 0755 /usr/share/keyrings
```
已有 `/etc/apt/sources.list.d/tailscale.list` 或同名密钥环时,先备份并检查,避免重复配置。密钥从 Tailscale 官方站点获取。
## Debian 示例
以 Debian 12(`bookworm`)为例,下载官方公钥:
```sh
curl -fsSL https://pkgs.tailscale.com/stable/debian/bookworm.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
sudo chmod 0644 /usr/share/keyrings/tailscale-archive-keyring.gpg
```
将 `/etc/apt/sources.list.d/tailscale.list` 设置为:
```text
deb [signed-by=/usr/share/keyrings/tailscale-archive-keyring.gpg] https://mirrors.app.itstudio.club/mirrors/tailscale/debian bookworm main
```
Debian 13 使用 `trixie`,同时替换官方密钥下载地址和源配置中的代号。其他版本请先确认 [Debian 目录](/mirrors/tailscale/debian/dists/)中存在对应套件。
## Ubuntu 示例
以 Ubuntu 24.04 LTS(`noble`)为例:
```sh
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
sudo chmod 0644 /usr/share/keyrings/tailscale-archive-keyring.gpg
```
将 `/etc/apt/sources.list.d/tailscale.list` 设置为:
```text
deb [signed-by=/usr/share/keyrings/tailscale-archive-keyring.gpg] https://mirrors.app.itstudio.club/mirrors/tailscale/ubuntu noble main
```
其他 Ubuntu 版本需同时修改密钥地址和套件代号,并确认 [Ubuntu 目录](/mirrors/tailscale/ubuntu/dists/)中已提供该套件。
## 安装和登录
```sh
sudo apt update
sudo apt install tailscale
sudo systemctl enable --now tailscaled
sudo tailscale up
tailscale status
```
根据 `tailscale up` 输出的登录地址完成设备授权。镜像仅负责安装包下载,账号登录、控制服务和组网仍由 Tailscale 提供。
## 参考资料
- [Tailscale 稳定版软件仓库](https://pkgs.tailscale.com/stable/)
- [Tailscale Linux 安装说明](https://tailscale.com/kb/1031/install-linux)
+62
View File
@@ -0,0 +1,62 @@
本站提供 Ubuntu 的 x86 软件仓库。ARM 等架构使用的 `ubuntu-ports` 不在此仓库内;安装 ISO 请前往 [Ubuntu 安装镜像](/help/ubuntu-releases/)。
## 选择系统版本
运行下面的命令,确认当前系统代号和架构:
```sh
. /etc/os-release
printf '%s\n' "$VERSION_CODENAME"
dpkg --print-architecture
```
本文以 Ubuntu 24.04 LTS(`noble`)为例。Ubuntu 22.04 LTS 使用 `jammy`。只替换为当前系统的代号,换源不能代替发行版升级。
切换前检查 [noble 索引目录](/mirrors/ubuntu/dists/noble/)是否有 `InRelease` 或 `Release`。如果索引尚未同步完成,请继续使用官方源,稍后再切换。
## Ubuntu 24.04 及之后:DEB822 格式
先备份 `/etc/apt/sources.list.d/ubuntu.sources`,再将其中的 Ubuntu 仓库配置替换为:
```text
Types: deb
URIs: https://mirrors.app.itstudio.club/mirrors/ubuntu/
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
Types: deb
URIs: http://security.ubuntu.com/ubuntu/
Suites: noble-security
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
```
安全更新保留官方源,以减少镜像同步延迟的影响。不要同时保留另一份相同仓库配置。
## Ubuntu 22.04:传统格式
备份 `/etc/apt/sources.list` 后,将 Ubuntu 条目替换为:
```text
deb https://mirrors.app.itstudio.club/mirrors/ubuntu/ jammy main restricted universe multiverse
deb https://mirrors.app.itstudio.club/mirrors/ubuntu/ jammy-updates main restricted universe multiverse
deb https://mirrors.app.itstudio.club/mirrors/ubuntu/ jammy-backports main restricted universe multiverse
deb http://security.ubuntu.com/ubuntu/ jammy-security main restricted universe multiverse
```
保留其他独立软件源的配置。需要源码包时,可以在传统格式中增加对应 `deb-src` 行,或将 DEB822 的 `Types` 改为 `deb deb-src`。
## 更新索引
```sh
sudo apt update
apt-cache policy
```
检查输出中的仓库地址是否指向本站。若出现缺少 Release 文件、404 或签名错误,先恢复备份并检查系统代号、同步状态及系统时间,不要关闭签名校验。
## 参考资料
- [TUNA Ubuntu 使用帮助](https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/)
- [Ubuntu 软件仓库说明](https://documentation.ubuntu.com/server/how-to/software/package-management/)