dietermartens/uvdesk

UVDesk Docker化镜像

镜像概述

本镜像基于thecodingmachine/docker-images-php构建，包含社区版UVDesk帮助台软件，支持快速部署和配置，适用于企业或团队搭建工单管理系统。

核心功能

1. 工单全生命周期管理（创建、分配、处理、关闭）
2. 定时邮件同步（通过Cron任务刷新指定***生成工单）
3. 多环境切换（开发模式用于安装，生产模式用于正式运行）
4. 支持Traefik反向代理集成

使用场景

• 企业内部IT支持工单系统
• 客户服务工单处理平台
• 团队协作任务跟踪系统

配置说明

环境变量

• APP_ENV：运行环境（安装时用dev，完成后切换为prod）
• APP_SECRET：应用密钥（需自行设置）
• TZ/APP_TIMEZONE：时区设置（如Asia/Shanghai）
• APP_CURRENCY：货币单位（如CNY）
• CRON_*：定时任务配置（用于邮件同步）

Docker Compose部署示例（基础版）

yaml
version: "3"

volumes:
  app:

services:
  uvdesk:
    image: dietermartens/uvdesk
    environment:
      # 安装阶段使用dev模式，完成后改为prod
      - APP_ENV=dev
      - APP_SECRET=your_secret_key
      - TZ=Asia/Shanghai
      - APP_TIMEZONE=Asia/Shanghai
      - APP_CURRENCY=CNY
      - CRON_USER1=root
      - CRON_SCHEDULE1=*/5 * * * *
      - CRON_COMMAND1=cd /var/www/html && php bin/console uvdesk:refresh-mailbox support@yourdomain.com
    restart: always
    extra_hosts:
      - "uvdesk.yourdomain.com:127.0.0.1"
    networks:
      - public
    volumes:
      - app:/var/www/html

Docker Compose部署示例（Traefik反向代理版）

yaml
version: "3"

networks:
  public:
    external:
      name: proxy

volumes:
  app:

services:
  uvdesk:
    image: dietermartens/uvdesk
    environment:
      - APP_ENV=dev
      - APP_SECRET=your_secret_key
      - TZ=Asia/Shanghai
      - APP_TIMEZONE=Asia/Shanghai
      - APP_CURRENCY=CNY
      - CRON_USER1=root
      - CRON_SCHEDULE1=*/5 * * * *
      - CRON_COMMAND1=cd /var/www/html && php bin/console uvdesk:refresh-mailbox support@yourdomain.com
    # Traefik配置标签
    labels:
      - traefik.enable=true
      - traefik.docker.network=proxy
      - traefik.http.routers.uvdesk.rule=Host(`uvdesk.yourdomain.com`)
      - traefik.http.services.uvdesk.loadbalancer.server.port=80
      - traefik.http.routers.uvdesk.tls.certresolver=le
      - traefik.http.routers.uvdesk.tls=true
    restart: always
    extra_hosts:
      - "uvdesk.yourdomain.com:127.0.0.1"
    networks:
      - public
    volumes:
      - app:/var/www/html

常见问题

***同步不生成工单

检查config/packages/uvdesk.yaml中的site_url配置，确保其为正确的域名（无需添加https://或http://前缀）。