智简魔方 V10 是一套开源的 IDC/云服务器售卖业务管理系统 [citation:2][citation:8]。它的安装并不复杂，但对 PHP 和 MySQL 的版本有严格要求，且伪静态规则配置错误是新手最常见的翻车点。
在宝塔里安装环境之前，请严格对照下表。智简魔方 V10 对环境比较挑剔，版本不对直接导致安装失败或功能异常。
| 组件 | 要求 | 说明 |
|---|---|---|
| PHP | 7.2 或 7.3（推荐 7.3） | 官方要求 PHP >= 7.2.5 且 < 7.4.0 [citation:8]。PHP 7.4 虽然接近，但部分社区反馈存在兼容问题，建议严格用 7.3。 |
| MySQL | 5.7 | 官方硬性要求 MySQL 5.7 [citation:2][citation:8]。 |
| PHP 扩展 | ionCube、fileinfo | 必须安装，否则安装向导无法运行 [citation:8]。 |
| Nginx | 任意稳定版 | 推荐使用 Nginx，伪静态配置比 Apache 简单。 |
进入宝塔 软件商店，搜索 PHP，选择 PHP-7.3 进行安装（极速安装即可，不需要编译安装）。
PHP 7.3 安装完成后，点击 设置 -> 安装扩展，找到并安装：
ionCube（必装，智简魔方核心依赖）fileinfo（必装）在软件商店中安装 MySQL 5.7。如果服务器内存小于 2G，建议先添加 Swap 虚拟内存，否则 MySQL 5.7 可能启动失败。
官方建议将 Nginx 的连接超时时间改为 300。在宝塔 软件商店 -> Nginx -> 配置修改 中，找到 keepalive_timeout 并修改为：
keepalive_timeout 300;点击宝塔左侧 网站 -> 添加站点：
utf8mb4，并记下数据库名和密码。从智简魔方官网或 GitHub 下载 V10 安装包 [citation:2]。进入站点根目录（如 /www/wwwroot/你的域名），上传压缩包并解压。
关键步骤：解压后如果发现文件都在一个子文件夹里（比如 ZJMF-CBAP-master），需要进入该文件夹，全选所有文件，剪切并粘贴到站点根目录，确保 public、app 等文件夹直接位于根目录下 [citation:8]。
这一步做错，访问网站会直接 404 或 500。
进入站点设置 -> 网站目录，将“运行目录”从默认的 / 修改为 /public，然后保存 [citation:4][citation:8]。
在站点设置 -> 伪静态 中，粘贴以下规则并保存 [citation:8]：
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
break;
}
}在浏览器访问你的域名，应该能看到智简魔方的安装界面。
localhost。大概率是运行目录没改成 /public。去站点设置 -> 网站目录里检查一下。
确认 PHP 7.3 的 ionCube 扩展是否已安装并处于“运行中”状态。如果装了但还报错，尝试在宝塔 PHP 设置里 重启 PHP，然后刷新安装页面。
首先检查伪静态规则是否填写正确。如果伪静态没问题，去宝塔 网站 -> 站点 日志 中查看 Nginx 错误日志，通常会提示具体是哪个文件缺失或 PHP 报错。另外，确认 config 目录是否有写入权限（宝塔默认通常没问题）。
核对安装完成时保存的“后台安全地址”是否输入完整。如果不小心关了页面，去网站根目录找到 config.php（或 data/config.php），里面通常记录了后台入口路径和授权码 [citation:3]。