SurveyKing开源问卷系统部署配置教程：从零搭建企业级调查平台

SurveyKing开源问卷系统部署配置教程：从零搭建企业级调查平台

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

SurveyKing是一款功能强大的开源问卷系统，为企业提供完整的调查问卷解决方案。它支持高级表单设计、实时数据可视化、多终端适配和灵活的权限管理，是SurveyMonkey等商业产品的理想替代方案。本教程将带您从零开始，通过前后端分离架构部署SurveyKing系统，让您快速拥有一个专业的企业级调查平台。

部署流程概览

在开始详细部署之前，让我们先了解整个部署过程的逻辑顺序：

这个部署方案采用前后端分离架构，前端使用Vue.js构建，后端基于Spring Boot开发，通过Nginx实现统一访问入口，确保系统的高可用性和易维护性。

环境准备与系统要求

系统硬件要求

✅最低配置：2核CPU、4GB内存、20GB硬盘空间 ✅推荐配置：4核CPU、8GB内存、50GB硬盘空间

软件依赖安装

首先，我们需要安装所有必要的软件依赖：

1. Java开发环境

# 安装OpenJDK 11或更高版本 sudo apt-get update sudo apt-get install openjdk-11-jdk java -version # 验证安装

2. Node.js运行环境

# 安装Node.js 14+和npm curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - sudo apt-get install -y nodejs node --version npm --version

3. MySQL数据库

# 安装MySQL 8.0+ sudo apt-get install mysql-server sudo mysql_secure_installation # 安全配置

4. Nginx Web服务器

sudo apt-get install nginx nginx -v # 验证安装

权限与安全配置

在继续之前，请确保：

• 🔧 系统防火墙已开放80、8080端口
• 🔧 MySQL已创建专用用户和数据库
• 🔧 所有服务都配置为系统服务，确保开机自启

后端服务部署步骤

获取项目源码

首先克隆SurveyKing项目到本地：

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

项目结构清晰，主要包含三个核心模块：

• server/- 后端Java服务
• client/- 前端Vue.js应用
• website/- 官方文档站点

数据库配置与初始化

进入项目目录，找到数据库配置文件：

cd server/api/src/main/resources/

编辑application.yml文件，配置数据库连接信息：

spring: datasource: url: jdbc:mysql://localhost:3306/surveyking_db?useSSL=false&serverTimezone=Asia/Shanghai username: surveyking_user password: YourSecurePassword123 driver-class-name: com.mysql.cj.jdbc.Driver

重要参数说明：

• surveyking_db：数据库名称，建议使用有意义的名称
• surveyking_user：数据库专用用户，避免使用root账户
• useSSL=false：开发环境可关闭SSL，生产环境建议开启
• serverTimezone：设置为本地时区确保时间正确

创建数据库和用户：

CREATE DATABASE surveyking_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'surveyking_user'@'localhost' IDENTIFIED BY 'YourSecurePassword123'; GRANT ALL PRIVILEGES ON surveyking_db.* TO 'surveyking_user'@'localhost'; FLUSH PRIVILEGES;

后端服务构建与启动

SurveyKing使用Gradle作为构建工具，构建过程简单：

# 进入后端目录 cd ../../../../.. # 返回项目根目录 cd server # 清理并构建项目 ./gradlew clean bootJar # 启动服务（开发环境） java -jar api/build/libs/api-*.jar --server.port=8080

生产环境启动建议：

# 创建systemd服务文件，确保服务稳定运行 sudo nano /etc/systemd/system/surveyking.service

服务文件内容示例：

[Unit] Description=SurveyKing Backend Service After=network.target mysql.service [Service] User=surveyking WorkingDirectory=/opt/SurveyKing/server ExecStart=/usr/bin/java -jar api/build/libs/api-*.jar SuccessExitStatus=143 TimeoutStopSec=10 Restart=on-failure RestartSec=5 [Install] WantedBy=multi-user.target

启动并启用服务：

sudo systemctl daemon-reload sudo systemctl start surveyking sudo systemctl enable surveyking sudo systemctl status surveyking # 检查服务状态

要点总结：

