any-hub/specs/007-apt-apk-cache/quickstart.md

Quickstart: APT/APK 缓存代理

1) 启用新 Hub

在 config.toml 增加示例：

[[Hub]]
Domain = "apt.hub.local"
Name = "apt"
Port = 5001
Upstream = "https://mirrors.edge.kernel.org/ubuntu"
Type = "debian"
Module = "debian" # 待实现模块键

[[Hub]]
Domain = "apk.hub.local"
Name = "apk"
Port = 5002
Upstream = "https://dl-cdn.alpinelinux.org/alpine"
Type = "apk"
Module = "apk" # 待实现模块键

2) 指向代理

• APT：将 /etc/apt/sources.list 中的 http://apt.hub.local:5001 替换官方源域名（需匹配 suite/component 路径）。
• APK：在 /etc/apk/repositories 中写入 http://apk.hub.local:5002/v3.19/main 等路径。

3) 验证

# APT
apt-get update
apt-get install -y curl

# Alpine
apk update
apk add curl

观察 logs/ 输出：首次请求应为回源，二次请求命中缓存（索引可能返回 304）。如上游不可达且缓存已有包体，应继续命中缓存；无缓存则透传错误。