查看“︁如何在搬瓦工VPS搭建一个匿名聊天室（vocechat）”︁的源代码

在当当下联网环境下，主流聊天软件普遍存在内容审查和和隐私泄露的隐患。如果您希望拥有一个完全属于自己、数据掌控在自己手中、且不用担心聊天记录被扫描的聊天平台，搭建一个私有聊天室是最佳选择。

VoceChat 是一款超轻量级的开源聊天应用（基于Rust开发），它资的源占用低(不超过100MB内存），传输过程全程加密。配合搬瓦工 VPS 稳定中国优化网络，可以让你轻松和客户、朋友进行流畅、安全沟通。同时它还提供Web端及移动端App，体验接近主流通讯软件。

=== 需要准备的事项： ===
1.拥有一台搬瓦工的服务器（[https://vpsmes.com/602.html 参考教程]）；

2.服务器在运行，且安装了debian12系统（[https://vpsmes.com/615.html 参考教程]）；

3.拥有一个域名（为了反向代理需要）；

4. SSH 连接工具已准备就绪（例如 Xshell）。

=== 一、连接服务器并安装 vocechat ===
vocechat 官方推荐使用 Docker 部署，本部分将完成 Docker 环境的安装。

==== 1.SSH 连接与基础工具安装 ====
使用 SSH 工具连接到您的搬瓦工服务器（推荐使用 Xshell 等工具，如果你是个人或家庭使用，可以下载 Xshell：[https://www.xshell.com/zh/free-for-home-school/ 下载链接]），

然后执行下方命令安装必要的工具。<syntaxhighlight lang="abap">apt-get install wget curl vim sudo unzip -y</syntaxhighlight>

==== 2.安装并启动Docker ====
执行下方命令安装 Docker，安装过程预计耗时数十秒。<syntaxhighlight lang="abap">wget -qO- get.docker.com | bash</syntaxhighlight>Docker 安装完成后，执行以下命令启动 Docker 服务并设置开机自启：<syntaxhighlight lang="abap">
systemctl start docker
systemctl enable docker
</syntaxhighlight>

==== 3.安装 vocechat ====

执行下方命令安装  vocechat ，大概10秒钟可以安装完毕。<syntaxhighlight lang="abap">
docker run -d --restart=always \
  -p 3000:3000 \
  --name vocechat-server \
  privoce/vocechat-server:latest
</syntaxhighlight>[[File:聊天室部署001ssh.png|900x900px]]

=== 二、访问 vocechat 并进行基础配置 ===

==== 1.登录并设置 vocechat ====
在浏览器中输入 '''IP 地址:3000'''（例如 <code><nowiki>http://1.2.3.4:3000</nowiki></code>）。

[[File:访问设置聊天室.png|900x900px]]

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

[[File:聊天室部署1.png|900x900px]]

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

[[File:聊天室注册.png|900x900px]]

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

[[File:聊天部署.png|900x900px]]

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

[[File:聊天室部署2.png|900x900px]]

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

[[File:聊天室部署3.png|900x900px]]

==== 2.被邀请用户注册 ====
将刚才复制的邀请链接发送给您的朋友或客户，会提示输入名称

* 对方访问链接后，只需输入昵称和密码即可快速注册（无需邮箱验证，通过邀请链接直接加入）。
* 注册成功后，点击左侧的用户列表，即可开始私聊或群聊。

[[File:邀请001.png|900x900px]]


[[File:聊天室邀请2.png|900x900px]]

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

[[File:聊天室发消息.png|900x900px]]

以下是发送消息后双双方的界面。

[[File:聊天室发消息2.png|900x900px]]

=== 三、vocechat 的一些使用优化 ===

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

[[File:优化设置 居右.png|900x900px]]

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

[[File:聊天室居右图示.png|900x900px]]

==== 2.聊天记录定期清除 ====
搬瓦工 E-Commerce 系列的硬盘空间是相对有限的，对于非永久性存档的聊天室，建议设置自动清理策略。

[[File:聊天室优化-数据清除.png|900x900px]]

==== 3.反向代理 vocechat ====
默认情况下，vocechat 的访问地址是IP加端口的形式，不利于记忆和访问，而且无法使用 HTTPS 加密，存在安全风险。建议配合 '''Nginx Proxy Manager (NPM)''' 使用域名访问，反向代理的具体路程看可以参考以下教程。

[[如何搭建Nginx Proxy Manager并使用反向代理和远程桌面加速]]

===== '''3.1 域名解析：''' 将二级域名（如 <code>chat.yourdomain.com</code>）解析到 VPS IP。 =====

===== '''3.2 反向代理配置：''' =====

* '''Forward Hostname/IP:''' <code>127.0.0.1</code>
* '''Forward Port:''' <code>3000</code>
* '''重要设置：''' 务必在编辑页面开启 '''Websockets Support'''（这对实时聊天至关重要）。同时建议开启 '''Block Common Exploits'''。
* '''SSL：''' 申请免费证书并开启 <code>Force SSL</code>。

===== 3.3 最终测试 =====
配置完成后，请通过 <code><nowiki>https://chat.yourdomain.com</nowiki></code> 访问：

'''3.3.1 登录界面：''' 访问地址正常访问，且变成域名。

[[File:反代后聊天室登录.png|900x900px]]

'''3.3.2 消息收发：''' 发送消息无延迟，对方能即时收到（验证 WebSocket 正常）。

[[File:反代聊天测试.png|900x900px]]

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

[[File:反代邀请链接测试.png|border|900x900px]]
[[Category:500 常见应用指南 — Application Guides]]