Linux如何搭建本地软件仓库?从同步软件包到客户端验证的步骤
本地软件仓库可以把上游发行版仓库同步到内网服务器,再通过 HTTP 提供给客户端。客户端仍使用 APT 校验仓库的签名元数据,但下载软件包时走内网地址,适合减少重复的外网下载、统一软件包来源或应对外网访问受限的环境。
下面以 Debian 12、amd64、deb.debian.org 上的 bookworm 仓库为例,使用 apt-mirror 同步、Nginx 发布。示例只镜像 main 组件;如果客户端需要 contrib、non-free-firmware 等组件,必须在同步配置和客户端源配置中一并添加。Ubuntu 或其他发行版的仓库地址、发行代号和签名密钥不同,不能直接照抄本例的源配置。

本地软件仓库的同步与发布需要服务器承载软件包存储、索引更新和 HTTP 服务。A5数据提供中国香港、美国、日本等地区的物理服务器,配置涵盖 SSD、NVMe 及大容量硬盘,并有不同线路和带宽方案,可为软件仓库及相关业务服务提供计算、存储与网络资源。
准备条件
准备一台可访问 Debian 上游仓库的服务器,以及至少一台用于验证的 Debian 12 客户端。服务器需要有固定的内网地址或可解析的主机名;客户端要能访问服务器的 HTTP 端口。首次同步会下载大量数据,磁盘应预留足够空间,并根据需要保留增长余量。仓库的实际占用取决于发行版、组件、架构和同步范围,部署前应检查可用空间。
在服务器上确认系统版本、架构、网络和磁盘:
cat /etc/debian_version
dpkg --print-architecture
df -h /var
getent hosts deb.debian.org
本例要求架构输出为 amd64。如果同步服务器本身是其他架构,但需要为 amd64 客户端提供软件包,应确认所用同步工具和配置支持指定架构;不要因为服务器安装了某个架构的软件包,就默认仓库只包含该架构。
还需要确认以下条件:
- 服务器可以连接
deb.debian.org的 HTTP 或 HTTPS 服务。 - 内网客户端可以访问服务器的 80 端口。
/var或后续配置的镜像目录所在文件系统有足够空间。- 服务器和客户端系统时间正常,避免签名有效期校验出现问题。
部署同步服务
安装 apt-mirror 和 Nginx
在 Debian 12 服务器上安装所需软件:
sudo apt update
sudo apt install apt-mirror nginx
检查软件是否已安装:
apt-mirror --version
nginx -v
命令能够输出版本信息即可。若安装失败,先检查服务器现有 APT 源是否可用,再查看报错中是否有 DNS、网络或磁盘空间问题。
配置镜像范围
先备份现有配置,再编辑 /etc/apt/mirror.list。下面的示例只同步 Debian 12 的 amd64、main 组件:
sudo cp -a /etc/apt/mirror.list /etc/apt/mirror.list.bak
sudo tee /etc/apt/mirror.list >/dev/null <<'EOF'
set base_path /var/spool/apt-mirror
set mirror_path $base_path/mirror
set skel_path $base_path/skel
set var_path $base_path/var
set cleanscript $var_path/clean.sh
set defaultarch amd64
set nthreads 10
set _tilde 0
deb http://deb.debian.org/debian bookworm main
clean http://deb.debian.org/debian
EOF
base_path 是镜像数据及同步状态文件所在目录。同步完成后,仓库内容预计位于:
/var/spool/apt-mirror/mirror/deb.debian.org/debian/
nthreads 控制并发下载数量。网络或上游限制较严格时,可适当调低。若需要更多组件,应在 deb 行中追加组件名称,例如:
deb http://deb.debian.org/debian bookworm main contrib non-free non-free-firmware
客户端后续也要使用相同的发行代号和组件。不要把 bookworm 与其他发行版代号混用,也不要随意删除 clean 行:清理规则应与对应的 deb 源一致。
检查配置内容:
sudo cat /etc/apt/mirror.list
确认源地址、发行代号、架构和组件符合预期后,再开始同步。
首次同步软件包
运行同步命令:
sudo apt-mirror
首次同步耗时和磁盘占用受仓库范围、网络带宽及上游响应影响。命令运行过程中会显示下载进度;同步结束后检查镜像目录和状态:
sudo du -sh /var/spool/apt-mirror/mirror
sudo test -f /var/spool/apt-mirror/mirror/deb.debian.org/debian/dists/bookworm/InRelease \
&& echo "找到 InRelease 文件"
预期能看到镜像目录的大小,以及 找到 InRelease 文件。如果没有该文件,先检查同步日志输出和实际目录结构,不要直接继续配置客户端。
此处的 InRelease 是上游仓库签名元数据。镜像服务器应原样提供它及其关联文件,不要手动修改或重新生成仓库索引,否则客户端可能无法通过签名校验。
通过 Nginx 发布仓库
配置 HTTP 路径
创建独立的 Nginx 站点配置:

