Docker 部署填鸭表单完整教程：搭建私有化问卷与表单收集平台

共计 11384 个字符，预计需要花费 29 分钟才能阅读完成。

本文基于  tduckcloud/tduck-platform:latest，跟做标签  latest（选型见第三节），实测  填鸭表单社区版 6.0（Spring Boot 2.7.8），测试平台  Ubuntu 24.04 Linux。

年会报名要手机号、部门、是否吃辣；培训结束发满意度；人事再做一轮匿名调研——表格往往散在微信群 Excel、第三方问卷链接，甚至打印后扫码回传。改一题就要重发链接，答卷字段对不齐，活动结束还得手工合并 CSV。

放到公有问卷 SaaS，又会碰到更硬的约束：答卷、附件和受访者信息最好留在自己的库里。内网机房、等保或「数据不出域」时，外链问卷不合适；自建又怕装 JDK、配前端、手搓 MySQL。很多团队其实已经有一台跑 Docker 的 Ubuntu，缺的是镜像能拉、库能初始化、浏览器打开  8999  就能拖组件。

填鸭表单（TDuck Platform）（文档 、Gitee、 镜像页 ）是开源问卷 / 在线表单：拖拽建表、逻辑显隐、统计报表、模板与 WebHook。官方镜像  tduckcloud/tduck-platform  把前后端打进同一容器， 外置 MySQL，上传目录用卷持久化。跟做时务必带上官方  tduck-v5.sql——镜像本身不会建表。

部署跑通之后，你实际能做这些事：

用  轩辕镜像  加速拉取  tduckcloud/tduck-platform:latest，Docker Compose  拉起 MySQL + 应用。把下文中的 IP 与数据库密码换成你的。无 Compose 见第八节。文内附  18  张实测截图。

上手要点

• 主路径：第四节 Compose；备选 docker run 见第八节
• SQL：必须挂载官方 docker/init-db/tduck-v5.sql（空库会缺表重启）
• 端口：宿主机 8999 → 容器 8999
• 标签：跟做 latest（v5 仅 arm64，见 §3.1）
• 体积：应用 DISK 736MB / CONTENT 267MB；MySQL 8.0 DISK 1.1GB / CONTENT 249MB
• 冷启动：首次导库约 2～3 分钟；应用约 24 秒 出「社区版 6.0- 启动成功」
• 账号：[email protected] / 123456（生产立即改密）
• 目录：Linux /www/wwwroot/tduck-platform；macOS ~/docker/tduck-platform
• 可忽略：启动时 OssStorageFactory … 更新存储配置失败 仍可起来，后台再配存储

官方：Docker 部署  ·  镜像页  ·  标签列表 · Docker Hub

一、填鸭表单镜像是什么？

tduckcloud/tduck-platform  是填鸭表单的 应用一体镜像 （API + 前端静态资源），监听  8999。业务在 MySQL，上传文件在挂载目录。它 不内置库表：要么让 MySQL 首次启动时执行  init-db  里的 SQL，要么你手动导入。

浏览器 ──HTTP:8999──▶  tduck-platform（Spring Boot 2.7.x）├── JDBC ──▶ MySQL（库名 tduck，由 tduck-v5.sql 建表）└── ./upload ──▶ /application/BOOT-INF/lib/upload

/zh/r/  与  /r/  为同一镜像的中英文详情页。

官方 Gitee 的  docker/  目录也会挂  ./init-db（内含  tduck-v5.sql）。本文不强制整仓 clone：只下载该 SQL，再用轩辕镜像坐标写 Compose。若你已按官方 clone，把  image:  改成  docker.xuanyuan.run/...  即可。

二、环境要求

docker --version
docker compose version

Linux 未装 Docker 可使用轩辕镜像一键安装脚本：

