快速开始与使用指南

只需三步，在任何场景下搭建属于自己的安全私密通讯。

1

下载并安装 unobox 桌面客户端

从 官网首页 根据你的操作系统下载对应版本：

  • 🪟 Windows：下载 .exe 安装包，双击运行，按向导一键完成安装。
  • 🍎 macOS：下载 .dmg 磁盘镜像，打开后将 unobox 拖入 Applications 文件夹。
💡 首次启动 macOS 版本时，系统可能提示"无法验证开发者"。请前往 系统设置 → 隐私与安全性，点击"仍要打开"即可。
2

首次启动：选择通信模式

首次打开 unobox 时，会显示欢迎引导界面。点击 "开始配置"，然后从三种通信模式中选择一种：

🔌 WebSocket 局域网 🌐 Matrix 联邦网络 💾 本地存储
🔌 模式一：WebSocket 局域网（推荐）

适合局域网（家庭/公司/内网）中多台设备互联通信。分为两个角色：

  • 服务端模式（主机）：选择"服务端模式（本地承载）"，填写端口（默认 8080）、访问密码（系统会自动随机生成）和本机用户名，点击"保存并连接"启动内置 WebSocket 服务器。
  • 客户端模式（其他设备）：选择"客户端模式（连接远端）"，填入主机的局域网 IP + 端口（如 ws://192.168.1.100:8080）和对应的访问密码，点击"保存并连接"即可加入。
服务端信息（其他人连接时需要提供）： 地址：ws://[主机局域网IP]:8080 密码：（服务端页面中显示的随机 Token）
📢 主机的局域网 IP 可以在"服务端模式"配置面板的 "局域网接入信息" 提示框中直接复制，无需自行查找。
🌐 模式二：Matrix 联邦网络

适合连接全球公开的 Matrix/Synapse 服务器或自建 Synapse 私有节点，打破地理隔阂实现跨网络私密通信。

  • 在 Homeserver URL 中填入 Matrix 服务器地址（如 https://matrix.example.com、自建 Synapse 地址，或确认本机网络可解析的公共 Matrix 地址）。
  • 填写用户名（如 samjoeyang，系统会根据 Homeserver 自动组成完整 Matrix ID）。
  • 使用账号密码或 Access Token（syt_...）登录，点击"保存并连接"。
  • 新建会话时选择普通对话、普通房间、加密对话或加密房间；加密会话创建时启用 Matrix 房间级 m.room.encryption。
🌍 Matrix 模式支持与全球任何 Matrix 服务器的用户聊天。添加服务器时默认填入 matrix.org 便于快速体验；如果 DNS/网络不可达，请改用可访问的 Homeserver 或自建 Synapse 节点。加密房间创建后不可降级为普通房间。
💾 模式三：本地存储

无需网络、无需服务器，所有消息保存在本机 SQLite 数据库中。适合单机记录、离线备忘或测试使用。

  • 选择"本地存储"后，直接点击"保存并连接"即可，无需填写任何地址或密码。
3

创建会话并开始聊天

连接成功后，即可看到 Telegram 风格的三栏主界面。从这里开始你的私密通讯：

  • 📢 创建频道（Channel）：点击聊天列表左上角的"+"图标，选择"创建频道"，输入名称后即可完成，适合广播消息或公告。
  • 👥 创建群组（Group）：同样通过"+"图标选择"创建群组"，邀请其他已连接的成员加入，进行多人对话。
  • 💬 发送消息：进入任意频道或群组后，在底部输入框中输入消息并按 Enter 键发送。支持换行（Shift+Enter）。
  • 🔔 在线提示：局域网模式下，当其他设备连入服务器时，系统会自动弹出桌面通知提醒。
⚙️ 更换主题 / 调整字体大小：点击左上角的"设置"图标（⚙️）进入设置页，在 外观 选项中可切换日间/深色主题，以及拖动滑块调整消息字体大小（12–24px）。
💡

管理服务器与切换连接

unobox 支持同时管理多个服务器配置，方便在不同网络环境中快速切换：

  • 进入 设置 → 服务器管理，可以新增、编辑或删除已配置的服务器。
  • 点击左侧功能导航栏中的服务器头像图标，可快速在多个服务器之间切换。
  • 应用启动时会自动尝试重新连接上次活跃的服务器，断线后也会自动增量同步离线期间的消息。
🔄 自动更新：客户端内置静默更新检测，启动 5 秒后自动检查是否有新版本。也可在 设置 → 外观 → 关于与自动更新 中手动点击"检查新版本"。
🔒

端到端加密（E2EE）— 隐私与安全

unobox v0.2.4 起全面支持端到端加密，三种协议模式均已实现：

  • 本地模式：设置口令后，所有消息和附件自动使用 XSalsa20-Poly1305 加密存储，密钥通过 BLAKE2b KDF 从口令派生。
  • WebSocket 模式：X3DH 密钥协商 + Double Ratchet 会话加密，每次消息自动更新密钥（前向安全）。
  • Matrix 模式：Olm + Megolm 端到端加密，兼容 Element 等 Matrix 客户端。

📋 如何启用：

  • 进入 设置 → 隐私与安全，设置加密口令即可启用。
  • 口令强度指示器会实时反馈安全等级，建议使用 8 位以上混合字符。
  • 启用后，消息气泡右侧会显示 🔒 加密图标；Bot/AI 房间自动豁免加密。
🔑 密钥备份：在隐私与安全页面可导出加密密钥备份（JSON 文件）。重装系统或更换设备后，通过"恢复密钥备份"导入即可解密历史消息。关闭 E2EE 不会自动解密已加密的历史消息，需输入口令后手动导出。