# ZsAdmin

**Repository Path**: zhangsens/zsadmin

## Basic Information

- **Project Name**: ZsAdmin
- **Description**: ZsAdmin「智数」 是一款基于 ThinkPHP 8 和 Bootstrap 5 的轻量级后台开发框架，内置 Auth 权限与用户组菜单体系，支持自定义后台路径、Web 一键安装、站点配置与操作日志；提供插件 / 主题应用中心、钩子扩展与远程市场，业务前台（如社区、导航）按需安装挂载。（ZsAdmin 智数 轻量级快速开发框架）
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-07
- **Last Updated**: 2026-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zsadmin

#### 介绍

ZsAdmin「智数」是一款基于 ThinkPHP 8 和 Bootstrap 5 的轻量级后台开发框架，内置 Auth 权限与用户组菜单体系，支持自定义后台路径、Web 一键安装、站点配置与操作日志；提供插件 / 主题应用中心、钩子扩展与远程市场，业务前台（如社区、导航）按需安装挂载。（ZsAdmin 智数 轻量级快速开发框架）

- 官网：https://www.zsadmin.com
- 应用市场：https://www.zsadmin.com/market.html

#### 软件架构

| 层级 | 说明 |
|------|------|
| 框架 | ThinkPHP 8 + Composer 依赖管理 |
| 前端壳 | Bootstrap 5，后台 iframe 多标签布局 |
| 核心 | 安装向导、RBAC 鉴权、站点配置、用户与等级、文件上传、操作日志 |
| 扩展 | `plugins/` 功能插件、`themes/` 主题包，路由 / 钩子 / 菜单按需注册 |
| 应用中心 | 本地安装升级、远程市场购买下载、核心白名单升级 |
| 数据 | MySQL（安装脚本 `database/install.sql`） |

主程序提供后台与扩展底座；社区、支付、导航等业务以插件形式交付。

#### 界面截图
![输入图片说明](https://zsens.oss-cn-beijing.aliyuncs.com/images/2026/10/07/105149_c714e6a72df685c5.png)
![输入图片说明](https://zsens.oss-cn-beijing.aliyuncs.com/images/2026/10/07/105150_473f10fdbedb04c2.png)
![输入图片说明](https://zsens.oss-cn-beijing.aliyuncs.com/images/2026/10/07/105151_cf37f63e08f66d3e.png)
![输入图片说明](https://zsens.oss-cn-beijing.aliyuncs.com/images/2026/10/07/105152_d62e8efd70633408.png)

#### 安装教程

1. 环境：PHP >= 8.0（推荐 8.5）、MySQL 8.0+、Nginx/Apache、Composer；扩展需含 `pdo_mysql`、`mbstring`、`openssl`、`json`、`curl`、`fileinfo`
2. 进入项目目录执行 `composer install`，并确保 `runtime`、`config`、`.env`、`public/static` 可写
3. 运行 `php think run`（或配置 Web 根目录指向 `public/`）
4. 浏览器访问 `http://127.0.0.1:8000/install`，按向导完成环境检测、数据库、管理员与后台路径设置
5. 安装成功后生成 `config/install.lock`；生产环境请关闭调试模式（`.env` 中 `APP_DEBUG=false` 或后台站点配置）

重新安装：删除 `config/install.lock` 后再次访问 `/install`。

#### 使用说明

1. 默认后台地址为 `/admin`（登录页 `/admin/login`）；若安装时或「安全配置」中修改了后台路径，请使用新入口访问
2. 超管登录后可在「系统管理」维护站点配置、菜单、文件；在「权限管理」维护用户组、权限节点、管理员与操作日志
3. 「用户管理」维护前台用户与用户等级；「应用中心」安装 / 卸载插件与主题，并可登录官方账号使用远程市场
4. 站点根路径 `/`：已安装并启用社区插件时跳转社区首页，否则进入后台
5. 修改后台路径后请强制刷新浏览器，避免框架页仍请求旧的 `/admin/welcome`


#### 相关链接

1. 官网 [www.zsadmin.com](https://www.zsadmin.com)
2. 应用市场 [www.zsadmin.com/market.html](https://www.zsadmin.com/market.html)
3. ThinkPHP 文档 [doc.thinkphp.cn](https://doc.thinkphp.cn)
4. Bootstrap 文档 [getbootstrap.com](https://getbootstrap.com)

#### 版权信息

ZsAdmin遵循Apache2开源协议发布，并提供免费使用。
本项目包含的第三方源码和二进制文件之版权信息另行标注。
版权所有Copyright © 2017-2026 by ZsAdmin (https://www.zsadmin.com)
All rights reserved。