# 源自美国海军的Zarf，把气隙环境的多次拷贝并成一次

> 镜像、Helm Chart 和配置打成一个文件，过边界前先检查；受监管行业的客户越多，FDE 越常用到它。

原文: https://fdetimes.net/zh/tools/zarf-air-gapped-kubernetes-deployment/

设想这样一个场景：`helm install` 在第一行就失败了，因为节点拉不到镜像。在普通的 Kubernetes 集群上，这只是配置错误。但在银行、工厂或国防单位那些不通互联网的集群上，这是家常便饭，而且每出一次问题，就要再走一轮审批，才能把文件拷进去。

Zarf 无法省掉这轮审批，但能把多次零散的传输合并成一次：只传一个文件，并且在它跨过边界之前就检查好。官方文档的定义是：一款声明式工具，用于把软件打包并交付到断网、受限网络或完全独立运行的环境中。

对前线部署工程师（FDE）来说，这并非小众需求。强监管行业的客户越多，就越常需要把软件交付到一个你永远不会获准接入的集群里。

## 真正的难题是“全部带齐”

据 Mattermost（一家用 Zarf 部署过自家产品的厂商）介绍，这款工具的设计目标是把软件连同所需的全部文件和依赖一起交付到隔离系统中。它最初的用途，是在长时间断网、由 Kubernetes 编排的容器集群上安装应用。

工具的来历解释了它为何如此严格。最早编写 Zarf 的公司 Defense Unicorns 的 Wayne Starr 表示，Zarf 源自美国海军研究生院（Naval Postgraduate School）为美国海军开展的研究。

参与 Zarf 开发的 Brandt Keller 在 OpenSSF 播客中说，Zarf 从一开始就以可靠地打包、搬运和部署软件为目标。所有内容都写在一份声明式清单里，因此包能准确记录应用的状态，每次部署结果都一致。

**要点:** 在物理隔离环境里，没有提前带进去的东西，就等于不存在。

## 一个包里装了什么？

OpenSSF 的文章介绍，Zarf 包把应用的镜像、Helm Chart 和配置打包成单个文件。Create a Package 文档描述了 `zarf package create` 的执行顺序：加载每个组件的内容，收集所有镜像，生成软件物料清单（SBOM）（除非刻意跳过），最后才写出归档文件。

SBOM 听起来像附属功能，实际上很有价值。在强监管客户那里，最耽误时间的往往不是安装命令，而是安装前的安全审查。组件清单和要带进去的文件放在一起，回答“这里面有什么”时，靠的就是文档，而不是记忆。

Keller 建议，所有内容都应在跨入隔离网络之前检查完毕。所以，不要为了让构建快几分钟就跳过 SBOM。

## 走一遍部署流程

假设要给一家银行的本地集群交付一个应用：后端和前端两个镜像、一个 Helm Chart，以及一个 ConfigMap 清单。声明这一步，就是把这四样东西写进 `zarf.yaml` 文件。

文档中的模板以 `kind: ZarfPackageConfig` 开头；下面其余部分只是最简示例，使用前请对照 Create a Package 页面核对字段名：

```yaml
kind: ZarfPackageConfig
metadata:
  name: bank-app
  version: 0.1.0
components:
  - name: app
    required: true
    images:
      - registry.example.com/backend:1.0.0
      - registry.example.com/frontend:1.0.0
    charts:
      - name: app-chart
        localPath: ./chart
        namespace: app
    manifests:
      - name: config
        files:
          - ./configmap.yaml
```

最容易出错的是 `images` 列表：它必须与 Chart 实际用到的所有镜像一一对应。在联网机器上构建后，会得到一个附带 SBOM 的归档文件。

这个文件通过客户允许的渠道送到断网一侧。按照 Getting Started 指南，在全新集群上要先运行 `zarf init`，再部署包。整套命令很短（文件名仅为示例）：

```bash
# 联网一侧：根据 zarf.yaml 构建包
zarf package create .

# 断网一侧，在全新集群上首次安装
zarf init
zarf package deploy <your-package-file>
```

部署命令也支持从 OCI 镜像仓库获取包。Getting Started 中的示例从 ghcr.io 安装 dos-games 示例包，并通过 `--key` 参数指定公钥来验证包签名，体现了“先验证、再信任”的原则。

最大的好处是可重复。下次升级时，只需修改 `zarf.yaml`，按同样的流程重新构建、部署，而不必逐步手工重做。

