终极部署指南：3步搞定卷王SurveyKing自托管问卷系统

终极部署指南：3步搞定卷王SurveyKing自托管问卷系统

【免费下载链接】SurveyKingOne command to deploy a more powerful, self‑hosted alternative to SurveyMonkey.项目地址: https://gitcode.com/gh_mirrors/su/SurveyKing

还在为商业问卷系统的高昂费用发愁吗？卷王SurveyKing来拯救你的钱包！这是一款功能强大的开源问卷系统，支持20多种题型、自动计算、复杂逻辑设置，还能私有化部署。今天，我将手把手教你如何在3步内完成卷王SurveyKing的完整部署，让你轻松拥有自己的问卷考试平台！

卷王SurveyKing是一款开源的问卷系统和考试系统，它支持20多种题型，包括填空、选择、下拉、级联、矩阵等，还具备强大的逻辑设置功能。最吸引人的是，它支持私有化部署，完全掌控数据安全，告别商业系统的限制和高昂费用。

🎯 部署前的“灵魂三问”

在开始部署之前，让我们先确认几个关键问题：

1. 环境准备好了吗？- 需要JDK 11+、Node.js 14+、MySQL 8.0+和Nginx 1.18+
2. 数据放在哪里？- 准备好MySQL数据库，创建名为surveyking的数据库
3. 域名和端口想好了吗？- 确定你的访问地址和端口配置

如果你已经点头如捣蒜，那么恭喜你，可以进入实战阶段了！

🚀 第一步：后端服务搭建（Java大佬的专属舞台）

后端是卷王SurveyKing的核心引擎，使用Spring Boot构建，性能杠杠的！

1.1 克隆源码获取“武功秘籍”

git clone https://gitcode.com/gh_mirrors/su/SurveyKing cd SurveyKing

1.2 数据库配置（连接数据库的“桥梁”）

打开配置文件server/api/src/main/resources/application-pro.yml，添加数据库连接信息：

spring: datasource: url: jdbc:mysql://localhost:3306/surveyking?useSSL=false&serverTimezone=UTC username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver

💡小贴士：记得把yourpassword换成你的真实数据库密码哦！

1.3 启动后端服务（见证奇迹的时刻）

进入server目录，使用Gradle构建并启动：

cd server ./gradlew bootJar java -jar api/build/libs/api-*.jar

看到类似下面的输出，就说明后端启动成功了：

Started SurveyServerApplication in 5.234 seconds (JVM running for 5.567)

🎨 第二步：前端界面部署（颜值担当的诞生）

前端是用户直接交互的界面，基于Vue.js构建，响应式设计，电脑手机都能完美适配！

2.1 环境配置（给前端“喂”点配置）

修改前端配置文件client/.env.production：

VUE_APP_API_BASE_URL=/api NODE_ENV=production

2.2 构建静态文件（打包成“外卖”）

进入client目录，安装依赖并构建：

cd client npm install npm run build

构建完成后，会在client/dist目录生成所有静态文件，这些就是我们的“前端外卖套餐”！

2.3 验证构建结果

检查dist目录是否包含以下关键文件：

