配置索引
本章节汇总 SurveyKing Pro MySQL、Redis、MQ、文件存储 等运行时配置,帮助运维与开发快速完成环境部署。
📖 目录
文档 | 作用 |
---|---|
环境变量总览 | 完整列举 Spring Boot application*.yml 中所有可配置项,含默认值与说明 |
数据库配置(计划中) | MySQL 8 连接池、读写分离、备份策略 |
Redis & 消息队列(计划中) | Redis 缓存、Redisson 分布式锁、Stream 队列 |
对象存储(计划中) | MinIO / 阿里 OSS 配置示例 |
第三方集成(计划中) | 邮件、短信、OAuth2 社交登录配置 |
若某篇文档显示"计划中",说明功能已支持,文档仍在编写;可参考
server
源码或联系维护者。
⚡ 快速开始
- 克隆代码并启动 MySQL 8 & Redis(可用
docker-compose
):
docker compose up -d mysql redis
- 初始化数据库:
mysql -h127.0.0.1 -uroot -p < scripts/init-mysql.sql
- 修改本地配置:在
server/surveyking-server/src/main/resources/
新建/修改application-dev.yml
:
spring:
datasource:
url: jdbc:mysql://localhost:3306/surveyking?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
username: root
password: surveyking
redis:
host: localhost
port: 6379
surveyking:
file:
local-path: ./files
- 启动后端:
./mvnw -pl server/surveyking-server -am spring-boot:run
- 访问 Swagger: 本地 Swagger
前端请参见 client/README.md
或直接执行:
cd client && pnpm install && pnpm dev
🗺️ 配置文件层级
server/
└── surveyking-server/
└── src/main/resources/
├── application.yml # 公共默认配置
├── application-dev.yml # 开发环境专属
├── application-test.yml # 测试环境专属
└── application-prod.yml # 生产环境专属
Spring Boot 将按照 --spring.profiles.active
读取对应文件并 覆盖 application.yml
中同名属性。
🔑 常用变量速查
键 | 默认 | 说明 |
---|---|---|
spring.datasource.url | jdbc:mysql://localhost:3306/surveyking | MySQL 连接串 |
spring.redis.host | localhost | Redis 主机 |
server.port | 48080 | 服务端口 |
surveyking.file.local-path | ./files | 本地上传文件存放目录 |
完整列表请见 环境变量总览。
如有配置疑问,欢迎在 GitHub Issue 或企业微信交流群提问。