从零部署云枢社区

一、部署概览

云枢社区后端由 PHP API、三套管理后台、安装向导、上传目录和授权配置组成。整个项目应作为网站根目录，不能把 Web 根目录单独指向 api/ 或某个后台目录。

二、服务器要求

推荐使用 64 位 Linux、2 核 CPU、4 GB 内存和 40 GB 可用磁盘。小型测试环境可以使用 2 GB 内存。

宝塔面板安装扩展

进入“软件商店”，打开网站实际使用的 PHP 版本，进入“设置 → 安装扩展”，安装 pdo_mysql、mbstring、curl、zip、openssl、fileinfo 和 gd，随后重启 PHP-FPM。

php -m | grep -E 'pdo_mysql|mbstring|curl|zip|openssl|fileinfo|gd'
php -r 'var_dump(class_exists("ZipArchive"));'

三、域名和网站目录

目录权限

chown -R www:www /www/wwwroot/community
find /www/wwwroot/community -type d -exec chmod 755 {} \;
find /www/wwwroot/community -type f -exec chmod 644 {} \;
chmod -R 775 /www/wwwroot/community/uploads

四、创建数据库

在宝塔面板“数据库”中新建 MySQL 数据库，字符集选择 utf8mb4。记录数据库名、用户名和密码，安装器会使用这些信息生成 api/config.local.php。

五、运行安装向导

首次访问网站根域名时，系统会检测是否已安装并跳转安装页面。也可以直接访问：

https://community.example.com/install.php

1. 检查 PHP 版本、扩展、目录写入能力。
2. 填写 MySQL 地址、端口、数据库名、用户名和密码。
3. 选择是否导入初始数据，已有站点应勾选保留数据。
4. 创建管理员账号并设置强密码。
5. 等待安装器建表、写入数据库配置并生成安装锁。

六、HTTPS 与安全配置

• 在宝塔中申请并强制启用 HTTPS。
• 后台管理域名建议限制管理员 IP，或启用面板访问密钥。
• 禁止直接访问 SQL、ZIP、日志、数据库备份和系统更新存储目录。
• PHP 进程只能写入必要的 uploads/、系统临时目录和更新所需目录。
• 不要随意修改 PHP 的 open_basedir 或关闭 HTTPS 证书校验。

location ~* \.(sql|zip|log|bak|ini)$ {
    deny all;
}

location ~ ^/api/(config\.local\.php|install\.lock\.php|license_config\.php)$ {
    deny all;
}

location ^~ /uploads/ {
    try_files $uri =404;
}

下载完整 Nginx 配置示例

七、购买并绑定域名授权

打开授权平台，注册账号后进入“购买授权”，先选择“云枢社区”程序，再选择授权周期和实际部署域名。

return [
    'enabled' => true,
    'server_url' => 'https://auth.example.com/auth_server.php',
    'app_key' => '授权平台中云枢社区程序的 AppKey',
    'timeout' => 6,
    'cache_minutes' => 5,
];

八、进入管理后台

安装完成后有三种后台入口，可先使用经典后台完成基础配置，再切换到动效版。

上线前建议配置

九、授权与在线更新

授权管理后台发布新版本时配置版本、更新标题、更新日志和 ZIP 下载链接。社区后台进入“系统配置 → 系统更新”检查版本。

• 社区服务器需要 PHP ZipArchive 扩展。
• 系统会校验授权域名、程序 AppKey 和更新包 SHA-256。
• 覆盖文件前会保存可回滚备份。
• 数据库配置、授权配置、安装锁、uploads 和 storage 不会被更新包覆盖。
• 安装成功后可删除不再需要的旧更新备份，但不要删除当前可用的回滚记录。

十、备份和维护

建议保留最近至少 7 天的数据库和文件备份，并将备份下载到另一台服务器或对象存储。在线更新的临时回滚目录位于系统临时目录，服务器重启或临时文件清理后可能消失，不能代替正式备份。

十一、常见故障