开源版快速开始
SurveyKing 社区版适合把调查问卷、在线考试、题库练习、投票和公开查询部署在自己的电脑、服务器或 NAS 上。当前文档以 1.13.0 为准。
提示
SurveyKing 社区版采用 MIT License。自行部署时，运行环境、数据安全、备份和升级由部署者负责。
1. 选择部署方式
| 使用场景 | 推荐方式 | 数据库建议 |
|---|---|---|
| Windows 10/11 电脑，本机或局域网使用 | Windows 一键部署 | H2 |
| Linux 云服务器，长期运行 | Docker Compose 部署 | MySQL 8.0 |
| 已有 Docker，只想快速体验 | Docker 单容器部署 | H2 |
| 群晖或飞牛 NAS | 群晖 NAS / 飞牛 NAS | MySQL 8.0 |
| 已有宝塔面板 | 宝塔部署 | MySQL 8.0 |
不确定时，局域网使用选 Windows；需要公网、域名、HTTPS 或 7×24 小时运行时选 Docker Compose。
2. 打开首次初始化页面
服务启动后访问部署文档给出的地址，例如：
http://127.0.0.1:1991
未初始化的 1.13.0 会自动进入 /setup。如果没有自动跳转，可以直接打开：
http://你的地址:1991/setup
在初始化页面完成以下设置：
- 选择 H2 或 MySQL。
- 填写系统名称、描述、默认语言和是否开放注册。
- 按需配置 OpenAI-compatible 模型；暂时不用时可以关闭，之后再到系统设置中配置。
- 核对信息并开始初始化。
系统和 Windows 启动器支持简体中文、繁体中文、英语、日语、韩语、德语、法语和泰语。
数据库选择、Docker MySQL 参数和初始化后的行为见：第一次初始化。
3. 登录并修改密码
初始化完成后使用以下账号登录：
| 项目 | 默认值 |
|---|---|
| 账号 | admin |
| 密码 | 123456 |
注意
默认密码只用于第一次登录。登录后立即进入个人安全设置，将密码修改为 8～16 位、同时包含大写字母、小写字母和数字的密码；特殊字符目前不受支持。
4. 创建第一个项目
登录后进入项目页面，新建问卷或考试。可以从空白项目、模板或 AI 智能创建开始：
- 调查问卷：满意度、报名、信息收集、反馈。
- 在线考试：培训考核、课程测验、知识竞赛。
- 题库练习：顺序练习、随机练习、错题练习。
- 公开查询：成绩、证书、报名结果查询。
AI 的模型服务地址、模型 ID 和 API Key 配置见：AI 智能创建。
5. 验证访问地址
localhost和127.0.0.1只能从运行 SurveyKing 的设备访问。192.168.x.x、10.x.x.x等局域网地址只能从同一网络访问。- 公网使用应配置云服务器、防火墙、域名和 HTTPS，不要把个人 Windows 电脑直接暴露到互联网。
发布第一个问卷前，使用实际填写者所在的手机或电脑测试一次链接和二维码。
6. 立即建立备份
用管理员账号进入 系统管理 → 系统设置 → 数据备份，导出第一份备份包并下载到另一台设备或外部存储。
至少在以下时间备份：
- 每次升级、迁移或导入备份前。
- 批量导入用户、题库或项目数据前。
- 正式使用后按天、周或月定期备份。
完整说明见：初始化、备份和升级。