PHP 版本与扩展：对不上就别硬装
程序对 PHP 版本有明确区间，低于下限或高于上限都可能直接报错。除了版本，还要确认 fileinfo、curl 这类常用扩展已开启。面板里可以一键切换版本与安装扩展，别用默认配置硬碰。
Install Guide
小旋风蜘蛛池安装教程
小旋风蜘蛛池安装教程里真正卡人的从来不是命令，而是顺序、环境和那些看起来不起眼的配置项。
我们帮客户部署过不少池子，翻车点集中在三处：PHP 版本和程序对不上、伪静态规则没生效、缓存目录没有写权限。这篇教程不堆术语，按「环境先过一遍、八步按顺序装、报错按对照表查、上线前跑自检」四段来，每一步都能自己核对。
- 环境要求速查
- 八步安装顺序
- 报错原因对照
- 上线自检清单
TG:@mspseo ｜ Q/V:897569356 ｜ www.yinliuyuan.cn ｜ 装到一半报错，把日志发来，免费帮你看一眼
Before You Start
动手之前，把这三件事弄明白
安装流程本身不复杂，复杂的是环境。下面三块是最容易在安装中途把你卡住的，提前确认过一遍，后面八步会顺很多。
数据库与字符集：先建库、再授权
安装前把库建好，字符集统一为 utf8mb4，避免后期出现乱码。账号不要直接给 root，建一个只对目标库有权限的专用账号更稳妥。地址与端口按实际情况填，远程库别写成 localhost。
目录权限与伪静态：装一半卡住多半是这里
缓存、上传与配置目录必须可写，权限建议按运行用户来设，别图省事直接给 777。伪静态要按 Web 服务器类型选规则，Apache 用 .htaccess，Nginx 用 rewrite 段，两者不能混用。
Eight Steps
八步安装顺序：照着做，不要跳步
下面这八步是有先后依赖的，前一步没验证通过，后一步的问题会更难定位。每一步都写了怎么确认它真的生效了，别只看「没报错」就往下走。
-
上传程序包并解压到站点根目录
通过面板文件管理或 SFTP 把程序包上传到站点目录，解压后确认目录层级正确。常见错误是把压缩包里的外层文件夹一起传上去，导致入口路径多了一层。解压后核对文件数量是否与包内清单一致。
-
先配好伪静态规则，再继续往下
按 Web 服务器类型放置规则文件：Apache 用
.htaccess，Nginx 粘贴 rewrite 段。配好后随便访问一个不存在的路径，如果返回的是程序页面而不是服务器 404，说明规则已生效。 -
创建数据库并确认字符集
在数据库面板新建库，字符集选
utf8mb4，排序规则用对应的 unicode 版本。同时建好专用账号并授予该库的全部权限。字符集不统一，后面导入数据时很容易出现中文乱码。 -
访问安装入口，填写连接信息
浏览器打开安装地址，按提示填数据库主机、端口、库名、账号与密码。远程库要填真实 IP 或域名，端口不是 3306 的要改。点下一步前先确认服务器能连上数据库，避免反复提交。
-
设置管理员账号并完成建表
填写后台管理员账号与强密码，执行安装。这一步程序会创建数据表并写入初始数据，中途不要刷新或关闭页面，否则可能出现表建了一半的残缺状态，排查起来非常麻烦。
-
安装完成后立刻锁掉安装目录
安装成功后，删除或重命名安装目录，防止被重复执行安装流程。很多站点被重新初始化，就是安装目录一直留着没处理。锁掉之后再登录后台，确认能正常进入。
-
配置站点基本信息与站点分组
在后台填写站点名称、域名、首页设置，并按计划把域名分到不同分组。分组的意义是让后续的调度与模板能按组区分，不要所有站点都塞进默认组。
-
权限复查与首次抓取自检
最后回到服务器复查关键目录权限，然后在后台手动触发一次抓取任务，确认能跑通、日志有输出、返回状态码正常。这一步通过，才算真正装完。
Error Reference
常见报错对照表：先判断，再动手
安装过程中遇到的大部分报错，都能归到下面六种里。表里给了「先查什么」，按顺序排查，比盲目改配置快得多。
| 报错现象 | 高概率原因 | 先查什么 | 处理方式 |
|---|---|---|---|
| 安装页白屏或 500 | PHP 版本不兼容、扩展缺失 | PHP 错误日志 | 优先 切版本、补扩展 |
| 数据库连接失败 | 账号密码、端口或权限不对 | 主机与端口、账号权限 | 优先 重建专用账号 |
| 除首页外全部 404 | 伪静态规则未生效 | 访问不存在路径的返回 | 必查 重配规则文件 |
| 提示目录不可写 | 缓存或上传目录权限不足 | 目录属主与运行用户 | 必查 按运行用户授权 |
| 后台能进但样式全乱 | 静态资源路径或域名配置错 | 资源请求的真实地址 | 一般 后台修正域名 |
| 中文显示乱码 | 库表字符集不统一 | 库与表的字符集设置 | 一般 统一为 utf8mb4 |
对照表是经验归纳，不是诊断结论。遇到表里没有的报错，把完整日志发到 TG:@mspseo 或 Q/V:897569356，我们帮你看是哪一层的问题。
Cases
三个安装卡点案例
下面三次都是装到一半卡住的典型，问题的根因都不在程序本身。案例为个体经验，环境不同结论会不一样。
个人站长 · 小陈
首次部署，面板环境
小陈按网上的教程装到第三步就白屏。我们让他先看 PHP 错误日志，发现是 PHP 版本偏高、程序不兼容。在面板里切回程序支持的版本并补上缺失扩展，安装流程一次走完。
「一直以为是程序包有问题，其实是版本没对上。」
运维 · 老赵
自建服务器，十台机器
老赵在 Nginx 上装完后，除首页外全部 404。他一开始怀疑是程序路由问题，我们让他访问一个不存在的路径看返回，果然是伪静态没生效。把 rewrite 段补进站点配置并重载后，问题消失。
「先问服务器返回了什么，比猜程序快。」
站群项目负责人 · 阿凯
批量部署 40 个站点
阿凯批量装的时候，有几个站点导入数据后中文乱码。排查下来是这几个库的字符集还是旧版默认值。统一改成 utf8mb4 并重新导入后恢复正常。之后他把字符集检查加进了部署清单。
「环境清单不是形式，是少踩坑的备忘录。」
案例为个体经验，结果因服务器环境与站点规模而异，本文不针对任何具体服务商作出评价。
FAQ
安装过程中问得最多的六个问题
这些是安装时最常被问到的问题，答案统一放在这里，遇到对应情况先对一遍。
小旋风蜘蛛池安装对服务器环境有什么硬性要求？
主要是三点：PHP 版本要落在程序支持的区间内，数据库建议用 MySQL 且字符集统一为 utf8mb4，Web 服务器要能配置伪静态规则。另外要给缓存目录和上传目录写权限，否则安装到一半会卡在文件写入这一步。
安装教程里的步骤能不能跳着做？
不建议。安装顺序本身是有依赖的，比如数据库要先建好、伪静态要先配好，后一步才能验证前一步是否生效。跳步看似省时间，出问题时反而更难定位是哪一环没做。
伪静态规则报错怎么办？
先确认 Web 服务器类型，Apache 用 .htaccess、Nginx 用 rewrite 规则，两者不能混用。再检查规则文件是否放在正确目录、是否被主配置加载。报 404 或 500 时，多半是规则没生效或语法写错。
数据库连接失败一般是什么原因？
常见的是账号密码写错、数据库地址填成了 localhost 但实际是远程库、或者该账号没有对应库的权限。还有一种容易被忽略：数据库端口不是默认的 3306，安装时忘了改。
安装完成后页面打不开、显示空白怎么排查？
先看 PHP 错误日志，空白页基本都会在里面留下线索。再确认是否开启了调试模式、模板目录是否完整、缓存是否需要在后台清一次。如果是 500 错误，重点检查文件权限和 PHP 版本。
不懂服务器能自己装吗？
如果用的是宝塔一类面板，按教程走基本能装完。但遇到伪静态、权限、扩展缺失这类问题时，需要一点命令行基础。实在卡住，把报错日志发给我们，比自己盲改配置安全得多。
装到一半卡住？把报错日志发来，免费帮你看一眼
不用先付费。把报错截图、PHP 错误日志或服务器返回信息发过来，我们帮你判断是哪一层的问题，告诉你怎么改。
TG:@mspseo ｜ Q/V:897569356 ｜ www.yinliuyuan.cn ｜ 排错不收费，也不会追着你下单
Related
装完之后，这几篇接着看
安装只是起点。下面六篇覆盖了程序整体说明、模板配置、版本核对与更细的部署教程，装完池子后按需要往下读。