跳到主要内容
卷王问卷
中文EN
微信咨询

Windows 一键部署

Windows 版适合个人电脑、办公室、教室和实验室局域网。安装包包含图形启动器、SurveyKing 服务端和 Java 17 Runtime，不需要预装 Java、.NET、WebView2、MySQL 或 Docker。

  • 支持 Windows 10/11 64 位。
  • 当前版本：1.13.0。
  • 安装包大小约 89 MB。
  • 默认按当前 Windows 用户安装，可以选择程序目录。

1. 下载安装包​

从官方地址下载：

下载 SurveyKing-1.13.0.exe

双击安装包，进入安装向导：

SurveyKing Windows 安装向导

如果 SmartScreen 显示“Windows 已保护你的电脑”，先确认下载域名和文件名正确，再点击 更多信息 → 仍要运行。正式发布包如果尚未完成代码签名，Windows 可能显示未知发布者。

2. 选择程序目录​

安装程序允许更改程序目录：

选择 SurveyKing 安装目录

程序与业务数据分开保存：

内容默认位置
启动器、服务端和 Java Runtime%LOCALAPPDATA%\SurveyKingApp，安装时可更改
配置、H2 数据、附件和日志%LOCALAPPDATA%\SurveyKing，固定保存

升级、重新安装或卸载程序不会自动删除业务数据目录。

3. 打开图形启动器​

安装完成后，从桌面或开始菜单打开 SurveyKing：

SurveyKing 桌面快捷方式

启动器会自动启动本地服务。状态变成 运行中 后，可以使用：

SurveyKing Windows 图形启动器

功能说明
浏览器打开未初始化时直接打开 /setup，初始化后打开系统首页
启动 / 停止 / 重启管理当前用户的 SurveyKing 服务进程
重置 admin 密码使用本机随机令牌设置新的强密码
本机访问默认显示 http://127.0.0.1:1991
局域网访问自动检测主要局域网 IPv4 地址
联系我们打开 SurveyKing 官网
运行日志查看服务启动、停止和错误信息

启动器会跟随系统语言，也可手动选择并记住设置。支持简体中文、繁体中文、英语、日语、韩语、德语、法语和泰语。

4. 首次初始化​

点击 浏览器打开，在 /setup 中：

  1. 选择 H2 内置数据库。
  2. 填写系统名称、描述和默认语言。
  3. 按需设置开放注册和 AI；暂时不用可关闭。
  4. 确认并完成初始化。
  5. 使用 admin / 123456 登录并立即修改密码。

Windows 局域网轻量使用建议选择 H2。如果需要公网、MySQL 和 7×24 小时运行，改用 Docker Compose。

5. 让同一局域网设备访问​

启动器会显示类似下面的地址：

http://192.168.1.23:1991

在其他设备上访问前确认：

  1. Windows 主机和手机、平板或电脑连接到同一个局域网。
  2. 启动器状态为运行中。
  3. Windows 防火墙允许 SurveyKing/Java Runtime 访问专用网络。
  4. 路由器没有启用访客网络隔离或 AP 隔离。

主机休眠、关机或完全退出启动器后，其他设备无法访问。不建议通过路由器端口映射直接把 Windows 版暴露到互联网。

6. 日常使用​

关闭主窗口只会最小化到系统托盘，服务会继续运行。要完全退出，在托盘图标菜单中选择 退出；退出启动器时也会停止 SurveyKing 服务。

忘记密码时：

  1. 在安装 SurveyKing 的电脑上打开启动器。
  2. 等待状态为运行中。
  3. 点击 重置 admin 密码。
  4. 输入 8～16 位、同时包含大写字母、小写字母和数字的新密码。

重置接口使用只保存在当前用户数据目录中的随机令牌，不能从其他电脑直接调用。

7. 修改端口​

先停止服务，再编辑：

%LOCALAPPDATA%\SurveyKing\config\application.properties

修改或添加：

server.port=8080

保存后在启动器中重新启动。启动器显示的本机和局域网地址会自动更新。

8. 备份、升级和卸载​

备份​

优先从 系统管理 → 系统设置 → 数据备份 导出备份包，并额外备份：

%LOCALAPPDATA%\SurveyKing

复制 H2 数据文件前先停止服务。

升级​

  1. 导出系统备份并退出托盘中的 SurveyKing。
  2. 下载新版本安装包。
  3. 运行安装程序完成升级。
  4. 启动并检查项目、答卷和附件。

卸载​

卸载前先从系统托盘选择 退出，避免运行中的进程占用安装目录。然后进入 Windows 设置 → 应用 → 已安装的应用 卸载 SurveyKing。

卸载不会自动删除 %LOCALAPPDATA%\SurveyKing。只有在确认备份有效且不再使用时，才手动删除该目录。

排查问题​

现象优先检查
一直显示停止启动器运行日志、端口占用、安全软件隔离
手机打不开局域网地址、防火墙、同一 Wi-Fi、网络隔离
首次打开进入登录页而非 /setup点击启动器“浏览器打开”，确认使用最新 1.13.0 安装包
卸载窗口卡住先从托盘退出；仍有进程时在任务管理器结束 SurveyKing 后再卸载
重装后数据还在这是正常行为，数据目录独立保留

更多初始化和迁移说明见：初始化、备份和升级。

最后于 更新