安装

环境要求

环境要求

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

FastAdmin推荐你使用阿里云和腾讯云服务器

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

可选项

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

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

客户端浏览器推荐

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

安装教程

FastAdmin 开源框架的安装非常简单，只需简单三步即可安装完成。

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

第一步：新建站点

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

第二步：上传框架

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

第三步：配置并安装

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

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

视频教程

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

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

常见问题

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，使用旧版的请尽快升级到最新版的 FastAdmin，如有问题可以在问答区提出。