Laradock 服务总览:70+ 预配置 Docker 容器按需启停、开箱即用的 PHP 开发环境
Laradock 服务总览:70+ 预配置 Docker 容器按需启停、开箱即用的 PHP 开发环境
本篇技术指南以 Laradock 官方文档的 Supported Services 索引页为核心骨架,系统讲解 Laradock 内置的 70+ 个预配置服务容器(数据库、缓存与队列、搜索引擎、Web 服务器、邮件、AI/ML、监控等)的编排架构、按需启停方式、统一网络与配置机制,并结合当前仓库的 docker-compose.yml、各服务 compose.yml、defaults.env、.env.example 以及 laradock CLI 脚本源码,给出可复现的实操命令与可验证的底层实现依据。读完本文,你将掌握如何只启动自己需要的服务、如何在多个项目间复用/隔离不同技术栈,以及如何通过单个 .env 文件统一管理全部服务的凭据与端口。
一、Laradock 服务模型:预配置容器,而非本机安装
Laradock 将开发环境所需的全部基础设施打包为预配置的 Docker 容器:数据库、缓存与队列、搜索引擎、Web 服务器、邮件捕捉器、AI/ML 技术栈、监控以及开发者工具,全部以容器形式存在。你不需要在宿主机上安装任何一项,它们运行在 Docker 中,彼此隔离、随用随弃(disposable)。
这些服务不是"装好就常驻"的:只有当你点名启动时,对应的容器才会被拉起。这意味着宿主机保持干净,而两个不同的项目可以各自使用完全不同的技术栈而不产生冲突——这是 Laradock 服务模型与"本机一键安装全套环境"方案的本质区别。
从仓库结构看,服务的落地方式是每个服务一个独立目录,目录内包含自己的 compose.yml、Dockerfile(如有自定义镜像需求)与 defaults.env,例如:
| 服务 | 目录 | 关键文件 |
|---|---|---|
| MySQL | mysql/ | compose.yml、defaults.env、Dockerfile |
| Redis | redis/ | compose.yml、defaults.env、redis.conf |
| Nginx | nginx/ | compose.yml、sites/ 下的站点配置示例 |
| PHP-FPM | php-fpm/ | compose.yml、多个 phpX.Y.ini 版本配置 |
| Workspace | workspace/ | compose.yml、Dockerfile |
二、按需启停:只启动你需要的服务
Laradock 的核心使用哲学是"Enable only what you need"(只启用你需要的)。官方文档给出的启动命令非常直观,在项目名列表中点名要启动的服务即可:
./laradock start nginx mysql redis
这条命令只会启动 nginx、mysql、redis 三个容器(加上始终随附的 workspace),其余服务完全不会运行。
换一个项目需要 Postgres 和 Elasticsearch?那就启动它们:
./laradock start nginx postgres elasticsearch
两个项目互不干扰:宿主机不安装任何软件,也不会因为项目 A 装了 MySQL 而导致项目 B 的 Postgres 端口冲突。
从 laradock CLI 脚本源码可以看到,该脚本本质上是 Docker Compose 之上的一层便捷封装(设计要求是"无状态、不生成文件、每条命令都打印它实际执行的 docker compose 命令",普通 docker compose 始终可用)。其核心命令包括:
| 命令 | 作用 |
|---|---|
./laradock start |
启动服务(首次运行会引导完成 setup) |
./laradock stop |
停止服务(数据保留) |
./laradock restart |
重启服务 |
./laradock remove |
移除容器 |
./laradock rebuild |
重新构建镜像 |
./laradock logs |
查看日志 |
./laradock enter <服务名> |
进入某个容器内部终端(如 enter mysql) |
./laradock setup |
重新运行交互式向导,仅写 .env |
./laradock workspace |
进入 Laradock Workspace(开发 shell) |
./laradock info |
显示运行中的服务、URL、凭据 |
./laradock doctor |
诊断常见问题 |
./laradock <其它命令> |
原样透传给 docker compose |
脚本同时包含前置检查逻辑:要求 Docker 已安装且正在运行、必须使用 Docker Compose v2(MIN_COMPOSE_MINOR=20,即 v2.20+,因为顶层 docker-compose.yml 使用了 include 指令)、并要求在 Laradock 目录内执行(通过检查 docker-compose.yml 是否包含 ^include: 判断)。
三、Configured, not just installed:开箱即用的网络与连接
"预配置"(Configured)而不是"仅安装"(just installed),是 Laradock 服务的另一大特点。每个服务都被接入 Laradock 统一的 Docker 网络中,并带有合理的默认配置:
- workspace 容器可以直接通过主机名访问
mysql、redis等所有服务,无需记忆 IP 地址或做端口映射; - 所有凭据集中存放在一个
.env文件中,统一管理、统一修改。
3.1 双网络拓扑:frontend 与 backend
顶层 docker-compose.yml 定义了全局共享的两个网络:
networks:
frontend:
driver: ${NETWORKS_DRIVER}
backend:
driver: ${NETWORKS_DRIVER}
- backend 网络:数据类服务(如 MySQL)只接入 backend,见 mysql/compose.yml 中的
networks: - backend; - frontend + backend 双网络:需要同时对外提供 HTTP 与访问后端的服务(如 Nginx、workspace)同时接入两个网络,见 nginx/compose.yml 与 workspace/compose.yml 中的
networks: - frontend - backend。
这一拓扑让 Web 服务器可以同时访问前端入口与后端数据服务,而数据库等服务则被限制在 backend 网络内,隔离清晰。
3.2 通过主机名连接
因为所有服务都在同一个 Docker 网络中,你的应用代码(运行在 workspace 或 PHP-FPM 中)可以直接使用服务名作为主机名连接,例如:
// Laravel .env 示例
DB_HOST=mysql
REDIS_HOST=redis
CACHE_HOST=redis
QUEUE_HOST=redis
这也是"workspace 容器已经能通过主机名访问 mysql、redis 等"这一官方表述的底层原因——Docker 内置 DNS 负责将服务名解析到对应容器。
3.3 端口映射与对外暴露
对外暴露的端口同样由 .env 控制。以 MySQL 为例,mysql/compose.yml 中的映射为:
ports:
- "${MYSQL_PORT}:3306"
MYSQL_PORT 在 .env.example 中有默认值,官方注释明确说明可以按需覆盖:Example: add MYSQL_PORT=3307 here to override the default. 同理,Postgres 对应 POSTGRES_PORT=5432。这意味着:容器内部始终使用标准端口(如 3306),宿主机端口则通过 .env 灵活映射,多个项目并行时也不会互相冲突。
四、统一配置:一个 .env 管全部
所有服务的凭据、端口、版本等配置都集中在根目录的 .env 文件中(首次使用可从 .env.example 复制生成)。其中关键项包括:
| 配置项 | 默认值(来自 .env.example) | 说明 |
|---|---|---|
COMPOSE_PROJECT_NAME |
laradock |
Compose 项目名,隔离不同项目 |
APP_CODE_PATH_HOST |
../ |
宿主机上应用代码的路径 |
PHP_VERSION |
8.4 |
workspace / PHP-FPM 使用的 PHP 版本 |
MYSQL_PORT |
3306 | MySQL 对外端口 |
POSTGRES_PORT |
5432 | Postgres 对外端口 |
NETWORKS_DRIVER |
- | 网络驱动 |
VOLUMES_DRIVER |
- | 数据卷驱动 |
而各服务自身的默认值则存放在各自目录的 defaults.env 中,由顶层 docker-compose.yml 的 include 声明通过 env_file 引用。
laradock CLI 的 setup 命令(laradock 脚本中的 cmd_setup)还会做两件贴心的事:
- 自动探测应用框架:检测
APP_CODE_PATH_HOST指向的项目目录,若存在artisan则识别为 Laravel、wp-settings.php则识别为 WordPress、symfony.lock则识别为 Symfony、core/lib/Drupal.php则识别为 Drupal,并据此预填交互式向导的答案; - 自动生成合法的项目名:由于 Compose 对项目名有严格限制(仅允许小写字母、数字、
-、_,且必须以字母或数字开头),脚本中的sanitize_project_name会把类似My-App的目录名规范化后再作为COMPOSE_PROJECT_NAME。
五、按类别浏览服务
官方文档将服务按类别组织(与 DOCUMENTATION/sidebars.ts 中的侧边栏分类一一对应),每个服务的专属指南涵盖默认端口、如何从应用连接、以及值得修改的配置项:
5.1 数据库(Databases)
MySQL、MariaDB、PostgreSQL、PostGIS、MongoDB、RethinkDB、Cassandra、CouchDB、Neo4j、MSSQL、Percona、ClickHouse、Manticore、Solr、SSDB、ArangoDB、SurrealDB,以及管理界面 phpMyAdmin、Adminer、pgAdmin、pgbackups、pgvector。
5.2 缓存与队列(Caching & Queues)
Redis、Redis Cluster、Redis WebUI、Memcached、Valkey、Dragonfly、Aerospike、Tarantool、Kafka、Beanstalkd、Mosquitto、RabbitMQ、NATS、Zookeeper、Gearman、SQS、Soketi、Mercure,以及 Laravel 专属的 Laravel Echo Server、Laravel Reverb、Laravel Horizon。
5.3 搜索引擎(Search)
Elasticsearch、OpenSearch、Meilisearch、Typesense、Kibana、Dejavu。
5.4 AI 与机器学习(AI & ML)
Ollama、Open WebUI、n8n、Flowise、Langflow、LocalAI、LiteLLM、vLLM、Qdrant、Weaviate、Chroma、MCP。
5.5 Web 服务器与代理(Web Servers & Proxies)
Nginx、Apache2、Caddy、OpenResty、HAProxy、Traefik、Varnish、RoadRunner、FrankenPHP。
5.6 邮件(Mail)
MailCatcher、MailDev、MailHog、Mailpit、Mailu。
5.7 DevOps 与 CI/CD(DevOps & CI/CD)
GitLab、GitLab Runner、Jenkins、Portainer、SonarQube、Certbot、Docker-in-Docker、Docker Registry、OneDev、IDE Theia、Swagger Editor、Swagger UI。
5.8 监控(Monitoring)
Grafana、Prometheus、InfluxDB、Netdata、Graylog、Logstash。
5.9 工具(Tools)
Workspace、PHP-FPM、PHP-Worker、MinIO、Metabase、Keycloak、Confluence、Selenium、Thumbor、Tomcat、AWS EB CLI、Blackfire。
六、底层实现:compose include 与服务组装
服务之所以能做到"按需启停",关键在于顶层 docker-compose.yml 使用了 Docker Compose v2.20+ 的 include 指令,将每个服务目录下的 compose.yml 动态组装进主编排文件。仓库中该文件包含 109 条 include 条目,每条形如:
include:
- path: mysql/compose.yml
project_directory: .
env_file: mysql/defaults.env
- path: nginx/compose.yml
project_directory: .
env_file: nginx/defaults.env
# ... 其余服务依此类推
这种设计带来两个直接好处:
- 每个服务的配置高度内聚:服务的镜像、端口、卷、环境变量都定义在各自的 compose.yml 中,便于单独维护与版本化;
- 顶层零散配置:顶层文件只保留全局的网络、数据卷与
include列表,避免了单个超大 compose 文件的维护噩梦。
同时,顶层声明的数据卷(如 arangodb、elasticsearch、influxdb、mssql、ollama、qdrant 等)让有状态服务的数据可以在容器重建后保留,符合"stop 保留数据、remove 才清理"的使用模型。
七、工作流建议:从启动到排查
结合上述机制,一个典型的 Laradock 使用流程是:
- 初始化:克隆仓库后在 Laradock 目录内运行
./laradock setup(或cp .env.example .env后手动编辑.env),设置APP_CODE_PATH_HOST指向你的应用代码、按需覆盖端口与版本; - 启动:
./laradock start nginx mysql redis,只拉起当前项目需要的服务; - 进入开发环境:
./laradock workspace进入 workspace 容器执行composer install、php artisan等命令,此时mysql、redis等主机名均可直接访问; - 调试连接:使用
./laradock info查看运行中的服务、URL 与凭据;遇到问题用./laradock doctor做诊断; - 切换项目:在另一个项目目录重复步骤 1–2,选择不同的服务组合,宿主机保持干净,两个项目互不干扰。
每个服务的专属文档(见第五节各分类链接)进一步给出了默认端口、应用连接方式与值得修改的配置项,配合仓库中各服务目录下的 defaults.env 与 compose.yml,足以支撑完整的实战调优。
八、结语
Laradock 的服务模型可以概括为三句话:预配置(每个服务带合理默认值、自动接入统一网络)、按需启停(./laradock start 点名即启动,不点名绝不运行)、统一配置(一个 .env 管理全部凭据与端口,多个项目互不冲突)。无论是 Laravel、Symfony 等框架项目,还是需要 Kafka、Elasticsearch、Redis 集群等基础设施的复杂场景,都可以通过这套服务目录快速组装出一套隔离、可复用、可丢弃的开发环境。