使用khuedoan/homelab项目搭建开发沙盒环境指南

前言

在部署生产环境前，开发人员通常需要一个安全的测试环境来验证配置变更。khuedoan/homelab项目提供了一个完整的开发沙盒解决方案，让您可以在本地快速搭建一个功能齐全的测试环境，而无需准备任何物理硬件。

环境准备

硬件要求

建议使用以下配置的主机：

• CPU：4核及以上
• 内存：16GB及以上
• 可用端口：80和443

软件依赖

需要安装以下软件包：

1. Docker：用于容器化部署
2. Nix：提供开发环境所需的工具链（具体安装方法可参考项目文档中的开发环境说明）

项目初始化

1. 获取项目代码：

git clone 项目仓库地址
cd homelab
git checkout dev

构建开发集群

1. 进入开发环境：

nix develop

2. 构建并启动开发集群：

make

注意：根据网络状况不同，此过程可能需要15-30分钟完成

访问沙盒环境

构建完成后，您可以通过以下地址访问首页：

https://home.127-0-0-1.nip.io

注意：由于是开发环境，浏览器会显示安全警告，这是正常现象

默认管理员凭证请参考项目文档中的"管理员凭证"部分。

开发工作流

在沙盒环境中进行开发变更的流程：

1. 添加远程仓库：

git remote add sandbox https://git.127-0-0-1.nip.io/ops/homelab
git config http.https://git.127-0-0-1.nip.io.sslVerify false

2. 提交并推送变更：

git add 修改文件
git commit -m "提交说明"
git push sandbox

提示：可以使用gitea_admin账户进行推送

环境清理

当不再需要沙盒环境时，可以执行以下命令彻底删除集群：

k3d cluster delete homelab-dev

开发环境与生产环境的差异

开发沙盒环境相比生产环境有以下限制：

1. 没有有效域名，因此缺少有效的SSL证书（部分服务依赖有效证书）
2. 只能在宿主机访问
3. 没有备份机制

请注意，开发集群可能存在不稳定性，这是正常现象，因为它的定位就是用于开发和测试。

最佳实践建议

1. 在进行重要变更前，建议先在沙盒环境中测试
2. 定期清理并重建沙盒环境，确保环境干净
3. 重要数据不要长期存储在沙盒环境中
4. 测试完成后及时清理资源

通过这个沙盒环境，开发人员可以安全地实验各种配置变更，而不会影响生产环境的稳定性。