TduckAppearance
TDUCK 社区版 · 安装文件获取与部署说明
本文档将指导您获取 TDUCK 社区版 的安装部署文件，并说明所需的基础环境、资源配置与文件用途，帮助您快速完成本地或服务器部署。
一、获取部署安装文件
TDUCK 社区版采用公众号自动发放方式获取源码与安装包。
获取方式
- 扫描下方二维码，关注 填鸭表单官方公众号
- 在公众号对话框中回复关键词：
部署文件
- 系统将自动推送最新版本的部署压缩包下载地址。
二、部署前必备环境
在正式部署前，请确认您的服务器 / 本地环境已满足以下要求：
1. 基础运行环境
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux（推荐：CentOS 7+/Ubuntu 20+），或 Windows |
| JDK | JDK 8（必须） |
| 数据库 | MySQL 5.7 / 8.0 |
| Web端口 | 需要开放后端服务端口（默认 8998） |
| 解压工具 | tar / unzip |
2. 最小资源配置（建议）
| 资源项 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 1 核 | 2 核 |
| 内存 | 2 GB | 4 GB |
| 磁盘 | 10 GB 可用空间 | 20 GB+ |
| 带宽 | 1 Mbps | 5 Mbps+ |
如为企业或多人使用场景，建议 2 核 4G 以上配置。
三、部署文件说明
下载并解压部署包后，您将看到以下核心文件：
| 文件名 | 说明 |
|---|---|
tduck-api.jar | 后端主程序启动包 |
application-custom.yml | 外置配置文件（数据库、端口、缓存等配置） |
tduck-v5.sql | 数据库初始化脚本 |
deploy.sh | 一键快速部署脚本（Linux 环境） |
文件作用说明
tduck-api.jar 系统后端核心服务，启动后提供接口与管理后台能力。
application-custom.yml 外置配置文件，可修改数据库地址、账号、端口号、文件存储路径等。
tduck-v5.sql 用于初始化数据库结构及基础数据，请在部署前导入到 MySQL。
deploy.sh 针对 Linux 服务器的快速部署脚本，可自动完成启动与基础校验。
四、部署流程简要
安装 JDK8
安装并创建 MySQL 数据库
导入
tduck-v5.sql修改
application-custom.yml中数据库连接信息启动服务：
bashjava -jar tduck-api.jar或：
bashsh deploy.sh浏览器访问后台地址即可开始使用
五、注意事项
- JDK 版本必须为 1.8，否则无法正常启动
- 数据库字符集建议使用
utf8mb4 - 请确保服务器已开放对应端口（默认 8998）
- 如部署失败，可查看日志定位问题