企业 SCRM 使用说明书

深浅色

安装前准备 ​

这一篇是干什么的：动手装系统之前，把要准备的东西一次说清楚。清单备齐了，正式安装十几分钟就能走完。

先说清一件事：这套系统是"私有化部署"——装在你公司自己的服务器上，数据存在你自己手里。所以下面这些东西都要你自己准备，不是我们给你一个网址就能用。

安装前准备：在服务器上检查环境的命令和输出示例

一、一台服务器 ​

项目要求
操作系统Linux，x86_64 架构
Docker Engine24 或更高版本
Docker Composev2 版本
CPU建议 4 核
内存建议 8 GB
磁盘建议 40 GB 可用
其他工具OpenSSL、Curl（多数系统自带）

看不懂的词，一句话解释：

  • Docker：一个"把软件和它需要的一切打包成一个盒子来运行"的工具。跑起来的盒子叫容器。
  • Docker Compose：按一份配置文件，把好几个容器一起启动、一起管理的工具。
  • x86_64：服务器 CPU 的一种常见型号。买云服务器时看清这一项，别选 ARM 架构。

登录服务器后，跑这三条命令检查：

bash
docker version
docker compose version
openssl version

每条都能打印出版本号，就算合格。看到 command not found，说明这项还没装，先装上再继续。

ARM 架构的服务器用不了聊天存档

把员工和客户的聊天记录存下来（"会话存档"），用到的官方程序只有 x86_64 版本。ARM 服务器可以跑其他功能，但聊天存档这一块用不了。

二、一个域名 ​

一个专用的域名（下文统一写成「你的域名」）。建议用公司自己的域名——企业微信对"可信域名"有归属要求，用公司名义最省事。

要不要备案，看服务器放在哪：

服务器位置要不要备案
香港、新加坡等境外不用，直接用
中国大陆要，域名得先在工信部登记
  • 备案是什么：在中国大陆的服务器上，域名要在工信部登记过才能用。走完流程通常要几周，要提前安排。
  • 域名还要能配 HTTPS（地址栏带小锁的加密访问）。企业微信只接受 HTTPS 地址，所以证书这一项省不掉。

三、企业微信这边的准备 ​

要准备的说明
企业微信管理员账号要有创建和管理"自建应用"的权限
一个自建应用在企微管理后台创建，用来和这套系统对接
会话存档（可选）聊天功能的前提。企微官方的收费能力，要单独申请、签协议

"会话存档"是什么：企业微信官方提供的一个能力，作用是"把员工和客户的聊天内容保存到服务器上"。它是收费的，而且要单独向企业微信申请、签协议、员工要同意。不开通也能用系统，只是聊天相关的页面会是空的。

四、要提前拿到手的参数 ​

这些参数在装系统的过程中要用。有的填在网页上，有的灌进服务器（区别见下面）。

参数从哪拿怎么给系统
企业 ID（CorpID）企微后台 → 我的企业网页上填
应用 ID（AgentID）企微后台 → 应用管理 → 自建应用网页上填
应用 Secret自建应用详情页只走服务器密钥文件
回调 Token创建应用时设置或随机生成只走服务器密钥文件
EncodingAESKey同上只走服务器密钥文件
会话存档 Secret企微后台 → 会话存档只走服务器密钥文件
会话存档私钥文件企微后台 → 会话存档，下载只走服务器密钥文件

钥匙不走网页

企业 ID 和应用 ID 是"明牌"，网页上直接填。

应用 Secret、回调 Token、EncodingAESKey、会话存档密钥和私钥是"钥匙"，只能通过服务器上的密钥文件灌进去。网页不接收、也不回显。这样设计，钥匙永远不经过浏览器。

五、决定两件事 ​

第一件：装在哪条路径下。

默认装在域名的 /scrm 路径下，访问地址是 https://你的域名/scrm/tools/。想换别的路径（比如 /ops），在安装前改 deploy/runtime.env 里的 SCRM_PATH_PREFIX。

规则：不能是 /，也不能以 / 结尾。

第二件：用哪种安装方式。

方式适合的情况看哪篇
在线安装服务器能上外网在线安装（一步一步）
离线安装服务器不能上外网离线安装（不能联网的服务器）

六、最后核对一遍 ​

  • [ ] 服务器：Linux x86_64，装好 Docker 和 Compose
  • [ ] 域名：能配 HTTPS，准备解析到服务器（大陆服务器还要先备案）
  • [ ] 企微：管理员账号就位，自建应用已创建，参数已拿到
  • [ ] 会话存档：需要聊天功能的话，已向企微申请
  • [ ] 安装方式：在线还是离线，已经确定

相关页面 ​

本说明书为企业 SCRM 私有化部署产品的配套文档

企业 SCRM