shinsenter/espocrm

镜像概述和主要用途

shinsenter/espocrm是基于PHP的生产就绪型Docker镜像，专为快速部署EspoCRM客户关系管理系统设计。该镜像内置自动EspoCRM安装程序，支持通过环境变量轻松配置PHP和PHP-FPM设置，无需重建镜像即可调整配置。同时集成最新版Composer，便于快速初始化项目，提供Debian和Alpine两种基础版本供选择。

• Docker Hub: [***]
• GitHub Packages: [***]

核心功能和特性

• 灵活配置：通过环境变量自定义PHP和PHP-FPM设置，无需重建镜像
• 自动安装：挂载空目录时自动下载EspoCRM源代码，快速引导新项目
• 工具集成：内置最新版Composer，简化依赖管理和项目初始化
• 多版本支持：提供Debian和Alpine两种基础镜像版本
• HTTPS支持：内置SSL证书配置，支持自定义证书实现安全访问
• 持续更新：每日构建确保包含PHP、基础系统、Composer等最新上游更新

使用场景和适用范围

• 快速部署EspoCRM客户关系管理系统
• 开发/测试环境中实时同步代码变更（通过卷挂载）
• 生产环境中稳定运行EspoCRM，支持安全HTTPS访问
• 需要频繁调整PHP配置而避免镜像重建的场景

使用方法和配置说明

基础使用

详细配置文档请参考官方PHP镜像文档，了解如何根据项目需求自定义镜像。

创建新项目

当挂载空目录到容器时，系统会自动下载EspoCRM完整源代码，快速引导新项目：

步骤：

1. 在主机创建空项目目录：

   mkdir espocrm
   

2. 运行容器并挂载该目录：

   docker run -p 80:80 -p 443:443 -p 443:443/udp \
       -v ./espocrm:/var/www/html \
       shinsenter/espocrm:latest
   

容器将检测空目录并自动克隆框架源代码到挂载卷中。

使用现有项目

将现有项目代码目录挂载到容器的/var/www/html路径，实现代码实时同步：

docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v /path/to/your/existing/espocrm:/var/www/html \
    shinsenter/espocrm:latest

配置HTTPS

镜像内置测试用SSL证书，生产环境需替换为有效证书。以下是三种配置方式：

使用Dockerfile

FROM shinsenter/espocrm:latest

# 复制自定义证书
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

# 可选：添加项目代码
# ADD --chown=$APP_USER:$APP_GROUP ./espocrm/ /var/www/html/

使用docker run命令

docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./espocrm:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    shinsenter/espocrm:latest

使用docker-compose

services:
  web:
    image: shinsenter/espocrm:latest
    volumes:
      - ./espocrm:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"

稳定镜像标签策略

由于每日构建会更新相同标签下的镜像内容，建议为生产环境标记稳定版本：

1. 拉取最新镜像并标记为稳定版：

   docker pull shinsenter/espocrm:latest
   docker tag  shinsenter/espocrm:latest your-repo/espocrm:stable
   docker push your-repo/espocrm:stable
   

2. 使用稳定标签镜像构建生产容器：

   FROM your-repo/espocrm:stable
   # 添加自定义配置
   

贡献和许可

贡献

如果发现镜像有用，可通过PayPal***支持，或在GitHub提交问题反馈。

许可

本项目基于GNU General Public License v3.0许可。使用或基于本项目思想进行开发时，请注明出处。

来自越南 🇻🇳 的爱心贡献。