把系统装到自己的服务器

这一篇是给负责装系统的人看的概览。详细的每一步在部署与运维里。

先说清楚这套东西的形态

它是私有化部署的——装在你自己公司的服务器上，不是租别人的账号。

意思是：

• 代码跑在你的服务器上
• 数据库在你的服务器上
• 客户资料、聊天记录、上传的文件，全都在你的服务器上
• 一企一套，跟别家公司完全隔开

代价是：服务器要你自己准备，装和维护也得自己来（或者找我们协助）。

需要准备什么

一台服务器

项目	要求	说明
操作系统	Linux x86_64	就是常见的 Linux 服务器
配置	建议 4 核 CPU、8 GB 内存、40 GB 硬盘	人少可以再低一点
软件	Docker 24 以上 + Docker Compose v2	安装时会有命令检查

ARM 架构的服务器有个限制

会话存档功能（就是把聊天记录存下来的那个）用到一个只支持 x86_64 的程序库。

如果服务器是 ARM 架构（比如某些国产芯片或苹果 M 系列），除了会话存档，其他功能都能正常跑。

一个域名

要一个能配 HTTPS 的域名。

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

服务器位置	要不要备案	说明
香港、新加坡等境外	不用	直接用就行
中国大陆	要	域名得先在工信部登记过

• "备案"是什么意思：在中国大陆的服务器上，域名要在工信部登记过才能用。走完流程通常要几周，要提前安排。
• HTTPS 是什么：网址前面那个小锁。企业微信要求必须用 HTTPS 才能对接，所以证书这一项省不掉。

企业微信的权限

需要企业微信的管理员权限，还要建一个自建应用。

要开通的功能越多，需要的权限就越多。最少要开：客户联系、客户群、标签。要用聊天记录功能，还得单独申请会话存档（这是企业微信的收费能力）。

一个密钥保险箱

安装时会生成一堆密钥，备份包里不包含这些密钥。

所以要另外找个安全的地方存起来，比如公司的密码管理工具或保险柜。丢了密钥，备份也恢复不了。

装完之后大概长这样

服务器上会跑起这么几个东西：

组件	干什么的
网页前端	你在浏览器里看到的界面
后端服务	处理业务逻辑
数据库	存客户、群、标签、配置和业务数据
缓存	存临时状态，让系统跑得快
上传目录	存你上传的素材和附件
网关	把外面的访问转进来，管路径和大小限制

升级和普通回滚不会删除或重建这三个数据卷（数据库、缓存、上传目录）。所以升级是安全的，数据不会丢。

装的时候大概走这些步

1. 准备服务器 —— 装 Docker、检查版本
2. 拿到代码或安装包 —— 三种方式任选：
   • 从授权仓库拉源码，自己构建
   • 从私有镜像仓库拉现成的镜像
   • 用签名的离线包（服务器不能上网时用这个）
3. 跑安装脚本 —— 会问你域名，然后自动生成数据库密码、缓存密码、登录密钥和管理员密码
4. 配 HTTPS —— 用 Nginx 之类的把域名指过来
5. 配企业微信密钥 —— 用脚本把密钥写进服务器配置文件
6. 登录系统 —— 打开 https://你的域名/scrm/，进第一次配置

管理员密码只显示一次

安装脚本跑完会打印一次管理员密码。必须当场存下来，关掉窗口就找不回来了。真丢了要走服务器上的重置流程。

日常要做的三件事

事情	多久做一次	命令
备份	建议每天	./scripts/backup.sh
看服务状态	随时	docker compose ps
升级	有新版时	./scripts/upgrade.sh 版本号

升级出问题可以回滚：

./scripts/rollback.sh

接下来

你要做的事	看哪一篇
一步步装	安装前准备 → 在线安装
服务器不能上网	离线安装
配企业微信	企业微信接入
配域名和 HTTPS	域名与 HTTPS 配置
管密钥	密钥与安全边界
备份和恢复	备份与恢复
升级	升级与回滚
出问题了	日常巡检与故障处理