环境与配置
汇总 ContiNew Admin 后端环境变量、profile 差异与前端 .env 配置项,供部署与本地开发时逐项对照。
ContiNew Admin 的配置分两侧。后端在 continew-server/src/main/resources/config/ 下按 profile 拆分 YAML,前端在 continew-ui/ 目录按 .env.<mode> 拆分环境变量。本页把两侧需要注入的变量和关键配置块列全,默认值与源码保持一致。各配置块的语义讲解见 配置说明,本页只做对照参考。
后端配置
配置文件组织
application.yml 放环境无关的通用配置,application-dev.yml 与 application-prod.yml 放环境差异配置。启用的 profile 由 spring.profiles.active 决定,默认经环境变量 PROFILES_ACTIVE 注入,未设置时回退到 dev。
spring:
profiles:
active: ${PROFILES_ACTIVE:dev}端口不写死在通用配置里。dev 为 8000,prod 为 18000。
环境变量
dev 环境的必需变量都有默认值,不注入也能启动。prod 环境的核心凭据没有默认值,缺失即启动失败;可选能力(第三方登录)默认关闭,只在开启后要求对应平台凭据。
| 变量 | 作用 | dev 默认值 | prod |
|---|---|---|---|
PROFILES_ACTIVE | 启用的 profile | dev | 需设为 prod |
DB_HOST | MySQL 主机 | 127.0.0.1 | 有回退,按需注入 |
DB_PORT | MySQL 端口 | 3306 | 有回退 |
DB_USER | 数据库用户 | root | 有回退 |
DB_NAME | 数据库名 | continew_admin | 有回退 |
DB_PWD | 数据库密码 | 123456 | 必填,无默认值 |
REDIS_HOST | Redis 主机 | 127.0.0.1 | 有回退 |
REDIS_PORT | Redis 端口 | 6379 | 有回退 |
REDIS_PWD | Redis 密码 | 123456 | 必填,无默认值 |
REDIS_DB | Redis 数据库索引 | 0 | 有回退 |
ACCESS_TOKEN_JWT_SECRET | Access Token 的 JWT 密钥 | dev 有固定示例值 | 必填,无默认值 |
REFRESH_TOKEN_SECRET | Refresh Token 签名密钥 | dev 有固定示例值 | 必填,无默认值 |
FIELD_ENCRYPT_PASSWORD | 字段加密 AES 密钥 | dev 有示例值 | 必填,无默认值 |
FIELD_ENCRYPT_PUBLIC_KEY | 字段加密 RSA 公钥 | dev 有示例密钥对 | 必填,无默认值 |
FIELD_ENCRYPT_PRIVATE_KEY | 字段加密 RSA 私钥 | dev 有示例密钥对 | 必填,无默认值 |
SCHEDULE_HOST | Snail Job 服务端主机 | 127.0.0.1 | 有回退 |
SCHEDULE_PORT | Snail Job 服务端通讯端口 | 17888 | 有回退 |
SCHEDULE_USERNAME | Snail Job OpenAPI 用户名 | admin | 有回退 |
SCHEDULE_PASSWORD | Snail Job OpenAPI 密码 | dev 为 admin | 必填,无默认值 |
SCHEDULE_NAMESPACE | Snail Job 命名空间 | 内置默认值 | 有回退 |
SCHEDULE_GROUP | Snail Job 接入组名 | continew-admin | 有回退 |
SCHEDULE_TOKEN | Snail Job 接入组 token | dev 有示例值 | 启用任务调度时必填,无默认值 |
JUSTAUTH_ENABLED | 是否启用第三方登录 | dev 为 true,prod 为 false | 默认 false |
JUSTAUTH_<平台>_CLIENT_ID | 第三方平台 Client ID | 空 | 启用该平台时必填 |
JUSTAUTH_<平台>_SECRET | 第三方平台 Client Secret | 空 | 启用该平台时必填 |
REFRESH_TOKEN_SECRET 必须是独立的高熵随机值,禁止与 ACCESS_TOKEN_JWT_SECRET 复用。dev 配置里的示例密钥只用于本地联调,生产环境必须全部替换。
通用配置块速查
以下配置块定义在 application.yml,两个环境共用。配置项本身的语义属于 ContiNew Starter,完整定义见 ContiNew Starter 文档;这里列的是 admin 填的值。
| 配置块 | 关键值 |
|---|---|
server.tomcat | max-http-form-post-size: -1(表单体不限)、threads.max: 256;max-connections、accept-count 保持 Spring Boot 默认 |
spring.servlet.multipart | max-file-size: 10MB、max-request-size: 20MB,与分片上传阈值 10MB 配套 |
springdoc / nextdoc4j | 接口文档路径 /v3/api-docs 与 /swagger-ui,NextDoc4j 增强开启 |
continew-starter.web.response | default-success-code: 0、default-error-code: 1,响应类 top.continew.starter.web.model.R |
continew-starter.log | 记录请求/响应头、请求/响应体、IP、浏览器、OS 等 |
continew-starter.trace | 链路头 X-Trace-Id,日志经 Micrometer Tracing 的 MDC traceId 输出 |
continew-starter.tenant | isolation-level: LINE,租户头 X-Tenant-Id,默认租户 0 |
continew-starter.rate-limiter | 开启,key 前缀 RateLimiter |
sa-token | token 名 Authorization,jwt-secret-key: ${ACCESS_TOKEN_JWT_SECRET},持久层 dao.type: REDIS |
mybatis-plus | id-type: ASSIGN_ID,逻辑删除字段 deleted(未删除 0,已删除取 id),ID 生成器 COSID |
cosid | 雪花算法,epoch 1577203200000,开启时钟回拨同步;租户编码生成器前缀 T |
continew-starter.refresh-token | cookie-name: refresh_token、cookie-path: /、cookie-secure: false、cookie-same-site: Lax |
auth.password.excludes | 密码过期拦截与闲置失效判定共用的自助通道路径:/auth/user/route、/auth/user/info、/auth/logout、/user/profile/password;增删路径时两类判定同时生效 |
auth.online.presence-window | 在线用户页面的「在线」判定窗口,默认 5m;只影响展示与筛选,不参与会话失效 |
Sa-Token 的 timeout、active-timeout 等参数不在 YAML 里维护,改由「系统管理 → 系统配置 → 客户端配置」页面按客户端动态管理,application.yml 中对应配置已注释。
profile 差异
| 配置 | dev | prod |
|---|---|---|
server.port | 8000 | 18000 |
application.url | http://localhost:5173 | https://admin.continew.top |
| 数据源驱动 | com.p6spy.engine.spy.P6SpyDriver(SQL 日志) | com.mysql.cj.jdbc.Driver |
continew-starter.web.cors.allowed-origins | * | 仅 ${application.url} |
continew-starter.log.access-log.enabled | true | false |
logging.level.top.continew.* | DEBUG | INFO |
continew-starter.refresh-token.cookie-secure | false | true,且 cookie 名改为 __Host-refresh_token |
nextdoc4j.production | 关闭 | 随 application.production 屏蔽接口文档 |
snail-job.enabled | false | true |
Snail Job 配置
任务调度默认在 dev 关闭、prod 开启,开关是 snail-job.enabled。客户端连服务端的通讯端口、OpenAPI 地址、命名空间、接入组 token 都走 SCHEDULE_* 环境变量,见上表。关闭时调度相关接口由一个兜底 Controller 返回未启用提示。
前端配置
环境变量文件
前端用 Vite 的 mode 机制,continew-ui/ 目录放 .env.development 与 .env.production 两份文件,分别对应 pnpm dev 与 pnpm build。以 VITE_ 开头的变量会暴露给客户端代码(import.meta.env.<KEY>),这些文件里不能放敏感信息。
| 变量 | 作用 | development | production |
|---|---|---|---|
VITE_API_PREFIX | 接口前缀,dev 下由 Vite 代理转发;设置后优先于 VITE_API_BASE_URL | /api | 不设置 |
VITE_API_BASE_URL | 后端接口地址:dev 是代理目标,prod 是浏览器直连的完整 URL | http://localhost:8000 | https://api.continew.top |
VITE_APP_PORT | dev server 端口,vite build 与 vite preview 不读取 | 5173 | 5173(构建不使用) |
VITE_CLIENT_ID | 登录时上报的客户端 ID,对应后端「客户端配置」 | ef51c9a3e9046c4f2ea45142c8a8344a | 同左 |
VITE_APP_RSA_PUBLIC_KEY | 登录密码 RSA 加密公钥,须与后端 FIELD_ENCRYPT_PUBLIC_KEY 同密钥对 | 内置与后端 dev 配对的示例公钥 | 同左,生产换密钥对时构建前替换 |
VITE_BASE_PATH | 部署子路径 base(如 /admin/),缺省 / | 不设置 | 不设置 |
变量在代码里的落点
VITE_API_PREFIX 与 VITE_API_BASE_URL 决定 HTTP 封装的请求基址(continew-ui/src/lib/http.ts):VITE_API_PREFIX 优先,未设置时回退 VITE_API_BASE_URL。dev 由 vite.config.ts 的 server.proxy 把前缀代理到 VITE_API_BASE_URL 并去掉前缀;生产构建没有代理,.env.production 不设 VITE_API_PREFIX,请求按完整 URL 直连后端域名。VITE_CLIENT_ID 在 continew-ui/src/stores/auth/auth-store.ts 的登录与第三方登录请求里作为 clientId 上报。
VITE_CLIENT_ID 必须与后端「系统管理 → 系统配置 → 客户端配置」里某条客户端记录的 ID 一致,否则登录时会匹配不到客户端策略。默认值对应初始脚本里的 PC 端配置。
从 2.x 升级到 3.0.0
清空 Redis 存量键
升级前必须清空(FLUSHDB)Redis 存量键,或等待其自然过期。3.0.0 把 L2 缓存与 Sa-Token 会话的 JSON 编码从 Jackson 2 迁到 Jackson 3,两者对 Long 等类型的编码不兼容(Jackson 2 的 WRAPPER_ARRAY 是主因),存量键在新版本下反序列化失败,表现为缓存命中接口报错、会话状态异常。清库后所有用户需重新登录。
链路采样率
Spring Boot 4 的 Micrometer Tracing 默认采样率为 management.tracing.sampling.probability=0.1(十采一)。默认值下多数请求的日志不带 traceId,生产排障需要全采样时显式配置:
management:
tracing:
sampling:
probability: 1.0