juanluisbaptiste/znuny

Znuny - OTRS社区版分叉票务系统Docker镜像

镜像概述

Znuny是OTRS社区版的分叉项目，在OTRS AG停止社区版支持后，由Znuny团队提供长期支持（LTS）。本Docker镜像包含构建和运行Znuny票务系统所需的全部文件，基于官方CentOS镜像，支持MariaDB数据库，并可与外部SMTP服务集成。

核心功能

• 企业级票务管理：提供Agent（管理员）和Customer（客户）双界面，支持票务创建、分配、跟踪等全流程。
• 灵活配置：通过环境变量或自定义Config.pm文件调整系统参数（如数据库连接、时区、语言等）。
• 备份与恢复：支持自动每日备份（可配置时间、类型、压缩方式）及手动恢复功能。
• 版本升级：支持Minor版本（如6.0.1→6.0.5）和Major版本（如5.x→6.x）升级，升级前自动备份。
• 皮肤定制：可通过环境变量设置Agent/Customer界面皮肤，支持自定义皮肤导入。
• 插件安装：映射addons目录即可自动安装OPM格式插件。
• Docker Secrets支持：通过密钥文件安全存储敏感信息（如数据库密码）。

使用场景

• 企业内部IT支持票务系统：管理员工的IT问题请求。
• 客户服务平台：处理外部客户的咨询、投诉等请求。
• 问题跟踪系统：用于项目团队的任务分配与进度跟踪。

配置说明

环境变量（部分关键变量）

• OTRS_HOSTNAME：容器主机名（自动生成若未指定）。
• OTRS_DB_NAME：数据库名称（默认otrs）。
• OTRS_ROOT_PASSWORD：管理员密码（默认changeme）。
• OTRS_BACKUP_TYPE：备份类型（fullbackup/nofullbackup/dbonly，默认fullbackup）。
• OTRS_ARTICLE_STORAGE_TYPE：附件存储方式（ArticleStorageFS/ArticleStorageDB，默认DB）。

自定义配置文件

创建自定义镜像导入Config.pm：

dockerfile
FROM docker.xuanyuan.run/juanluisbaptiste/otrs:latest
COPY Config.pm /Kernel

Docker Secrets使用

将敏感信息存入密钥文件（如my_otrs_secrets）：

bash
OTRS_DB_PASSWORD=your_db_pwd
MYSQL_ROOT_PASSWORD=your_root_pwd

在docker-compose中指定：

yaml
services:
  otrs:
    environment:
      - OTRS_SECRETS_FILE=/run/secrets/my_otrs_secrets

部署示例

构建镜像

bash
git clone https://github.com/juanluisbaptiste/docker-otrs.git
cd docker-otrs
docker-compose build

启动服务（开发环境）

bash
docker-compose up

生产环境启动

bash
docker-compose -f docker-compose.yml -p companyotrs up -d

访问地址：

• Agent界面：http://${OTRS_HOSTNAME}/otrs/index.pl
• Customer界面：http://${OTRS_HOSTNAME}/otrs/customer.pl

备份与恢复

自动备份

默认每日6:00执行，备份文件存于/var/otrs/backups（需挂载主机目录）。

手动恢复

设置环境变量OTRS_INSTALL=restore和OTRS_BACKUP_DATE=备份目录/压缩包名，启动容器即可恢复。

版本升级

Minor版本升级

bash
docker-compose pull
docker-compose stop && docker-compose up -d

Major版本升级

1. 在docker-compose中设置OTRS_UPGRADE=yes。
2. 更换镜像版本标签（如latest-5x→latest）。
3. 执行pull和重启命令。

bash
docker-compose pull
docker-compose stop && docker-compose up -d

（升级完成后需移除OTRS_UPGRADE=yes）

调试模式

设置OTRS_DEBUG=yes可启用 verbose输出，并安装telnet、dig等工具辅助排查问题。