Stonehenge

!Stonehenge logo

基于Docker的本地开发环境工具集，支持多项目开发。

!测试

功能概述

Stonehenge旨在解决Web开发者的基本问题：如何尽可能轻松地在本地环境中进行开发。它提供了一个支持多项目的共享开发环境，可自动处理项目的路由、本地域名以及SSL证书配置。

系统要求

Stonehenge环境要求

• 最新版macOS、Ubuntu LTS或Windows 10/11（需WSL2）- 查看详情
• Make工具
• Docker 20+
• Docker Compose
• 端口80和443未被其他服务占用

项目要求

• 包含docker-compose.yml文件 - 参见示例了解如何使用Stonehenge

核心组件

• Traefik：通过traefik.docker.so处理所有容器流量
• mkcert：生成通配符SSL证书
• MailHog：通过mailhog.docker.so捕获邮件

安装配置

注意：在某些系统中，安装过程会提示输入密码以设置DNS。

Windows用户如未安装WSL2，请先查看通用安装说明。

一键安装

bash
sh -c "$(curl -fsSL [***]"

Git手动安装

bash
git clone -b 4.x [***] ~/stonehenge
cd ~/stonehenge
make up

使用自定义域名

可使用自定义域名替代默认的docker.so：

bash
make up DOCKER_DOMAIN=docker.druid.fi

或修改.env文件中的DOCKER_DOMAIN值。

停止与关闭

注意：默认情况下，若未提前停止，Stonehenge将在系统启动时自动启动。

停止Stonehenge：

bash
make stop

完全停止并移除Stonehenge：

bash
make down

添加别名

将以下行添加到shell配置文件（bash、zsh、fish）：

bash
alias stonehenge='make -C ~/stonehenge'

添加后可在任意位置使用别名执行命令：

bash
stonehenge up

SSH密钥配置

默认情况下，Stonehenge会尝试添加~/.ssh/id_ed25519和~/.ssh/id_rsa密钥。

添加额外SSH密钥：

bash
make addkey KEY=/path/to/mykey

示例项目

• Drupal 9
• Ghost 4
• Hugo
• Laravel 9
• Symfony 6
• Wordpress

支持的操作系统

• macOS Monterey 12（Intel和M1）
• macOS Big Sur 11（Intel和M1）
• Ubuntu 20.04 LTS
• Windows 10/11 + WSL2（Debian或Ubuntu LTS）

曾测试通过的系统：

• Arch Linux

定制与修改

如需为组织定制工具集：

1. Fork此仓库
2. 修改.env文件，例如：
   • COMPOSE_PROJECT_NAME=company
   • DOCKER_DOMAIN=docker.company.com
   • PREFIX=company
3. 将docker.company.com和*.docker.company.com指向127.0.0.1
4. 重要！请告知我们！<3

调试

使用以下命令查看检测到的数据：

bash
make debug

待办事项

• 支持Debian和RHEL系统
• 提供更多示例
• 自动检测Shell并创建别名

参考资料

• [***]
• [***]
• [***]

许可证

本仓库文件基于MIT许可证发布。详见LICENSE。