一、LumenIM介绍

1.LumenIM简介

Lumen IM 是一个网页版在线聊天项目，前端使用 Naive UI + Vue3，后端采用 GO 开发。

2.LumenIM功能

基于 WebSocket 服务做消息即时推送
支持私聊及群聊
支持多种聊天消息类型 例如:文本、代码块、图片及其它类型文件，并支持文件下载
支持聊天消息撤回、删除(批量删除)、转发消息(逐条转发、合并转发)、群禁言
支持编写个人笔记、支持笔记分享(好友或群)。

3.LumenIM项目地址

前端：https://gitee.com/gzydong/LumenIM
后端：https://gitee.com/gzydong/go-chat

二、本次实践介绍

1. 本次实践简介

a.本次实践部署环境为个人腾讯云的测试环境，若是生产环境请谨慎部署；

b.本次实践使用了mysql、redis、nginx以及前后端的开源包进行启动测试。

2. 本地环境规划

本次实践环境规划：通过docker启动nginx、mysql、redis，以及本地启动前后端

三、检查本地Docker环境

1. 检查本地Docker版本

 

  1.  
    检查Docker版本：docker version 
     
  2.  
     
  3.  
    root@WellDone:/home/goodjob# docker version 
     
  4.  
    Client: Docker Engine - Community 
     
  5.  
    Version: 25.0.0 
     
  6.  
    API version: 1.44 
     
  7.  
    Go version: go1.21.6 
     
  8.  
    Git commit: e758fe5 
     
  9.  
    Built: Thu Jan 18 17:09:49 2024 
     
  10.  
    OS/Arch: linux/amd64 
     
  11.  
    Context: default 
     
  12.  
     
  13.  
    Server: Docker Engine - Community 
     
  14.  
    Engine: 
     
  15.  
    Version: 25.0.0 
     
  16.  
    API version: 1.44 (minimum version 1.24) 
     
  17.  
    Go version: go1.21.6 
     
  18.  
    Git commit: 615dfdf 
     
  19.  
    Built: Thu Jan 18 17:09:49 2024 
     
  20.  
    OS/Arch: linux/amd64 
     
  21.  
    Experimental: false 
     
  22.  
    containerd: 
     
  23.  
    Version: 1.6.27 
     
  24.  
    GitCommit: a1496014c916f9e62104b33d1bb5bd03b0858e59 
     
  25.  
    runc: 
     
  26.  
    Version: 1.1.11 
     
  27.  
    GitCommit: v1.1.11-0-g4bccb38 
     
  28.  
    docker-init: 
     
  29.  
    Version: 0.19.0 
     
  30.  
    GitCommit: de40ad0 
     
  31.  
    root@WellDone:/home/goodjob# 
     
 

2. 检查Docker服务状态
 

 
 