• 后端服务默认运行在8080端口
• 使用systemd管理确保服务稳定性
• 建议使用专用系统用户运行服务
• 定期检查日志文件/var/log/surveyking.log

前端应用部署配置

前端环境配置

进入前端项目目录：

cd ../client

编辑环境配置文件.env.production：

NODE_ENV=production VUE_APP_API_BASE_URL=/surveyking/api VUE_APP_TITLE=SurveyKing问卷系统 VUE_APP_DESCRIPTION=专业的企业级问卷解决方案

配置说明：

• VUE_APP_API_BASE_URL：API接口前缀，与Nginx配置对应
• 生产环境必须设置NODE_ENV=production
• 可自定义系统标题和描述信息

依赖安装与构建

# 安装项目依赖（使用国内镜像加速） npm config set registry https://registry.npmmirror.com npm install # 构建生产版本 npm run build

构建完成后，静态文件将生成在dist/目录中。检查构建结果：

ls -la dist/ # 应包含index.html和assets等目录

前端部署优化

对于生产环境，我们建议进行以下优化：

1. 启用Gzip压缩：

# 安装compression-webpack-plugin npm install compression-webpack-plugin --save-dev

2. 配置CDN加速（可选）： 在vue.config.js中配置外部CDN资源，减少服务器压力。

3. 静态资源版本控制： 确保浏览器缓存策略正确，避免更新后客户端仍使用旧版本。

Nginx集成与二级目录配置

Nginx主配置

现在配置Nginx作为反向代理服务器，实现前后端统一访问入口：

# /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/surveyking.conf server { listen 80; server_name your-domain.com; # 替换为您的域名 root /var/www/html; # 启用gzip压缩 gzip on; gzip_vary on; gzip_min_length 1024; gzip_types text/plain text/css application/json application/javascript text/xml; # SurveyKing前端应用 location /surveyking/ { alias /path/to/SurveyKing/client/dist/; index index.html; try_files $uri $uri/ /surveyking/index.html; # 缓存策略 expires 1y; add_header Cache-Control "public, immutable"; } # 静态资源单独处理 location /surveyking/assets/ { alias /path/to/SurveyKing/client/dist/assets/; expires 1y; add_header Cache-Control "public, immutable"; } # 后端API代理 location /surveyking/api/ { proxy_pass http://127.0.0.1:8080/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; proxy_set_header X-Forwarded-Proto $scheme; # 超时设置 proxy_connect_timeout 60s; proxy_send_timeout 60s; proxy_read_timeout 60s; } # 健康检查端点 location /surveyking/health { proxy_pass http://127.0.0.1:8080/actuator/health; access_log off; } }

配置详解与优化

二级目录优势：

• ✅ 可在同一域名下部署多个应用
• ✅ 避免端口冲突问题
• ✅ 便于统一SSL证书管理
• ✅ 简化域名解析配置

关键配置说明：

1. try_files $uri $uri/ /surveyking/index.html：处理Vue路由的history模式
2. expires 1y：静态资源长期缓存，提升加载速度
3. proxy_*_timeout：适当调整超时时间，避免请求中断

应用配置并重启

# 测试Nginx配置语法 sudo nginx -t # 重新加载配置 sudo systemctl reload nginx # 查看Nginx状态 sudo systemctl status nginx

安全加固建议：

1. 配置防火墙只允许必要端口
2. 启用HTTPS（使用Let's Encrypt免费证书）
3. 限制API访问频率，防止滥用
4. 定期更新Nginx和系统安全补丁

图1：SurveyKing系统管理界面 - 管理员可在此配置系统名称、安全策略和外观设置

系统验证与功能测试

基本访问测试

部署完成后，通过以下步骤验证系统是否正常运行：

1. 访问前端应用： 打开浏览器访问http://your-domain.com/surveyking应看到SurveyKing的登录界面

2. API接口测试：

   curl http://your-domain.com/surveyking/api/health # 应返回{"status":"UP"}等健康状态信息

3. 数据库连接验证： 登录MySQL检查数据表是否创建成功：

   USE surveyking_db; SHOW TABLES; # 应看到user、project、answer等核心表

