Tduck开源版***镜像文档

1. 镜像概述

Tduck开源版是一款轻量级开源问卷表单系统，支持可视化表单设计、数据收集与分析等功能。本镜像为***容器化部署方案，封装了Tduck开源版的运行环境及依赖，简化部署流程，帮助用户快速搭建稳定、可扩展的在线表单应用。

2. 核心功能与特性

• 可视化表单设计：拖拽式编辑器，支持单选、多选、填空、矩阵等20+题型，自定义主题样式与提交逻辑
• 多终端适配：响应式设计，支持PC、移动端（手机/平板）访问，表单样式自动适配不同设备
• 数据管理与分析：实时数据统计，支持Excel导出、图表可视化（柱状图/饼图等），数据权限分级控制
• 灵活的权限体系：支持多角色管理（管理员/普通用户），表单访问权限（公开/密码保护/指定用户）配置
• API扩展能力：提供开放API接口，支持与第三方系统（如OA、CRM）数据对接

3. 使用场景与适用范围

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

4. 使用方法

4.1 镜像拉取

从Docker Hub拉取最新版本镜像：

bash
docker pull tduck/tduck-open:latest

4.2 快速启动容器

基础启动（使用内置H2数据库，适合测试环境）

bash
docker run -d \
  --name tduck \
  -p 8080:8080 \
  -v /local/data/tduck:/app/data \
  tduck/tduck-open:latest

生产环境启动（对接MySQL数据库）

bash
docker run -d \
  --name tduck \
  -p 8080:8080 \
  -v /local/data/tduck:/app/data \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://mysql-host:3306/tduck?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai" \
  -e SPRING_DATASOURCE_USERNAME="db_username" \
  -e SPRING_DATASOURCE_PASSWORD="db_password" \
  tduck/tduck-open:latest

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

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  tduck:
    image: tduck/tduck-open:latest
    container_name: tduck
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./tduck-data:/app/data  # 持久化用户上传文件
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/tduck?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=mysql_root_password
      - SERVER_PORT=8080
      - LOG_LEVEL=INFO
    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  # 自动创建数据库
      - MYSQL_CHARSET=utf8mb4
      - MYSQL_COLLATION=utf8mb4_general_ci

启动服务：

bash
docker-compose up -d

5. 配置说明

5.1 核心环境变量

5.2 数据持久化

• 挂载/app/data目录至宿主机（如示例中的/local/data/tduck），用于持久化用户上传的图片、附件及H2数据库文件（若使用H2）
• MySQL数据通过挂载/var/lib/mysql目录持久化（Docker Compose示例）

6. 系统访问与初始化

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

7. 注意事项

• 生产环境建议使用MySQL数据库（内置H2数据库仅适合测试，性能及并发支持有限）
• 定期备份挂载的/app/data目录及MySQL数据卷，防止数据丢失
• 若需启用HTTPS，可通过Nginx反向代理配置SSL证书，容器内无需额外配置