moss/osticket

docker-osticket镜像说明

镜像概述

本Docker镜像用于运行OSTicket 1.9.14版本，是一款开源支持工单系统。基于Debian 8构建，使用nginx+PHP-FPM（PHP5）提供服务，支持与MySQL容器联动，自动完成配置文件和数据库安装，具备邮件发送与接收能力。

核心功能

1. 自动初始化：启动时自动生成配置文件并完成数据库安装
2. MySQL兼容：支持链接MySQL容器或外部MySQL服务器
3. 邮件处理：通过SMTP发送邮件，支持IMAP/POP3收取邮件
4. 插件扩展：提供插件目录卷，方便添加功能扩展
5. 日志持久化：nginx日志可通过卷挂载保存

使用场景

• 企业内部帮助台：处理员工技术支持、行政请求工单
• 客户服务平台：接收客户咨询、投诉等工单
• 团队协作工具：跟踪项目问题与任务分配

配置说明

快速启动

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 docker.xuanyuan.run/mysql

2. 运行osticket镜像：

bash
docker run --name osticket -d --link osticket_mysql:mysql -p 8080:80 docker.xuanyuan.run/moss/osticket

3. 访问后台：浏览器打开http://localhost:8080/scp，默认账号：用户名ostadmin，密码Admin1（生产环境请修改密码）

MySQL连接配置

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

邮件配置

SMTP发送设置

需设置环境变量：

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

IMAP/POP3收取设置

• CRON_INTERVAL：邮件检查间隔（分钟，默认5，0禁用），需配合后台设置

卷挂载

• /data/upload/include/plugins：插件目录，可挂载外部插件
• /var/log/nginx：nginx日志目录，用于持久化日志

环境变量

• INSTALL_SECRET：安装密钥（生产环境建议指定，避免容器重建丢失）
• INSTALL_EMAIL：帮助台***（默认***）
• 初始化变量：INSTALL_NAME（帮助台名称）、ADMIN_USERNAME（管理员账号）等（仅首次安装使用）

许可证

本镜像及源代码基于MIT许可证发布，详情见LICENSE文件。