系统环境要求

在安装协会管理系统之前，请确认你的服务器满足以下条件。不满足会导致安装失败或运行异常。

建议使用 宝塔面板 管理服务器，安装和配置会简单很多。以下示例均以宝塔 + Nginx 为准。

一、服务器配置建议

| 项目 | 最低配置 | 推荐配置 | |---|---|---| | CPU | 2 核 | 4 核 | | 内存 | 2 GB | 4 GB 以上 | | 硬盘 | 40 GB | 100 GB（档案多的话越大越好） | | 带宽 | 3 Mbps | 5 Mbps 以上 | | 系统 | Ubuntu 20.04 / CentOS 7.9 | Ubuntu 22.04 |

档案管理会存很多扫描件，硬盘建议留足。一个协会一年档案大概 2-5 GB。

二、软件环境

| 软件 | 版本要求 | 说明 | |---|---|---| | PHP | 8.2（最低 8.1） | 必须开启指定扩展，见下 | | MySQL | 5.7 或 8.0 | 字符集必须 utf8mb4 | | Nginx | 1.20+ | 或 Apache 2.4+ | | Composer | 2.x | 装依赖用 |

三、PHP 必须开启的扩展

在宝塔面板「软件商店 → PHP 8.2 → 设置 → 安装扩展」中开启：

fileinfo        ← 文件上传识别
gd              ← 图片处理（缩略图）
zip             ← 压缩包处理
mbstring        ← 中文字符
openssl         ← 加密/授权签名
pdo_mysql       ← 数据库
curl            ← 接口调用
bcmath          ← 金额计算
exif            ← 图片信息
intl            ← 国际化

同时需要解除以下函数禁用（宝塔默认禁用了部分）：

proc_open
proc_get_status
putenv
pcntl_signal
symlink

位置：宝塔 → PHP 设置 → 禁用函数 → 删除上述几项 → 保存。

四、Nginx 伪静态配置

宝塔建站后，在「网站 → 设置 → 伪静态」选择 laravel5，或手填：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

五、目录权限

以下目录必须给 www 用户 755 权限（宝塔默认 www）：

chown -R www:www /www/wwwroot/你的站点目录
chmod -R 755 /www/wwwroot/你的站点目录
chmod -R 775 /www/wwwroot/你的站点目录/storage
chmod -R 775 /www/wwwroot/你的站点目录/bootstrap/cache

六、检查清单

安装前逐项打勾：

• [ ] PHP 8.2 + 上述扩展全开
• [ ] MySQL 5.7+ 建好数据库（utf8mb4）
• [ ] Nginx 伪静态已配
• [ ] 目录权限已给 www
• [ ] 已备好域名并解析到服务器
• [ ] 已申请 SSL 证书（小程序/微信公众号必须 https）

全部满足后，进入下一步：源码下载与上传