系统安装

环境要求

组件	版本要求	说明
PHP	>= 8.0	推荐 8.1 及以上
MySQL	>= 8.0	推荐 8.0.25+
Nginx / Apache	-	推荐 Nginx 1.20+
Redis	>= 5.0	用于缓存和队列
内存	>= 2G	推荐 4G 以上
磁盘空间	>= 20G	含附件、会话存档等数据

安装步骤

1. 下载源码

从官方渠道获取 Niucloud 主框架 + SCRM_v2 插件安装包，或从代码仓库克隆：

git clone <your-repo-url> niucloud-2.0
cd niucloud-2.0

2. 配置 Web 服务器

Nginx 配置示例：

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/niucloud-2.0/public;
    index index.php index.html;

    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php?s=$1 last;
            break;
        }
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

3. 安装 Niucloud 主框架

1. 浏览器访问 http://your-domain.com
2. 按照安装向导完成数据库配置、管理员账号创建
3. 安装完成后，进入平台管理后台

4. 安装 SCRM_v2 插件

方式一：应用市场安装

1. 登录平台管理后台
2. 进入 应用 → 应用市场
3. 搜索 "SCRM" 或 "企微AI-SCRM"
4. 点击安装，等待安装完成

方式二：本地插件安装

1. 将 scrm_v2 插件目录放到 niucloud/addon/ 下
2. 登录平台管理后台
3. 进入 应用 → 未安装应用
4. 找到 SCRM_v2 插件，点击安装

5. 站点配置

1. 进入 站点 → 站点管理
2. 新建站点或编辑已有站点
3. 在"可用应用"中勾选 "SCRM"
4. 保存配置

6. 访问 SCRM 管理后台

1. 在站点管理中进入对应站点
2. 或直接访问 http://your-domain.com/admin
3. 左侧导航即可看到 SCRM 相关菜单

企业微信配置

SCRM_v2 依赖企业微信开放能力，需完成以下配置：

1. 注册企业微信

如果还没有企业微信，请到 企业微信官网 注册。

2. 创建应用

1. 登录企业微信管理后台
2. 进入 应用管理 → 自建 → 创建应用
3. 填写应用名称、logo、可见范围
4. 创建后记录 AgentId 和 Secret

3. 配置回调

在 SCRM 系统中进入 系统设置 → 企微接入，按页面指引完成：

• 企业 ID（CorpID）
• 通讯录 Secret
• 应用 AgentId 和 Secret
• 回调 URL 和 Token 配置
• 事件订阅配置

4. 配置侧边栏

1. 在企业微信管理后台配置聊天侧边栏
2. 在 SCRM 系统中配置侧边栏应用链接
3. 员工在企业微信中即可使用侧边栏功能

5. 会话存档配置（可选）

如需会话存档功能，需：

1. 企业微信开通会话存档功能
2. 在 SCRM 系统中配置存档相关参数
3. 部署存档接收服务

数据库初始化

系统安装时会自动创建数据库表。如需手动执行，SQL 文件位于：

niucloud/addon/scrm_v2/sql/install.sql

所有表名以 scrm_ 前缀开头，便于识别和管理。

插件启用与升级

启用插件

安装完成后，插件默认启用。如需管理：

1. 平台管理后台 → 应用 → 已安装应用
2. 找到 SCRM_v2 插件
3. 可进行启用/禁用、设置、版本升级等操作

版本升级

1. 获取新版本插件包
2. 平台管理后台 → 应用 → 已安装应用
3. 找到 SCRM_v2，点击"升级"
4. 系统会自动执行数据库迁移和代码更新

升级前请务必备份数据库和代码！

常见安装问题

问题	可能原因	解决方案
页面 404	URL 重写未配置	检查 Nginx/Apache 重写规则
安装页面空白	PHP 版本过低或扩展缺失	检查 PHP 版本 >= 8.0，安装必要扩展
数据库连接失败	配置错误或数据库未创建	检查数据库地址、用户名、密码
插件安装失败	目录权限不足	确保 addon/ 目录可写
企微回调失败	回调地址或 Token 错误	检查企微后台与系统配置是否一致

---

下一步：安装完成后，继续阅读 系统配置 完成基础配置。