功能完整性测试

完成基本访问测试后，进行核心功能验证：

1. 用户注册与登录

• 测试管理员账户登录
• 验证普通用户注册流程
• 检查权限控制是否正常

2. 问卷创建与编辑

• 创建新问卷项目
• 测试各种题型（单选、多选、填空、矩阵等）
• 验证富文本编辑功能

图2：SurveyKing问卷编辑器 - 可视化拖拽设计界面，支持多种题型和布局配置

3. 问卷发布与数据收集

• 配置问卷访问权限
• 生成问卷链接和二维码
• 模拟用户填写提交

4. 数据统计与分析

• 查看实时数据报表
• 测试图表可视化功能
• 验证数据导出功能

图3：SurveyKing数据报表界面 - 实时数据统计与可视化分析，支持多种图表类型

性能压力测试

对于生产环境，建议进行简单的性能测试：

# 使用ab进行并发测试 ab -n 1000 -c 50 http://your-domain.com/surveyking/ # 监控系统资源使用 top -p $(pgrep java) # 监控Java进程 nginx -s reload # 检查Nginx配置加载

性能指标参考：

• ✅ 页面加载时间：< 3秒
• ✅ API响应时间：< 500ms
• ✅ 并发用户数：支持50+同时在线
• ✅ 内存使用：稳定在合理范围

常见问题排查指南

部署问题分类解决

1. 服务启动失败

问题现象：Java服务无法启动或立即退出

排查步骤：

# 查看服务日志 sudo journalctl -u surveyking -f # 检查端口占用 sudo netstat -tlnp | grep :8080 # 验证Java环境 java -version echo $JAVA_HOME

常见原因：

• 端口被占用：修改application.yml中的端口配置
• 内存不足：调整JVM参数-Xmx512m -Xms256m
• 数据库连接失败：检查MySQL服务状态和连接参数

2. 前端访问404错误

问题现象：能访问首页但路由跳转后显示404

解决方案： 确保Nginx配置中包含正确的try_files指令：

location /surveyking/ { try_files $uri $uri/ /surveyking/index.html; }

3. API接口跨域问题

问题现象：前端控制台显示CORS错误

解决方案： 在后端WebConfig.java中添加CORS配置：

