ClayBBS 加密版安装教程

一、安装前准备

正式包不内置测试授权文件。安装完成后，系统会为当前域名获取或放入对应的 clayguard.lic。用户也可以登录“我的授权”页面，直接下载对应域名的 clayguard.lic。

二、上传并解压安装包

1. 下载官方提供的正式商用 ZIP：ClayBBS.zip。
2. 上传到服务器网站目录，例如 /www/wwwroot/example.com。
3. 在网站根目录直接解压。
4. 确认根目录能看到 index.php、app/、loaders/、CLAYGUARD_DIST.json、CLAYGUARD_MANIFEST.sig。
5. 不要多套一层外层文件夹，否则访问路径会不正确。

三、启用 ClayGuard 运行组件

推荐使用包内一键脚本自动安装：

bash tools/install-clayguard-loader.sh

如需手动安装，可参考宝塔 PHP 8.2 示例：

cd /www/wwwroot/example.com
/www/server/php/82/bin/php-config --extension-dir
cp loaders/linux-x86_64/php-8.2/nts/clayguard.so /www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/clayguard.so
echo "extension=clayguard.so" >> /www/server/php/82/etc/php.ini
/etc/init.d/php-fpm-82 restart

四、检查是否启用成功

在网站根目录执行：

php tools/clayguard-check.php

正常输出应包含：

[OK] clayguard_require available

如果没有成功，请检查 PHP 版本、扩展目录、php.ini 配置以及 PHP-FPM 是否已重启。

五、验证文件完整性

正式包内包含完整性校验信息，用于确认文件没有被篡改或漏传。

php -d extension=loaders/linux-x86_64/php-8.2/nts/clayguard.so tools/verify-manifest.php .

正常输出：

MANIFEST_OK files=... signature=ok

如果提示文件不匹配，请重新上传完整 ZIP，不要手动修改核心文件。

六、自动获取授权文件

1. 在官方站商户后台输入客户授权码和绑定域名，或让客户在“我的授权”页面直接下载对应域名的 clayguard.lic。
2. 安装向导会自动向官方站请求授权文件。
3. 系统会保存到 storage/license/clayguard.lic。
4. 如果需要手动放置，请确保文件名必须是 clayguard.lic。

七、配置网站运行环境

1. 确认站点绑定域名正确。
2. 确认网站运行目录按当前版本要求设置。
3. 确认 storage/、uploads/ 等运行目录可写。
4. 配置数据库连接。
5. 配置伪静态；如果暂未配置，可使用 index.php?path=... 兼容访问。
6. 重启 PHP-FPM 和 Web 服务。

八、首次访问与安装

1. 浏览器访问授权绑定的域名。
2. 如果进入安装页面，按提示填写数据库信息。
3. 安装完成后进入后台。
4. 检查首页、后台登录、插件管理、主题管理、应用市场、更新中心。
5. 如出现域名不一致提示，请确认授权文件对应当前访问域名。

九、常见问题

十、升级注意事项

1. 官方每次重新生成安装包都会有新的版本标识和签名。
2. 不要混用不同版本的程序文件、运行组件和校验文件。
3. 升级时请整体上传同一个 ZIP 内的文件。
4. 客户授权文件通常可以继续使用，除非域名变更或授权过期。
5. 升级后重新执行运行组件检测和文件校验。