快速开始#

欢迎使用 XinAdmin！本指南将指导您完成最基本的安装、配置，并在不到 10 分钟内成功部署您的第一个项目。

系统要求#

在安装之前，请确保您的系统符合以下要求：

后端要求#

前端要求#

后端安装#

1. 克隆项目#

git clone https://github.com/xin-admin/xin-admin-laravel.git
cd xin-admin-laravel

2. 安装依赖#

composer install

3. 环境文件配置#

cp .env.example .env

然后根据您的数据库配置修改 .env 文件：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=xinadmin
DB_USERNAME=root
DB_PASSWORD=

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

4. 生成 APP_KEY#

php artisan key:generate

5. 执行数据库迁移#

php artisan migrate --graceful

6. 初始化数据#

php artisan db:seed

7. 启动开发服务器#

php artisan serve

后端服务器将在 http://127.0.0.1:8000 运行。

前端安装#

1. 克隆项目#

git clone https://github.com/xin-admin/xin-admin-ui.git
cd xin-admin-ui

2. 安装依赖#

pnpm install

3. 配置 API 基础 URL#

创建 .env.development 文件：

VITE_BASE_URL=http://127.0.0.1:8000

4. 启动开发服务器#

pnpm run dev

前端开发服务器将在 http://127.0.0.1:3000 运行。

首次登录#

程序启动成功！现在打开浏览器访问：

前端地址: http://127.0.0.1:3000/login

使用以下凭证登录：

常见问题#

Q: Composer 安装失败#

正常情况下安装失败会有以下几种原因：

1.网络问题，网络连接不稳定或防火墙/代理服务器阻止访问，建议使用国内镜像源加速安装。

2.缺少PHP扩展,确保系统信任存储库的SSL证书，并检查是否缺少Composer所需的PHP扩展。