检查Docker服务状态，确保Docker服务正常运行。
 

 

 

  1.  
    systemctl status docker 
     
  2.  
     
  3.  
    root@WellDone:/home/goodjob/Downloads# systemctl status docker 
     
  4.  
    ● docker.service - Docker Application Container Engine 
     
  5.  
    Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled) 
     
  6.  
    Active: active (running) since Wed 2024-01-24 08:54:31 CST; 1 day 4h ago 
     
  7.  
    TriggeredBy: ● docker.socket 
     
  8.  
    Docs: https://docs.docker.com 
     
  9.  
    Main PID: 1549 (dockerd) 
     
  10.  
    Tasks: 65 
     
  11.  
    Memory: 419.5M 
     
  12.  
    CPU: 38.874s 
     
  13.  
    CGroup: /system.slice/docker.service 
     
  14.  
    ├─ 1549 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock 
     
  15.  
    ├─ 2010 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 6379 -container-ip 172.17.0.2 -container-port 6379 
     
  16.  
    ├─ 2016 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 6379 -container-ip 172.17.0.2 -container-port 6379 
     
  17.  
    ├─ 2029 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 5432 -container-ip 172.17.0.3 -container-port 5432 
     
  18.  
    ├─ 2036 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 5432 -container-ip 172.17.0.3 -container-port 5432 
     
  19.  
    ├─123083 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 8888 -container-ip 172.17.0.4 -container-port 8080 
     
  20.  
    └─123095 /usr/bin/docker-proxy -proto tcp -host-ip :: -host-port 8888 -container-ip 172.17.0.4 -container-port 8080 
     
  21.  
     
  22.  
    1月 24 08:54:31 WellDone dockerd[1549]: time="2024-01-24T08:54:31.067895045+08:00" level=info msg="API listen on /run/docker.sock" 
     
  23.  
    1月 24 08:54:31 WellDone systemd[1]: Started Docker Application Container Engine. 
     
  24.  
    1月 24 16:13:48 WellDone dockerd[1549]: time="2024-01-24T16:13:48.185008219+08:00" level=info msg="ignoring event" container=8ad99af82d8a41dd661d> 
     
  25.  
    1月 24 16:13:48 WellDone dockerd[1549]: time="2024-01-24T16:13:48.189484205+08:00" level=warning msg="ShouldRestart failed, container will not be> 
     
  26.  
    1月 24 21:58:08 WellDone dockerd[1549]: time="2024-01-24T21:58:08.024915139+08:00" level=info msg="ignoring event" container=27fd28e2993f31b170b8> 
     
  27.  
    1月 24 21:58:08 WellDone dockerd[1549]: time="2024-01-24T21:58:08.029986730+08:00" level=warning msg="ShouldRestart failed, container will not be> 
     
  28.  
    1月 25 10:46:16 WellDone dockerd[1549]: time="2024-01-25T10:46:16.329180722+08:00" level=info msg="Container failed to exit within 10s of signal > 
     
  29.  
    1月 25 10:46:16 WellDone dockerd[1549]: time="2024-01-25T10:46:16.350757439+08:00" level=info msg="ignoring event" container=b1223add00f36bbb3246> 
     
  30.  
    1月 25 10:49:21 WellDone dockerd[1549]: time="2024-01-25T10:49:21.993755983+08:00" level=info msg="Container failed to exit within 10s of signal > 
     
  31.  
    1月 25 10:49:22 WellDone dockerd[1549]: time="2024-01-25T10:49:22.015822650+08:00" level=info msg="ignoring event" container=edb0e153b45dbe62acd8> 
     
  32.  
    lines 1-28/28 (END) 
     
 