• index.html（入口文件）
• static/js/*.js（JavaScript文件）
• static/css/*.css（样式文件）

🔗 第三步：Nginx反向代理配置（让前后端“牵手成功”）

这是最关键的一步，让Nginx作为“媒人”，把前后端完美连接起来！

3.1 创建Nginx配置文件

在/etc/nginx/conf.d/目录下创建surveyking.conf：

server { listen 80; server_name yourdomain.com; # 改成你的域名或IP # 前端静态资源服务 location / { root /path/to/SurveyKing/client/dist; index index.html; try_files $uri $uri/ /index.html; } # 后端API代理 location /api/ { proxy_pass http://127.0.0.1:1991/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }

3.2 测试并重启Nginx

nginx -t # 测试配置是否正确 systemctl restart nginx # 重启Nginx服务

3.3 访问验证

打开浏览器，访问http://yourdomain.com，你应该能看到卷王SurveyKing的登录界面：

默认管理员账号：admin，密码：123456

🎪 部署成功后的“炫技”时刻

恭喜你！现在你已经拥有了一个功能完整的问卷系统。让我们看看有哪些酷炫的功能：

4.1 创建你的第一个问卷

登录后点击"新建问卷"，选择模板或从零开始。卷王支持多种创建方式：

• 📝 在线编辑器编辑
• 📊 Excel导入问卷
• 📋 文本导入问卷

4.2 体验强大的逻辑设置

卷王的逻辑设置功能堪称一绝：

• 显示隐藏逻辑：根据答案动态显示或隐藏题目
• 值计算逻辑：自动计算BMI等复杂公式
• 跳转逻辑：根据答案跳转到不同题目
• 自定义校验：实现复杂的业务规则验证

4.3 数据统计与导出

收集到的数据可以：

• 📈 实时统计分析
• 📊 图形化展示（柱状图、饼图等）
• 📥 导出为Excel、PDF
• 🖨️ 直接打印

🚧 常见踩坑点与解决方案

问题1：跨域错误（CORS）

症状：前端无法调用后端API解决：在后端server/api/src/main/java/cn/surveyking/server/config/WebConfig.java中添加CORS配置

问题2：静态资源404

症状：页面能打开但样式丢失解决：检查Nginx配置中的root路径是否正确指向client/dist

问题3：数据库连接失败

症状：后端启动失败，连接数据库超时解决：

1. 确认MySQL服务已启动
2. 检查数据库用户名密码
3. 确认数据库名称为surveyking

问题4：端口被占用

症状：后端启动报端口占用错误解决：修改server/api/src/main/resources/application-pro.yml中的端口号

🚀 进阶技巧：二级目录部署

如果你的网站已经有其他应用，可以使用二级目录部署：

server { listen 80; server_name yourdomain.com; # 二级目录部署 location /surveyking/ { alias /path/to/SurveyKing/client/dist/; index index.html; try_files $uri $uri/ /surveyking/index.html; } location /surveyking/api/ { proxy_pass http://127.0.0.1:1991/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

这样卷王就可以通过http://yourdomain.com/surveyking访问了！

📦 Docker一键部署（懒人福音）

如果你觉得以上步骤太麻烦，卷王还提供了Docker一键部署：

docker run -p 1991:1991 surveyking/surveyking

是的，就这么简单！一行命令搞定所有！

🎯 部署完成后的下一步

1. 安全加固

• 🔐 修改默认管理员密码
• 🛡️ 配置HTTPS证书
• 👥 设置用户权限和角色

2. 性能优化

• ⚡ 配置数据库连接池
• 🚀 启用Nginx缓存
• 📊 监控系统性能

3. 功能探索

• 📱 体验移动端适配
• 🔄 测试问卷逻辑跳转
• 📤 尝试数据导出功能

📚 相关资源

• 官方文档：website/docs/installation.md
• 配置文件示例：server/api/src/main/resources/application-pro.yml
• 数据库脚本：scripts/database/
• 考试系统预览：docs/exam.jpg

🎉 总结

通过这三个步骤，你已经成功部署了卷王SurveyKing问卷系统！从后端服务搭建到前端界面部署，再到Nginx反向代理配置，每一步都清晰明了。

卷王SurveyKing不仅功能强大，而且部署灵活。无论是单机部署、Docker部署还是二级目录部署，都能轻松应对。更重要的是，它完全开源免费，数据完全掌握在自己手中！

现在，你可以开始创建问卷、组织考试、收集数据了。卷王SurveyKing将是你数据收集和分析的得力助手！

最后的小彩蛋：卷王还支持考试功能哦！试试创建一套在线考试，体验自动评分和成绩统计的便利吧！

祝你在问卷系统的世界里玩得开心！如果有任何问题，记得查看官方文档或者在社区寻求帮助哦！😊

【免费下载链接】SurveyKingOne command to deploy a more powerful, self‑hosted alternative to SurveyMonkey.项目地址: https://gitcode.com/gh_mirrors/su/SurveyKing