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

常见问题

安装和初始化​

当前文档对应哪个版本？​

本文档按 SurveyKing 开源版 v1.13.0 编写。升级前先查看更新日志。

第一次打开为什么进入 /setup？​

这是 v1.13.0 的正常首次启动流程。系统需要在这里选择 H2 或 MySQL、创建数据库表并保存基础设置。初始化完成后，再次访问会进入登录页。

如果一个已经使用过的系统突然重新进入 /setup，不要重复初始化。先检查挂载目录、程序工作目录和 config/application.properties 是否仍然存在。

默认账号和密码是什么？​

账号：admin
密码：123456

首次登录后需要改为 8～16 位密码，同时包含大写字母、小写字母和数字，并且只能使用字母和数字。

H2 还是 MySQL？​

  • H2 不需要单独安装数据库，适合个人、演示和局域网轻量使用；
  • MySQL 8 更适合公网、长期运行、多人高频使用和已有数据库运维体系的场景。

两种数据库都应定期使用系统内的“数据备份”导出 ZIP，并额外备份持久化目录或数据库。

访问问题​

127.0.0.1、局域网 IP 和域名有什么区别？​

  • 127.0.0.1 或 localhost 只能在运行 SurveyKing 的本机访问；
  • 192.168.x.x、10.x.x.x 等局域网地址供同一网络中的设备访问；
  • 公网用户应使用配置了 HTTPS 的域名。

Windows 启动器会同时显示本机地址和检测到的局域网地址。

局域网其他电脑打不开​

依次检查：

  1. 服务是否正在运行；
  2. 访问的是运行机器的局域网 IP，不是 127.0.0.1；
  3. Windows 防火墙、服务器防火墙或 NAS 防火墙是否允许 TCP 1991；
  4. 两台设备是否处在可互通的网络；
  5. 路由器是否开启了访客网络隔离。

公网部署需要直接开放 1991 吗？​

初始化时可以临时开放。正式使用建议由 Nginx 或宝塔反向代理到 127.0.0.1:1991，公网只开放 80 和 443，并启用 HTTPS。不要开放 MySQL 3306。

Windows​

Windows 是否需要提前安装 Java、MySQL 或 WebView2？​

不需要。官方 v1.13.0 安装包已经内置精简的 Java 17 运行时，默认使用 H2，也不依赖 .NET 或 WebView2。

关闭启动器后服务为什么还在运行？​

点击窗口关闭按钮会最小化到系统托盘。需要彻底退出时，右键托盘图标选择“退出”；退出会停止本地服务。

卸载会删除问卷数据吗？​

安装目录与数据目录相互独立。卸载前先从托盘退出，安装器默认不会删除 %LOCALAPPDATA%\SurveyKing 中的数据。仍建议先导出应用备份并复制该目录。

忘记 admin 密码怎么办？​

Windows 用户优先使用启动器的“重置 admin 密码”按钮，按提示设置新密码。

Docker 或 Linux 用户如果还有其他管理员账号，可以登录后重置。完全无法登录时，先备份数据库，再由熟悉数据库的管理员处理；不要在没有备份的情况下直接修改表数据。

Docker 和数据​

删除容器会丢数据吗？​

正确挂载宿主机目录后，删除容器不会删除这些目录。SurveyKing 至少应持久化：

/app/config
/app/db
/app/files
/app/logs

Compose 使用 MySQL 时还要持久化 /var/lib/mysql。不要执行 docker compose down -v，也不要删除宿主机映射目录。

容器更新后又进入 /setup​

这通常说明 /app/config 没有持久化，或新容器挂载到了另一个空目录。检查容器配置和宿主机目录中是否存在 application.properties，不要在新页面上直接重新初始化旧数据库。

Docker Compose 的数据库地址填什么？​

按本站 Compose 文档部署时填写：

地址：mysql
端口：3306
数据库：surveyking
用户：root
密码：.env 中的 MYSQL_ROOT_PASSWORD

容器之间使用服务名和内部端口，不填写宿主机 IP，也不填写对外映射端口。

全新安装还需要导入 init-mysql.sql 吗？​

不需要。v1.13.0 的 /setup 会自动初始化空数据库。手工预导入旧 SQL 反而可能导致重复数据或初始化失败。

备份、升级和 AI​

最少应该备份什么？​

管理员在“系统管理 → 系统设置 → 数据备份”导出 ZIP；同时备份部署对应的 config、数据库和 files 目录。备份副本应保存在另一台机器或对象存储。

AI 功能为什么不显示或无法调用？​

检查“系统管理 → 系统设置 → AI 设置”中是否启用 AI、Base URL 与模型 ID 是否正确，以及服务器是否能访问模型服务。401/403 多为密钥或权限问题，404 多为接口路径问题。详见 AI 智能创建。

仍未解决​

提交问题时请附上版本、部署方式、操作系统、复现步骤和必要日志，并隐藏密码、Token、API Key 等敏感信息：

最后于 更新