> For the complete documentation index, see [llms.txt](https://stablebuild.gitbook.io/stablebuild-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stablebuild.gitbook.io/stablebuild-docs/docs/cn/readme.md).

# StableBuild 文档

我们帮助开发者创建可靠且可重复（deterministic）的构建流程。通过 StableBuild，你可以轻松地冻结（freeze）并固定（pin）Docker镜像，操作系统软件包， Python软件包和任意构建依赖。你只需要不到 5 行代码就可以把 StableBuild 集成到现有的构建流程中，从此再也不用担心因为依赖包更新而随机破坏构建（build break）的问题。

**快速开始**

* 如果你不确定为什么需要固定所有依赖（pin all dependencies），可以先阅读 StableBuild 的介绍：[为什么需要 StableBuild？](/stablebuild-docs/docs/cn/why-stablebuild.md).
* 然后跟着教程操作: [使用 StableBuild 固定你的第一个容器](/stablebuild-docs/docs/cn/pinning-your-first-container.md).

**镜像与缓存（Mirrors and Caches）**

* [OS 软件包注册表（Ubuntu、Debian、Alpine）](/stablebuild-docs/docs/cn/jing-xiang-yu-huan-cun/os-package-registry-ubuntu-debian-alpine.md) - 将所有 Ubuntu、Debian 和 Alpine 的软件包固定到某一个具体日期。
* [Docker 镜像（Docker mirror）](/stablebuild-docs/docs/cn/jing-xiang-yu-huan-cun/docker-mirror.md) - 缓存容器镜像，使任意容器不可变（immutable），并且在拉取镜像时不会受到速率限制（rate limits）。
* [PyPI 镜像（PyPI mirror）](/stablebuild-docs/docs/cn/jing-xiang-yu-huan-cun/pypi-mirror.md) - 使用 pip、Poetry 或 uv 将 Python 软件包固定到某个特定日期。
* [HuggingFace 镜像（HuggingFace mirror）](/stablebuild-docs/docs/cn/jing-xiang-yu-huan-cun/huggingface-mirror.md) - 缓存 HuggingFace 模型，并使任意模型不可变。
* [文件镜像（File mirror）](/stablebuild-docs/docs/cn/jing-xiang-yu-huan-cun/file-mirror.md) - 让 URL 变成不可变资源，并存储任意构建依赖文件。

**产品文档**

* [单点登录（SAML）](/stablebuild-docs/docs/cn/chan-pin-wen-dang/single-sign-on-saml.md) - 包含 Google Workspace 和 Okta 的配置教程。
* [软件物料清单（SBOM）](/stablebuild-docs/docs/cn/chan-pin-wen-dang/sbom.md) - 为构建通过 StableBuild 获取的所有内容生成 CycloneDX SBOM。
* [计费（Billing）](/stablebuild-docs/docs/cn/chan-pin-wen-dang/billing.md) - 详细说明我们如何根据\*\*流量（traffic）和存储（storage）\*\*收费。

**教程**

* [如何在公开 Docker 容器中保护你的密钥](/stablebuild-docs/docs/cn/jiao-cheng/protecting-your-keys-in-public-docker-containers.md) - 如果你计划把通过 StableBuild 构建的容器发布到 Docker Hub 或其他公共镜像仓库，这是必须阅读的内容。

如果你有技术支持或计费相关问题，请联系 <support@stablebuild.com>。