ContiNew

环境与配置

汇总 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启用的 profiledev需设为 prod
DB_HOSTMySQL 主机127.0.0.1有回退,按需注入
DB_PORTMySQL 端口3306有回退
DB_USER数据库用户root有回退
DB_NAME数据库名continew_admin有回退
DB_PWD数据库密码123456必填,无默认值
REDIS_HOSTRedis 主机127.0.0.1有回退
REDIS_PORTRedis 端口6379有回退
REDIS_PWDRedis 密码123456必填,无默认值
REDIS_DBRedis 数据库索引0有回退
ACCESS_TOKEN_JWT_SECRETAccess Token 的 JWT 密钥dev 有固定示例值必填,无默认值
REFRESH_TOKEN_SECRETRefresh Token 签名密钥dev 有固定示例值必填,无默认值
FIELD_ENCRYPT_PASSWORD字段加密 AES 密钥dev 有示例值必填,无默认值
FIELD_ENCRYPT_PUBLIC_KEY字段加密 RSA 公钥dev 有示例密钥对必填,无默认值
FIELD_ENCRYPT_PRIVATE_KEY字段加密 RSA 私钥dev 有示例密钥对必填,无默认值
SCHEDULE_HOSTSnail Job 服务端主机127.0.0.1有回退
SCHEDULE_PORTSnail Job 服务端通讯端口17888有回退
SCHEDULE_USERNAMESnail Job OpenAPI 用户名admin有回退
SCHEDULE_PASSWORDSnail Job OpenAPI 密码dev 为 admin必填,无默认值
SCHEDULE_NAMESPACESnail Job 命名空间内置默认值有回退
SCHEDULE_GROUPSnail Job 接入组名continew-admin有回退
SCHEDULE_TOKENSnail Job 接入组 tokendev 有示例值启用任务调度时必填,无默认值
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.tomcatmax-http-form-post-size: -1(表单体不限)、threads.max: 256;max-connections、accept-count 保持 Spring Boot 默认
spring.servlet.multipartmax-file-size: 10MB、max-request-size: 20MB,与分片上传阈值 10MB 配套
springdoc / nextdoc4j接口文档路径 /v3/api-docs 与 /swagger-ui,NextDoc4j 增强开启
continew-starter.web.responsedefault-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.tenantisolation-level: LINE,租户头 X-Tenant-Id,默认租户 0
continew-starter.rate-limiter开启,key 前缀 RateLimiter
sa-tokentoken 名 Authorization,jwt-secret-key: ${ACCESS_TOKEN_JWT_SECRET},持久层 dao.type: REDIS
mybatis-plusid-type: ASSIGN_ID,逻辑删除字段 deleted(未删除 0,已删除取 id),ID 生成器 COSID
cosid雪花算法,epoch 1577203200000,开启时钟回拨同步;租户编码生成器前缀 T
continew-starter.refresh-tokencookie-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 差异

配置devprod
server.port800018000
application.urlhttp://localhost:5173https://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.enabledtruefalse
logging.level.top.continew.*DEBUGINFO
continew-starter.refresh-token.cookie-securefalsetrue,且 cookie 名改为 __Host-refresh_token
nextdoc4j.production关闭随 application.production 屏蔽接口文档
snail-job.enabledfalsetrue

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>),这些文件里不能放敏感信息。

变量作用developmentproduction
VITE_API_PREFIX接口前缀,dev 下由 Vite 代理转发;设置后优先于 VITE_API_BASE_URL/api不设置
VITE_API_BASE_URL后端接口地址:dev 是代理目标,prod 是浏览器直连的完整 URLhttp://localhost:8000https://api.continew.top
VITE_APP_PORTdev server 端口,vite build 与 vite preview 不读取51735173(构建不使用)
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

相关源码

目录