安装

环境要求

服务器环境要求

为了确保 FastAdmin 框架能够正常运行，请确保你的服务器满足以下环境要求：

• 操作系统：Linux、Windows、Mac OS
• Web 服务器：Apache、Nginx（推荐 Nginx）
• PHP 版本：PHP 7.4+ （推荐 PHP 7.4，详见下面的依赖信息）
• MySQL 版本：>= 5.6 且 <= 8.0 (需支持 innodb 引擎)

客户端浏览器推荐

推荐使用 Google Chrome v100+、Firefox v100+、Microsoft EDGE v100+ 或 Apple Safari v13+。

安装教程

FastAdmin 开源框架的安装非常简单，只需简单三步即可安装完成。（推荐使用云服务器）

下面以 Linux 宝塔面板 （Linux + Nginx + PHP7.4 + MySQL5.7）为例。

第一步：新建站点

• 在宝塔面板中，创建一个新的站点，并填写项目域名。

第二步：上传框架

• 通过宝塔的文件管理功能，进入站点的文件目录。
• 上传 最新版 FastAdmin 开源框架完整包 并解压到站点的当前目录，比如：/www/wwwroot/www.example.com。

第三步：配置并安装

• 进入站点配置，设置站点的运行目录为 /public（注意：这是 FastAdmin 后台框架的运行目录，必须设置为 /public，否则无法正常运行），并设置站点的伪静态为 thinkphp 规则。
• 访问你的站点域名进行安装，比如：https://www.example.com/install.php
• 安装完成后即可进入后台，比如： https://www.example.com/奇怪的文件名.php （奇怪的文件名.php 是后台安全入口）
• 至此 FastAdmin 后台框架已经安装完成，欢迎加入 FastAdmin 开源社区。

注意事项：如果你重复执行install.php，数据库中的 FastAdmin 框架基础表和用户表将被重置，请提前做好全站备份。

视频教程

我们还提供了更加详细的 FastAdmin 安装教程，欢迎观看。

• FastAdmin开发环境配置教程：https://www.fastadmin.net/video/environment.html
• FastAdmin安装系列视频教程：https://www.fastadmin.net/video/install.html

开发环境可选项

以下为可选项，你可以根据需要进行安装：

• Git：用于源代码的版本管理
• Node.js：用于安装 Npm 和 LESS，同时前端打包压缩也需要使用到
• Composer：用于管理第三方扩展包
• Npm+Grunt：用于管理前端资源和打包(FastAdmin >= 1.6.0)
• - Bower：用于管理前端资源(FastAdmin < 1.6.0) (新版本已弃用)
• Less：用于编辑 less 文件，如果你需要增改 css 样式，建议安装上。

依赖的 php 环境

为了节省你的时间，FastAdmin 开源框架推荐的 php 环境如下。

常见问题

1. 如果安装后打开页面提示404错误，请检查服务器伪静态配置，宝塔伪静态请配置使用thinkphp规则。
2. 提示请先下载完整包覆盖后再安装，说明你是直接从仓库下载的代码，请从官网下载完整包覆盖后再进行安装。
3. 如果提示当前权限不足，无法写入配置文件application/database.php，请检查database.php是否可写，还有可能是当前安装程序无法访问父目录，请检查PHP的open_basedir配置。
4. 如果提示找不到fa_admin表或表不存在，请检查你的MySQL是否开启了支持innodb。
5. 如果使用的宝塔面板，请在软件配置中PHP的禁用函数中，移除putenv函数。
6. 后台入口忘记怎么办？可以在站点 public 目录内找到，一个奇怪的文件名.php ，这个奇怪的文件名.php 是 FastAdmin 后台的安全入口。
7. FastAdmin 从 V1.3.4+ 开始全面支持 PHP7.4，从 V1.7.0 开始推荐使用 php8.0 环境，使用旧版的请尽快升级到最新版的 FastAdmin，如有问题可以在问答区提出。

文档日志

• 2022-05-30，FastAdmin 从 V1.3.4+ 开始全面支持 PHP7.4，使用旧版的请尽快升级到最新版的 FastAdmin，如有问题可以在问答区提出。
• 2024-03-28，FastAdmin V1.5.0+ 推荐使用 php7.4，不过有合并了 php8 兼容代码，欢迎测试反馈，和贡献开源代码。
• 2025-03-31，FastAdmin 从 V1.6.0 开始采用了 npm + grunt 管理前端组件，弃用了 bower 前端管理工具。
• 2025-06-03，FastAdmin 从 V1.7.0 开始推荐使用 php8.0 环境。
• 2025-08-29，FastAdmin v1.7.0 在开发测试中： https://gitee.com/fastadminnet/fastadmin/milestones/213559