快速开始

环境要求

在开始之前，请确保你的服务器/开发环境满足以下要求：

依赖	最低版本	推荐版本
PHP	8.0+	8.2+
MySQL	5.7+	8.0+
Node.js	18+	20+（仅二次开发需要）
Composer	2.0+	最新版

安装部署

1. 获取源码

git clone https://github.com/yuandianxitong/ydadmin.git
cd ydadmin

2. 安装后端依赖

cd server
composer install

3. 配置 Web 服务器

将 Nginx / Apache 的站点根目录指向 server/public/。

Nginx 参考配置：

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/ydadmin/server/public;
    index index.php index.html;

    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php?s=/$1 last;
        }
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

4. 运行安装向导

浏览器访问：

http://your-domain.com/install/

安装向导会引导你完成：

1. 许可协议 — 阅读并同意开源协议
2. 环境检测 — 自动检测 PHP 版本、扩展和目录权限
3. 参数配置 — 填写数据库连接信息和管理员账号
4. 执行安装 — 自动创建数据表、导入初始数据、生成配置文件

5. 访问管理后台

安装完成后，管理后台已预编译在 server/public/admin/ 目录下，直接访问：

http://your-domain.com/admin/

使用安装时设置的管理员账号密码登录即可。

二次开发

如需修改前端管理界面，可在本地进行开发：

管理后台（admin）

cd admin
npm install
npm run dev          # 本地开发服务器（热更新）
npm run build        # 构建生产版本

构建产物默认输出到 server/public/admin/，上传至服务器覆盖即可生效。

移动端（UniApp）

cd uniapp
pnpm install
pnpm dev:h5          # H5 开发
pnpm dev:mp-weixin   # 微信小程序开发

使用 HBuilderX 打开 uniapp/ 目录也可以直接运行和调试。

默认账号

系统安装时会创建管理员账号（安装向导中设置），如果使用默认值：

角色	账号	密码
超级管理员	admin	安装时设置的密码

安全提示

请使用强密码，并在生产环境中定期更换。

访问地址

服务	地址
安装向导	http://your-domain.com/install/
管理后台	http://your-domain.com/admin/
后端 API	http://your-domain.com/adminapi/

安装完成后 /install/ 会自动跳转到管理后台，无需手动删除安装文件。

常见问题

Composer 安装失败

如果 composer install 失败，尝试：

# 更换为国内镜像
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 忽略平台要求（不推荐，仅用于排查问题）
composer install --ignore-platform-reqs

数据库连接失败

• 确认 MySQL 服务已启动
• 确认安装向导中填写的数据库信息正确
• 提前创建好数据库：CREATE DATABASE yd_admin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

前端开发启动报错

• 确认 Node.js 版本 >= 18
• 删除 node_modules 后重新安装：rm -rf node_modules && npm install
• 检查 vite.config.ts 中的 API 代理地址是否指向后端服务

端口被占用

# 前端开发时指定其他端口
npm run dev -- --port 3000