mintopia/laravel-echo-server

Laravel Echo Server Docker镜像

镜像概述

本镜像提供了Laravel Echo Server的容器化部署方案，用于支持Laravel应用的实时通信功能（如实时通知、聊天等），默认使用Redis作为消息队列，可通过环境变量或自定义配置文件灵活调整参数。

核心功能

• 默认集成Redis支持，简化实时通信架构
• 通过环境变量快速配置服务器参数（如认证主机、端口、调试模式等）
• 支持HTTP/HTTPS协议切换，提供SSL证书配置选项
• 内置API访问功能，可配置跨域（CORS）规则

使用场景

• Laravel应用的实时通知推送
• 在线聊天或协作系统的实时消息传递
• 需要低延迟数据同步的Web应用场景

配置说明

环境变量配置

可通过以下环境变量调整容器参数：

• LARAVEL_ECHO_SERVER_AUTH_HOST：私有/存在频道的认证服务器地址
• LARAVEL_ECHO_SERVER_HOST：Echo服务器主机地址
• LARAVEL_ECHO_SERVER_PORT：Echo服务器监听端口
• LARAVEL_ECHO_SERVER_DEBUG：调试模式开关（true/false）
• ECHO_CLIENTS：客户端配置JSON字符串
• ECHO_DEVMODE：开发模式开关（与调试模式功能类似）

SSL配置

若需启用HTTPS，需设置以下变量：

• ECHO_PROTOCOL：协议类型（http/https）
• ECHO_SSL_CERT_PATH：SSL证书路径
• ECHO_SSL_KEY_PATH：私钥路径
• ECHO_SSL_CHAIN_PATH：证书链路径（可选）
• ECHO_SSL_PASSPHRASE：私钥密码（可选）

API跨域配置

• ECHO_ALLOW_CORS：是否允许跨域（true/false）
• ECHO_ALLOW_ORIGIN：允许的跨域源地址
• ECHO_ALLOW_METHODS：允许的HTTP方法（如GET,POST）
• ECHO_ALLOW_HEADERS：允许的请求头

部署示例

Docker Run命令

bash
docker run -d \
  --name laravel-echo-server \
  -p 6001:6001 \
  -e LARAVEL_ECHO_SERVER_AUTH_HOST=http://your-laravel-app.com \
  -e LARAVEL_ECHO_SERVER_PORT=6001 \
  -e ECHO_PROTOCOL=http \
  mintopia/laravel-echo-server

自定义配置文件挂载

若需复杂配置，可将本地配置文件挂载到容器内：

bash
docker run -d \
  --name laravel-echo-server \
  -p 6001:6001 \
  -v /path/to/your/laravel-echo-server.json:/opt/laravel-echo-server/laravel-echo-server.json \
  mintopia/laravel-echo-server