zammad/zammad-docker-compose

Zammad Docker镜像文档

镜像概述与主要用途

Zammad是一款基于Web的开源帮助台和客户支持平台，被誉为"客户支持的瑞士军刀"。本Docker镜像专为通过docker-compose和Kubernetes部署Zammad而设计，可帮助团队高效管理跨邮件、聊天、电话及社交媒体等多渠道的客户咨询，提升支持团队协作效率，减少系统管理时间成本。

核心功能与特性

开源与独立管理

• 软件采用GNU AGPLv3许可协议，源代码托管于https://github.com/zammad/zammad
• 由独立的Zammad基金会管理，不受商业提供商控制，确保开源性质可持续

多渠道沟通支持

• 整合邮件、在线聊天、电话、社交媒体等多种客户沟通渠道
• 提供统一平台管理所有客户咨询，避免团队信息孤岛

社区与专业开发支持

• 由Zammad GmbH团队与社区协作开发，确保功能迭代与问题修复
• 提供商业云服务选项，可简化部署、配置、备份及更新等运维工作

使用场景与适用范围

• 客户支持团队：需要统一管理多渠道客户咨询的企业或组织
• 小型团队/临时需求：预算有限或需求规模较小的团队，可作为临时解决方案
• 自托管需求：希望完全掌控数据与系统的组织，通过Docker实现本地化部署
• 多应用环境：需在同一服务器部署多个Web应用时，可配合反向代理使用

使用方法与配置说明

快速开始

详细部署指南请参考官方文档：Zammad文档 - Docker Compose安装

升级指南

升级说明请查阅GitHub Releases：https://github.com/zammad/zammad-docker-compose/releases

镜像状态

!https://github.com/zammad/zammad-docker-compose/actions/workflows/ci-remote-image.yaml/badge.svg
!Docker Pulls

使用反向代理

在多Web应用环境中，需通过反向代理将80/443端口请求路由至对应应用。部署步骤如下：

1. 复制示例代理配置文件至自定义配置：
   cp ./.examples/proxy/docker-compose.proxy-example.yml ./docker-compose.prod.yml

2. 修改./docker-compose.prod.yml中的环境变量VIRTUAL_HOST及外部网络名称，适配目标环境

3. 结合默认配置与自定义配置启动服务：
   docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

参考示例代理项目：.examples/proxy/docker-compose.yml

Rancher部署

console
RANCHER_URL=http://RANCHER_HOST:8080 rancher-compose --env-file=.env up

不使用Elasticsearch运行

Elasticsearch是可选但强烈推荐的依赖组件，适用于以下场景可禁用：

• 小型团队使用
• 预算有限
• Elasticsearch临时故障或升级

禁用方法：

1. 为zammad-init容器设置环境变量：ELASTICSEARCH_ENABLED=false
2. 移除所有与Elasticsearch相关配置：包括zammad-elasticsearch容器、其数据卷及链接引用

关于Zammad

软件与基金会

Zammad软件将始终保持开源，由Zammad基金会独立管理，与Zammad GmbH等商业提供商无隶属关系，确保开源生态独立性。

Zammad GmbH公司

Zammad的开发由Zammad GmbH团队与社区协作完成。如需简化运维（部署、配置、备份、更新），可考虑其商业云服务，提供免费试用实例。