tduckcloud/tduck-platform

Tduck Platform 官方镜像文档

1. 镜像概述

TDuck填鸭表单是国内首批基于Vue开源的问卷/表单收集工具。系统采用无代码设计理念，使用者可以通过拖拽的方式创建问卷表单，所见即所得；与此同时也支持专业技术人员自行二次开发自定义组件，来满足不同企业组织的个性化需求。系统采用SpringBoot+Vue+ElementUI技术栈，无需复杂学习即可快速上手，功能强大UI界面清新，通过简要部署就能够助力企业组织快速赋能业务。

本镜像为官方容器化部署方案，封装了TDuck Platform的运行环境及依赖，简化部署流程，帮助用户快速搭建稳定、可扩展的在线表单应用。

2. 核心功能与特性

2.1 表单组件

• 27+自定义组件：支持拖拽式快速生成表单问卷
• 丰富组件类型：单行文本、多行文本、日期、下拉、单选、文件上传、排序、级联、轮播、一键定位、手机号验证、矩阵量表、子表单等组件
• 批量导入：支持通过文本批量导入表单组件
• 逻辑设置：支持题目显隐逻辑设置

2.2 表单外观与配置

• 外观自定义：支持头图、背景图、背景颜色、按钮文字等配置
• 提交后设置：支持提交后自定义文案、提交后自动跳转网址

2.3 数据管理

• 数据操作：支持数据新增、编辑、导出、打印、预览和打包下载附件
• 报表分析：支持对问题实时统计分析并以图形（柱状图、折线图、饼图）的形式展示输出和导出png图片

2.4 访问控制

• 填写限制：每个微信、账号、ip、设备、答题次数限制
• 时间控制：支持设置允许填写时间
• 信息记录：记录微信个人信息

2.5 通知与推送

• 邮件提醒：支持发邮件提醒
• 微信推送：支持微信公众号模板推送提醒

2.6 数据集成

• 数据同步API：支持全量数据同步
• WebHook推送：可订阅事件（新增、修改、删除）

2.7 模板管理

• 模板中心：支持保存至模板中心，支持从模板中心选用模板创建表单问卷

2.8 用户管理

• 用户操作：新增用户、修改用户、删除用户

2.9 存储配置

• 文件存储：支持阿里云、七牛云、又拍云、本地、通用S3协议上传

2.10 第三方服务配置

• 邮件配置：支持邮件参数配置
• 短信配置：支持阿里云、腾讯云、中昱维信短信服务
• 微信公众号配置：支持微信公众号参数配置

2.11 其他功能

• 回收中心：支持回收中心，快速恢复问卷
• 可视化大屏：支持配置TReport可视化大屏，高效展示数据

3. 使用场景与适用范围

• 企业/组织：内部调研、员工考核、会议报名、需求收集
• 教育机构：学生作业提交、在线考试、课程评价
• 活动运营：活动报名、问卷抽奖、用户反馈收集
• 个人用户：小型调研、活动签到、信息登记表制作

4. 使用方法

4.1 镜像拉取

从轩辕镜像平台拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/tduckcloud/tduck-platform:latest

4.2 快速启动容器

官方推荐启动命令（对接MySQL数据库）

bash
docker run -d \
  --name tduck-platform \
  --restart=always \
  -p 8999:8999 \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://127.0.0.1:3310/tduck-v4?useSSL=false&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&tinyInt1isBit=false&nullCatalogMeansCurrent=true" \
  -e SPRING_DATASOURCE_USERNAME=root \
  -e SPRING_DATASOURCE_PASSWORD=tduck@tduck \
  -v /upload:/application/BOOT-INF/lib/upload \
  docker.xuanyuan.run/tduckcloud/tduck-platform

参数说明：

• -p 8999:8999：容器端口映射，访问地址为 http://宿主机IP:8999
• SPRING_DATASOURCE_URL：MySQL数据库连接地址，请根据实际情况修改主机、端口和数据库名
• SPRING_DATASOURCE_USERNAME：数据库用户名
• SPRING_DATASOURCE_PASSWORD：数据库密码，请修改为实际密码
• -v /upload:/application/BOOT-INF/lib/upload：挂载上传文件目录，用于持久化用户上传的图片和附件

自定义配置启动（根据实际情况调整）

bash
docker run -d \
  --name tduck-platform \
  --restart=always \
  -p 8999:8999 \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://mysql-host:3306/tduck-v4?useSSL=false&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&tinyInt1isBit=false&nullCatalogMeansCurrent=true" \
  -e SPRING_DATASOURCE_USERNAME="db_username" \
  -e SPRING_DATASOURCE_PASSWORD="db_password" \
  -v /local/upload:/application/BOOT-INF/lib/upload \
  docker.xuanyuan.run/tduckcloud/tduck-platform:latest

4.3 Docker Compose部署（推荐生产环境）

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  tduck-platform:
    image: docker.xuanyuan.run/tduckcloud/tduck-platform:latest
    container_name: tduck-platform
    restart: always
    ports:
      - "8999:8999"
    volumes:
      - ./upload:/application/BOOT-INF/lib/upload  # 持久化用户上传文件
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/tduck-v4?useSSL=false&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&tinyInt1isBit=false&nullCatalogMeansCurrent=true
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=mysql_root_password
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    container_name: tduck-mysql
    restart: always
    ports:
      - "3306:3306"
    volumes:
      - ./mysql-data:/var/lib/mysql  # 持久化数据库数据
    environment:
      - MYSQL_ROOT_PASSWORD=mysql_root_password
      - MYSQL_DATABASE=tduck-v4  # 自动创建数据库
      - MYSQL_CHARSET=utf8mb4
      - MYSQL_COLLATION=utf8mb4_general_ci

启动服务：

bash
docker-compose up -d

5. 配置说明

5.1 核心环境变量

数据库URL参数说明：

• useSSL=false：禁用SSL连接
• useUnicode=true：使用Unicode编码
• characterEncoding=utf8：字符编码为UTF-8
• serverTimezone=Asia/Shanghai：时区设置为上海
• tinyInt1isBit=false：TinyInt(1)不作为Bit类型处理
• nullCatalogMeansCurrent=true：空目录表示当前目录

推荐数据库名： tduck-v4

5.2 数据持久化

• 挂载/application/BOOT-INF/lib/upload目录至宿主机（如示例中的/upload或./upload），用于持久化用户上传的图片、附件等文件
• MySQL数据通过挂载/var/lib/mysql目录持久化（Docker Compose示例）

6. 系统访问与初始化

1. 容器启动后，通过http://宿主机IP:8999访问系统（默认端口为8999）
2. 首次登录：默认管理员账号admin，密码123456（生产环境需立即修改）
3. 系统初始化：登录后进入「系统设置」完成基础配置（如网站名称、Logo、邮件服务等）

7. 镜像标签版本

• latest：最新稳定版本（推荐使用）
• new：新版本标签
• v5：v5版本
• 4：v4版本

8. 注意事项

• 本镜像需要连接MySQL数据库，请确保数据库服务已启动并可访问
• 数据库连接URL中的参数请按照官方推荐配置，特别是tinyInt1isBit=false和nullCatalogMeansCurrent=true参数
• 定期备份挂载的/application/BOOT-INF/lib/upload目录及MySQL数据卷，防止数据丢失
• 默认访问端口为8999，如需修改请调整-p参数映射
• 若需启用HTTPS，可通过Nginx反向代理配置SSL证书，容器内无需额外配置
• 本镜像托管于轩辕镜像平台，提供稳定快速的镜像下载服务