四、部署过程
 

 

  1.  
    ``` 
     
  2.  
    1.下载前后端程序
     
  3.  
     
  4.  
    # 前端部分：
     
  5.  
    #到opt目录下创建该程序的存放路径
     
  6.  
    cd /opt
     
  7.  
    mkdir LumenIm 
     
  8.  
    cd LumenIm
     
  9.  
    git clone https://gitee.com/gzydong/LumenIM.git
     
  10.  
    git clone https://github.com/gzydong/go-chat.git
     
  11.  
     
  12.  
    2.下载下来后，要部署编译，先前端：
     
  13.  
    yarn install
     
  14.  
     
  15.  
    #需要先安装yarn
     
  16.  
    yum install npm
     
  17.  
    npm install -g yarn
     
  18.  
     
  19.  
    3.安装依赖包后，构建生产环境配置
     
  20.  
    yarn build
     
  21.  
     
  22.  
    4.ll -a查看LumenIm全部的配置文件，找到.env.electron，接口的地址写上，具体的ip根据你自己的服务器的公网地址去写。
     
  23.  
    ENV = 'production'
     
  24.  
     
  25.  
    VITE_BASE=./
     
  26.  
    VITE_ROUTER_MODE=hash
     
  27.  
    VITE_BASE_API=http://43.138.153.157:9503
     
  28.  
    VITE_SOCKET_API=ws://43.138.153.157:9504
     
  29.  
     
  30.  
    5.然后启动本地开发环境桌面客户端
     
  31.  
    yarn electron:dev
     
  32.  
     
  33.  
     
  34.  
    6.mysql、redis、nginx部署，我这边是直接docker compose启动的
     
  35.  
     
  36.  
    version: '3'
     
  37.  
    services:
     
  38.  
    redis:
     
  39.  
    image: 'redis:latest'
     
  40.  
    volumes:
     
  41.  
    - '/opt/redis/data:/data'
     
  42.  
    - '/opt/redis/conf/redis.conf:/etc/redis/redis.conf'
     
  43.  
    privileged: true
     
  44.  
    container_name: redis
     
  45.  
    ports:
     
  46.  
    - '6379:6379'
     
  47.  
    restart: always
     
  48.  
     
  49.  
    mysql_dba:
     
  50.  
    image: 'mysql:latest'
     
  51.  
    environment:
     
  52.  
    - MYSQL_ROOT_PASSWORD=111111
     
  53.  
    volumes:
     
  54.  
    - '/etc/localtime:/etc/localtime:ro'
     
  55.  
    - '/opt/mysql/conf:/etc/mysql/conf.d'
     
  56.  
    - '/opt/mysql/data:/var/lib/mysql'
     
  57.  
    - '/opt/mysql/log:/var/log/mysql'
     
  58.  
    privileged: true
     
  59.  
    restart: always
     
  60.  
    container_name: mysql_dba
     
  61.  
    ports:
     
  62.  
    - '3306:3306'
     
  63.  
     
  64.  
    nginx:
     
  65.  
    image: 'nginx:latest'
     
  66.  
    restart: always
     
  67.  
    volumes:
     
  68.  
    - '/etc/localtime:/etc/localtime:ro'
     
  69.  
    - '/opt/LumenIm/LumenIM/dist:/opt/LumenIm/LumenIM/dist'
     
  70.  
    - '/opt/nginx/nginx.conf:/etc/nginx/nginx.conf'
     
  71.  
    ports:
     
  72.  
    - '80:80'
     
  73.  
    container_name: nginx
     
  74.  
     
  75.  
     
  76.  
    以上具体每个容器的路径自己设定
     
  77.  
     
  78.  
    ####nginx配置文件如下：
     
  79.  
    user nginx;
     
  80.  
    worker_processes auto;
     
  81.  
     
  82.  
    error_log /var/log/nginx/error.log notice;
     
  83.  
    pid /var/run/nginx.pid;
     
  84.  
     
  85.  
     
  86.  
    events {
     
  87.  
    worker_connections 1024;
     
  88.  
    }
     
  89.  
     
  90.  
     
  91.  
    http {
     
  92.  
    include /etc/nginx/mime.types;
     
  93.  
    default_type application/octet-stream;
     
  94.  
     
  95.  
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
     
  96.  
    '$status $body_bytes_sent "$http_referer" '
     
  97.  
    '"$http_user_agent" "$http_x_forwarded_for"';
     
  98.  
     
  99.  
    access_log /var/log/nginx/access.log main;
     
  100.  
     
  101.  
    server {
     
  102.  
    listen 80;
     
  103.  
    server_name localhost;
     
  104.  
     
  105.  
    root /opt/LumenIm/LumenIM/dist;
     
  106.  
    index index.html;
     
  107.  
     
  108.  
    location / {
     
  109.  
    try_files $uri $uri/ /index.html;
     
  110.  
    }
     
  111.  
     
  112.  
    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|flv|ico)$ {
     
  113.  
    expires 7d;
     
  114.  
    }
     
  115.  
     
  116.  
    location ~ .*\.(js|css)?$ {
     
  117.  
    expires 7d;
     
  118.  
    }
     
  119.  
    }
     
  120.  
     
  121.  
    sendfile on;
     
  122.  
    #tcp_nopush on;
     
  123.  
     
  124.  
    keepalive_timeout 65;
     
  125.  
     
  126.  
    #gzip on;
     
  127.  
     
  128.  
    #include /etc/nginx/conf.d/*.conf;
     
  129.  
    }
     
  130.  
     
  131.  
     
  132.  
     
  133.  
    7.后端部署：
     
  134.  
    拷贝项目根目录下 config.example.yaml 文件为 config.yaml 并正确配置相关参数
     
  135.  
    cp config.example.yaml config.yaml
     
  136.  
     
  137.  
     
  138.  
    我这边的配置如下：
     
  139.  
    # 项目配置信息
     
  140.  
    app:
     
  141.  
    env: dev
     
  142.  
    debug: false
     
  143.  
    juhe_key: "xxxxxxx"
     
  144.  
    admin_email:
     
  145.  
    -
     
  146.  
    public_key: |
     
  147.  
    -----BEGIN PUBLIC KEY-----
     
  148.  
    xxxxxxx
     
  149.  
    -----END PUBLIC KEY-----
     
  150.  
    private_key: |
     
  151.  
    -----BEGIN RSA PRIVATE KEY-----
     
  152.  
    xxxxx
     
  153.  
    -----END RSA PRIVATE KEY-----
     
  154.  
     
  155.  
    server:
     
  156.  
    http: 9503
     
  157.  
    websocket: 9504
     
  158.  
    tcp: 9505
     
  159.  
     
  160.  
    # 日志配置
     
  161.  
    log:
     
  162.  
    # 日志文件路径 *请使用绝对路径*
     
  163.  
    path: "/path/to/.../runtime"
     
  164.  
     
  165.  
    # Redis 相关配置
     
  166.  
    redis:
     
  167.  
    host: 43.138.153.157:6379
     
  168.  
    auth: xxxxx
     
  169.  
    database: 0
     
  170.  
     
  171.  
    # Mysql 数据库配置
     
  172.  
    mysql:
     
  173.  
    host: 43.138.153.157
     
  174.  
    port: 3306
     
  175.  
    charset: utf8mb4
     
  176.  
    username: root
     
  177.  
    password: 111111
     
  178.  
    database: go_chat
     
  179.  
    collation: utf8mb4_general_ci
     
  180.  
     
  181.  
    # Jwt 配置
     
  182.  
    jwt:
     
  183.  
    secret: 836c3fea9bba4e04d51bd0fbcc5
     
  184.  
    expires_time: 3600
     
  185.  
    buffer_time: 3600
     
  186.  
     
  187.  
    openai:
     
  188.  
    key: "xxxx"
     
  189.  
    proxy: "https://api.openai.com"
     
  190.  
     
  191.  
    # 跨域配置
     
  192.  
    cors:
     
  193.  
    origin: "*"
     
  194.  
    headers: "Content-Type,Cache-Control,User-Agent,Keep-Alive,DNT,AccessToken,Authorization"
     
  195.  
    methods: "OPTIONS,GET,POST,PUT,DELETE"
     
  196.  
    credentials: false
     
  197.  
    max_age: 600
     
  198.  
     
  199.  
    # 文件系统配置【oss,qiniu 暂不支持】
     
  200.  
    filesystem:
     
  201.  
    default: local
     
  202.  
    local:
     
  203.  
    # 文件保存的根目录
     
  204.  
    root: "/path/xx/lumenim/"
     
  205.  
    # 公开的 bucket
     
  206.  
    bucket_public: "public"
     
  207.  
    # 私有的 bucket
     
  208.  
    bucket_private: "private"
     
  209.  
    endpoint: "im-cdn.gzydong.com"
     
  210.  
    ssl: false
     
  211.  
    minio:
     
  212.  
    secret_id: "xxxxxx"
     
  213.  
    secret_key: "xxxxx"
     
  214.  
    # 公开的 bucket
     
  215.  
    bucket_public: "im-static"
     
  216.  
    # 私有的 bucket
     
  217.  
    bucket_private: "im-private"
     
  218.  
    endpoint: "im-cdn.gzydong.com:9000"
     
  219.  
    ssl: false
     
  220.  
     
  221.  
    # 邮件配置
     
  222.  
    email:
     
  223.  
    host: smtp.163.com
     
  224.  
    port: 465
     
  225.  
    username: xxxxx
     
  226.  
    password: xxxxx
     
  227.  
    fromname: "Lumen IM 在线聊天"
     
  228.  
     
  229.  
     
  230.  
    以上是配置文件内容
     
  231.  
     
  232.  
    8.这时候要安装依赖包
     
  233.  
    go mod tidy
     
  234.  
     
  235.  
    #但是要先安装go，以下是步骤
     
  236.  
    wget https://golang.google.cn/dl/go1.21.0.linux-amd64.tar.gz
     
  237.  
    tar -xvf go1.21.0.linux-amd64.tar.gz
     
  238.  
    vim /etc/profile
     
  239.  
    mkdir /home/gopath
     
  240.  
    source /etc/profile
     
  241.  
    go version
     
  242.  
    出来版本即可，要1.21.0
     
  243.  
    这时候执行go mod tidy，会有一段时间，后面就可以了
     
  244.  
     
  245.  
    #其中有可能下载会遇到go 下载github包提示： dial tcp 172.217.160.81:443: i/o timeout ，这时候执行下面，然后重新安装依赖就可以
     
  246.  
    go env -w GOPROXY=https://goproxy.cn
     
  247.  
     
  248.  
    ##然后再安装依赖包
     
  249.  
    go mod tidy
     
  250.  
     
  251.  
    9.安装相关依赖命令行工具
     
  252.  
    make install
     
  253.  
     
  254.  
    10.安装完成后，要初始化数据库
     
  255.  
    go run ./cmd/lumenim migrate
     
  256.  
     
  257.  
    #这时候又会遇到问题，有以下的，各自执行就行
     
  258.  
    问题： 运行electorn . 报错:error while loading shared libraries: libX11-xcb.so.1
     
  259.  
    yum install libX11-devel --nogpg
     
  260.  
     
  261.  
    问题: error while loading shared libraries: libatk-bridge-2.0.so.0
     
  262.  
    yum install at-spi2-atk -y
     
  263.  
     
  264.  
    问题：error while loading shared libraries: libgtk-3.so.0
     
  265.  
    yum install gtk3 -y
     
  266.  
     
  267.  
    问题：error while loading shared libraries: libXss.so.1
     
  268.  
    yum install libXScrnSaver* -y
     
  269.  
     
  270.  
    问题：error while loading shared libraries: libdrm.so.2
     
  271.  
    yum install libdrm*
     
  272.  
     
  273.  
    问题：error while loading shared libraries: libgbm.so.1
     
  274.  
    yum install libgbm*
     
  275.  
     
  276.  
    11.再次初始化数据库
     
  277.  
    go run ./cmd/lumenim migrate
     
  278.  
     
  279.  
    ##这时候可能会爆内存，我服务器比较小，4g，直接爆了，虚拟内存加了8g，然后初始化成功了
     
  280.  
     
  281.  
    下面是加交换分区的方法
     
  282.  
    创建要作为swap分区的文件:增加1GB大小的交换分区，则命令写法如下，其中的count等于想要的块的数量（bs*count=文件大小）。
     
  283.  
     
  284.  
    dd if=/dev/zero of=/root/swapfile bs=1M count=1024
     
  285.  
    格式化为交换分区文件:
     
  286.  
     
  287.  
    mkswap /root/swapfile #建立swap的文件系统
     
  288.  
    启用交换分区文件:
     
  289.  
     
  290.  
    swapon /root/swapfile #启用swap文件
     
  291.  
    使系统开机时自启用，在文件/etc/fstab中添加一行：
     
  292.  
     
  293.  
    /root/swapfile swap swap defaults 0 0
     
  294.  
     
  295.  
     
  296.  
    12.这时候完成后，启动后端即可
     
  297.  
    go run ./cmd/lumenim http # 本地启动 http 服务
     
  298.  
    go run ./cmd/lumenim commet # 本地启动 websocket 服务
     
 

六、访问LumenIM首页
 

 
 
访问地址http://43.138.153.157/auth/login?redirect=/message，这是我的测试服务器的地址，大家可以访问玩玩，账号密码：13188886666,111222
 

 

 

图片
 

 

图片
 

 

图片
 

 

图片
 

 

图片
 
  

        # 云原生
      
        # 前端
      
 
 
 Logo 
GitCode 开源社区
 
旨在为数千万中国开发者提供一个无缝且高效的云端环境，以支持学习、使用和贡献开源项目。
 
 
  
更多推荐
  
cover
 
GitTalk | 使用面向业务的狮偶编程语言提升开发效率
 
 
avatar GitCode 开源社区
 
cover
 
GitTalk | DevUI Suits 场景解决方案
 
 
avatar GitCode 开源社区
 
cover
 
GitTalk | DevUI Admin 前端项目构建
 
 
avatar GitCode 开源社区