准备
- 已绑定域名,PHP 与 MySQL 已就绪
- 准备好数据库名、用户名、密码
第一步:上传
把安装包上传到站点根目录并解压。注意解压后的目录结构应当是 app/、public/、config/ 直接位于站点根目录下。
第二步:设置运行目录
把站点的运行目录指向 /public(宝塔:站点设置 → 网站目录 → 运行目录)。这样程序文件不会暴露在 web 根下。
第三步:目录权限
把站点目录属主设为运行用户(宝塔默认 www),并给 runtime/ 与 public/uploads/ 写权限。
第四步:跑安装向导
浏览器访问 https://你的域名/install.php,按提示填写:
- 数据库信息(地址、端口、库名、账号、密码、表前缀)
- 站点名称与管理员账号密码
- 是否导入演示数据(建议勾选,装完可以删)
点安装,大约 10 秒完成,会自动写好 .env 并生成管理员。
第五步:删入口、进后台
安装完成后删除 public/install.php,访问 https://你的域名/admin.php 登录后台。建议立刻把入口文件名改成只有你知道的名字。
常见报错
| 现象 | 原因与处理 |
|---|---|
| 502 / 500 | PHP 版本低于 8.1,或缺少扩展,看 runtime/log |
| 页面 404 | 伪静态未配置,或运行目录没指向 public |
| 连不上数据库 | 地址写 localhost 但库在另一台机器;改用内网 IP |
| 后台样式丢失 | 运行目录不对,静态资源路径错位 |