sudo tee /etc/nginx/sites-available/debian-mirror >/dev/null <<'EOF'
server {
listen 80;
server_name _;
location /debian/ {
alias /var/spool/apt-mirror/mirror/deb.debian.org/debian/;
autoindex on;
}
}
EOF
启用配置并检查语法:
sudo ln -s /etc/nginx/sites-available/debian-mirror \
/etc/nginx/sites-enabled/debian-mirror
sudo nginx -t
如果系统已有默认站点占用相同的监听地址,先检查站点配置,确保访问 /debian/ 时由上述规则处理。nginx -t 应显示配置测试成功。通过后重新加载 Nginx:
sudo systemctl reload nginx
sudo systemctl status nginx --no-pager
预期服务处于 active (running) 状态。若 Nginx 无法读取镜像目录,检查目录及文件的逐级访问权限:
namei -l /var/spool/apt-mirror/mirror/deb.debian.org/debian/dists/bookworm/InRelease
不要用对整个系统开放写权限的方式解决权限问题。Nginx 只需要读取仓库文件;应根据实际目录权限,为 Web 服务用户提供必要的目录遍历和文件读取权限。
从服务器本机验证 HTTP
在仓库服务器上请求仓库元数据:
curl -I http://127.0.0.1/debian/dists/bookworm/InRelease
预期状态码为 200。如果返回 404,核对实际镜像目录是否与 Nginx alias 路径一致;如果连接失败,检查 Nginx 服务状态及监听端口:
sudo ss -ltnp | grep ':80'
sudo journalctl -u nginx -n 50 --no-pager
本机验证通过后,再从内网客户端访问服务器的实际地址。例如仓库服务器地址为 192.168.10.20:
curl -I http://192.168.10.20/debian/dists/bookworm/InRelease
客户端也应得到 200。如果本机请求正常而客户端不通,优先检查路由、主机防火墙或网络侧访问控制,并确认 80 端口允许客户端所在网段访问。
配置客户端并验证安装
添加本地 APT 源
在 Debian 12 客户端上备份原有配置,再创建独立的源文件。将示例地址替换为仓库服务器的实际内网地址:
sudo cp -a /etc/apt/sources.list /etc/apt/sources.list.bak
sudo tee /etc/apt/sources.list.d/local-mirror.list >/dev/null <<'EOF'
deb http://192.168.10.20/debian bookworm main
EOF
客户端使用的发行代号和组件必须包含在服务器已同步的范围内。若服务器只同步 main,客户端就不能依赖该镜像安装 contrib 或其他组件的软件包。
检查客户端系统信息和源配置:
cat /etc/debian_version
dpkg --print-architecture
cat /etc/apt/sources.list.d/local-mirror.list
更新索引并确认来源
运行:
sudo apt update
成功时,输出中应出现指向 192.168.10.20 的仓库地址,并且没有签名校验或缺少索引文件的错误。可以进一步查看 APT 为目标软件包选择的来源:
apt-cache policy curl
输出会列出软件包版本及其仓库来源。确认候选版本来自本地镜像后,可用一个尚未安装的软件包进行安装验证;如果客户端已安装 curl,可换成其他仓库中存在且尚未安装的软件包:
sudo apt install curl
安装成功可以证明客户端能够从当前配置的源完成索引查询和软件包安装。若软件包已安装且没有需要升级的版本,这一步不一定会发生下载,不能单独作为镜像下载成功的证据;应结合 apt-cache policy、apt update 输出和服务器访问日志判断。
常见异常处理
| 现象 | 优先检查 | 处理方向 |
|---|---|---|
apt-mirror 报网络或名称解析错误 | getent hosts deb.debian.org、服务器到上游的连接 | 修复 DNS、路由或上游访问后重新运行同步 |
缺少 InRelease 或仓库目录为空 | /etc/apt/mirror.list、同步输出、实际目录结构 | 核对发行代号、组件和源地址,再执行 sudo apt-mirror |
| 客户端访问返回 404 | Nginx alias 路径与镜像目录 | 确认文件存在,并检查 URL 是否以 /debian/ 开头 |
| 客户端连接超时或拒绝连接 | Nginx 状态、80 端口监听、网络访问控制 | 先确认服务器本机访问正常,再排查客户端到服务器的网络路径 |
| APT 报签名错误 | 客户端系统时间、InRelease 是否完整、同步是否中断 | 修复时间或完成同步;不要用关闭签名验证的方式绕过错误 |
| APT 提示没有某组件的软件包 | 镜像与客户端源中的组件是否一致 | 在服务器同步配置中加入所需组件,并保持客户端源配置一致 |
如果客户端报签名错误,检查服务器提供的文件与上游仓库是否一致,并查看同步过程是否中途失败。不要使用 trusted=yes 或关闭 APT 签名校验来掩盖问题,这会降低客户端对软件来源的安全校验能力。
后续同步与结果检查
镜像建立后,需要定期更新索引和软件包,否则客户端只能安装仓库当前已同步的内容。首次部署可以手动执行:
sudo apt-mirror
需要自动同步时,可使用系统定时任务或已有调度系统执行同一命令,并确保运行用户对镜像目录有相应权限。配置自动任务前,先手动确认同步过程稳定;避免多个同步任务同时运行,以免产生资源竞争或文件状态不一致。
每次同步后,可核对以下项目:
- 同步命令结束时是否报告错误。
dists/bookworm/InRelease是否存在且可通过 HTTP 读取。- 客户端执行
apt update是否成功,仓库来源是否指向内网服务器。 - 磁盘空间是否仍满足后续同步需要。
回滚检查项
如果首次部署未通过验收,可先移除客户端本地源,恢复其原有仓库配置:
sudo rm -f /etc/apt/sources.list.d/local-mirror.list
sudo cp -a /etc/apt/sources.list.bak /etc/apt/sources.list
sudo apt update
rm 会删除本地源文件,执行前应确认文件名正确;若客户端原本没有 /etc/apt/sources.list,不要用备份命令覆盖现有配置,应按实际情况恢复。
服务器侧回滚时,先禁用新增的 Nginx 站点并检查配置,再重新加载服务:
sudo rm -f /etc/nginx/sites-enabled/debian-mirror
sudo nginx -t
sudo systemctl reload nginx
若要恢复镜像配置,可将 /etc/apt/mirror.list 还原为备份版本,再检查内容:
sudo cp -a /etc/apt/mirror.list.bak /etc/apt/mirror.list
sudo cat /etc/apt/mirror.list
只有确认不再需要镜像数据、且路径确实是本次部署创建的镜像目录后,才考虑删除数据。删除前先检查路径和占用:
sudo du -sh /var/spool/apt-mirror
sudo find /var/spool/apt-mirror -maxdepth 2 -type d
最终验收应至少确认:同步目录内存在目标发行版的 InRelease;Nginx 可通过内网 HTTP 返回该文件;客户端 apt update 成功且来源指向本地镜像;客户端能查询并安装镜像范围内的软件包。回滚验收则确认客户端已恢复原有软件源、服务器新增站点已禁用,并且没有误删既有仓库或其他业务数据。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5598.html



