手把手教你企业微信SCRM源码下载和私有化部署教程

服务器要求

MoChat 对系统环境有一些要求，仅可运行于 Linux 和 Mac 环境下，但由于 Docker 虚拟化技术的发展，在 Windows 下也可以通过 Docker for Windows 来作为运行环境，通常来说 Mac 环境下，我们更推荐本地环境部署，以避免 Docker 共享磁盘缓慢导致 MoChat 启动速度慢的问题。

提示

MoChat 基于 Docker-compose 方式的安装视频https://www.bilibili.com/video/BV1Dy4y1n77N/(opens new window)

mochat-cloud\mochat-docker (opens new window)项目内已经为您准备好了各种版本的 Dockerfile ，或直接基于已经构建好的mochat\mochat (opens new window)镜像来运行。

以上 Github 暂未提交，请暂时参考项目中的api-server/Dockerfile

当您不想采用 Docker 来作为运行的环境基础时，您需要确保您的运行环境达到了以下的要求：

PHP >= 7.4 (推荐7.4版本)

MYSQL >= 5.7

Swoole PHP 扩展 >= 4.5，并关闭了Short Name

OpenSSL PHP 扩展

JSON PHP 扩展

PDO PHP 扩展

Redis PHP 扩展

pcntl PHP 扩展

Composer

FFMpeg（会话存档功能需要）

wxwork_finance_sdk PHP 扩展 （会话存档功能需要）

Node.js >= 10

#安装 MoChat

MoChat 使用Composer (opens new window)来管理项目的依赖，在使用 MoChat 之前，请确保你的运行环境已经安装好了 Composer。

建议将 Composer 镜像设置为阿里云镜像，加速国内下载速度

视情况而定

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer

#项目下载

假设项目相关代码都放在/data/www目录

cd /data/www

git clone https://github.com/mochat-cloud/mochat.git

#PHP接口环境安装

#Shell 安装方式

为了方便非docker用户，我们额外提供了一个install.shCentOS 下的环境安装脚本，你可以直接在相应的系统上运行。

# 安装linux软件如 php、swoole、FFMpeg、wxwork_finance_sdk等等(为避免软件冲突覆盖，本安装不会自动创建软链接，需要根据脚本提示手动创建，请放心执行)

cd /usr/local/src

wget https://mochatcloud.oss-cn-beijing.aliyuncs.com/deploy/CentOS-install.sh

chmod o+x ./CentOS-install.sh

sh ./CentOS-install.sh

如自行编译安装 PHP 相关环境，wxwork_finance_sdk 的安装可参考：https://github.com/oh-stone/wework-chatdata-sdk(opens new window)

#确认相关环境正确安装

# 查看 PHP 版本是否正确，需 >= 7.4

php -v

# 查看 Swoole 版本安装是否正确，并确定 `swoole.use_shortname` 参数值为 `Off`

php --ri swoole

# 查看 Reids wxwork_finance_sdk 扩展是否正确安装

php --ri redis

php --ri wxwork_finance_sdk

# FFMpeg

ffmpeg -version

# 确保内存大于 1024M

php -i | grep memory_limit

# 以下函数不能禁用

# symlink,putenv,proc_open,pcntl系列函数

# 安装PHP依赖(./api-server目录下)

cd /data/www/mochat/api-server

composer install

# 初始化项目，执行项目初始化命令，设置MySQL、Redis、OSS、默认用户等信息

cp .env.example .env

php bin/hyperf.php mc:init

# 运行项目 (推荐使用Supervisor后台守护，具体使用可参考 Hyperf 官方文档-Supervisor部署)

php bin/hyperf.php start

# 或后台启动

php bin/hyperf.php server:start -d

# 或开发环境也可以使用 watch 命令来进行热更新

php bin/hyperf.php server:watch

如果 mc:init 执行失败，可参考：

# 1、将 .env 中的 DB REDIS OSS DOMAIN 配置完成

