fauzie/docker-whmcs

Docker WHMCS

即用型WHMCS环境Docker镜像，帮助快速部署WHMCS客户管理系统。

注意：请使用您自己的WHMCS包，并映射到卷 /var/www/whmcs

核心功能

• 使用PHP 7.2版本
• 已就绪Ioncube加载器
• 针对WHMCS优化的Nginx服务器配置
• 预装WHMCS默认 cron 任务（含工单导入）
• 自定义WHMCS安装卷映射：/var/www/whmcs
• 支持密码或公钥的SSH登录（端口2222）
• 支持主机SSL（需映射Let's Encrypt或其他有效证书）

使用场景

• 网络托管服务提供商部署WHMCS客户管理系统
• WHMCS本地开发与测试环境搭建
• 快速构建WHMCS生产或测试实例

配置说明

环境变量

必选变量

• VIRTUAL_HOST：WHMCS安装的URL
• WHMCS_SERVER_IP：WHMCS许可证验证所需的Docker主机公网IP
• APP_PASSWORD：SSH登录用户app的密码
• SSH_PUBLIC_KEY：SSH登录公钥（若指定则自动禁用密码登录）

可选变量

• TZ：PHP时区配置，默认Asia/Jakarta
• WORKER_PROCESSES：Nginx工作进程数，默认自动使用CPU总数
• NGINX_CLIENT_MAX_BODY_SIZE：Nginx最大上传限制，默认50MB
• PHP_SESSION_SAVE_HANDLER：PHP会话存储方式（如redis），默认files
• PHP_SESSION_SAVE_PATH：PHP会话存储路径，默认/var/lib/php/sessions
• PHP_UPLOAD_MAX_FILESIZE：PHP最大上传限制，默认与Nginx一致
• PHP_POST_MAX_SIZE：PHP POST最大大小
• PUID：修改app用户UID，默认911
• PGID：修改app用户组GID，默认911
• SMTP_HOST：SMTP中继服务器地址
• SMTP_USER：SMTP中继服务器用户名
• SMTP_PASS：SMTP中继服务器密码
• SMTP_PORT：SMTP端口，默认587
• SMTP_SECURE：是否需要安全连接，默认在设置SMTP_USER时为TRUE
• SMTP_TLS：是否使用STARTTLS，默认TRUE（若为FALSE且SMTP_SECURE为TRUE则使用SSL）
• SMTP_MASQ：邮件发件人域名伪装，默认空

端口

• 443：Nginx SSL端口
• 2222：SSH登录端口

邮件配置

若需发送邮件且无法直接使用SMTP，可通过SMTP_变量配置ssmtp（提供/usr/bin/sendmail）。若未设置SMTP_USER，则使用未认证SMTP且禁用SSL/TLS。

本地WHMCS开发

WHMCS开发许可证

若您拥有活跃的WHMCS许可证，可联系WHMCS支持获取免费开发许可证用于本地开发。此Docker设置确保不同机器使用相同有效IP，注意不要更改主机名，否则需手动重新申请许可证。

运行步骤

1. 修改docker-compose[-local].yml中的卷映射：将/your/path/to/whmcs:/var/www/whmcs替换为您的WHMCS安装目录（如./../whmcs-local/public:/var/www/whmcs）
2. 启动容器：

console
docker-compose up

3. 访问http://localhost/（默认映射80端口，可在docker-compose.yml中修改），或在hosts文件添加whmcs.test指向127.0.0.1后访问http://whmcs.test

使用Mailhog测试邮件

docker-compose-local.yml中添加了Mailhog容器，配置WHMCS容器使用其作为SMTP服务器。所有WHMCS邮件将被Mailhog捕获，无需在WHMCS内配置（依赖容器的php mail()设置）。启动命令：

console
docker-compose -f docker-compose-local.yml up

访问Mailhog web界面：http://localhost:8025