polonel/trudesk

Trudesk Docker镜像文档

镜像概述和主要用途

Trudesk是一款社区版帮助台解决方案，旨在提供客户支持与问题跟踪功能。通过Docker容器化部署，需配合MongoDB数据库使用，适用于企业或团队快速搭建内部/外部支持系统，简化问题管理流程。

核心功能和特性

• 容器化部署：基于Docker实现快速安装与扩展，降低环境配置复杂度
• 数据持久化：支持主机目录挂载，确保插件、上传文件、备份等数据持久存储
• 灵活配置：通过环境变量自定义数据库连接、运行环境等参数
• 多组件联动：需与MongoDB容器配合使用，实现完整功能

使用场景和适用范围

适用于需要构建客户支持平台、内部IT服务台或问题跟踪系统的企业、团队及个人。尤其适合追求快速部署、易于维护且对成本敏感的用户场景。

详细使用方法和配置说明

存储准备 - 在主机创建目录

为确保数据持久化，需在主机提前创建以下目录：

bash
$ mkdir -p /data/db          # MongoDB数据存储目录
$ mkdir -p /data/configdb    # MongoDB配置存储目录
$ mkdir -p /data/trudesk/plugins  # Trudesk插件存储目录
$ mkdir -p /data/trudesk/uploads  # Trudesk上传文件存储目录
$ mkdir -p /data/trudesk/backups  # Trudesk备份存储目录

MongoDB容器部署

部署MongoDB 5容器作为Trudesk的数据库服务：

bash
$ docker run --name mongodb \
    -v /data/db:/data/db \
    -v /data/configdb:/data/configdb \
    -d mongo:5.0

参数说明：

• --name mongodb：指定容器名称为mongodb
• -v /data/db:/data/db：挂载主机数据目录到容器，持久化MongoDB数据
• -v /data/configdb:/data/configdb：挂载配置目录
• -d：后台运行容器
• mongo:5.0：使用MongoDB 5.0版本镜像

Trudesk容器部署

拉取Trudesk镜像

获取最新的1.2版本镜像：

bash
$ docker pull polonel/trudesk:1.2

运行Trudesk容器

bash
$ docker run --name trudesk --link mongodb:mongodb \
    -v /data/trudesk/uploads:/usr/src/trudesk/public/uploads \
    -v /data/trudesk/plugins:/usr/src/trudesk/plugins \
    -v /data/trudesk/backups:/usr/src/trudesk/backups \
    -e NODE_ENV=production \
    -e TRUDESK_DOCKER=true \
    -e TD_MONGODB_SERVER=mongodb -e TD_MONGODB_DATABASE=trudesk \
    -P -d polonel/trudesk:$TAG

参数说明：

• --name trudesk：指定容器名称为trudesk
• --link mongodb:mongodb：链接到mongodb容器，建立网络通信
• 挂载目录：
  • /data/trudesk/uploads:/usr/src/trudesk/public/uploads：持久化上传文件
  • /data/trudesk/plugins:/usr/src/trudesk/plugins：持久化插件
  • /data/trudesk/backups:/usr/src/trudesk/backups：持久化备份文件
• 环境变量：
  • NODE_ENV=production：设置为生产运行环境
  • TRUDESK_DOCKER=true：标识在Docker环境中运行
  • TD_MONGODB_SERVER=mongodb：MongoDB服务器地址（链接的容器名）
  • TD_MONGODB_DATABASE=trudesk：使用的数据库名称
• -P：随机映射容器端口到主机端口
• -d：后台运行容器
• polonel/trudesk:$TAG：指定Trudesk镜像及版本（将$TAG替换为具体版本，如1.2）

访问Trudesk服务

容器运行后，通过Docker分配的NodePort访问服务。执行docker ps命令查看端口映射：

bash
$ docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                     NAMES
5f75716aa8cc        polonel/trudesk:1.2 "/bin/bash /usr/src/…"   1 minute ago        Up 1 minute         0.0.0.0:32772->8118/tcp   trudesk
5b4f77cbf1a3        mongo:5.0           "docker-entrypoint.s…"   32 minutes ago      Up 32 minutes       27017/tcp                 mongodb

在PORTS列中，0.0.0.0:32772->8118/tcp表示主机端口32772映射到容器端口8118。通过http://{主机IP}:32772即可访问Trudesk服务。

注意：在多主机容器集群中运行时，需使用共享存储（如NFS）确保数据一致性。