Repolode
ChristianLempa

ChristianLempa/boilerplates

一个命令行工具,用于创建可复用的基础设施模板,并渲染成适合家庭实验室和自托管环境的配置。

Star
8,000
Fork
1,820
未关闭 Issue
11
最近提交
2个月前

这是什么?

Boilerplates 是面向家庭实验室和自托管基础设施的模板工具。你可以为 Docker Compose、Kubernetes、Terraform、Ansible、Python、Bash 以及静态文件等技术编写可复用模板,再通过默认值、交互式向导或命令行参数填入变量,生成具体的环境配置。

模板采用类 Jinja2 语法,但使用自定义分隔符:<< >> 表示变量,<% %> 表示代码块,<# #> 表示注释。模板存放在基于 Git 的模板库中,可以与远程仓库双向同步,也可以纯本地管理,还能添加自己的模板仓库。

命令行工具支持列出和查看模板、校验模板、保存常用默认变量,并将生成结果输出到任意目录。0.2.0 版本起,新模板必须使用 template.json 清单,并将可渲染内容放在 files/ 目录下。

核心功能

  • 01为 Docker Compose、Kubernetes、Terraform、Ansible、Python、Bash 和静态文件提供可复用模板
  • 02采用类 Jinja2 语法,使用 << >> 作为变量分隔符,支持条件代码块
  • 03支持交互式向导、命令行变量覆盖和保存默认值
  • 04基于 Git 的模板库,可双向同步或完全本地管理
  • 05提供列出、查看、校验和生成模板的命令

适用场景

  • 为家庭实验室生成 Docker Compose 服务栈,并按环境设置主机名和时区
  • 维护一套 Terraform 或 Ansible 模板,为多台服务器分别渲染配置
  • 通过 Git 仓库与团队共享私有模板库

快速上手

  1. 1

    运行 README 中的官方安装脚本(使用 pipx)

  2. 2

    更新模板库

    boilerplates repo update
  3. 3

    列出可用的 Docker Compose 模板

    boilerplates compose list
  4. 4

    以交互方式生成模板

    boilerplates compose generate authentik

使用前须知

  • 使用自定义模板分隔符(<< >>、<% %>、<# #>),而非标准 Jinja2 语法。
  • 自 0.2.0 版本起不再支持旧版 template.yaml 和 .j2 模板。
  • 目前 python 和 bash 模板的验证功能较为简单。

收录于专题

标签

常见问题

boilerplates 是什么?
一个命令行工具,用于创建可复用的基础设施模板,并渲染成适合家庭实验室和自托管环境的配置。 Boilerplates 是面向家庭实验室和自托管基础设施的模板工具。你可以为 Docker Compose、Kubernetes、Terraform、Ansible、Python、Bash 以及静态文件等技术编写可复用模板,再通过默认值、交互式向导或命令行参数填入变量,生成具体的环境配置。
boilerplates 可以免费使用吗?用的什么许可证?
boilerplates 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
boilerplates 还在维护吗?
半年内有更新。boilerplates 最近一次提交是在 2026年8月31日。
boilerplates 适合用来做什么?
为家庭实验室生成 Docker Compose 服务栈,并按环境设置主机名和时区 维护一套 Terraform 或 Ansible 模板,为多台服务器分别渲染配置 通过 Git 仓库与团队共享私有模板库
boilerplates 怎么安装和运行?
运行 README 中的官方安装脚本(使用 pipx) 更新模板库: boilerplates repo update 列出可用的 Docker Compose 模板: boilerplates compose list 以交互方式生成模板: boilerplates compose generate authentik
在哪里获取 boilerplates?
源代码和安装说明在 GitHub 上:https://github.com/ChristianLempa/boilerplates

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目