## 向客户承诺之前，要知道哪些限制？

最大的风险恰恰来自“全部带齐”这个模式本身。部署时无法再拉取任何东西，所以漏掉一个镜像或一个子 Chart，就得从头重新构建、重新传输文件，并再走一遍客户的完整审批流程。

其次是适用范围。Zarf 面向 Kubernetes 集群和云原生工作负载，只有当客户已经有、或即将搭建这样的集群时，它才能发挥作用。根据 FAQ，Zarf 也能在联网环境中运行，因此测试环境和封闭环境可以使用同一个包。

Zarf 本身是用 Go 和 Rust 构建的静态编译二进制文件，没有外部依赖。把工具带进封闭环境，和带包进去一样简单。

## 文件离开联网一侧之前，检查这三个错误

最常见的错误是漏了镜像：Chart 额外拉取了某个 sidecar 或辅助镜像，而 `zarf.yaml` 里没有列出。检查方法是把包部署到一个禁止出站访问互联网的 kind 集群上，看是否有 Pod 因拉不到镜像而卡住。

第二个是顺序搞错：在没有运行过 `zarf init` 的集群上部署应用包。把这一步写进交给客户的运维手册，因为客户的运维人员未必知道。

第三个是为了省时间跳过 SBOM 或签名。想想安全审查：构建时省下的几分钟，可能要用几天的审批等待来偿还，只因为没人说得清包里有什么。

## 先学什么，面试时怎么讲

Zarf 免费，采用 Apache-2.0 许可证，但它只是最上面一层。上手之前，需要扎实掌握 Helm、镜像如何拉取到节点，以及 OCI 镜像仓库，因为 Zarf 打包的正是这些东西。

阅读 FDE 岗位描述时，留意 “air-gapped”、“on-prem”、“disconnected” 等字样，或者国防、金融类客户。简历上不要只写“熟悉 Zarf”，而要写清楚：打包过一个真实应用，部署到了无网络的集群，并把 SBOM 交给安全团队审查。

面试时按顺序讲：如何梳理依赖，如何在隔离集群上测试包，给安全团队提供了哪些文档。面试官想听到的是你预见到了哪些故障点，而不只是你知道这个工具的名字。

在物理隔离的客户现场，出了错很少能在当天有第二次机会修正。文件离开联网一侧之前检查得足够彻底，才能兑现对客户的承诺。

**本周动手试试:**

- 启动一个 kind 集群，运行 zarf init，然后按照 Getting Started 指南从 OCI 镜像仓库安装 dos-games 示例包
- 挑一个内部应用，列出它需要的全部镜像、Chart 和清单，参照 Create a Package 文档中的模板写一份 zarf.yaml，然后运行 zarf package create
- 打开刚生成的 SBOM，试着回答：如果客户的安全团队问这个包里有什么，你会让他们看哪里？

## 信源

- [What is Zarf? | Zarf documentation](https://docs.zarf.dev/)

- [GitHub - zarf-dev/zarf: The Airgap Native Package Manager for Kubernetes](https://github.com/zarf-dev/zarf)

- [FAQ | Zarf](https://docs.zarf.dev/faq/)

- [Getting Started | Zarf](https://docs.zarf.dev/getting-started/)

- [Create a Package | Zarf](https://docs.zarf.dev/ref/create/)

- [Tech Talk Recap: Simplifying DevSecOps in Air-Gapped Environments with Zarf](https://openssf.org/blog/2025/11/18/tech-talk-recap-simplifying-devsecops-in-air-gapped-environments-with-zarf/)

- [What’s in the SOSS? Podcast #60 – S3E12 Packaging, Transferring, and Deploying Software in Air-Gapped Environments with Zarf](https://openssf.org/podcast/2026/05/05/whats-in-the-soss-podcast-60-s3e12-packaging-transferring-and-deploying-software-in-air-gapped-environments-with-zarf/)

- [The Kubelist Podcast | Ep. #42, Zarf with Wayne Starr of Defense Unicorns | Heavybit](https://www.heavybit.com/library/podcasts/the-kubelist-podcast/ep-42-zarf-with-wayne-starr-of-defense-unicorns)

- [Deploying Mattermost with Zarf for highly secure air-gapped collaboration](https://mattermost.com/blog/mattermost-and-zarf-secure-air-gapped-collaboration/)
