PHPackages                             xqkeji/fast-admin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. xqkeji/fast-admin

ActiveProject

xqkeji/fast-admin
=================

一个基于新齐低代码开发框架的后台管理系统，包含xq-app-admin后台管理模块，并可根据需要安装其他后台管理模块。

1.1.1(4mo ago)0111SSPL-1.0PHP

Since Jun 17Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/xqkeji/fast-admin)[ Packagist](https://packagist.org/packages/xqkeji/fast-admin)[ RSS](/packages/xqkeji-fast-admin/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (46)Used By (0)

fast-admin
==========

[](#fast-admin)

一个基于新齐低代码开发框架(xqkeji)的后台管理系统，默认只安装xq-app-admin模块，该模块主要用于系统管理，包括管理员管理、角色管理、修改密码、退出登录、系统配置等基本功能。

运行环境
----

[](#运行环境)

该项目需要新齐低代码开发框架(xqkeji)的运行环境，目前只提供docker方式的运行环境。

在window系统中，可以运行在wsl(window系统的Linux子系统)环境下。

### 检查CPU是否开启虚拟化技术

[](#检查cpu是否开启虚拟化技术)

在Window打开“任务管理器”，然后点击“性能选项卡”，再点击进入“CPU”详细页。 在CPU的信息中，有显示“虚拟化：已启用”说明CPU有开启虚拟化技术。 如果没有开启，需要重启电脑进入主板的BIOS管理程序，启用CPU的虚拟机技术。

### 开启WSL功能

[](#开启wsl功能)

右键任务栏的“开始”图标，进入“系统信息”选项页，回退到“系统”页，再点击进入“可选功能”页，然后滚动到页面底部，见到“相关设置”后，点击“更多Window功能”。 点击开启“适用于Linux的Windows子系统”选项和“虚拟机平台”再点击“确定”，系统重启后，就开启了WSL的功能。

### 检查WSL

[](#检查wsl)

为了避免不必要的错误，建议使用前先升级wsl,打开一个命令行窗口，并输入命令：

```
wsl --update
```

更新完成后，可以查看wsl的状态。

```
wsl --status
```

状态中的默认版本号需要为0

```
默认版本：2
```

如果默认版本不为2，需要修改默认版本号。

```
wsl --set-default-version 2
```

### 安装ubuntu应用

[](#安装ubuntu应用)

可以从window“开始”菜单进入“Microsoft Store"，在应用商店中搜索”ubuntu"并安装该应用。 安装完成后可以通过以下命令启动"ubuntu"应用。

```
wsl -d ubuntu
```

也可以在“开始”的“应用列表”直接点击“Ubuntu”图标来进入“ubuntu"。

### 安装xqkeji运行环境

[](#安装xqkeji运行环境)

进入"ubuntu"应用后，执行以下命令：

**【注意：执行完命令后，会在当前目录创建docker目录，并作为xqkeji的运行目录，因此执行前要确定好当前的目录】**

当前的目录一般用window的盘符，例如：/mnt/d/为D盘，/mnt/e/为E盘。

可以使用cd /mnt/d/ 命令让当前目录为window的D盘。

使用window的盘符路径可以使得linux子系统的文件与Window共享，方便开发。

```
cd /mnt/d/
curl -O https://www.xqkeji.cn/docker.tar.gz
tar -xzvf docker.tar.gz
rm docker.tar.gz
cd docker
chmod -R a+w log
chmod +x install.sh
sudo ./install.sh
```

创建项目
----

[](#创建项目)

通过以下命令进入xqkeji容器

```
sudo docker exec -it xqkeji /bin/bash
```

在容器中执行命令

```
cd /home/web
composer create-project xqkeji/fast-admin app1
```

执行该命令会自动下载fast-admin项目代码，并要求配置数据库信息，并自动安装xq-app-admin模块. **【app1为项目名称，可以根据实际情况修改。】**项目创建完成后，可以进入项目目录，继续安装其他模块。 例如：

```
cd app1
composer require xqkeji/xq-app-content
```

执行后将安装内容管理模块。

完成程序模块安装后，执行命令：

```
exit
```

退出xqkeji容器，回到linux子系统。

在nginx配置一个虚拟机
-------------

[](#在nginx配置一个虚拟机)

### 1、添加一个本地的域名解析

[](#1添加一个本地的域名解析)

在window操作系统下，打开C:\\Windows\\System32\\drivers\\etc\\hosts文件，在文件底部增加一行内容：

```
127.0.0.1 app1.xqkeji.cn
```

作用是在你的本地电脑添加一个域名解析，后面我们可以通过这个域名访问上面创建的项目。

### 2、添加一个nginx虚拟主机

[](#2添加一个nginx虚拟主机)

在nignx的配置目录下docker/etc/nginx/conf.d/增加一个app1.conf的虚拟主机配置文件，内容如下：

```
server {
	listen       80;
	server_name  app1.xqkeji.cn;
	error_log  /home/log/app1.log;
	root    "/home/web/app1/www";
	location / {
		index  index.html index.htm index.php;
		autoindex  off;
		try_files $uri $uri/ /index.php?_url=$uri&$args;
	}
	location ~ \.php(.*)$  {
		try_files		$uri = 404;
		fastcgi_pass   172.0.0.10:9000; #php-fpm的服务地址
		fastcgi_index  index.php;
		fastcgi_split_path_info  ^((?U).+\.php)(/?.+)$;
		fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
		fastcgi_param  PATH_INFO  $fastcgi_path_info;
		fastcgi_param  PATH_TRANSLATED  $document_root$fastcgi_path_info;
		include        fastcgi_params;
	}
}
```

### 3、重启nginx服务

[](#3重启nginx服务)

```
sudo docker restart nginx
```

重启后，就可以通过浏览器输入地址：[http://app1.xqkeji.cn/admin就可以访问到该管理后台了。](http://app1.xqkeji.cn/admin%E5%B0%B1%E5%8F%AF%E4%BB%A5%E8%AE%BF%E9%97%AE%E5%88%B0%E8%AF%A5%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0%E4%BA%86%E3%80%82)同时[http://app1.xqkeji.cn/默认访问管理后台的主页面，如果要修改或取消该路由，请修改app/example/config/router.php的路由配置。](http://app1.xqkeji.cn/%E9%BB%98%E8%AE%A4%E8%AE%BF%E9%97%AE%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0%E7%9A%84%E4%B8%BB%E9%A1%B5%E9%9D%A2%EF%BC%8C%E5%A6%82%E6%9E%9C%E8%A6%81%E4%BF%AE%E6%94%B9%E6%88%96%E5%8F%96%E6%B6%88%E8%AF%A5%E8%B7%AF%E7%94%B1%EF%BC%8C%E8%AF%B7%E4%BF%AE%E6%94%B9app/example/config/router.php%E7%9A%84%E8%B7%AF%E7%94%B1%E9%85%8D%E7%BD%AE%E3%80%82)

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance74

Regular maintenance activity

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~21 days

Recently: every ~181 days

Total

45

Last Release

148d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/73de0dbe1c160efa8d8a2d794993a81a973577340e9ad4b76d2177e65d110d7b?d=identicon)[xqkeji](/maintainers/xqkeji)

---

Top Contributors

[![xqkeji](https://avatars.githubusercontent.com/u/8099848?v=4)](https://github.com/xqkeji "xqkeji (50 commits)")

### Embed Badge

![Health badge](/badges/xqkeji-fast-admin/health.svg)

```
[![Health](https://phpackages.com/badges/xqkeji-fast-admin/health.svg)](https://phpackages.com/packages/xqkeji-fast-admin)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)