Appearance
环境变量
前端
| 包 | 变量 | 说明 | 文件 |
|---|---|---|---|
| web | VITE_API_BASE_URL | API 根地址 | .env.development |
| desktop | VITE_API_BASE_URL | RBAC 后端 | .env.development |
| desktop | VITE_DEVICE_AGENT_URL | 本地 Agent 地址，默认 http://127.0.0.1:19721 | .env.development |
| desktop（主进程） | DEVICE_AGENT_AUTO_START=true | 仪器设备场景：主进程自动拉起 C# Agent | Shell 环境变量 |
| desktop（主进程） | DEVICE_AGENT_PORT | Agent 监听端口，默认 19721 | Shell 环境变量 |
| mobile | VITE_API_BASE_URL | API 根地址；App 打包用 .env.production | .env.development / .env.production |
TIP
.env.example 仅为模板，不会被 Vite 加载。复制为 .env.development 或 .env.production 后生效。
mobile 读取逻辑：packages/mobile/src/config/index.ts → import.meta.env.VITE_API_BASE_URL，未设置时默认 http://localhost:8080（App 真机不可用 localhost）。
Java 后端（server-java 单体）
src/main/resources/application.yml + 环境变量。模块说明见 Java 概览。
| 变量 | 说明 |
|---|---|
| DB_HOST | MySQL 主机 |
| DB_PORT | 3306 |
| DB_NAME | xichen |
| DB_USER | 数据库用户 |
| DB_PASSWORD | 数据库密码 |
| JWT_SECRET | JWT 签名密钥 |
| CORS_ORIGINS | 允许的前端源，逗号分隔 |
| SERVER_PORT | 8080 |
| DB_INIT_ALLOW_WEB | 是否允许 POST /api/v1/system/database/init（生产建议 false） |
| UPLOAD_PATH | 文件上传目录，默认 ./uploads |
micro-java 微服务
各服务 application.yml + 环境变量（JWT_SECRET 须在 auth / system / monitor 保持一致）：
通用
| 变量 | 默认 | 说明 |
|---|---|---|
| NACOS_ADDR | localhost:8848 | 服务注册 |
| NACOS_NAMESPACE | public | 命名空间 |
| JWT_SECRET | 开发密钥 | 与单体版语义相同 |
| CORS_ORIGINS | localhost:5173,... | Gateway GatewayCorsConfig + 各业务服务 |
| DB_HOST / DB_PORT / DB_NAME / DB_USER / DB_PASSWORD | 同 MySQL | 数据库 |
各服务端口
| 变量 | auth | system | monitor | gateway |
|---|---|---|---|---|
| SERVER_PORT | 8081 | 8082 | 8083 | 8080 |
system-service 专用
| 变量 | 默认 | 说明 |
|---|---|---|
| SEATA_ENABLED | false | 启用 Seata 时设 true |
| SEATA_SERVER | localhost:8091 | Seata TC |
| MESSAGING_TYPE | rabbitmq | 改为 kafka 时使用 Kafka |
| RABBITMQ_HOST | localhost | |
| RABBITMQ_PORT | 5672 | |
| RABBITMQ_USER | xichen | |
| RABBITMQ_PASSWORD | xichen123 | |
| KAFKA_BOOTSTRAP | localhost:9092 | MESSAGING_TYPE=kafka 时 |
| DB_INIT_ALLOW_WEB | true | database init 开关 |
| UPLOAD_PATH | ./uploads | 文件上传目录 |
详见 micro-java 中间件、配置与环境。
Python 后端
packages/server-python/.env：
| 变量 | 说明 |
|---|---|
| DB_HOST | MySQL 主机 |
| DB_PORT | 3306 |
| DB_NAME | xichen |
| DB_USER | 数据库用户 |
| DB_PASSWORD | 密码（可含特殊字符） |
| JWT_SECRET | JWT 签名密钥 |
| JWT_ACCESS_TOKEN_EXPIRE_MINUTES | access 过期（分钟，默认 60） |
| JWT_REFRESH_TOKEN_EXPIRE_DAYS | refresh 过期（天，默认 7） |
| CORS_ORIGINS | 跨域 |
| SERVER_PORT | 8000（package.json dev 脚本固定 8000） |
| DB_INIT_ALLOW_WEB | 是否允许 POST /api/v1/system/database/init（生产建议 false） |
| UPLOAD_PATH | 文件上传目录（Docker 建议 /app/uploads） |
参考 packages/server-python/.env.example。
Electron 二进制镜像（系统环境变量）
pnpm 11 下须在 Shell / 系统环境 中设置（不要仅写在 .npmrc 指望 postinstall 生效）：
| 变量 | 说明 |
|---|---|
ELECTRON_MIRROR | Electron 运行时二进制，如 https://npmmirror.com/mirrors/electron/ |
ELECTRON_BUILDER_BINARIES_MIRROR | electron-builder 二进制 |
.npmrc 中的 registry=https://registry.npmmirror.com 只影响 npm 包下载，不包含 Electron 二进制。
npm / pnpm（.npmrc）
| 配置 | 说明 |
|---|---|
registry | npmmirror，加速 npm 包 |
| pnpm 11 | 非 registry/认证项建议迁到 pnpm-workspace.yaml，见 Monorepo |