VoceChat 是一款超轻量级的开源聊天应用(基于Rust开发),它资的源占用低(不超过100MB内存),传输过程全程加密。配合搬瓦工 VPS 稳定中国优化网络,可以让你轻松和客户、朋友进行流畅、安全沟通。同时它还提供Web端及移动端App,体验接近主流通讯软件。(本教程在MD5.PW同步发布)
需要准备的事项:
1.拥有一台搬瓦工的服务器(参考教程);
2.服务器在运行,且安装了debian12系统(参考教程);
3.拥有一个域名(为了反向代理需要);
4. SSH 连接工具已准备就绪(例如 Xshell)。
一、连接服务器并安装 vocechat
vocechat 官方推荐使用 Docker 部署,本部分将完成 Docker 环境的安装。
1.SSH 连接与基础工具安装
使用 SSH 工具连接到您的搬瓦工服务器(推荐使用 Xshell 等工具,如果你是个人或家庭使用,可以下载 Xshell:下载链接),
然后执行下方命令安装必要的工具。
apt-get install wget curl vim sudo unzip -y
2.安装并启动Docker
执行下方命令安装 Docker,安装过程预计耗时数十秒。
wget -qO- get.docker.com | bash
Docker 安装完成后,执行以下命令启动 Docker 服务并设置开机自启:
systemctl start docker systemctl enable docker
3.安装 vocechat
执行下方命令安装 vocechat ,大概10秒钟可以安装完毕。
docker run -d --restart=always \ -p 3000:3000 \ --name vocechat-server \ privoce/vocechat-server:latest

二、访问 vocechat 并进行基础配置
1.登录并设置 vocechat
在浏览器中输入 IP 地址:3000(例如 http://1.2.3.4:3000)。

1.1 设置服务器名称
给您的聊天室起个名字。

1.2 创建管理员账号
输入您的邮箱作为账号,并设置强密码。

1.3 配置邀请方式并进入聊天室
接下来会选择邀请方式,这里建议选择链接邀请。

系统会生成一个初始邀请链接,您可以复制保存(也可以稍后在后台生成),然后点击完成。

到这里聊天室就配置完成了,点击按钮进入聊天室。

2.被邀请用户注册
将刚才复制的邀请链接发送给您的朋友或客户,会提示输入名称
- 对方访问链接后,只需输入昵称和密码即可快速注册(无需邮箱验证,通过邀请链接直接加入)。
- 注册成功后,点击左侧的用户列表,即可开始私聊或群聊。

3.用户间发送聊天消息
点击左侧用户按钮,可以看到该聊天室已经存在的用户,并向他发送消息。

三、vocechat 的一些使用优化
1.聊天布局优化
默认情况下,VoceChat 的消息可能全部靠左对齐。如果您习惯像微信或者 Telegram 那样“自己的消息靠右”,可以在 设置 -> 概况 中调整布局偏好。

设置完成后可以看到自己的聊天内容已经靠后排列。

2.聊天记录定期清除
如果你的VPS硬盘空间是相对有限,建议设置自动清理策略。

3.反向代理 vocechat
默认情况下,vocechat 的访问地址是IP加端口的形式,不利于记忆和访问,而且无法使用 HTTPS 加密,存在安全风险。建议配合 Nginx Proxy Manager (NPM) 使用域名访问,反向代理的具体路程看可以参考以下教程。
3.1 域名解析
先域名(如 chat.yourdomain.com)解析到 VPS 的 IP。
3.2 反向代理
具体配置如下:
- Forward Hostname/IP: 127.0.0.1
- Forward Port: 3000
- 重要设置: 务必在编辑页面开启 Websockets Support(这对实时聊天至关重要)。同时建议开启 Block Common Exploits。
- SSL: 申请免费证书并开启 Force SSL。
3.3 最终测试
配置完成后,访问域名测试结果。
3.3.1 登录界面: 访问地址正常访问,且变成域名。

3.3.2 消息收发: 发送消息无延迟,对方能即时收到(验证 WebSocket 正常)。

3.3.3 邀请链接: 此时生成的邀请链接应自动变为以域名开头的形式。




