华为云服务器VoceChat在线聊天室部署

最新推荐文章于 2025-05-02 07:11:49 发布

Anthony_hui

最新推荐文章于 2025-05-02 07:11:49 发布

阅读量917

点赞数 21

分类专栏：实战部署实战文章标签：华为云服务器运维 linux

本文链接：https://blog.csdn.net/weixin_45693551/article/details/147655072

版权

部署实战同时被 2 个专栏收录

6 篇文章

订阅专栏

实战

3 篇文章

订阅专栏

1. 项目介绍

VoceChat是一款超轻型、基于Rust开发的聊天应用程序、API和SDK，优先考虑私人托管。其主要特点包括：

轻量级：占用资源少，部署简单
开源：代码完全开源，可自由修改
私人托管：保护隐私和数据安全
多平台支持：提供Web界面、移动应用等
集成能力：可以轻松集成到您的网站或应用程序中
机器人和社交渠道功能：扩展应用场景

VoceChat非常适合作为网站的客服系统，可以实现即时通讯，提高用户体验和客户服务质量。

2. 准备条件

在开始部署VoceChat之前，您需要准备以下条件：

服务器：一台运行Linux系统的服务器（本教程以CentOS 7为例）
- 可以使用云服务商提供的ESC，如Vultr等
- 建议配置：至少1核1G内存，10GB存储空间
域名（可选）：如果您希望通过域名访问VoceChat，需要准备一个域名并完成DNS解析
Docker和Docker Compose：用于容器化部署VoceChat
项目资源：
- 官方网站：https://voce.chat/zh-CN
- GitHub仓库：https://github.com/Privoce/vocechat-web

3. Docker环境部署

VoceChat使用Docker进行部署，因此我们需要先在服务器上安装Docker和Docker Compose。

3.1 安装Docker（CentOS 7）

# 更新包管理器
sudo yum update -y

# 安装必要的软件包
sudo yum install -y yum-utils device-mapper-persistent-data lvm2

# 添加Docker官方源
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo 

# 安装Docker
sudo yum install -y docker-ce docker-ce-cli containerd.io

# 启动Docker服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

# 验证Docker安装
sudo docker --version

3.2 安装Docker Compose

# 下载Docker Compose二进制文件
sudo curl -L "https://github.com/docker/compose/releases/download/v2.18.1/docker-compose- $(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 添加可执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 创建软链接
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

# 验证安装
docker-compose --version

3.3 Docker常用命令

# 查看当前运行的容器
docker ps

# 查看所有容器（包括已停止的）
docker ps -a

# 查看镜像
docker images

# 停止容器
docker stop 容器ID或容器名

# 启动容器
docker start 容器ID或容器名

# 重启容器
docker restart 容器ID或容器名

# 删除容器
docker rm 容器ID或容器名

# 删除镜像
docker rmi 镜像ID或镜像名

# 查看容器日志
docker logs 容器ID或容器名

# 查看容器资源使用情况
docker stats

4. 创建配置文件

部署VoceChat需要创建一个docker-compose.yml配置文件，该文件定义了VoceChat的运行环境和参数。

4.1 创建工作目录

# 创建工作目录并进入
mkdir ~/VoceChat && cd ~/VoceChat

4.2 创建docker-compose.yml文件

# 使用vim编辑器创建配置文件
vim docker-compose.yml

将以下内容复制到文件中（根据需要修改参数）：

version: '3.3'
services:
    ywsjchat:   # 服务名，可以自定义
        container_name: ywsjchat    # 容器名，可以自定义
        ports:
            - '3322:3000'   # 冒号左边的3322可以改成任意未使用过的端口
        environment:
            - PUID=0    # 用户ID，可以通过id命令查看当前用户的ID
            - PGID=0    # 组ID，可以通过id命令查看当前用户的组ID
            - TZ=Asia/Shanghai  # 时区设置
        restart: always    # 开启自启动
        volumes:
           - './data:/home/vocechat-server/data' # 数据持久化配置，冒号左侧可以更改本地的目录
        image: privoce/vocechat-server:latest    # 镜像名称，不要修改

配置说明：

ywsjchat：服务名称，可以根据需要自定义
container_name：容器名称，可以根据需要自定义
ports：端口映射，格式为"主机端口:容器端口"，可以修改主机端口（冒号左边的数字）
environment：环境变量设置
- PUID和PGID：用户ID和组ID，可以使用id命令查看
- TZ：时区设置，默认为Asia/Shanghai
restart：容器重启策略，always表示总是自动重启
volumes：数据卷映射，用于数据持久化
image：使用的Docker镜像

4.3 保存配置文件

在vim编辑器中，按Esc键退出编辑模式，然后输入:wq保存并退出。

5. 部署运行

完成配置文件创建后，我们可以启动VoceChat服务。

5.1 启动服务

# 在VoceChat目录下执行
docker-compose up -d

命令说明：

up：创建并启动容器
-d：后台运行模式

5.2 检查服务状态

# 查看正在运行的容器
docker ps

# 查看容器日志
docker logs ywsjchat

如果一切正常，您应该能看到VoceChat容器正在运行。

5.3 防火墙配置

如果您的服务器开启了防火墙，需要放行VoceChat使用的端口（本例中为3322）：

