campbellsoftwaresolutions/osticket

docker-osticket

概述

该Docker镜像用于运行OSTicket 1.14.3版本（开源帮助台系统）。基于Alpine Linux构建，采用nginx+PHP-FPM 7.2提供服务，修复了原镜像的AJAX问题，支持与MySQL容器联动、自动配置文件生成和数据库安装，以及邮件发送功能。

核心功能

• 自动完成OSTicket配置文件生成和数据库初始化
• 支持链接MySQL容器或外部MySQL服务器
• 集成msmtp实现邮件发送，支持SMTP认证和TLS加密
• 定时检查IMAP/POP3***接收工单（可通过CRON_INTERVAL设置）
• 提供卷挂载支持：插件目录、语言包目录、nginx日志目录
• 可通过环境变量自定义数据库连接、邮件设置、管理员信息等

使用场景

• 企业内部IT帮助台系统部署
• 客户服务工单管理平台搭建
• 团队协作支持请求处理系统

配置说明

快速启动

1. 运行MySQL容器：

bash
docker run --name osticket_mysql -d -e MYSQL_ROOT_PASSWORD=secret -e MYSQL_USER=osticket -e MYSQL_PASSWORD=secret -e MYSQL_DATABASE=osticket mysql:5

2. 运行OSTicket镜像并链接MySQL容器：

bash
docker run --name osticket -d --link osticket_mysql:mysql -p 8080:80 campbellsoftwaresolutions/osticket

3. 访问管理员面板：http://localhost:8080/scp/，默认账号：用户名ostadmin，密码Admin1（生产环境请立即修改）。

MySQL连接配置

• 链接容器：直接链接MySQL容器并使用别名mysql，无需额外配置。
• 外部MySQL：需设置以下环境变量：
  • MYSQL_HOST：MySQL服务器地址
  • MYSQL_PORT：MySQL端口（默认3306）
  • MYSQL_USER：数据库用户名（默认osticket）
  • MYSQL_PASSWORD：数据库密码
  • MYSQL_DATABASE：数据库名（默认osticket）

邮件配置

SMTP发送设置

需设置以下环境变量：

• SMTP_HOST：SMTP服务器地址（默认localhost）
• SMTP_PORT：SMTP端口（默认25）
• SMTP_FROM：发件人***（未设置则使用SMTP_USER）
• SMTP_TLS：是否启用TLS（1/0，默认1）
• SMTP_USER：SMTP认证用户名（可选）
• SMTP_PASSWORD：SMTP认证密码（可选）

IMAP/POP3接收设置

• CRON_INTERVAL：定时检查***的间隔（分钟，默认5，0为禁用），需配合管理员面板中的邮件检查间隔设置。

卷挂载

• /data/upload/include/plugins：插件目录（放置OSTicket插件）
• /data/upload/include/i18n：语言包目录（添加自定义语言）
• /var/log/nginx：nginx日志目录（用于日志收集）

关键环境变量

• INSTALL_URL：帮助台公网URL（默认http://localhost:8080/）
• ADMIN_USERNAME：默认管理员用户名（默认osticket）
• ADMIN_PASSWORD：默认管理员密码（默认Admin1）
• INSTALL_SECRET：安装密钥（生产环境建议指定，避免容器重建丢失）

注意事项

• 生产环境必须修改默认密码和安装密钥
• 非80端口访问时，管理员面板URL需带 trailing slash（如http://localhost:8080/scp/）
• 外部MySQL用户需具备数据库全权限以完成自动安装