@Bean public WebMvcConfigurer corsConfigurer() { return new WebMvcConfigurer() { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/api/**") .allowedOrigins("http://your-domain.com") .allowedMethods("*") .allowCredentials(true); } }; }

4. 静态资源加载缓慢

问题现象：页面加载时间长，资源请求慢

优化建议：

1. 启用Nginx的gzip压缩
2. 配置浏览器缓存策略
3. 使用CDN加速静态资源
4. 优化图片大小和格式

日志分析与监控

建立有效的监控体系：

1. 应用日志：

   # 查看实时日志 tail -f /var/log/surveyking/application.log # 错误日志筛选 grep -i error /var/log/surveyking/application.log

2. 系统监控：

   # 监控系统资源 htop # 监控网络连接 ss -tulpn

3. 数据库监控：

   -- 查看连接数 SHOW PROCESSLIST; -- 查看慢查询 SHOW VARIABLES LIKE 'slow_query%';

进阶优化与生产建议

安全加固配置

1. HTTPS加密传输

使用Let's Encrypt免费SSL证书：

# 安装Certbot sudo apt-get install certbot python3-certbot-nginx # 获取并安装证书 sudo certbot --nginx -d your-domain.com

更新Nginx配置启用HTTPS：

server { listen 443 ssl http2; ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem; # 强制HTTP跳转HTTPS if ($scheme != "https") { return 301 https://$host$request_uri; } }

2. 访问控制与限流

# 限制API访问频率 limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s; location /surveyking/api/ { limit_req zone=api burst=20 nodelay; # ... 其他配置 } # 阻止敏感文件访问 location ~* \.(env|log|sql)$ { deny all; }

性能优化策略

1. 数据库优化

-- 创建索引优化查询 CREATE INDEX idx_answer_project_id ON answer(project_id); CREATE INDEX idx_answer_create_time ON answer(create_time); -- 定期优化表 OPTIMIZE TABLE answer, project, user;

2. 缓存配置

在后端启用Redis缓存：

# application.yml中添加 spring: cache: type: redis redis: host: localhost port: 6379

3. 负载均衡配置（多实例部署）

upstream surveyking_backend { server 127.0.0.1:8080 weight=3; server 127.0.0.1:8081 weight=2; server 127.0.0.1:8082 weight=2; keepalive 32; }

备份与恢复策略

1. 数据库定期备份

创建备份脚本/opt/backup/surveyking_backup.sh：

#!/bin/bash BACKUP_DIR="/opt/backup/data" DATE=$(date +%Y%m%d_%H%M%S) DB_NAME="surveyking_db" # 备份数据库 mysqldump -u surveyking_user -pYourSecurePassword123 $DB_NAME > $BACKUP_DIR/${DB_NAME}_${DATE}.sql # 压缩备份文件 gzip $BACKUP_DIR/${DB_NAME}_${DATE}.sql # 保留最近7天备份 find $BACKUP_DIR -name "*.sql.gz" -mtime +7 -delete

添加到crontab自动执行：

0 2 * * * /opt/backup/surveyking_backup.sh

2. 配置文件备份

# 备份重要配置文件 cp -r /etc/nginx/conf.d/ /opt/backup/nginx_config_$(date +%Y%m%d) cp /etc/systemd/system/surveyking.service /opt/backup/

监控与告警

1. 健康检查端点

SurveyKing提供了健康检查端点：

• /actuator/health- 应用健康状态
• /actuator/metrics- 性能指标
• /actuator/info- 应用信息

2. 基础监控配置

使用Prometheus + Grafana建立监控面板：

# Prometheus配置 scrape_configs: - job_name: 'surveyking' metrics_path: '/actuator/prometheus' static_configs: - targets: ['localhost:8080']

图4：SurveyKing问卷设置界面 - 详细的问卷发布与回收策略配置，支持多种访问控制选项

总结与后续维护

部署成功验证清单

完成所有部署步骤后，请核对以下清单：

• 前端应用可通过http://your-domain.com/surveyking访问
• 后端API接口/surveyking/api/health返回健康状态
• 管理员账户可以正常登录系统
• 问卷创建、编辑、发布功能正常
• 数据收集和报表功能正常
• HTTPS加密访问正常（如果配置）
• 定时备份任务正常运行
• 监控告警配置生效

日常维护建议

1. 定期更新：

   • 关注项目更新，及时升级到新版本
   • 定期更新系统安全补丁
   • 备份后再进行重要更新

2. 性能监控：

   • 每日检查系统日志
   • 监控磁盘空间和内存使用
   • 定期分析慢查询日志

3. 数据管理：

   • 定期清理过期问卷数据
   • 归档历史数据释放空间
   • 验证备份文件的完整性

扩展功能建议

SurveyKing支持丰富的扩展功能，您可以根据需要启用：

1. 邮件通知：配置SMTP服务器，启用问卷提交邮件通知
2. 第三方登录：集成微信、钉钉等第三方登录方式
3. 自定义主题：根据企业品牌定制界面样式
4. API集成：通过REST API与其他系统集成

获取帮助与支持

如果在部署过程中遇到问题，可以通过以下方式获取帮助：

1. 查看官方文档：项目根目录下的website/docs/包含详细文档
2. 检查日志文件：应用日志通常包含详细的错误信息
3. 社区支持：访问项目社区获取其他用户的经验分享
4. 问题反馈：在项目仓库提交详细的问题描述

通过本教程，您已经成功部署了功能完整的SurveyKing问卷系统。这个开源解决方案不仅提供了强大的问卷功能，还具备良好的扩展性和维护性。我们建议您根据实际业务需求，进一步探索系统的各项高级功能，如工作流审批、数据导出定制、多语言支持等。

小贴士：在生产环境运行一段时间后，建议根据实际使用情况调整JVM内存参数和数据库连接池配置，以获得最佳性能表现。定期检查系统更新，及时应用安全补丁，确保系统长期稳定运行。

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