# ChatMini **Repository Path**: fortyfivexo/chatmini ## Basic Information - **Project Name**: ChatMini - **Description**: 这是一个基于 Python 的点对点聊天程序,支持两个用户之间的加密通信,无需中心服务器。 - **Primary Language**: Python - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2024-10-30 - **Last Updated**: 2024-12-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: shell ## README # Python 点对点聊天程序[终端] 这是一个基于 Python 的点对点聊天程序,支持两个用户之间的加密通信,无需中心服务器。 ## 功能特点 - 点对点直接通信 - 端到端加密通信 - 用户名显示和交换 - 简洁的命令行界面 - 消息带有时间戳 - 实时显示聊天状态 - 支持优雅退出 - 自定义端口号 - 消息长度限制 - 输入验证 ## 系统要求 - Python 3.6 或更高版本 - cryptography >= 41.0.0 库 - 支持的操作系统:Windows、Linux、macOS ## 安装依赖 ```bash pip install cryptography ``` ## 使用方法 ### 作为接收方启动 ```bash python ChatMini.py -p 5000 ``` 然后输入你的用户名,程序会在指定端口等待连接。 ### 作为发起方连接 ```bash python ChatMini.py 192.168.1.100:5000 ``` 然后输入你的用户名,程序会尝试连接到指定地址。 ### 聊天界面 - 显示格式:`[时间] 用户名: 消息内容` - 输入提示:`用户名> ` - 连接状态提示 - 用户加入/退出提示 - 加密状态提示 ### 操作说明 - 直接输入消息后按回车发送 - 输入 `quit` 退出程序 - 使用 `Ctrl+C` 也可以安全退出 - 空消息不会被发送 - 超长消息会被自动截断 ## 安全特性 1. 加密通信: - 使用 Fernet 对称加密 - 自动密钥交换 - 消息完整性验证 - 防重放保护 2. 输入安全: - 消息长度限制(4096字节) - 输入验证和过滤 - 空消息过滤 3. 连接安全: - 连接超时处理(30秒) - 安全的消息帧处理 - 优雅的连接断开 ## 参数说明 - `-p` 或 `--port`: 指定监听端口(默认:5000) - `IP:端口`: 指定要连接的目标地址 ## 注意事项 1. 网络配置: - 确保指定的端口未被占用 - 确保防火墙允许指定端口的通信 - 需要知道对方的 IP 地址和端口号 2. 运行环境: - 确保已安装 cryptography 库 - 确保 Python 版本兼容 - 确保网络连接正常 3. 字符编码: - 程序使用 UTF-8 编码 - Windows 用户可能需要设置终端编码:`chcp 65001` ## 安全建议 1. 使用建议: - 在可信网络中使用 - 避免传输敏感信息 - 定期更换端口号 - 及时关闭不使用的连接 2. 已知限制: - 不支持完整的身份认证 - 不支持消息历史记录 - 不支持群聊功能 - 不支持文件传输 ## 技术实现 - 网络通信:TCP Socket - 并发处理:多线程 - 加密实现:Fernet (AES-128-CBC) - 字符编码:UTF-8 - 参数解析:argparse - 用户界面:命令行交互 ## 错误处理 程序会处理以下错误情况: - 连接失败 - 消息发送失败 - 加密/解密错误 - 消息超长 - 连接断开 - 程序异常退出 ## 许可证 MIT License