bash <(wget -qO- https://get.xuanyuan.cloud/docker.sh)

备用地址：

bash <(wget -qO- https://get.xuanyuan.me/docker.sh)

更多见  轩辕镜像使用手册。

三、拉取镜像

3.1 标签怎么选

规范上优先写具体版本号，但当前  v5  没有 amd64，常见 x86_64 Ubuntu 拉  v5  会失败；new / 4  过旧。故在上游给出可用的多架构语义化标签之前，跟做使用  latest，升级前对照  标签列表。arm64 可改用  v5。

3.2 用轩辕镜像加速拉取

docker pull docker.xuanyuan.run/tduckcloud/tduck-platform:latest
docker pull docker.xuanyuan.run/library/mysql:8.0

Ubuntu 24.04 实测：

latest: Pulling from tduckcloud/tduck-platform
c3d540630ac8: Download complete
2ebcedb0253b: Pull complete
d5099453b19b: Pull complete
997278513bfd: Pull complete
e4600cca76ff: Pull complete
73cb655b6fa1: Pull complete
d1f56e4c7f2f: Pull complete
613b839994a8: Pull complete
81e2f2053c8f: Pull complete
d316eafedae0: Pull complete
Digest: sha256:74400b35e5397b5cf78f07a82ac9d3594989bb7065edfdea2f95bd3b7f575f49
Status: Downloaded newer image for docker.xuanyuan.run/tduckcloud/tduck-platform:latest
docker.xuanyuan.run/tduckcloud/tduck-platform:latest

8.0: Pulling from library/mysql
96d30d9fbee8: Pull complete
297d04cfe470: Pull complete
edf85873f64e: Pull complete
6ef6c7b50a93: Pull complete
e3e5d1ac74c1: Pull complete
0d74d296605b: Pull complete
7534d1db9f8d: Pull complete
4c8a3e0d4e4b: Pull complete
a63160a5eda1: Pull complete
49ec2dab01d9: Pull complete
ab24264a27e9: Pull complete
796812c73292: Download complete
af166387641d: Download complete
Digest: sha256:7dcddc01f13bab2f15cde676d44d01f61fc9f99fe7785e86196dfc07d358ae2b
Status: Downloaded newer image for docker.xuanyuan.run/library/mysql:8.0
docker.xuanyuan.run/library/mysql:8.0

docker images docker.xuanyuan.run/tduckcloud/tduck-platform:latest
docker images docker.xuanyuan.run/library/mysql:8.0

IMAGE                                                  ID             DISK USAGE   CONTENT SIZE   EXTRA
docker.xuanyuan.run/tduckcloud/tduck-platform:latest   74400b35e539        736MB          267MB

IMAGE                                   ID             DISK USAGE   CONTENT SIZE   EXTRA
docker.xuanyuan.run/library/mysql:8.0   7dcddc01f13b        1.1GB          249MB

四、Docker Compose 部署（推荐）

4.1 准备目录并下载初始化 SQL

sudo mkdir -p /www/wwwroot/tduck-platform/{mysql-data,upload,init-db}
sudo chown -R 999:999 /www/wwwroot/tduck-platform/mysql-data
cd /www/wwwroot/tduck-platform

# macOS：mkdir -p ~/docker/tduck-platform/{mysql-data,upload,init-db} && cd ~/docker/tduck-platform

wget -O init-db/tduck-v5.sql \
  https://gitee.com/TDuckApp/tduck-platform/raw/master/docker/init-db/tduck-v5.sql
ls -lh init-db/tduck-v5.sql

实测 SQL 约  29KB。999:999  对应官方 MySQL 镜像常见 uid；权限报错见 FAQ。

/docker-entrypoint-initdb.d 只在数据目录为空时执行一次。若你曾经用空库起过栈，见 §4.4。

4.2 编写 docker-compose.yml

将  ChangeMe_Tduck_Root_Pwd  换成强密码（MySQL 与应用必须一致）：

cat > docker-compose.yml <<'EOF'
services:
  mysql:
    image: docker.xuanyuan.run/library/mysql:8.0
    container_name: tduck-mysql
    restart: unless-stopped
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_general_ci
      - --default-authentication-plugin=mysql_native_password
    environment:
      MYSQL_ROOT_PASSWORD: ChangeMe_Tduck_Root_Pwd
      MYSQL_DATABASE: tduck
      TZ: Asia/Shanghai
    volumes:
      - ./mysql-data:/var/lib/mysql
      - ./init-db:/docker-entrypoint-initdb.d:ro
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-uroot", "-pChangeMe_Tduck_Root_Pwd"]
      interval: 10s
      timeout: 5s
      retries: 18
      start_period: 60s

  tduck-platform:
    image: docker.xuanyuan.run/tduckcloud/tduck-platform:latest
    container_name: tduck-platform
    restart: unless-stopped
    depends_on:
      mysql:
        condition: service_healthy
    ports:
      - "8999:8999"
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/tduck?useSSL=false&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&tinyInt1isBit=false&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true
      SPRING_DATASOURCE_USERNAME: root
      SPRING_DATASOURCE_PASSWORD: ChangeMe_Tduck_Root_Pwd
      TZ: Asia/Shanghai
    volumes:
      - ./upload:/application/BOOT-INF/lib/upload
EOF

JDBC 参数里的  tinyInt1isBit=false、nullCatalogMeansCurrent=true、allowPublicKeyRetrieval=true  建议保留（官方文档同款；后一项对 MySQL 8 常见）。

4.3 启动并验证

docker compose up -d
docker compose ps
docker compose logs -f tduck-platform

Ubuntu 24.04 实测：MySQL 到  healthy  约  3 分钟，应用约  24 秒  完成启动。

✔ Network tduck-platform_default Created
✔ Container tduck-mysql          Healthy
✔ Container tduck-platform       Started

成功日志（节选）：

:: Spring Boot ::                (v2.7.8)
...
Tomcat initialized with port(s): 8999 (http)
...
DatebookHikariCP - Start completed.
...
SysEnvConfigMapper.selectList  : <==      Total: 2
...
已在数据库中自动生成并保存了新的高强度随机 JWT 密钥。...
Tomcat started on port(s): 8999 (http) with context path ''
Started TduckApiApplication in 24.207 seconds (JVM running for 25.573)
Tduck- 填鸭表单社区版 6.0- 启动成功 >>
启动成功，请访问：http://localhost:8999
请使用管理员账号登录，用户名：[email protected]，密码：123456, 然后请尽快修改密码!!!

看到  社区版 6.0- 启动成功，且没有  sys_env_config doesn't exist，即可打开浏览器。

curl -I http://127.0.0.1:8999

4.4 已起过空库时怎么补救

若第一次没挂 SQL，日志会反复报  Table 'tduck.sys_env_config' doesn't exist。数据目录非空后，init 脚本不会再跑。

尚无业务数据（推荐）：确认  init-db/tduck-v5.sql  存在，且 Compose 已含 §4.2 的  init-db  挂载，然后：

cd /www/wwwroot/tduck-platform
docker compose down
sudo rm -rf mysql-data/*
docker compose up -d
docker compose logs -f tduck-platform

不想清目录：手动导入后重启应用：

cd /www/wwwroot/tduck-platform
wget -O init-db/tduck-v5.sql \
  https://gitee.com/TDuckApp/tduck-platform/raw/master/docker/init-db/tduck-v5.sql
docker exec -i tduck-mysql \
  mysql -uroot -pChangeMe_Tduck_Root_Pwd tduck < init-db/tduck-v5.sql
docker compose restart tduck-platform

把  -p  后的密码换成 Compose 里的实际值。

五、浏览器首次初始化

打开  http:// 服务器 IP:8999，应出现 Tduck CE 登录页。用  [email protected] / 123456  登录（与启动日志一致），登录后立刻改密。

进入「我的项目」时列表为空，可点  + 新建表单；需要时再试  AI 智能建表。

下面以手动新建「周末聚餐报名」为例：填名称与描述后进入编辑器。

左侧拖入组件，中间改标题与题干，右侧调必填、占位等属性。实测可先加「姓名」「联系方式」两个单行文本。

点「预览」可在手机 / 电脑视图间切换；手机预览旁有扫码二维码（预览模式通常不可真正提交）。

发布前建议先到侧栏「系统配置」核对  系统基础域名（须含协议并带尾部  /，例如  http://192.168.1.35:8999/），否则外链与二维码可能指向错误地址。文件存储也可一并配好（对应启动时的 Oss 告警）。

六、主界面与核心功能

6.1 逻辑、外观与提交设置

「逻辑」里可为单选 / 下拉等题设置显隐规则；「外观」可开关 Logo、头图、背景；「设置 → 提交设置」可改提交后文案或跳转 URL。

6.2 发布、填写与统计

「发布 → 立即发布」后，可复制专属链接或下载二维码。公开填写页底部有 Powered By 标识，旁侧可扫码打开。

「统计」汇总有效回收量、浏览量、回收率与周趋势；「数据」里可查看具体答卷（有提交后才有明细）。

6.3 模板、用户与系统配置

共享模板库可按名称检索；用户管理里可见默认  [email protected]（以及 SQL 种子里的  test  账号，生产建议禁用或改密）。系统配置页版本徽章为  V6.0，并可切换到文件存储、邮件、短信、微信、AI 等页签。

更多能力见  填鸭表单文档。

七、安全、备份与生产加固

cd /www/wwwroot/tduck-platform
docker compose stop
tar -czf tduck-backup-$(date +%Y%m%d).tgz mysql-data upload init-db docker-compose.yml
docker compose start

八、备选：docker run（临时 / 无 Compose）

适用于已有可访问的 MySQL，且 已导入  tduck-v5.sql。容器内不要把库地址写成宿主机  127.0.0.1（Linux 用宿主机局域网 IP；Docker Desktop 可用  host.docker.internal）。

mysql -uroot -p -e "CREATE DATABASE IF NOT EXISTS tduck DEFAULT CHARACTER SET utf8mb4;"
mysql -uroot -p tduck < /www/wwwroot/tduck-platform/init-db/tduck-v5.sql

docker run -d \
  --name tduck-platform \
  --restart unless-stopped \
  -p 8999:8999 \
  -e SPRING_DATASOURCE_URL="jdbc:mysql:// 主机或 IP:3306/tduck?useSSL=false&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&tinyInt1isBit=false&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true" \
  -e SPRING_DATASOURCE_USERNAME=root \
  -e SPRING_DATASOURCE_PASSWORD='你的数据库密码' \
  -v /www/wwwroot/tduck-platform/upload:/application/BOOT-INF/lib/upload \
  docker.xuanyuan.run/tduckcloud/tduck-platform:latest

docker logs -f tduck-platform
curl -I http://127.0.0.1:8999

成功时不应再出现  sys_env_config doesn't exist。

九、迁移与升级说明

1. 备份 mysql-data、upload、init-db、docker-compose.yml。
2. 在 标签列表 确认目标标签架构（amd64 / arm64）。
3. 修改 Compose 中 image: 后执行：

docker compose pull
docker compose up -d
docker compose logs -f tduck-platform

4. 浏览器登录冒烟测试。跨旧线（如 4 → latest）前先在测试机验证库结构。

十、常见问题 FAQ

Q1：拉取  v5  报  no matching manifest？
A：v5  当前多为 arm64。x86_64 请用  latest。

Q2：日志报  Table 'tduck.sys_env_config' doesn't exist？
A：镜像不会自动建表。按 §4.1 下载 SQL 并挂到  /docker-entrypoint-initdb.d；数据目录已非空则按 §4.4 清库或手动  mysql < tduck-v5.sql。

Q3：连库失败（不是缺表）？
A：JDBC 主机是否为服务名  mysql；密码是否与  MYSQL_ROOT_PASSWORD  一致；MySQL 是否已  healthy；是否含  allowPublicKeyRetrieval=true。

Q4：浏览器打不开？
A：首次冷启动可能要数分钟；若在缺表循环，先修 Q2。确认防火墙放行  8999。

Q5：上传文件刷新后丢失？
A：确认已挂载  ./upload:/application/BOOT-INF/lib/upload。

Q6：默认账号登不进去？
A：须先成功导入 SQL。账号为  [email protected] / 123456（见启动日志）。

Q7：该用  tduck-v5.sql  还是  tduck-v6.sql？
A：跟做官方 Docker 目录用  docker/init-db/tduck-v5.sql。实测  latest  横幅为社区版 6.0，与该 SQL 可跑通。doc/tduck-v6.sql  面向另一套安装包，换用前请先在测试机验证。

Q8：日志有  OssStorageFactory … 更新存储配置失败？
A：仍可启动成功。登录后到「系统配置 → 文件存储」配置即可。

Q9：经轩辕镜像拉 MySQL 怎么写坐标？
A：library 镜像写  docker.xuanyuan.run/library/mysql:8.0，不要写成无  library/  的  mysql:8.0  前缀形式（若你习惯 Hub 短名，在轩辕加速域下仍建议显式  library/）。

十一、命令速查

# 拉取
docker pull docker.xuanyuan.run/tduckcloud/tduck-platform:latest
docker pull docker.xuanyuan.run/library/mysql:8.0

# SQL
mkdir -p /www/wwwroot/tduck-platform/init-db
wget -O /www/wwwroot/tduck-platform/init-db/tduck-v5.sql \
  https://gitee.com/TDuckApp/tduck-platform/raw/master/docker/init-db/tduck-v5.sql

# Compose
cd /www/wwwroot/tduck-platform
docker compose up -d
docker compose ps
docker compose logs -f tduck-platform
docker compose down

十二、延伸阅读

总结

• 跟做 latest + tduck-v5.sql + Compose，端口 8999，实测为 社区版 6.0。
• 空库缺表是最常见坑，按 §4.1 / §4.4 处理。
• 默认 [email protected] / 123456，上线改密、写好基础域名，并备份 mysql-data 与 upload。

阅读原文

• 轩辕镜像官方博客：https://xuanyuan.cloud/blog/tduck-platform-docker-deploy