Docker-compose项目实践，一键部署开源项目Open-IM-Server，源码和docker部署对比版本

落日映苍穹つ 2022-09-02 08:32 568阅读 0赞

# 快速部署开源项目Open-IM-Server #

> 快速部署开源后端项目Open-IM-Server，开源项目地址[点我进入Open-IM-Server Github开源地址][Open-IM-Server Github]。如果光看本文档步骤，你会发现源码部署视乎步骤比docker-compose少，事实也是如此，步骤少就真的简单吗？那就不一定啦，尽管docker-compose步骤多，大多数都是在修改各种配置文件配置，多数都是替换为自己服务器ip地址，修改后一键启动即可。源码部署你不仅要安装项目所依赖的语言环境，还要安装组件环境，一些组件安装起来是是分麻烦的，远没有docker来的简单方便。

## 服务器配置要求 ##

> Linux 8G运行内存

## 依赖安装 ##

> Open-IM 依赖五大开源高性能组件：**ETCD**、**MySQL**、**MongoDB**、**Redis**、**Kafka**。私有化部署Open-IM-Server前，请确保已安装以上五个组件，并**检查配置文件中的组件配置参数**。如果您的服务器没有上述组件，您必须先安装缺少的组件。如果你有以上组件， **建议直接使用。如果没有，建议使用Docker-compose，不需要安装依赖，更快更方便**。

### 源码部署 ###

#### 安装Go环境 [Go environment][]. 确保 Go 版本至少为 1.15,安装后go version查看是否安装成功。 ####

![请添加图片描述][5d16f0275cf74f4094bc45fe7e04a9a1.png]

#### 克隆Open-IM 项目到你的服务器。 ####

git clone https://github.com/OpenIMSDK/Open-IM-Server.git

#### 下载后打开配置文件 [config.yaml][],然后修改以下参数,**127.0.0.1替换为你的服务器IP**。 ####

*  检查或修改 Etcd 连接参数。
    
        etcd:
          etcdAddr: [ 127.0.0.1:2379 ]
    
    ![请添加图片描述][7300518804954a7c8788f570b3148fe8.png]
 *  检查或修改数据库（MySQL）连接参数。`dbUserName和dbPassword为Mysql的账户和密码，默认用户是root，密码是openIM`。
    
        mysql:
          dbAddress: [ 127.0.0.1:3306 ]
          dbUserName: root
          dbPassword: openIM

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70]

*  检查或修改数据库（MongoDB）连接参数.`如果 dbUserName 和 dbPassword 为空则无身份验证模式，否则有身份验证，连接就需要密码，默认不需要密码`。
    
        mongo:
           dbAddress: [ 127.0.0.1:27017 ]
           dbUserName:
          dbPassword:

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 1]

*  检查或修改Redis连接参数.`如果 dbPassword 为空则无身份验证模式，否则身份验证,默认openIM`。
    
        redis:
          dbAddress: [ 127.0.0.1:6379 ]
          dbPassWord: openIM

" />![请添加图片描述][19832207ee3c4ce88920e3cf97fc32fe.png]

*  检查或修改 Kafka 连接参数。

kafka:
       ws2mschat:
         addr: [ 127.0.0.1:9092 ]
       ms2pschat:
         addr: [ 127.0.0.1:9092 ]

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 2]

#### 构建项目与启动. ####

1.  所有Shell 加可执行权限。
    
        #cd Open-IM-server/scrip
        
        chmod +x *.sh
2.  执行Shell 构建项目为二进制文件。
    
        ./build_all_service.sh
3.  Shell一键启动服务
    
        ./start_all.sh
4.  查看服务是否成功全部启动
    
        ps -aux|grep open_im
    
    ![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 3]

### Docker部署 ###

所有可使用官方镜像地址： https://hub.docker.com/r/lyt1123/open\_im\_server

#### [安装Docker][Docker] Docker版本至少1.13,使用docker version 查看是否安装成功。 ####

![请添加图片描述][84e96b16e3234cb382432ea32db12229.png]

#### [安装Docker-compose][Docker-compose] Docker-compose版本至少1.22，使用docker-compose version查看是否安装成功。 ####

![请添加图片描述][d476382c577b45d0b91dcaa30f36824a.png]

#### [点击下载Redis官方配置文件][Redis] **`下载Redis官方配置文件到 /home/redis/config目录`** ####

![请添加图片描述][24dfb5e1ae3d415dbbf144363d45b240.png]

#### Redis配置文件修改 ####

1.  持续化存储
    
        appendonly no ---> appendonly yes

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 4]

1.  容器启动地址绑定
    
        bind 127.0.0.1  ---->bind 0.0.0.0 或者注释

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 5]

#### 克隆 Open-IM 项目到你的服务器。 ####