# 2、将数据库文件导入初始化 api-server/storage/install/mochat.sql

# 3、执行初始租户和账号信息 SQL ，请注意修改下面的手机号和服务器IP，以下用户密码是 13412347867和123456

# 4、使用下面的命令生成新密码，然后用SQL替换到 user 表里的密码就可以。

php -r "var_dump(password_hash(md5('具体密码' . ".env中的SIMPLE_JWT_SECRET"), PASSWORD_BCRYPT));"

INSERT INTO `mc_user` (`phone`,`password`,`status`,`isSuperAdmin`) VALUES ('13412347867','这里填写生成的加密后的密码',1,1);

INSERT INTO `mc_tenant` (`server_ips`) VALUES ('["182.92.11.11"]');

由于 MoChat 是持久化的 CLI 框架，当您修改完您的代码后，通过CTRL + C终止当前启动的进程实例，并重新执行php bin/hyperf.php start启动命令即可。

#Docker 方式安装

为了节省复杂度，我们推荐您使用项目下已经编写好的Dockerfile环境

开发、测试环境下，您可以使用docker-compose.sample.yml来直接运行容器

线上正式环境，我们推荐使用K8S，使用滚动更新来应对系统的平滑重启

# 需要您在服务器上安装`docker/docker-compose`，并且开启了`docker`

cp docker-compose.sample.yml docker-compose.yml

# 初始化项目

docker-compose build

# 运行容器服务(如果要初始化项目，可以将启动命令改为`php bin/hyperf.php mc:init`)

docker-compose up

#存在兼容性问题的扩展

由于 Hyperf 基于 Swoole 协程实现，而 Swoole 4 带来的协程功能是 PHP 前所未有的，所以与不少扩展都仍存在兼容性的问题。 以下扩展（包括但不限于）都会造成一定的兼容性问题，不能与之共用或共存：

xhprof

xdebug

blackfire

trace

uopz

#前端项目编译

项目安装前，需要安装Node.js，目前已知 15.x 版本下项目编译会有问题。

修改.env中的配置VUE_APP_API_BASE_URL=接口地址，以下的4种都是正确的格工，请根据您的实际情况进行配置。

# 1、HTTP协议方式

VUE_APP_API_BASE_URL=http://api.mochat.com

# 2、HTTPS协议方式

VUE_APP_API_BASE_URL=https://api.mochat.com

# 3、HTTP协议与HTTPS协议同时兼容方式

VUE_APP_API_BASE_URL=//api.mochat.com

# 4、子目录模式(需根据实际 Nginx 配置来确定是否 URL中是否需要加 api )

VUE_APP_API_BASE_URL=http://scrm.mochat.com/api

#H5侧边栏编译

cd /data/www/mochat/sidebar

cp .env.example .env

# 修改.env中的接口地址

vim .env

yarn install

yarn run build

#商户管理后台编译

cd /data/www/mochat/dashboard

cp .env.example .env

# 修改.env中的接口地址

vim .env

yarn install

yarn run dll

yarn run build

#运营工具H5编译

cd /data/www/mochat/operation

cp .env.example .env

# 修改.env中的接口地址

vim .env

yarn install

yarn run build

#Nginx 配置

在这里我们会用到三个域名

api.mochat.com 后端接口域名 api-server 对应的域名

scrm.mochat.com 商户后台域名 dashboard 对应的域名

sidebar.mochat.com 聊天侧边栏域名 sidebar 对应的域名

op.mochat.com 运营工具H5域名 operation 对应的域名

项目位置/data/www/mochat

#后端-接口配置

server {

    # 监听端口

    listen 80;

    # 绑定的域名，填写您的域名

    server_name api.mochat.com;

    location / {

        # 将客户端的 Host 和 IP 信息一并转发到对应节点 

        proxy_set_header Host $http_host;

        proxy_set_header X-Real-IP $remote_addr;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        # 转发Cookie，设置 SameSite

        proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";

        # 执行代理访问真实服务器

        proxy_pass http://127.0.0.1:9501;

    }

}

