做出离线引入包
目标
把一个软件包及其全部依赖打成“导入包”,用校验和清单验证后,只凭这个导入包重现安装。这是隔离网络导入流程的缩小版。最后,当别人制作的导入包在内部安装失败时,区分哪些在内部修复、哪些留到下次导入。
为什么重要
隔离网络中最常见的失败是“已经下载带进去,却因缺少依赖项而不得不再次出来”。在每天只进行一次导入审核的组织里,一个来回就意味着一天。因此,熟练的工程师会把在外部完整解析依赖关系图所得的结果带进去。同时,还需要一种方法确认通过介质传输的文件是否完好——校验和能够发现传输损坏,签名则能保证来源。本实验将帮助你掌握这套流程的骨架。
最后一步的故障事件,就是这个流程某一处被漏掉时的样子。导入包有文件、清单、索引三层,所以同样是“装不上”的症状,根据错在哪一层,可能是“在内部重新生成索引就行的事”,也可能是“要等一周到下次导入的事”。判断错了,往返就会多一次。
步骤
- 创建
/root/offline目录,并将安装cowsay时需要下载的文件 URI 列表保存为/root/offline/uris.txt。(不得实际安装。) - 只下载
cowsay及其依赖项,并将下载的.deb文件集中到/root/offline/pool/。必须至少有 2 个。 - 为
/root/offline/pool中的所有.deb创建 SHA-256 清单/root/offline/manifest.sha256。 - 使用该清单执行验证,并将结果保存为
/root/offline/verify.txt。所有行都必须正常(OK)。 - 要将
/root/offline/pool建成软件源,请生成Packages和Packages.gz。 - 通过
/etc/apt/sources.list.d/labhub-airgap.list注册该软件源并更新索引。 - 重新安装
cowsay,确认也能使用导入的软件包完成安装;安装后,将cowsay labhub的执行结果保存为/root/offline/run.txt。 - 故障事件——运行
incident pk-bundle-broken并阅读工单。导入包中的四个软件包有三个装不上。能在内部修复的修好并安装,并在/root/incident/pk-bundle-broken/report.txt中为每个软件包写下原因代码(corrupt-file·missing-dep·stale-index·unsigned·wrong-arch)、下次导入要带来的东西(refetch:),以及一行evidence:。
参考
- 下载的文件通常堆积在
/var/cache/apt/archives/中。事先清空缓存,就只会留下这次下载的东西,便于区分。 - 常见错误 1:第 3 步用绝对路径生成清单,第 4 步在别的目录中校验就会失败。进入解包目录、用相对路径生成更安全。
- 常见错误 2:如果在第 1 步中实际执行了安装,第 2 步会提示“已经是最新版本”,因而什么也不下载。
- 常见错误 3:第 6 步中索引更新因
Permission denied而失败。apt 只在下载文件时把权限降为名为_apt的非特权用户,而/root是 700,那个用户无法穿过。只要给其他用户开放一格“进入”(x)即可——查看列表(r)依然是关闭的。 - 常见错误 4:在故障事件中保留损坏的文件就重新生成索引。索引工具只读取文件开头(控制信息)就会写出条目,所以损坏的文件会摇身一变成为“可安装”。
- 事件工具:用
incident list查看列表,用incident show <이름>重新查看工单(同事的报告)。再次触发同一事件会回到最初的故障状态。 - 报告写在
/root/incident/<이름>/report.txt中——每个对象一行<이름>: <원인 코드>(名称:原因代码),再加一行evidence: <관찰한 출력 한 줄>(观察到的一行输出)。证据行会与事件中实际出现的输出比对。 - 评分不只看报告。dpkg 状态数据库、apt 的候选、签名验证等实际状态必须正确,只抹掉症状的绕行办法(强制安装、删除、关闭签名)判为失败。
先计算需要下载的内容
创建 /root/offline 目录,并将安装 cowsay 时需要下载的文件 URI 列表保存为 /root/offline/uris.txt。(不得实际安装。)
apt-get install 有一个选项,可以只输出要下载的 URI 列表,而不实际下载。请查找模拟类选项。
下载软件包
只下载 cowsay 及其依赖项,并将下载的 .deb 文件集中到 /root/offline/pool/。必须至少有 2 个。
有一个选项可以只下载而不进行安装。下载的文件会累积在 apt 缓存目录中。
创建校验和清单
为 /root/offline/pool 中的所有 .deb 创建 SHA-256 清单 /root/offline/manifest.sha256。
对多个文件一次运行 sha256sum,会生成“哈希 空格 文件名”的格式。这个格式以后可以直接用于验证。
使用清单验证
使用该清单执行验证,并将结果保存为 /root/offline/verify.txt。所有行都必须正常(OK)。
sha256sum 有一个选项,可以读取清单而不是文件来进行检查。必须在清单所在的目录中执行验证,路径才能匹配。
用导入的软件包创建软件源索引
要将 /root/offline/pool 建成软件源,请生成 Packages 和 Packages.gz。
方法与上一个实验相同。不过这次有多个文件,请检查索引中的 Package 条目数。
注册导入的软件源
通过 /etc/apt/sources.list.d/labhub-airgap.list 注册该软件源并更新索引。
请使用与上一个实验不同的软件源名称。两个软件源同时有效也没有问题。
从导入的软件源重新安装
重新安装 cowsay,确认也能使用导入的软件包完成安装;安装后,将 cowsay labhub 的执行结果保存为 /root/offline/run.txt。
要以相同版本重新安装已经安装的软件包,需要使用重新安装选项。
故障事件——用导入包安装,四个中有三个装不上
运行 incident pk-bundle-broken 后,你会面对一台把带进隔离网络的导入包(/srv/airgap/bundle-2026-11)接为 apt 仓库的服务器(请先阅读工单)。症状:ttdata、ttfmt、ttplot、ttcli 四个中只有 ttdata 装上了。能在内部修复的修好并安装,需要从外部重新带来的,留在下次导入清单中。导入包中只能留下与已批准清单的哈希相符的文件,索引也必须与这些文件完全一致。修改清单或无视依赖强行塞入,都判为失败。在 /root/incident/pk-bundle-broken/report.txt 中写下三行 <패키지>: <코드>(软件包:代码,即 ttfmt、ttplot、ttcli)、refetch: <다음 반입에 가져올 패키지 이름들>(下次导入要带来的软件包名称)以及 evidence: <관찰한 출력 한 줄>(观察到的一行输出)。代码是 corrupt-file(经过介质时文件损坏)· missing-dep(依赖软件包不在导入包中)· stale-index(索引比导入包内容陈旧)· unsigned(因没有签名而被拒绝)· wrong-arch(架构不同)之一。
方向:导入包有“文件 + 清单 + 索引”三层。为每个软件包分辨错在哪一层,能在内部修复的和需要从外部重新带来的自然就分开了。 工具:导入记录(/var/log/airgap-install.log)、sha256sum 的清单校验、导入包中的 Packages、dpkg-deb -f(控制字段)、dpkg-scanpackages。 具体:查看清单校验中失败的行、索引的 Package 列表与 pool 中 .deb 列表的差异,以及 ttplot 的 Depends 所指的名称是否在导入包中。重新生成索引时,如果损坏的文件还留在 pool 中,它也会被写进索引。