[部署教程]系统安装运行教程

第一步：上传系统源码

将下载好的系统源码上传到服务器网站目录中，并确认源码文件已经完整上传。上传完成后，网站根目录中应能看到 app、config、public、vendor、view 等目录。

如果使用宝塔面板，请进入对应网站的站点目录检查文件是否完整。若上传的是压缩包，请先在服务器中解压，不要直接把压缩包当作网站运行目录。

第二步：设置运行目录

进入网站管理面板，将网站运行目录设置为：

public

该步骤必须正确设置。系统入口文件位于 public 目录下，如果运行目录没有选择 public，可能会出现首页 404、安装页面打不开、静态资源加载失败、后台入口无法访问等问题。

第三步：配置伪静态

如果服务器使用 Nginx，请将网站伪静态设置为以下内容：

location ~* (runtime|application)/{
    return 403;
}
location / {
    if (!-e $request_filename){
        rewrite  ^(.*)$  /index.php?s=$1  last;   break;
    }
}

如果使用宝塔面板，可进入 网站设置 → 伪静态，复制以上规则后保存。

配置完成后，建议重载 Nginx 或重启网站服务，避免伪静态规则未生效。

第四步：检查运行环境

访问您的站点域名后，系统会自动进入安装检测页面。请根据页面提示检查 PHP 版本、扩展、函数权限和目录权限。

常见需要检查的内容包括：

• PHP 版本是否符合系统要求。
• fileinfo、curl、openssl、pdo_mysql、ZipArchive 等扩展是否已安装。
• runtime、public/upload 等目录是否可写。
• 服务器是否禁用了系统必须使用的函数。

若页面提示某个扩展未安装，请先到服务器面板中安装或开启对应扩展，再刷新安装页面重新检测。

第五步：填写数据库信息

环境检测通过后，会进入安装初始化页面。请按照页面要求填写数据库信息：

• 数据库地址：一般填写 127.0.0.1。
• 数据库端口：一般填写 3306。
• 数据库账号：填写数据库用户名。
• 数据库密码：填写数据库密码。
• 数据库名称：填写提前创建好的数据库名。

请确保数据库已经提前创建，并且数据库账号拥有创建表、写入数据、修改数据的权限。

如果提示数据库连接失败，请检查数据库地址、端口、账号、密码和数据库名称是否正确。

第六步：配置管理员账号

在安装页面填写后台管理员账号、昵称和密码。

管理员账号用于登录系统后台，请不要设置过于简单的密码。建议使用字母、数字和符号组合，避免后台账号被恶意爆破。

填写完成后点击 开始安装，系统会自动创建数据表、写入基础配置并完成初始化。

第七步：进入系统后台

安装成功后，即可通过后台入口进入管理后台。

系统默认后台入口文件位于：

public/admin.php

如果您的域名是 https://example.com，默认后台访问地址一般为：

https://example.com/admin.php

第八步：安装后的安全处理

安装完成后，请务必及时修改 public 目录下的 admin.php 文件名称，例如修改为：

myadmin.php

修改后，后台访问地址也需要同步改为：

https://example.com/myadmin.php

这样可以降低后台入口被扫描和爆破的风险。

同时建议检查以下事项：

• 删除或确认安装锁文件已经生成，避免重复安装。
• 修改后台管理员默认密码。
• 检查 .env 中的调试模式，正式运营时不建议开启调试。
• 确认网站运行目录仍然是 public。
• 确认伪静态规则已经生效。