druidfi/stonehenge

Stonehenge

!https://github.com/druidfi/stonehenge/raw/4.x/logos/stonehenge_logo_wide.svg

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

!https://github.com/druidfi/stonehenge/workflows/Tests/badge.svg

功能概述

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处理所有容器流量
• https://github.com/FiloSottile/mkcert%EF%BC%9A%E7%94%9F%E6%88%90%E9%80%9A%E9%85%8D%E7%AC%A6SSL%E8%AF%81%E4%B9%A6
• https://github.com/mailhog/MailHog%EF%BC%9A%E9%80%9A%E8%BF%87mailhog.docker.so%E6%8D%95%E8%8E%B7%E9%82%AE%E4%BB%B6

安装配置

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

Windows用户如未安装WSL2，请先查看https://github.com/druidfi/stonehenge/blob/4.x/WSL2.md%E3%80%82

一键安装

bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/druidfi/stonehenge/4.x/install.sh)"

Git手动安装

bash
git clone -b 4.x https://github.com/druidfi/stonehenge.git ~/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

示例项目

• https://github.com/druidfi/stonehenge/tree/4.x/examples/drupal
• https://github.com/druidfi/stonehenge/tree/4.x/examples/ghost
• https://github.com/druidfi/stonehenge/tree/4.x/examples/hugo
• https://github.com/druidfi/stonehenge/tree/4.x/examples/laravel
• https://github.com/druidfi/stonehenge/tree/4.x/examples/symfony
• https://github.com/druidfi/stonehenge/tree/4.x/examples/wordpress

支持的操作系统

• macOS Monterey 12（Intel和M1）
• macOS Big Sur 11（Intel和M1）
• Ubuntu 20.04 LTS
• https://github.com/druidfi/stonehenge/blob/4.x/WSL2.md%EF%BC%88Debian%E6%88%96Ubuntu 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并创建别名

参考资料

• https://github.com/mailhog/MailHog
• https://github.com/FiloSottile/mkcert
• [***]

许可证

本仓库文件基于MIT许可证发布。详见https://github.com/druidfi/stonehenge/raw/4.x/LICENSE%E3%80%82