文档仓库、分支、目录、站点地址和图片都可以在 Cloudflare 控制台中设置。日常调整这些参数，无需安装开发工具，也不用编辑代码或 JSON 文件。
操作顺序：打开构建设置 → 添加或修改变量 → 保存 → 重新构建。
新建部署时，Cloudflare 表单只显示 DOCS_REPO、DOCS_BRANCH、DOCS_PATH 三个文档源字段，并预填示例值。下文四个可选项不会出现在初次部署表单中。没有站点 JSON、正式域名或自定义图片也能部署，之后有需要时再添加。
1. 找到构建变量入口
- 登录 Cloudflare，进入 Workers 和 Pages。
- 点击你部署的 Worker。
- 打开 设置（Settings），向下找到 构建（Builds）。
- 在构建区域找到 变量和机密（Build variables and secrets），点击该区域的 添加。
请使用“构建”下面的变量入口。页面上方的“运行时变量和机密”是运行时设置。本模板是静态网站，该区域可能提示“不能将变量添加到只有静态资产的 Worker”，但不影响下方的构建变量。
如果显示“未配置构建变量或密钥”，说明网站正在使用模板自带的默认值，不代表部署失败。直接点击“添加”即可；常用参数添加后，就能在列表中修改。
2. 填写基础参数
点击“添加”后，会出现 类型、名称、值 三个输入项：
- 类型：以下公开参数都选 变量（Variable）。
- 名称：从下表复制英文名称，大小写保持一致。
- 值：填写自己的内容，不加引号。名称和值分开填，不要把
DOCS_BRANCH=main整行填到一个输入框。
每填完一项，点击“添加”继续填写下一项。只添加要修改的文档源参数；未覆盖的项继续使用默认值。
| 想修改什么 | 名称 | 值怎么填 |
|---|---|---|
| 文档放在哪个 GitHub 仓库 | DOCS_REPO |
仓库的 HTTPS 地址，例如 https://github.com/example-user/project-docs.git；将示例换成自己的仓库 |
| 使用哪个分支 | DOCS_BRANCH |
例如 main；填写文档所在的实际分支 |
| 使用哪个文件夹 | DOCS_PATH |
例如 docs；文档就在仓库最外层时填一个英文句点 . |
example-user/project-docs 只是格式示例，填写时请换成自己的仓库。在 GitHub 打开文档仓库，点击 Code → HTTPS 复制地址，分支名可以在文件列表上方查看。默认文档源为 https://github.com/Azincc/nimbus-docs-template.git，复制模板不会自动将它改成你的仓库。
文档目录相对于文档仓库根目录，前面不加仓库地址。例如 DOCS_PATH=manual 时，模板自动读取 manual/site.json；没有该文件时使用通用站点配置，无需添加空变量。
模板默认的 DOCS_PATH=docs 读取英文示例。切换到本仓库的完整中文示例时，保留默认文档仓库和分支，只将 DOCS_PATH 改为 docs-zh-CN，模板会自动读取 docs-zh-CN/site.json。如果旧部署已有显式 DOCS_CONFIG_PATH，先删除它或更新它的路径，再保存并重新构建。
以下两项有需要时再添加：
| 想修改什么 | 名称 | 值怎么填 |
|---|---|---|
| 配置文件放在文档目录以外 | DOCS_CONFIG_PATH |
相对文档源仓库根目录的实际路径，例如 config/site.json；明确指定的文件必须存在且 JSON 有效 |
| 网站的访问地址 | SITE_URL |
例如 https://你的Worker.你的子域.workers.dev，或已绑定的自定义域名；包含 https://，不附带页面路径 |
SITE_URL 默认未设置。暂时不确定地址时不用添加，网站仍可浏览，只省略依赖正式地址的 canonical、SEO 信息和站点地图。地址确定后添加并重新构建。使用自定义域名前，需要先在 Worker 的“域”页面完成配置；仅填写地址不会自动绑定域名。
3. 按需设置 Logo 和浏览器图标
以下两个普通变量均可选，默认未设置。模板沿用站点配置中的对应图片；未配置时使用内置的 Nimbus 官方 Logo。需要自定义图片时再添加。
| 想修改什么 | 名称 | 值怎么填 |
|---|---|---|
| 网站 Logo | SITE_LOGO |
图片的 HTTP(S) 地址或文档仓库内的图片路径，例如 docs/assets/logo.svg |
| 浏览器标签页的小图标 | SITE_FAVICON |
图片的 HTTP(S) 地址或文档仓库内的图片路径，例如 docs/assets/favicon.png |
图片地址必须指向图片本身，不能使用 GitHub 的文件预览页面地址。图片放在文档仓库时，填写相对于仓库根目录的文件路径即可。
这两项独立生效，修改 Logo 不会同时改变浏览器图标。填图片 URL 或仓库路径会覆盖站点配置，删除变量即可恢复上述回退规则。原有 default 和空白值继续兼容相同规则。
旧部署需先更新模板才能获得新默认行为。仅修改构建变量不会更新模板代码。
4. 私有仓库再添加机密
公开仓库无需添加机密。使用私有文档仓库时，单独添加以下机密：
| 类型 | 名称 | 值 |
|---|---|---|
| 机密（Secret） | DOCS_TOKEN |
仅授权目标仓库、具有 Contents 只读权限的 GitHub Token |
Token 的创建方法见私有仓库部署。直接把 Token 填到 Cloudflare 的机密输入框，不要填进仓库地址、普通变量、文档或代码文件。
5. 保存并重新构建
- 检查刚填写的名称和值，点击页面底部的 保存（Save）。
- 等待保存请求完成。若仍提示“未保存的更改”，先检查有无错误提示。没有错误时，刷新设置页；刚填写的变量和值仍在，就表示保存成功。
- 打开 部署（Deployments），进入构建记录，选择 重试构建（Retry build）。
- 等待构建和部署成功，再打开网站查看结果。
变量保存后，需要重新构建才会改变已发布的静态页面。只修改这些参数时，无需重新复制模板、再次点击部署按钮，也不用修改构建命令、部署命令或根目录。
如果构建失败，查看日志中的错误并修正对应输入，再重试。明确指定的配置文件不存在时，修正 DOCS_CONFIG_PATH，或删除该变量以恢复自动查找。自动发现的 JSON 如果格式不正确，仍需修复文件内容。
以后如何修改或恢复默认值
再次打开 设置 → 构建 → 变量和机密，修改列表中对应的值，保存后重新构建即可。
已保存的构建变量优先于模板文件中的默认值。以后模板更新默认值时，也会继续使用你保存的配置。更新旧模板后，删除旧的 DOCS_CONFIG_PATH 才能让配置文件自动跟随 DOCS_PATH；其他不再需要的可选值，例如指向示例域名的 SITE_URL，也需删除才能恢复新的默认行为。
要恢复模板默认值，删除对应构建变量，保存后重新构建。各项删除后的行为如下：
| 操作 | 生效结果 |
|---|---|
删除 DOCS_CONFIG_PATH |
自动读取 DOCS_PATH/site.json，不存在时使用通用站点配置 |
删除 SITE_URL |
不指定正式站点地址 |
删除 SITE_LOGO 或 SITE_FAVICON |
沿用站点配置中的对应图片；未配置时使用内置 Nimbus 官方 Logo |
| 删除文档源变量 | 重新读取该项的模板默认值 |
为兼容已有配置，显式空白的 DOCS_CONFIG_PATH 仍会禁用 JSON，空白的 SITE_URL 仍表示不指定正式地址，图片变量的 default 或空白值仍沿用 JSON 或内置图片。使用新默认行为时，无需在 Cloudflare 创建空字段。如果模板副本在 wrangler.jsonc 中仍保留自定义可选默认值，删除构建变量后会恢复那些值。
常见问题
| 遇到的情况 | 处理方法 |
|---|---|
| 找不到添加按钮 | 向下找到“构建”区域中的“变量和机密”，不要停留在页面上方的运行时变量区域 |
| 保存后还是提示未保存 | 等待保存请求完成并检查错误提示；无错误时刷新页面，核对变量和值是否仍在，提示可能未及时更新 |
| 仍然显示模板示例文档 | 将 DOCS_REPO 改为自己的文档仓库，保存并重新构建 |
| 找不到站点配置文件 | 修正显式路径，或删除 DOCS_CONFIG_PATH 恢复自动查找；文件存在但 JSON 无效时，修复文件内容 |
| 私有仓库无法拉取 | 确认 DOCS_TOKEN 类型为机密，且 Token 有目标仓库的读取权限 |
| Logo 或图标没变化 | 检查图片地址、保存状态和构建结果；旧部署先按上文更新模板 |
| 文档仓库更新后网站没变化 | 为独立文档源设置构建挂钩，让文档推送自动触发构建 |
站点名称、导航、主题和侧栏顺序的设置方法见站点配置与侧栏顺序。构建变量只支持本文列出的参数，并非所有站点设置都能通过控制台表单修改。
供模板维护者参考
根目录 wrangler.jsonc 的 vars 只保留三个公开文档源默认值，Cloudflare 根据这些声明生成首次部署字段。可选项由构建脚本处理默认行为；把它们重新加入 vars 会使初次表单再次出现这些字段。构建环境中的同名变量优先，DOCS_TOKEN 只从构建环境读取。
首次部署表单和部署后的构建变量列表是两个入口。部署后的列表为空时，按需添加要修改的项即可，不代表模板默认值缺失。可选项无需提前添加占位值。
维护者也可以修改并提交仓库中的默认值，但已保存的同名构建变量仍然优先。修改后，需要构建包含这些改动的新模板提交；重试旧提交不会读到新改动。
官方参考：Workers Builds 配置。