• v3.0.0 a2d492e9f8

    dvs released this 2026-09-27 09:17:01 +00:00 | 1 commits to chat since this release

    ChaosCryptChat v3.0.0

    基于 ChaosCrypt 加密内核的端到端加密通讯应用,本次从 ChaosCrypt 仓库独立出来,成为单独项目。

    应用代码未做任何改动 —— 与原 ChaosCrypt 仓库中发布的版本逐字节一致。


    包含内容

    ChaosCryptChat/
    ├── qtmain.py      PyQt5 客户端 + 完整后端
    ├── server.py      可选中央中继服务器(纯标准库)
    ├── README.md      快速开始与架构说明
    ├── SECURITY.md    威胁模型与已知限制
    ├── LICENSE        MIT
    └── CHANGELOG.md   版本历史
    

    qtmain.py 是单文件应用,内含加密内核、账户与历史数据库、P2P 网络层、中继客户端与图形界面。直接运行即启动客户端。

    server.py 刻意保持独立,仅使用 Python 标准库,可直接部署在裸机上,无需安装任何依赖。


    功能

    • 端到端加密 —— 群密钥仅存于客户端,服务器只中继密文,无法解密
    • 两种群模式
      • 🔗 端到端 P2P —— 对等直连,不经服务器
      • ☁️ 中央服务器 —— 中继转发,解决 NAT 穿透
    • 多媒体消息 —— 文本、图片、任意文件、语音,均同等加密;二进制数据无损传输
    • 群管理 —— 创建 / 加入 / 改名 / 公告 / 踢人 / 入群审批
    • 每用户密钥认证 —— 成员凭签发密钥签名,防止群内冒充
    • HMAC 完整性校验 —— 密文被篡改即校验失败并拒收
    • 消息撤回 —— 限时窗口内可撤回
    • 本地历史 —— 按账户存于 SQLite,重启不丢
    • 现代化界面 —— PyQt5 圆角 UI,自适应消息气泡

    环境要求

    客户端

    pip install PyQt5 Pillow numpy pygame sounddevice pyaudio qrcode
    

    Linux 可能还需系统库:

    sudo apt install python3-pyqt5 portaudio19-dev libsndfile1
    

    服务器:无需任何依赖。


    运行

    P2P 直连

    python qtmain.py
    

    创建账户后新建端到端模式的群,把群密钥通过可信渠道分享给其他人。

    中继服务器

    python server.py          # 监听 0.0.0.0:8666
    python server.py 9000     # 或指定端口
    

    客户端创建中央服务器模式的群并指向该地址。服务器只转发密文,永远拿不到群密钥。

    ⚠️ 群密钥务必通过你已信任的渠道分享。持有群密钥的任何人都能读取该群消息。


    数据位置

    路径 内容
    data/users.db 本地账户(加盐密码哈希)
    data/chat_history.db 按账户与群的聊天历史
    data/session.dat 会话令牌(保持登录)
    data/server_state.db 中继状态缓存与已签发用户密钥
    server_data/server.db 服务端用户、群、成员关系
    ~/Documents/ChaosChat/media/ 收发媒体
    ~/Downloads/ChaosChat/ 下载文件

    ⚠️ 这些文件未加密存储。聊天历史与媒体为明文。请保护主机,或把这些目录放到加密卷上。


    安全说明

    已提供

    • 服务器无法读取消息内容(群密钥不离开客户端)
    • 账户密码不落明文(随机盐哈希)
    • 消息篡改可被检测(HMAC 校验)
    • 群内成员无法互相冒充(每用户密钥签名)

    需注意

    • 未经独立审计(加密内核与应用本身均未经过第三方评审)
    • 元数据暴露 —— 服务器可见群成员、通信时间与消息大小
    • 密钥需带外分享 —— 分享渠道被截获则群失守
    • P2P 模式下群主即参与者 —— 群主机器被攻陷则该群失守
    • 本地数据明文存储
    • 撤回仅为尽力而为 —— 离线成员仍可能看到原文
    • 无前向保密 —— 未实现 ratchet,群密钥泄露会波及该密钥下的全部消息
    • 第三方库依赖 —— 音视频与图像处理依赖 pygame / sounddevice / Pillow,其安全不在本项目范围内

    加密内核本身的完整分析(密钥空间、抗差分/线性/代数攻击、抗量子评估)见 ChaosCrypt 仓库的 SECURITY.md。


    适用范围

    本项目用于学习、实验与个人使用。它不是 Signal、Matrix 等经过审计的安全通讯工具的替代品,也不适用于对保密性有监管、合同或安全要求的场景。

    同样地,这不是一句为了保险而加上的免责声明 —— 而是正确的工程选择。做完整加密通讯,请把审计过的方案用在该用的地方。


    许可:MIT。代码按原样提供,不提供任何担保。因使用本软件造成的任何损失、泄露或损害,作者不承担责任。

    Downloads