# 配置文件位置与加载方式

**对外域名：** https://yuheng.yuxindazhineng.com（官网 /admin 管理后台 /api 接口均同域，由 Nginx Proxy Manager 反向代理）

---

## 一、后端（API 服务）— 启动时自动读取

**配置文件：** 仅 **server/.env** 一个文件。需要改配置时直接编辑该文件即可。

- 在 `server` 目录下启动时，加载 `server/.env`
- 在项目根目录启动时，加载 `server/.env`

**变量说明：** 见 `server/.env.example`（仅作参考，可不保留）。

---

## 二、前台（官网）— 构建时注入

**配置文件位置：**

| 环境 | 路径 | 说明 |
|------|------|------|
| 生产 | **web/.env.production** | 执行 `npm run build` 时注入 |
| 示例 | web/.env.example | 复制为 .env 或 .env.production 后修改 |

变量需以 `VITE_` 开头才会被打包进前端，如：`VITE_APP_DOMAIN`、`VITE_API_BASE`。

---

## 三、后台（管理端）— 构建时注入

**配置文件位置：**

| 环境 | 路径 | 说明 |
|------|------|------|
| 生产 | **admin/.env.production** | 执行 `npm run build` 时注入 |
| 示例 | admin/.env.example | 复制为 .env 或 .env.production 后修改 |

变量需以 `VITE_` 开头，如：`VITE_APP_DOMAIN`、`VITE_API_BASE`。

---

## 四、汇总表

| 端 | 配置文件 | 自动读取时机 |
|----|----------|--------------|
| 后端 | **server/.env** | **进程启动时**自动加载 |
| 前台 | **web/**（.env.production） | 执行 `npm run build` 时注入 |
| 后台 | **admin/**（.env.production） | 执行 `npm run build` 时注入 |
