部署方式选择
SurveyKing 1.13.0 的首选交付方式是 Windows 安装包和 Docker 镜像。二者都已经包含后端和前端,不需要单独部署网页文件。
推荐顺序
| 优先级 | 方式 | 适合谁 | 维护成本 |
|---|---|---|---|
| 1 | Windows 一键部署 | Windows 本机、办公室或教室局域网 | 最低 |
| 1 | Docker Compose 部署 | 云服务器、长期运行、需要 MySQL | 低 |
| 2 | Docker 单容器部署 | 已会 Docker,使用 H2 快速体验 | 低 |
| 2 | 宝塔部署 | 已有宝塔,希望用面板管理 Docker | 中 |
| 2 | 群晖 NAS / 飞牛 NAS | NAS 长期开机、局域网使用 | 中 |
| 3 | Linux 手动部署 | 需要自己管理 Java 和 systemd | 高 |
| 3 | 前后端分离部署 | 必须定制前端或接入已有网关 | 最高 |
备注
宝塔旧版“Java 项目一键部署”和历史 ZIP/JAR 教程不再是 1.13.0 的首选。新部署优先使用 Docker Compose;手动 JAR 只适合能够从源码构建和维护 Java 服务的用户。
数据库怎么选
| 数据库 | 优点 | 适合场景 | 必须持久化的内容 |
|---|---|---|---|
| H2 | 零依赖、初始化快 | Windows、个人或局域网轻量使用 | db、config、files |
| MySQL 8.0 | 独立运行、便于长期维护 | 云服务器、NAS、公网和重要数据 | MySQL 数据、config、files |
H2 和 MySQL 都可以使用系统自带的备份导入导出功能。需要从 H2 迁移到 MySQL 时,先在旧系统导出备份,再部署并初始化新的 MySQL 系统,最后导入备份。
局域网和公网的区别
| 地址示例 | 谁能访问 |
|---|---|
http://127.0.0.1:1991 | 只有当前设备 |
http://192.168.1.23:1991 | 通常只有同一局域网 |
https://survey.example.com | DNS、证书和防火墙配置正确时可公网访问 |
Windows 启动器会显示本机地址和局域网 IPv4 地址。Docker 或 Linux 部署到云服务器后,应使用公网 IP 或域名访问,并在云安全组和系统防火墙中开放需要的端口。
注意
不要直接把 MySQL 的 3306 端口开放到公网。生产环境建议只开放 80/443,通过 Nginx 或其他反向代理访问 SurveyKing。
最低准备
Windows
- Windows 10 或 Windows 11,64 位。
- 普通用户安装权限。
- 约 200 MB 可用程序空间,以及业务数据所需空间。
- 不需要预装 Java、.NET、WebView2、MySQL 或 Docker。
Docker
- Linux、macOS、Windows 或支持容器的 NAS。
- Docker Engine,以及 Docker Compose v2(Compose 部署时)。
- Docker 镜像同时提供
linux/amd64和linux/arm64。 - 建议至少 2 核 CPU、2 GB 内存;MySQL 与 SurveyKing 同机时建议 4 GB 以上。
部署完成后的统一步骤
无论选择哪种方式,都按以下顺序完成交付:
- 打开访问地址,确认自动进入
/setup。 - 选择数据库并填写系统信息。
- 使用
admin / 123456首次登录并立即修改密码。 - 用另一台设备测试问卷链接或二维码。
- 导出第一份系统备份。
- 记录程序版本、数据目录、端口和维护负责人。
详见:初始化、备份和升级。