
apt-cacher-ultra 发布 1.0,上游镜像故障时仍可提供缓存包
来源标题:Apt-cacher-ultra – Protecting you from the next Ubuntu.com outage
apt-cacher-ultra 发布稳定 1.0 版本,作为 apt-cacher-ng 的替代品,可在 Ubuntu/Debian/PPA 上游镜像变慢、故障或遭 DDoS 时继续从缓存提供软件包。它通过快照仓库更新并预下载热门包来保障可用性,冷门包仍需上游在线。该项目兼容原有 :3142 端口和代理配置,作者已在 4 个环境、200 台机器上实际运行。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
一个健壮的 apt 仓库缓存,专注于在上游故障时保持可用性。设计目标是替代 apt-cacher-ng:即使上游 Ubuntu/Debian/PPA 镜像变慢、故障或遭受 DDoS,缓存命中依然可用。它会为仓库更新创建快照,跟踪整个集群中的“热点软件包”,并在快照更新可供客户端请求之前预先下载热点软件包。这样一来,即使上游服务器不可用,也能可靠地向客户端提供软件包集合。限制在于“冷门”软件包仍需要上游可用性。典型使用场景下,软件包应始终可以从缓存中获取。
贡献:apt-cacher-ultra 只接受 AI 撰写的贡献。详情参见 CONTRIBUTING.md。
稳定版 1.0 发布。我在自己的 4 个环境中运行它,管理 200 台机器,处理数千次“apt update/upgrade”和“apt installs”。
可直接替换 apt-cacher-ng——相同的 :3142 端口、代理模式以及 http://HTTPS/// URL 约定,因此现有客户端配置无需改动即可工作。
TLS MITM(可选)——本地 CA 为每个主机签发叶证书,因此 HTTPS 仓库(例如 download.docker.com)可以被缓存。
服务器 HTTPS(可选)——管理端和缓存监听器支持证书文件重新加载,以及自动的 ACME HTTP-01 或 DNS-01 签发与续期,使用 Lego 完整的自动化 DNS 提供商目录。参见服务器 HTTPS 设置。
可用性优先的缓存——缓存命中绝不会因上游而阻塞;上游宕机或变慢时,直接提供快照而不是报错。
原子快照采用——每个 suite 的 InRelease 以及所有引用的 Packages/by-hash blob 都会先暂存,经过 GPG 验证(签名仓库;参见 Repositories),然后在单个 SQLite 事务中整体切换。切换会(有界地)等待,直到收到旧 InRelease 的客户端已经过了 adoption.flip_quiet_period 去获取其索引,这样 apt 客户端在收到其 InRelease 后的这段时间内发送的索引请求能与之一致(by-hash 请求即使在之后也会从被替换的快照中提供);残余情况(客户端在保持期进行到 15 秒时仍收到旧 InRelease,或在切换前不足 flip_quiet_period 才完成,提交慢于 20 秒保持期,切换等待 60 秒才轮到保持,响应慢于 apt 自身的超时,超过 256 个被保持的请求)各自都有计数器,并在 Flip consistency 中记录。
哈希校验——每个元数据文件都会对照 InRelease 检查,每个 .deb 都会对照 Packages 检查(签名仓库;参见 Repositories);不匹配的会被拒绝。
by-hash 去重——索引按内容哈希存储,跨 suite 去重。
单飞合并——N 个并发客户端请求同一个未缓存文件时,只产生一次上游获取。
可恢复的上游获取——使用 HTTP Range 在瞬时故障后恢复。
由允许主机正则表达式门控。
新鲜度控制——定期和按需的 InRelease 检查,带冷却时间;热点软件包主动刷新。
扁平、未签名和无 Release 的仓库——像 dists/ 仓库一样刷新,并启用采用(参见 Repositories)。
并发上限——每主机和全局的 max_concurrent_adoptions 信号量,防止采用流量饿死请求路径的调用者。
垃圾回收——当没有快照引用时,引用计数的 blob 会被清除。
Suite 回收——30 天内没有客户端请求的 suite 会被丢弃,连同其缓存的索引文件(参见 Suites no client uses)。
自愈快照——在所需索引短暂不可用时采用的快照会就地修复,在下次无变化的新鲜度检查时自动进行,或通过 POST /reconcile 按需进行(参见“Recovering a degraded repository”)。
可观测性——/metrics 端点、状态页面、结构化日志(参见 docs/log-fields.md)。
使用统计——管理仪表盘上显示持久化的获取/提供数据总量、缓存节省量和平均有效传输速率。
打包——可从 apt 仓库安装,使用带 systemd 单元的 .deb,或独立的 Go 可执行文件。
快速开始
从 apt 仓库安装(推荐):
sudo install -d -m0755 /etc/apt/keyrings
curl -fsSL https://linsomniac.github.io/apt-cacher-ultra/apt-cacher-ultra.gpg
| sudo tee /etc/apt/keyrings/apt-cacher-ultra.gpg >/dev/null
sudo chmod a+r /etc/apt/keyrings/apt-cacher-ultra.gpg # apt 以 _apt 用户身份验证;密钥必须全局可读
echo 'deb [signed-by=/etc/apt/keyrings/apt-cacher-ultra.gpg] https://linsomniac.github.io/apt-cacher-ultra/ stable main'
| sudo tee /etc/apt/sources.list.d/apt-cacher-ultra.list
sudo apt-get update
sudo apt-get install apt-cacher-ultra
编辑:/etc/apt-cacher-ultra/config.toml
sudo systemctl enable --now apt-cacher-ultra
预构建的 amd64 软件包发布在 https://linsomniac.github.io/apt-cacher-ultra/(最新的稳定版本)。 make deb dpkg -i build/apt-cacher-ultra_*.deb
编辑:/etc/apt-cacher-ultra/config.toml
sudo systemctl enable --now apt-cacher-ultra systemctl start apt-cacher-ultra
如有必要,允许防火墙通过 3142 端口:
iptables -I INPUT -p tcp --dport 3142 -j ACCEPT
手动构建: make build cp packaging/config/config.toml.default config.toml
编辑:config.toml
./build/apt-cacher-ultra -config config.toml
Docker 参见 Docker 和 Compose 了解仅 HTTP、服务器 HTTPS/ACME 以及 HTTPS MITM 示例、持久化存储和多平台 GHCR 构建。
编辑 /etc/apt-cacher-ultra/config.toml(或传递给 -config 的文件),然后重启守护进程。配置参考文档记录了每个选项、其默认值、有效值以及交互关系。打包的示例包含每个选项,并附有简洁注释和可选的 signer、remap 和 mirror 示例。如需在管理端或缓存监听器上启用 HTTPS,参见服务器证书和 ACME。指南涵盖现有证书和 Certbot、内置 HTTP-01 和 DNS-01、提供商凭据、续期、恢复以及经验证的健康检查。打包的配置监听 0.0.0.0:3142,允许所有上游,并启用 HTTPS MITM;HTTPS 代理客户端必须信任缓存的 CA。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。