Appearance
环境配置
前端
团队默认值在 packages/manage/.env.development，个人覆盖写入同目录 .env.development.local。
| 变量 | 默认值 | 用途 |
|---|---|---|
VITE_PORT | 根启动入口传入 5602 | Vite 开发端口 |
VITE_API_PROXY_TARGET | 根启动入口传入 http://localhost:5600 | 开发代理目标 |
VITE_API_BASE_URL | 路径前缀或留空 | 禁止绝对 URL，维持同源认证 |
VITE_APP_TITLE | ALang Admin | 应用标题 |
后端
首次解析 wuli3 插件和依赖前，按 Gradle 本机私服配置 安装用户级初始化脚本及认证属性。 同时安装其中的 SNAPSHOT 更新检查脚本，使在线解析时检查插件与业务依赖的新快照。
默认激活 dev profile。现有开发连接地址以 service 中的 Spring 配置为准，建议显式覆盖本机变量。
| 变量 | 用途 |
|---|---|
JAVA_HOME | JDK 21 路径 |
SPRING_PROFILES_ACTIVE | dev / prod |
SERVER_PORT / ACTUATOR_PORT | HTTP 端口，根启动入口为 5600 / 5601 |
DB_HOST / DB_PORT / DB_NAME | MySQL 连接位置 |
DB_USERNAME / DB_PASSWORD | MySQL 凭据 |
REDIS_HOST / REDIS_PORT | Redis 连接位置 |
ROCKETMQ_NAME_SERVER / ROCKETMQ_PRODUCER_GROUP | 消息中间件 |
RONGCLOUD_* | IM 外部集成，按对应配置文件填写 |
JWT_SECRET / JWT_TTL | JWT 密钥与有效期 |
OPENAPI_ENABLED | 同时启停 Swagger UI 与 OpenAPI JSON，开发默认 true、生产默认 false；修改后重启 |
生产必须配置独立密钥并注入数据库等凭据。dev profile 中的固定验证码和示例密钥仅用于开发。 新增后端环境变量时同步检查根 turbo.json 的 passThroughEnv，确保经 Turbo 启动时可见。 Gradle 直接运行时使用当前 shell 的 JDK 与环境变量。
OSS 临时上传目录统一使用 temp；上线时为 bucket 的 temp/ 前缀设置 1 天过期删除规则， 具体步骤和验收见 部署指南。
dev profile 的阿里云凭据通过 ALIYUN_ACCESS_KEY_ID、ALIYUN_ACCESS_KEY_SECRET、 ALIYUN_STS_ACCESS_KEY_ID、ALIYUN_STS_ACCESS_KEY_SECRET 注入。 本机也可在 packages/service/alang-bootstrap/src/main/resources/application-dev-secrets.properties 配置对应的 wuli3.aliyun.profiles.default.access-key.* 和 wuli3.aliyun.sts.access-key.* 属性； 该文件已由 service Git 忽略，dev 配置会自动导入。不要提交填写后的凭据文件。
根入口与 Vue
端口约定由根脚本维护：service 5600、manage 5602、Vue 5604、文档开发 5609、文档预览 5619。直接在子包启动时仍使用上游默认值。 SERVER_PORT、VITE_*、RONGCLOUD_* 经 Turbo 透传；Vue 固定端口通过原 start:dev 的 CLI 参数传入。 Vue 保留 env/.env.dev 与 env/.env.prod，API 地址继续沿用上游环境。含凭据的测试环境文件不导入，按需使用本机 env/.env.test.local。