# 安装与访问说明

## 推荐方式：上传解压直接使用

这套前端现在默认支持“零配置部署”。

你只需要：

1. 把整套源码上传到站点根目录。
2. 不修改网站运行目录。
3. 不配置伪静态。
4. 直接访问域名，进入安装页。

这种方式最适合新手用户。

## 零配置模式下的访问规则

安装完成后：

- 首页 / 登录页：`https://你的域名/`
- 后台首页：`https://你的域名/index.php?r=dashboard`
- 系统设置：`https://你的域名/index.php?r=admin/system`
- API：`https://你的域名/index.php?r=api/v1/ping`

也就是说：

- 页面和接口都可以正常用
- 只是地址会带 `index.php?r=`

## 进阶方式：美化地址

如果你想把地址改成：

- `/login`
- `/dashboard`
- `/api/v1/ping`

那就需要手动做两步：

1. 网站目录指向 `public`
2. 配置伪静态

这不是必须项，只是为了让地址更短更好看。

## Nginx 伪静态规则

如果你启用美化地址模式，可使用：

```nginx
location / {
    try_files $uri $uri/ /index.php?$query_string;
}
```

## Apache

如果网站目录已经指向 `public`，通常直接使用项目内自带的 `.htaccess` 即可。

## 建议

如果你的用户主要是新手，建议默认使用零配置模式：

- 部署最简单
- 不容易配错
- 上传解压即可安装
- 不影响后台、查卡、接口、在线更新