git clone https://github.com/OpenIMSDK/Open-IM-Server.git

#### 打开项目中[Docker-compose][Docker-compose 1],然后修改以下参数：**127.0.0.1 替换为你的服务器IP**. ####

*  检查或修改 docker-compose Kafka 连接参数。
    
        KAFKA_ZOOKEEPER_CONNECT: 127.0.0.1:2181
         KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://127.0.0.1:9092

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 6]

#### 打开配置文件 [config.yaml][],修改以下参数,**127.0.0.1 替换为你的真实IP**. ####

*  检查或修改 Etcd 连接参数。
    
        etcd:
          etcdAddr: [ 127.0.0.1:2379 ]

![请添加图片描述][3b4d5f44fa414d05b1aeb5f2fef287f6.png]

*  检查或修改数据库（MySQL）连接参数。`dbUserName和dbPassword为Mysql的账户和密码，默认用户是root，密码是openIM`
    
        mysql:
          dbAddress: [ 127.0.0.1:3306 ]
          dbUserName: root
          dbPassword: openIM

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 7]

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 8]

*  检查或修改Redis连接参数.`如果 dbPassword 为空则无身份验证模式，否则身份验证,默认openIM`。
    
        redis:
          dbAddress: [ 127.0.0.1:6379 ]
          dbPassWord: openIM
    
    ![请添加图片描述][08edf8c78c14481dbc77a5b2f828437d.png]
 *  检查或修改 Kafka 连接参数。
    
        kafka:
          ws2mschat:
            addr: [ 127.0.0.1:9092 ]
          ms2pschat:
            addr: [ 127.0.0.1:9092 ]

![请添加图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 9]

#### 一键启动docker-compose（Docker自动拉取所有镜像） ####

docker-compose up -d

#### 查看服务是否全部成功启动 ####

docker-compose ps

![请添加图片描述][42f242e51807482d84aa93c2ef9aca70.png]

[Open-IM-Server Github]: https://github.com/OpenIMSDK/Open-IM-Server
[Go environment]: https://golang.org/doc/install
[5d16f0275cf74f4094bc45fe7e04a9a1.png]: /images/20220829/1742780789f2469ba51e9f3cb59883dc.png
[config.yaml]: https://github.com/OpenIMSDK/Open-IM-Server/blob/main/config/config.yaml
[7300518804954a7c8788f570b3148fe8.png]: /images/20220829/325ccf9ff4c1455296d118630d99117f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70]: /images/20220829/70b78bd5e8c54e2d9eed0f7dc0a0e150.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 1]: /images/20220829/b5f3a5a51aa84d7b9d91b3bbf6361f6b.png
[19832207ee3c4ce88920e3cf97fc32fe.png]: /images/20220829/b0b4e16a581148749f98e0d38d253086.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 2]: /images/20220829/f00b9cdf13ce487389bdf22415e325c3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 3]: /images/20220829/1dc9c11db3a5499a9f19d0e87897e636.png
[Docker]: https://docs.docker.com/install/
[84e96b16e3234cb382432ea32db12229.png]: /images/20220829/1a94b9c82e164a3285c228c2147c1ab6.png
[Docker-compose]: https://docs.docker.com/compose/install/
[d476382c577b45d0b91dcaa30f36824a.png]: /images/20220829/b6272f16ad1c48a6a07bb6964ed5c48f.png
[Redis]: https://redis.io/topics/config
[24dfb5e1ae3d415dbbf144363d45b240.png]: /images/20220829/27f83f6f43bb4e1fbfe8fa656147c519.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 4]: /images/20220829/6af0e7c880644baea842ccef6b9263fa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 5]: /images/20220829/d15c6704b1164bb6abafcb65aaeaad7d.png
[Docker-compose 1]: https://github.com/OpenIMSDK/Open-IM-Server/blob/main/docker-compose.yaml
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 6]: /images/20220829/31bbe6ab38064aa4816efe0cfb957f81.png
[3b4d5f44fa414d05b1aeb5f2fef287f6.png]: /images/20220829/5c8afa6e9dcc42fb9fa46fbdc399a767.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 7]: /images/20220829/bbd47b5a117e4180a022503af92aedcc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 8]: /images/20220829/601f0bdcec634591a3a751bb5d57d760.png
[08edf8c78c14481dbc77a5b2f828437d.png]: /images/20220829/94d0f32fd6d347168e48772ad7980f57.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21lbW9yeV9xaWFueGlhbw_size_16_color_FFFFFF_t_70 9]: /images/20220829/d3334038377d451fa2d71da06d5e4748.png
[42f242e51807482d84aa93c2ef9aca70.png]: /images/20220829/fe82b7031e4e4b51b5f0b42ab62ce96a.png