# CentOS 7防火墙配置
sudo firewall-cmd --permanent --add-port=3322/tcp
sudo firewall-cmd --reload

# 检查端口是否开放
sudo firewall-cmd --list-ports

6. 访问VoceChat

6.1 通过IP和端口访问

在部署完成后，您可以通过浏览器访问VoceChat：

http://服务器IP:3322

例如，如果您的服务器IP是123.456.789.10，则访问地址为：http://123.456.789.10:3322

6.2 首次访问设置

首次访问VoceChat时，您需要进行以下设置：

创建管理员账户
设置服务器名称
配置基本参数（如是否允许注册等）

7. 更新VoceChat

当VoceChat发布新版本时，您可以按照以下步骤进行更新：

# 进入VoceChat目录
cd ~/VoceChat

# 停止当前运行的容器
docker-compose down

# 拉取最新的镜像
docker-compose pull

# 重新启动容器
docker-compose up -d

# 清理旧的未使用镜像
docker image prune -f

8. 绑定域名（可选）

如果您希望通过域名访问VoceChat，可以使用Nginx反向代理来实现。

8.1 安装Nginx Proxy Manager

Nginx Proxy Manager是一个简单易用的Nginx可视化管理工具，可以帮助您方便地配置反向代理。

关于Nginx Proxy Manager的详细部署教程，可以参考：
Nginx Proxy Manager部署指南

8.2 配置反向代理

在Nginx Proxy Manager中添加代理主机配置：

域名：您的VoceChat域名，如vocechat.example.com
方案：http
转发主机：VoceChat服务器的IP
转发端口：VoceChat服务端口（本例中为3322）
开启SSL（推荐）

配置完成后，您可以通过域名访问VoceChat：https://vocechat.example.com

9. 网站集成

VoceChat可以集成到现有网站中，作为客服系统使用。

9.1 获取集成代码

登录VoceChat管理界面，进入设置页面，找到"网站集成"或"嵌入代码"选项，复制集成代码。

9.2 将代码添加到网站

将获取的代码添加到您网站的HTML中，通常放在</body>标签之前。代码示例如下：

<script>
  (function(d, w, c) {
    w.VoceChat = {
      serverUrl: 'https://vocechat.example.com ',
      organization: 'Your Organization',
      position: 'right', // 可选：'left' 或 'right'
      locale: 'zh-CN', // 语言设置
      theme: 'light' // 主题设置，可选：'light' 或 'dark'
    };
    
    var s = d.createElement('script');
    s.type = 'text/javascript';
    s.async = true;
    s.src = 'https://vocechat.example.com/widget.js ';
    
    var x = d.getElementsByTagName('script')[0];
    x.parentNode.insertBefore(s, x);
  })(document, window);
</script>

集成后，您的网站右下角会出现一个聊天图标，用户可以点击打开聊天窗口。

10. 移动端应用

VoceChat提供移动端应用，方便管理员随时回复消息。

10.1 iOS应用

下载地址：https://apps.apple.com/app/vocechat/id1631779678

10.2 Android应用

下载地址：https://vocechat.s3.amazonaws.com/vocechat.android.apk

10.3 移动端配置

在移动应用中，您需要输入服务器地址（例如https://vocechat.example.com ）并登录您的账户。

11. 常见问题与故障排除

11.1 无法访问VoceChat

检查容器是否正常运行：docker ps
查看容器日志：docker logs ywsjchat
确认防火墙是否已放行端口
检查服务器安全组设置（如使用云服务器）

11.2 数据备份

VoceChat的数据存储在配置的数据卷中，本例中为~/VoceChat/data目录。您可以定期备份此目录：

# 创建备份
tar -zcvf vocechat_backup_$(date +%Y%m%d).tar.gz -C ~/VoceChat data

# 将备份文件移动到安全位置
mv vocechat_backup_*.tar.gz /path/to/backup/location

11.3 数据恢复

如需恢复数据，可以按以下步骤操作：

# 停止VoceChat容器
cd ~/VoceChat
docker-compose down

# 备份当前数据（以防万一）
mv data data_old

# 解压备份文件
tar -zxvf vocechat_backup_YYYYMMDD.tar.gz -C ~/VoceChat

# 重新启动VoceChat
docker-compose up -d

12. 高级配置

12.1 自定义VoceChat

您可以通过环境变量自定义VoceChat的行为，在docker-compose.yml文件的environment部分添加相应配置：

environment:
  - PUID=0
  - PGID=0
  - TZ=Asia/Shanghai
  - VOCECHAT_SERVER_NAME=My Chat Server  # 服务器名称
  - VOCECHAT_ENABLE_REGISTRATION=true    # 是否允许注册
  - VOCECHAT_MAX_USERS=100               # 最大用户数
  # 更多配置...

12.2 HTTPS配置

如果您不使用Nginx反向代理，也可以直接为VoceChat配置HTTPS：

environment:
  # 其他配置...
  - VOCECHAT_ENABLE_TLS=true
  - VOCECHAT_TLS_CERT=/path/to/cert.pem
  - VOCECHAT_TLS_KEY=/path/to/key.pem
volumes:
  - './data:/home/vocechat-server/data'
  - '/path/to/cert.pem:/path/to/cert.pem'
  - '/path/to/key.pem:/path/to/key.pem'