PHPackages                             laravelstack/filament-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. [Authentication & Authorization](/categories/authentication)
4. /
5. laravelstack/filament-admin

ActiveLibrary[Authentication & Authorization](/categories/authentication)

laravelstack/filament-admin
===========================

Admin foundation package for Laravel 13 and Filament 5.

v0.4.1(1mo ago)01↑2900%1MITPHP ^8.3

Since Jun 3Compare

[ Source](https://github.com/john-captain/filament-admin)[ Packagist](https://packagist.org/packages/laravelstack/filament-admin)[ Docs](https://github.com/john-captain/filament-admin)[ RSS](/packages/laravelstack-filament-admin/feed)WikiDiscussions Synced 1mo ago

READMEChangelog (3)Dependencies (17)Versions (3)Used By (1)

FilamentAdmin
=============

[](#filamentadmin)

基于 Laravel 13 + Filament 5 的企业级后台基础包。`composer require` 一行命令，即可获得完整的认证、RBAC 权限、菜单管理、部门数据权限、操作日志等后台底座，在上面直接构建业务模块，无需重建基础设施。

[![FilamentAdmin 后台首页](art/dashboard.png)](art/dashboard.png)

> 🌐 **在线体验**： · 演示账号 `demo@example.com` / `demo123`（演示环境每日凌晨 4:00 重置；高危操作已屏蔽）

[![最新版本](https://camo.githubusercontent.com/f5cda20ed17775f89757cfd424e08d00ffa90a6294fbe9258f4eba09c55752b6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c61726176656c737461636b2f66696c616d656e742d61646d696e)](https://packagist.org/packages/laravelstack/filament-admin)[![总下载量](https://camo.githubusercontent.com/2648b4dfb5acf8f9c2a7955cacec77733a9e541c6dbfc19b03bf43d7271b2af2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c61726176656c737461636b2f66696c616d656e742d61646d696e)](https://packagist.org/packages/laravelstack/filament-admin)[![PHP 版本](https://camo.githubusercontent.com/55ee1bbb2353e617a26bb42cd337a5576c72544d630827af3be39cbdcdf0b6b5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6c61726176656c737461636b2f66696c616d656e742d61646d696e)](https://packagist.org/packages/laravelstack/filament-admin)[![License](https://camo.githubusercontent.com/d8797bdda15b4025e11662d4aadad91cfee908b854ff0a24afa88442e642f144/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c61726176656c737461636b2f66696c616d656e742d61646d696e)](https://packagist.org/packages/laravelstack/filament-admin)[![Tests](https://camo.githubusercontent.com/861b9eac027f2df9cfd12f69ad9f70f80b2f88e7a3d8cd9691a081ee4938d77a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6f686e2d6361707461696e2f66696c616d656e742d61646d696e2f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d5465737473)](https://github.com/john-captain/filament-admin/actions/workflows/ci.yml)

---

快速开始
----

[](#快速开始)

### 第一步：安装

[](#第一步安装)

```
composer require laravelstack/filament-admin
```

### 第二步：发布资源

[](#第二步发布资源)

```
# 发布配置文件
php artisan vendor:publish --tag=filament-admin-config

# 发布数据库迁移
php artisan vendor:publish --tag=filament-admin-migrations

# 发布视图文件（如需自定义界面）
php artisan vendor:publish --tag=filament-admin-views

# 发布多语言文件（如需自定义翻译）
php artisan vendor:publish --tag=filament-admin-lang

# 发布 Stub 文件（如需自定义生成模板）
php artisan vendor:publish --tag=filament-admin-stubs
```

### 第三步：执行迁移与初始化

[](#第三步执行迁移与初始化)

```
# 执行数据库迁移
php artisan migrate

# 创建超级管理员账号
php artisan db:seed --class="FilamentAdmin\\Database\\Seeders\\SuperAdminSeeder"
```

> **安全提示：** 默认账号为 `admin@example.com`，密码为 `password`，仅供初始化使用。 **首次登录后请立即修改默认密码，请勿将默认账号用于生产环境。**

### 第四步：注册插件

[](#第四步注册插件)

在 `app/Providers/Filament/AdminPanelProvider.php` 中注册 FilamentAdmin 插件：

```
use FilamentAdmin\FilamentAdminPlugin;
use Filament\Panel;
use Filament\PanelProvider;

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->id('admin')
            ->path('admin')
            ->login()
            ->authGuard('admin')
            ->plugins([
                FilamentAdminPlugin::make(),
            ]);
    }
}
```

更多详细安装配置，请参阅 [安装文档](https://github.com/john-captain/filament-admin/blob/main/wiki/installation.md)。

### 第五步：访问后台

[](#第五步访问后台)

启动开发服务器后，访问 `/admin`，使用以下账号登录：

- **邮箱：** `admin@example.com`
- **密码：** `password`

> **再次提示：** 首次登录后请立即前往个人资料页修改默认密码。

---

功能清单
----

[](#功能清单)

### 认证与安全

[](#认证与安全)

- 自定义登录页（支持账号名 / 邮箱双模式登录）
- 防枚举攻击与登录限流
- 双因素认证（TOTP / 2FA）
- 登录日志自动记录

### 管理员管理

[](#管理员管理)

- 管理员用户 CRUD（含软删除与恢复）
- 账号状态管理（启用 / 禁用）
- 部门归属分配
- 角色批量分配

### 角色与权限

[](#角色与权限)

- 基于 Spatie Permission 的 RBAC 体系（admin guard）
- Filament Shield 4.x 集成，自动注册权限点
- 超级管理员 `Gate::before` 绕过，无需逐一授权
- BasePolicy 统一权限命名规范

### 菜单管理

[](#菜单管理)

- 数据库驱动的树形菜单结构
- 菜单与权限绑定
- 拖拽排序
- 动态导航构建器，按角色过滤展示

### 部门组织

[](#部门组织)

- 树形部门结构
- 循环引用检测
- DepartmentTree 服务层
- 部门排序管理

### 数据权限

[](#数据权限)

- 5 种权限范围枚举：全部数据 / 本部门 / 本部门及下级 / 仅本人 / 指定部门
- DataScopeResolver 统一解析

### 操作日志

[](#操作日志)

- Spatie ActivityLog + Observer 自动记录模型变更
- 日志清理命令（可配置保留天数）

### 系统配置

[](#系统配置)

- 统一配置入口 `config/filament-admin.php`
- 支持 `SUPER_ADMIN_ROLE` / `LOG_RETENTION_DAYS` 环境变量覆盖

---

能力亮点
----

[](#能力亮点)

**采用最新技术栈，开箱即用：** 基于 Laravel 13 与 Filament 5，锁定主版本，兼容 PHP 8.3+，patch/minor 版本自由升级，长期可维护。

**中文原生支持：** 界面与翻译文件均提供中文版本，适合以中文用户为主的项目团队。

**企业级权限体系开箱即用：** RBAC + 部门数据权限 + 双轨日志（操作审计 + 登录日志）全部内置，无需另行集成；超级管理员角色自动绕过所有权限检查，降低初始配置门槛。

**以包形式发布，可扩展可覆盖：** 通过 `filament-admin:publish` 命令将 Model、Resource、Migration 等以 Stub 形式发布到用户项目，允许完全自定义，同时保持后续升级不冲突。

**双轨日志，可追溯：** 操作日志通过 Observer 自动记录所有模型变更，登录日志通过事件监听器自动记录成功/失败登录，均支持按需清理，满足合规要求。

---

扩展发布（filament-admin:publish）
----------------------------

[](#扩展发布filament-adminpublish)

安装完成后，可使用内置命令将 Model / Resource 等以可自定义形态发布到项目中：

```
# 发布单个 Model stub
php artisan filament-admin:publish --model=Product

# 发布单个 Resource stub
php artisan filament-admin:publish --resource=Product

# 发布全套内置资源（AdminUser/Department/Menu/LoginLog）
php artisan filament-admin:publish --all

# 覆盖已存在文件
php artisan filament-admin:publish --model=Product --force
```

---

更多文档
----

[](#更多文档)

- [详细安装指南](https://github.com/john-captain/filament-admin/blob/main/wiki/installation.md)
- [v0.4 → v0.5 升级指南](UPGRADING.md)
- [变更记录](CHANGELOG.md)
- [贡献指南](https://github.com/john-captain/filament-admin/blob/main/CONTRIBUTING.md)
- [问题反馈](https://github.com/john-captain/filament-admin/issues)

---

许可证
---

[](#许可证)

MIT License © [FilamentAdmin](https://github.com/john-captain/filament-admin)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance90

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

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

Total

2

Last Release

51d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/094c196f414cab690dfde4af91f0eba17f27d443cb0b72912794823c5cca012c?d=identicon)[john-captain](/maintainers/john-captain)

---

Tags

laravelrbacbackendadminfilament

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/laravelstack-filament-admin/health.svg)

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

###  Alternatives

[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[slimani/filament-media-manager

A media manager plugin for Filament.

126.9k](/packages/slimani-filament-media-manager)[finity-labs/fin-mail

A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending.

284.8k2](/packages/finity-labs-fin-mail)[ercogx/laravel-filament-starter-kit

This is a Filament v5 Starter Kit for Laravel 13, designed to accelerate the development of Filament-powered applications.

461.8k](/packages/ercogx-laravel-filament-starter-kit)[a2insights/filament-saas

Filament Saas for A2Insights

191.7k](/packages/a2insights-filament-saas)

PHPackages © 2026

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