#前端-PC后台配置

server {

    listen 80;

    server_name scrm.mochat.com;

    access_log /var/log/nginx/scrm.mochat.com.log main;

    error_log /var/log/nginx/scrm.mochat.com.log.err error;

    fastcgi_intercept_errors off;

    rewrite_log off;

    location / {

        root /data/www/mochat/dashboard/dist;

        index index.html;

        try_files $uri $uri/ /index.html; 

    }

    location /authRedirect {

        proxy_set_header Host $http_host;

        proxy_set_header X-Real-IP $remote_addr;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        # http时使用下面的配置

        proxy_cookie_path / "/; HttpOnly; SameSite=strict";

        # https时使用下面的配置

        # proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";

        proxy_pass http://127.0.0.1:9501/dashboard/officialAccount/authRedirect/;

    }


    location ~* \.(?:jpg|jpeg|png|gif|ico|css|js)$ {

        # 缓存30天

        expires 30d;

    }

    location = /favicon.ico {

            log_not_found off;

            access_log off;

    }

}

#前端-H5侧边栏配置

server {

    listen 80;

    server_name sidebar.mochat.com;

    access_log /var/log/nginx/sidebar.mochat.com.log main;

    error_log /var/log/nginx/sidebar.mochat.com.log.err error;

    fastcgi_intercept_errors off;

    rewrite_log off;

    location / {

        root /data/www/mochat/sidebar/dist;

        index index.html;

        try_files $uri $uri/ /index.html;

    }


    location ~* \.(?:jpg|jpeg|png|gif|ico|css|js)$ {

        # 缓存30天

        expires 30d;

    }

    location = /favicon.ico {

            log_not_found off;

            access_log off;

    }


}

#前端-运营工具栏配置

server {

    listen 80;

    server_name op.mochat.com;

    access_log /var/log/nginx/op.mochat.com.log main;

    error_log /var/log/nginx/op.mochat.com.log.err error;

    fastcgi_intercept_errors off;

    rewrite_log off;

    location / {

        root /data/www/mochat/operation/dist;

        index index.html;

        try_files $uri $uri/ /index.html;

    }

    location ^~ /auth/ {

            proxy_set_header Host $http_host;

            proxy_set_header X-Real-IP $remote_addr;

            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

            # http时使用下面的配置

            proxy_cookie_path / "/; HttpOnly; SameSite=strict";

            # https时使用下面的配置

            # proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";


            proxy_pass http://127.0.0.1:9501/operation/auth/;

      }


  location ^~ /openUserInfo/ {

        proxy_set_header Host $http_host;

        proxy_set_header X-Real-IP $remote_addr;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        # http时使用下面的配置

        proxy_cookie_path / "/; HttpOnly; SameSite=strict";

        # https时使用下面的配置

        # proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";

        proxy_pass http://127.0.0.1:9501/operation/openUserInfo/;

  }


    location ~* \.(?:jpg|jpeg|png|gif|ico|css|js)$ {

        # 缓存30天

        expires 30d;

    }

    location = /favicon.ico {

            log_not_found off;

            access_log off;

    }


}

#运行

#登录

配置以上用到的三个域名对应的服务器IP至您的 host 文件

在浏览器输入 http://scrm.mochat.com

进入项目，在系统设置 -> 授权管理 中点击 添加企业微信号

如果您没有企业微信号，您可以到企业微信官网网站注册调试用的企业微信号

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 211,884评论 6赞 492
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,347评论 3赞 385
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 157,435评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,509评论 1赞 284
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 65,611评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,837评论 1赞 290
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,987评论 3赞 408
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,730评论 0赞 267
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,194评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,525评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,664评论 1赞 340
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,334评论 4赞 330
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,944评论 3赞 313
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,764评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,997评论 1赞 266
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,389评论 2赞 360
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,554评论 2赞 349

推荐阅读更多精彩内容