Spiu API 聚合管理系统搭建教程

一、运行环境

建议使用以下服务器环境：

Linux 服务器，推荐 CentOS、Ubuntu 或 Debian
Nginx 或 Apache
PHP 8.1，必须是 8.1 版本
MySQL 5.7 及以上版本
Redis 服务
SourceGuardian Loader

PHP 必须启用以下扩展：

mysqli
pdo
pdo_mysql
redis
fileinfo
openssl
curl
mbstring
SourceGuardian

二、创建网站

在宝塔面板或其他服务器面板中创建网站，并完成以下配置：

绑定需要使用的域名。
将网站运行目录设置为程序根目录。
PHP 版本选择 PHP 8.1。
创建一个新的 MySQL 数据库。
数据库字符集建议选择 utf8mb4。
开启网站 HTTPS，推荐部署 SSL 证书。

不要将程序放在二级目录中，建议直接部署到域名根目录。

三、上传程序

将完整程序上传到网站根目录并解压。

解压完成后，网站根目录应当能够看到：

index.php
admin.php
api.php
includes/
install/
template/
assets/

请删除网站根目录中的 .zip、.rar、.7z、.tar.gz 等程序压缩包，防止数据库配置和程序源码泄露。

四、设置目录权限

安装期间需要保证以下目录和文件可写：

网站根目录
includes/
install/
admin.php

安装程序需要完成以下操作：

写入 includes/config.php
导入 install/install.sql
创建 install/install.lock
根据填写的后台入口重命名 admin.php

Linux 环境下可根据网站运行用户设置目录所有者及权限，不建议长期使用 777 权限。

伪静态

location ^~ /Houtai/back/ {
    return 404;
}

location ^~ /includes/plugins/ {
    return 404;
}

location ~* ^/assets/.*\.(php|php3|php4|php5|phtml|phar|asp|aspx|jsp|cgi|pl)$ {
    return 403;
}

location ~ ^/api/(.+)\.api$ {
    rewrite ^/api/(.+)\.api$ /api/$1/api.php last;
}

error_page 403 /403.html;
error_page 404 /404.html;

五、安装 SourceGuardian Loader

访问网站首页时，如果没有安装 SourceGuardian Loader，系统会自动跳转到：

https://你的域名/install/SourceGuardian.php

安装助手会显示当前服务器的：

PHP 版本
操作系统
PHP 配置文件位置
PHP 扩展目录
线程安全状态
SourceGuardian 安装状态

根据页面提示下载适用于 PHP 8.1、当前系统及系统位数的 SourceGuardian Loader。

Linux 环境的配置示例：

extension=ixed.8.1.lin
sourceguardian.enable_vm_hybrid=1

实际扩展文件名请以 SourceGuardian 官方下载包为准。配置完成后重启 PHP 服务，再刷新安装助手页面。

六、开始安装系统

SourceGuardian 安装完成后，访问：

https://你的域名/install/

按照页面提示完成安装前的确认，然后进入正式安装向导。

七、环境检测

安装程序会自动检查：

PHP 版本是否符合要求
MySQLi 扩展是否启用
数据库配置目录是否可写
必要的 PHP 扩展是否启用

如果出现红色错误提示，请先修复对应问题，再继续安装。

八、填写数据库信息

根据创建网站时的数据库资料填写：

数据库地址：本机数据库一般填写 localhost
数据库端口：默认填写 3306
数据库名称：填写已创建的数据库名
数据库账号：填写数据库用户名
数据库密码：填写数据库密码
数据表前缀：默认使用 api

安装程序会自动读取并导入 install/install.sql，正常情况下不需要手动导入数据库。

请使用空数据库进行安装，避免已有数据表产生冲突。

九、设置后台信息

安装页面支持自定义后台账号、密码和后台入口。

需要填写：

后台入口文件名
管理员账号
管理员密码
确认管理员密码

后台入口只填写文件名，不需要填写 .php，例如：

api_manage_2026

安装完成后的后台地址为：

https://你的域名/api_manage_2026.php

后台入口不能使用 admin，管理员密码长度不能少于 6 位。建议使用包含大小写字母、数字和特殊符号的强密码。

十、填写系统授权码

打开以下文件：

includes/authcode.php

将授权平台提供的 32 位授权码填写到 $authcode 中：

$authcode = '这里填写32位授权码';

授权码不能为空，也不能包含多余空格。未填写时系统会明确提示“授权码为空”，授权码错误时会提示“授权码不正确”。

十一、完成安装

安装成功后，系统会自动：

导入数据库表和初始数据
保存数据库连接信息
写入管理员账号和密码
创建新的后台入口文件
删除原始的 admin.php
创建 install/install.lock

请妥善保存安装完成页面显示的管理员账号、密码和后台地址。

十二、安装后的安全处理

安装完成后请立即进行以下操作：

确认 install/install.lock 文件存在。
删除安装目录中除 install.lock 外的安装文件。
删除网站根目录中的所有程序压缩包。
修改后台管理员密码。
妥善保存自定义后台入口地址。
配置 HTTPS 并强制使用 HTTPS。
设置数据库定期备份。
不要对外公开数据库密码和系统授权码。

install.lock 是系统安装保护文件，不要删除。删除后系统会认为程序尚未安装，并存在被重新安装的安全风险。

十三、常见问题

访问首页自动进入 SourceGuardian 安装助手

说明当前 PHP 8.1 环境没有正确加载 SourceGuardian Loader。检查扩展文件、php.ini 配置，并重启 PHP 服务。

提示请使用 PHP 8.1

本系统要求 PHP 8.1，PHP 8.0、8.2 或其他版本均不符合当前程序要求。

提示缺少 Redis 或 Fileinfo 扩展

进入 PHP 扩展管理页面安装并启用 redis、fileinfo，然后重启 PHP。

提示数据库连接失败

检查数据库地址、端口、名称、账号和密码，并确认 MySQL 服务正常运行。

提示无法写入配置文件

检查 includes 目录及网站根目录的写入权限。

安装 SQL 导入失败

请确认使用的是空数据库，并检查数据库用户是否具有创建表、删除表、插入和修改数据的权限。

后台地址无法访问

后台入口会根据安装时填写的名称生成，例如填写 api_manage，实际文件为：

/api_manage.php

请不要继续访问原来的 /admin.php。

需要重新安装系统

先备份数据库和重要文件，然后删除：

install/install.lock

重新上传完整的安装目录后，再访问 /install/。重新安装会覆盖数据库内容，操作前必须做好备份。

文章版权归作者所有，未经允许请勿转载。

THE END

Spiu-API聚合管理系统安装教程