# admin-web

**Repository Path**: jiangzhanwei/admin-web

## Basic Information

- **Project Name**: admin-web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-17
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 前端启动文档

## 环境要求

- Node.js 20.19+ 或 22.12+
- npm 10 或更高版本
- 后端已在 `http://127.0.0.1:8080` 启动

## 安装并启动

```bash
cd admin-web
npm ci
npm run dev -- --host 127.0.0.1
```

浏览器访问 `http://localhost:5173`。系统不提供公共默认密码；请先按后端 README 使用一次性 `ADMIN_INITIAL_PASSWORD` 激活管理员。

开发服务器通过 Vite 代理把 `/api` 转发到本机后端。需要修改代理地址时，设置 `VITE_API_PROXY_TARGET`；需要把接口直接指向其他地址时，设置 `VITE_API_BASE_URL`。

```bash
VITE_API_PROXY_TARGET=http://127.0.0.1:8080 npm run dev -- --host 127.0.0.1
```

可用前端变量：

- `VITE_API_BASE_URL`：接口基础地址；开发时默认 `/api/v1`。
- `VITE_API_PROXY_TARGET`：Vite 开发代理目标；默认 `http://127.0.0.1:8080`。
- `VITE_APP_TITLE`：页面标题。

系统名称与 Logo 可在后台“系统管理 → 系统参数”中修改：

- `system.name`：登录页、侧边栏和浏览器标题显示的系统名称。
- `system.logo`：Logo 图片地址，支持 HTTPS 地址、站内绝对路径或常见图片 Data URL；留空时显示系统名称首字。

## 检查和构建

```bash
npm test
npm run lint
npm run build
```

构建产物位于 `dist/`。生产部署时由 HTTPS Web 服务器托管静态文件，将 `/api` 反向代理到后端，并为未命中的前端路由回退 `index.html`。Web 服务器应设置 HSTS、CSP、Referrer-Policy 和 Permissions-Policy；生产页面不会显示或预填开发管理员密码。

## 常见问题

- 页面能打开但接口失败：确认后端 `8080` 端口已启动，并核对 `VITE_API_PROXY_TARGET`。
- 登录后立即退出：检查浏览器 Cookie、后端 CORS 配置与两端系统时间。
- 端口占用：执行 `npm run dev -- --host 127.0.0.1 --port 5174` 使用其他端口，并把该地址加入后端 `CORS_ALLOWED_ORIGINS`。
- 修改环境变量未生效：停止并重新启动 Vite 开发服务器。