PHPackages                             imzhi/jf-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. [Admin Panels](/categories/admin)
4. /
5. imzhi/jf-admin

ActiveLibrary[Admin Panels](/categories/admin)

imzhi/jf-admin
==============

jf-admin 是基于 Laravel 的后台管理模板，提供后台登录、权限控制和操作日志查看等功能，前端框架使用 inspinia。

v1.3.13(5y ago)291479[1 issues](https://github.com/imzhi/jf-admin/issues)MITJavaScriptPHP >=7.1.3

Since Jul 12Pushed 5y ago1 watchersCompare

[ Source](https://github.com/imzhi/jf-admin)[ Packagist](https://packagist.org/packages/imzhi/jf-admin)[ RSS](/packages/imzhi-jf-admin/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (6)Versions (20)Used By (0)

jf-admin 是基于 Laravel 5.5+ 的扩展包（支持 Laravel 5.5+, 6.x, 7.x），助你构建自己的后台管理系统。

🌟 **演示站点：**

，用户名：admin，密码：admin。

🌟 **演示截屏：**

[![](https://camo.githubusercontent.com/0ea086aa2d46e35d6bc0ffad0718fd1181e065dfe5449bff102d0b9d658c4b07/687474703a2f2f757063646e2e696d7a68692e6d652f6a6661646d696e2f322e676966)](https://camo.githubusercontent.com/0ea086aa2d46e35d6bc0ffad0718fd1181e065dfe5449bff102d0b9d658c4b07/687474703a2f2f757063646e2e696d7a68692e6d652f6a6661646d696e2f322e676966)

**内容：**

- [简介](#%E7%AE%80%E4%BB%8B)
- [文档](#%E6%96%87%E6%A1%A3)
- [环境](#%E7%8E%AF%E5%A2%83)
- [安装](#%E5%AE%89%E8%A3%85)
- [许可证](#%E8%AE%B8%E5%8F%AF%E8%AF%81)

简介
--

[](#简介)

jf-admin 提供后台登录、权限控制和操作日志查看等功能。权限控制采用 RBAC，包括成员管理、角色管理、权限管理。

前端主题使用 inspinia。

文档
--

[](#文档)

### 目录结构

[](#目录结构)

```
├── config
├── database
│   └── migrations
├── resources
│   ├── assets
│   │   ├── inspinia
│   │   └── jfadmin
│   ├── lang
│   │   ├── en
│   │   └── zh-CN
│   └── views
│       ├── auth
│       ├── home
│       ├── layouts
│       ├── manageuser
│       ├── profile
│       └── setting
└── src
    ├── Console
    │   └── stubs
    ├── Controllers
    ├── Facades
    ├── Middleware
    ├── Models
    ├── Repositories
    ├── Requests
    └── Seeds

```

### 依赖包

[](#依赖包)

包名约束版本说明[mews/captcha](https://github.com/mewebstudio/captcha)^2.2图形验证码[spatie/laravel-activitylog](https://github.com/spatie/laravel-activitylog)^2.8操作日志记录[spatie/laravel-permission](https://github.com/spatie/laravel-permission)^2.37权限控制[doctrine/annotations](https://github.com/doctrine/annotations)^1.8注解解析### 安装说明

[](#安装说明)

**发布命令**

```
php artisan vendor:publish --provider="Imzhi\JFAdmin\JFAdminServiceProvider"
```

发布必要文件到项目中：

```
├── config          => config_path()
├── database
│   └── migrations  => database_path('migrations')
├── resources
│   ├── assets      => public_path('vendor/jfadmin')
│   │   ├── inspinia
│   │   └── jfadmin
│   ├── lang        => resource_path('lang/vendor/jfadmin')
│   │   ├── en
│   │   └── zh-CN
│   └── views
│       ├── auth
│       ├── home    => resource_path('views/vendor/jfadmin/home')
│       ├── layouts => resource_path('views/vendor/jfadmin/layouts')
│       ├── manageuser
│       ├── profile
│       └── setting
└── src
    ├── Console
    │   └── stubs
    ├── Controllers
    ├── Facades
    ├── Middleware
    ├── Models
    ├── Repositories
    ├── Requests
    └── Seeds

```

**安装命令**

```
php artisan jfadmin:install
```

首先会检查配置文件 `config/jfadmin.php` 是否存在，安装时需要用到。

执行迁移文件，并且生成初始的管理员用户（默认用户名：admin，密码：admin）。

新建目录（默认为 app/JFAdmin），并生成后台首页控制器类文件（HomeController）和路由文件（routes.php）：

```
app
└── JFAdmin
    ├── Controllers
    │   └── HomeController.php
    └── routes.php

```

### 卸载说明

[](#卸载说明)

```
php artisan jfadmin:uninstall
```

输入上面命令后会弹出确认提示，键入 yes 后，会开始卸载操作，将会删除：

- `jfadmin::install` 新建的目录（默认为 app/JFAdmin）
- `config_path('jfadmin.php')`
- `public_path('vendor/jfadmin')`
- `resource_path('lang/vendor/jfadmin')`
- `resource_path('views/vendor/jfadmin')`

请注意：卸载命令不会去更改数据表。卸载成功后如需重新安装请先执行发布命令再执行安装命令。

### 配置项

[](#配置项)

**title**

> 站点标题

**caption**

> 站点标题缩写（小屏浏览时用到）

**welcome**

> 欢迎语句（后台首页右上角的欢迎语句）

**wallpaper**

> 登录页面的背景图（支持 URL 和项目可访问的路径）

**wallpaper\_class**

> 登录页面标题文件的 CSS class

**directory**

> 安装目录（jfadmin::install 命令生成文件将要安装的目录）

### 操作日志

[](#操作日志)

操作日志记录使用的 laravel-activitylog 扩展包，数据表是 activity\_log。

jf-admin 新增两个响应宏：suc 和 fai，分别对应成功响应宏和失败响应宏，当调用成功响应宏时会进行操作日志的记录。

请注意：这两个响应宏只适用于 Ajax 操作返回响应数据。

### 超级管理员角色

[](#超级管理员角色)

默认的超级管理员角色名称是 Super Admin，也可以在配置文件中设置多个超级管理员角色名称。

初始管理员账号就是超级管理员，可以进行任何操作。

### 中间件

[](#中间件)

jf-admin 有两个重要的中间件：jfadmin.auth，jfadmin.permission。

jfadmin.auth 检测用户会话登录状态和用户账号的状态。

jfadmin.permission 根据路由名称检测用户的操作权限。

### 其它命令

[](#其它命令)

**重置密码**

```
php artisan jfadmin:reset-password
```

输入要修改的管理员用户名，并输入密码、重复密码。

环境
--

[](#环境)

- PHP >= 7.1.3
- Laravel >= 5.5

安装
--

[](#安装)

**第一步**

使用 Composer 安装 jf-admin 扩展包：

```
composer require imzhi/jf-admin ^1.1

```

**第二步**

发布 [laravel-permission](https://github.com/spatie/laravel-permission) 和 [laravel-activitylog](https://github.com/spatie/laravel-activitylog) 扩展包的迁移文件，并执行迁移命令：

```
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="migrations"
php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="migrations"
php artisan migrate --step

```

发布 [mews/captcha](https://github.com/mewebstudio/captcha) 扩展包的配置文件：

```
php artisan vendor:publish --provider="Mews\Captcha\CaptchaServiceProvider"

```

修改配置文件 `config/captcha.php` 的 length，修改成 4：

```
return [
    // 省略
    'default' => [
        'length' => 4,
```

**第三步**

发布 jf-admin 扩展包的文件，并执行安装命令：

```
php artisan vendor:publish --provider="Imzhi\JFAdmin\JFAdminServiceProvider"
php artisan jfadmin:install

```

经过以上三步，扩展包安装成功。

访问 URL 为：，默认用户名：admin，密码：admin。

许可证
---

[](#许可证)

jf-admin 扩展包使用 [MIT](/LICENSE) 许可证。

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity62

Established project with proven stability

 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 ~29 days

Recently: every ~54 days

Total

17

Last Release

2025d ago

PHP version history (2 changes)v1.0.0PHP >=7.0.0

v1.3.0PHP >=7.1.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2304019?v=4)[imzhi](/maintainers/imzhi)[@imzhi](https://github.com/imzhi)

---

Top Contributors

[![imzhi](https://avatars.githubusercontent.com/u/2304019?v=4)](https://github.com/imzhi "imzhi (74 commits)")

---

Tags

adminadmin-dashboardinspinialaravellaravel-packagephp

### Embed Badge

![Health badge](/badges/imzhi-jf-admin/health.svg)

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

###  Alternatives

[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)

PHPackages © 2026

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