从下载源码、宝塔添加站点、配置伪静态，到首次访问完成安装。本文覆盖虚拟主机与宝塔两种路径，并解释为什么 404 多半是伪静态没配。
AidoSaaS-CMS 的安装极简：下载源码 → 解压到 Web 根 → 配置伪静态 → 浏览器访问完成安装。本文以宝塔面板为例，同时说明虚拟主机的等价做法。
一、准备环境
- PHP 8.1+（推荐 8.3），开启 pdo_mysql / pdo_sqlite / mbstring / json / gd；
- Web 服务器 Nginx 或 Apache；
- 数据库 MySQL 5.7+/8.0 或 SQLite（轻量场景）。
二、上传与解压
把源码解压后，Web 根目录应指向含 index.php 的那一层（通常是解压后的根目录本身）。如果源码放在子目录，请调整站点根目录或配置别名。
三、配置伪静态（关键）
这是 90% 安装后 404 的根源。AidoSaaS-CMS 由 Bootstrap::run() 统一派发全部路由，因此所有未知路径都要交给 index.php：
location / {
try_files $uri $uri/ /index.php$is_args$args;
}Apache 则放置一条 FallbackResource /index.php 或等价 rewrite 规则。
四、首次安装向导
访问站点域名，按向导填写数据库连接（或选择 SQLite）、站点名称、管理员账号。完成后会自动写入 config.php 与演示数据（可选）。
五、常见问题
- 页面空白：检查 PHP 版本与必需扩展是否齐全；
- 静态资源 404：确认 Web 根指向正确，且伪静态已生效；
- 后台打不开：确认
/admin路径已被路由接管，而非被静态文件规则拦截。
延伸
常见问题
解压后访问首页 404 怎么办？
几乎都是伪静态没配。Nginx 需把未知路径交给 index.php：try_files $uri $uri/ /index.php$is_args$args; 否则路由无法派发。
需要 Composer 吗？
不需要。src 目录自带 PSR-4 自动加载，无需 install 或构建。
支持 SQLite 吗？
支持。安装向导会让你选择 MySQL 或 SQLite；轻量站点用 SQLite 可零数据库服务部署。
评论 (0)
还没有评论，来抢沙发吧。