Laradock 服务总览:70+ 预配置 Docker 容器按需启停、开箱即用的 PHP 开发环境

原创2026-09-22 17:30:091,654 阅读
文章标签:后端开发工具DevOps

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)还会做两件贴心的事:

  1. 自动探测应用框架:检测 APP_CODE_PATH_HOST 指向的项目目录,若存在 artisan 则识别为 Laravel、wp-settings.php 则识别为 WordPress、symfony.lock 则识别为 Symfony、core/lib/Drupal.php 则识别为 Drupal,并据此预填交互式向导的答案;
  2. 自动生成合法的项目名:由于 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
  # ... 其余服务依此类推

这种设计带来两个直接好处:

  1. 每个服务的配置高度内聚:服务的镜像、端口、卷、环境变量都定义在各自的 compose.yml 中,便于单独维护与版本化;
  2. 顶层零散配置:顶层文件只保留全局的网络、数据卷与 include 列表,避免了单个超大 compose 文件的维护噩梦。

同时,顶层声明的数据卷(如 arangodb、elasticsearch、influxdb、mssql、ollama、qdrant 等)让有状态服务的数据可以在容器重建后保留,符合"stop 保留数据、remove 才清理"的使用模型。

七、工作流建议:从启动到排查

结合上述机制,一个典型的 Laradock 使用流程是:

  1. 初始化:克隆仓库后在 Laradock 目录内运行 ./laradock setup(或 cp .env.example .env 后手动编辑 .env),设置 APP_CODE_PATH_HOST 指向你的应用代码、按需覆盖端口与版本;
  2. 启动:./laradock start nginx mysql redis,只拉起当前项目需要的服务;
  3. 进入开发环境:./laradock workspace 进入 workspace 容器执行 composer install、php artisan 等命令,此时 mysql、redis 等主机名均可直接访问;
  4. 调试连接:使用 ./laradock info 查看运行中的服务、URL 与凭据;遇到问题用 ./laradock doctor 做诊断;
  5. 切换项目:在另一个项目目录重复步骤 1–2,选择不同的服务组合,宿主机保持干净,两个项目互不干扰。

每个服务的专属文档(见第五节各分类链接)进一步给出了默认端口、应用连接方式与值得修改的配置项,配合仓库中各服务目录下的 defaults.env 与 compose.yml,足以支撑完整的实战调优。

八、结语

Laradock 的服务模型可以概括为三句话:预配置(每个服务带合理默认值、自动接入统一网络)、按需启停(./laradock start 点名即启动,不点名绝不运行)、统一配置(一个 .env 管理全部凭据与端口,多个项目互不冲突)。无论是 Laravel、Symfony 等框架项目,还是需要 Kafka、Elasticsearch、Redis 集群等基础设施的复杂场景,都可以通过这套服务目录快速组装出一套隔离、可复用、可丢弃的开发环境。

登录后查看全文
laradock