|
|
# P2P Chat - 点对点通信应用
|
|
|
|
|
|
一个基于 Python 的 P2P 网络通信应用程序，支持文本消息、文件传输、图片分享和语音通话。
|
|
|
|
|
|
## 功能特性
|
|
|
|
|
|
- 文本消息通信
|
|
|
- 文件传输（支持断点续传）
|
|
|
- 图片传输与显示
|
|
|
- 音视频播放
|
|
|
- 语音聊天
|
|
|
- 局域网自动发现
|
|
|
- 离线消息缓存
|
|
|
|
|
|
## 环境要求
|
|
|
|
|
|
- Python 3.9+
|
|
|
- MySQL 5.7+（可选，用于持久化存储）
|
|
|
|
|
|
## 安装
|
|
|
|
|
|
### 1. 克隆项目
|
|
|
|
|
|
```bash
|
|
|
git clone <repository-url>
|
|
|
cd chatProgram
|
|
|
```
|
|
|
|
|
|
### 2. 创建虚拟环境
|
|
|
|
|
|
```bash
|
|
|
python -m venv venv
|
|
|
|
|
|
# Windows
|
|
|
venv\Scripts\activate
|
|
|
|
|
|
# Linux/Mac
|
|
|
source venv/bin/activate
|
|
|
```
|
|
|
|
|
|
### 3. 安装依赖
|
|
|
|
|
|
```bash
|
|
|
pip install -r requirements.txt
|
|
|
```
|
|
|
|
|
|
### 4. 系统依赖（Linux）
|
|
|
|
|
|
```bash
|
|
|
# Ubuntu/Debian
|
|
|
sudo apt install portaudio19-dev ffmpeg libopus-dev
|
|
|
|
|
|
# openEuler/CentOS
|
|
|
sudo dnf install portaudio-devel ffmpeg opus-devel
|
|
|
```
|
|
|
|
|
|
## 快速开始
|
|
|
|
|
|
### 启动服务器
|
|
|
|
|
|
```bash
|
|
|
# 基本启动
|
|
|
python run_server.py
|
|
|
|
|
|
# 指定地址和端口
|
|
|
python run_server.py --host 0.0.0.0 --port 8888
|
|
|
|
|
|
# 调试模式
|
|
|
python run_server.py --debug
|
|
|
```
|
|
|
|
|
|
### 启动客户端（命令行）
|
|
|
|
|
|
```bash
|
|
|
# 基本启动
|
|
|
python run_client.py --username alice
|
|
|
|
|
|
# 连接远程服务器
|
|
|
python run_client.py -u bob -s 192.168.1.100 -p 8888
|
|
|
|
|
|
# 带显示名称
|
|
|
python run_client.py -u alice -d "Alice Wang"
|
|
|
```
|
|
|
|
|
|
### 启动客户端（GUI）
|
|
|
|
|
|
```bash
|
|
|
# 基本启动
|
|
|
python run_client_gui.py
|
|
|
|
|
|
# 指定服务器
|
|
|
python run_client_gui.py --server 192.168.1.100 --port 8888
|
|
|
```
|
|
|
|
|
|
## 命令行客户端命令
|
|
|
|
|
|
连接成功后可使用以下命令：
|
|
|
|
|
|
| 命令 | 说明 |
|
|
|
|------|------|
|
|
|
| `/list` | 查看在线用户 |
|
|
|
| `/msg <用户> <消息>` | 发送消息 |
|
|
|
| `/file <用户> <路径>` | 发送文件 |
|
|
|
| `/call <用户>` | 发起语音通话 |
|
|
|
| `/endcall` | 结束通话 |
|
|
|
| `/stats` | 查看统计信息 |
|
|
|
| `/refresh` | 刷新用户列表 |
|
|
|
| `/help` | 查看帮助 |
|
|
|
| `/quit` | 退出 |
|
|
|
|
|
|
## 配置
|
|
|
|
|
|
### 环境变量
|
|
|
|
|
|
```bash
|
|
|
# 服务器配置
|
|
|
P2P_SERVER_HOST=0.0.0.0
|
|
|
P2P_SERVER_PORT=8888
|
|
|
P2P_MAX_CONNECTIONS=1000
|
|
|
|
|
|
# 数据库配置
|
|
|
P2P_DB_HOST=localhost
|
|
|
P2P_DB_PORT=3306
|
|
|
P2P_DB_NAME=p2p_chat
|
|
|
P2P_DB_USER=root
|
|
|
P2P_DB_PASSWORD=your_password
|
|
|
|
|
|
# 安全配置
|
|
|
P2P_USE_TLS=true
|
|
|
P2P_CERT_FILE=/path/to/cert.pem
|
|
|
P2P_KEY_FILE=/path/to/key.pem
|
|
|
```
|
|
|
|
|
|
### 配置文件
|
|
|
|
|
|
也可以直接修改 `config.py` 中的默认值。
|
|
|
|
|
|
## 部署到 openEuler 服务器
|
|
|
|
|
|
### 1. 安装依赖
|
|
|
|
|
|
```bash
|
|
|
sudo dnf update -y
|
|
|
sudo dnf install -y python3 python3-pip python3-devel
|
|
|
sudo dnf install -y portaudio-devel ffmpeg opus-devel mysql-server mysql-devel
|
|
|
```
|
|
|
|
|
|
### 2. 部署项目
|
|
|
|
|
|
```bash
|
|
|
mkdir -p /opt/p2p-chat
|
|
|
cd /opt/p2p-chat
|
|
|
|
|
|
# 上传项目文件
|
|
|
# scp -r ./* user@server:/opt/p2p-chat/
|
|
|
|
|
|
python3 -m venv venv
|
|
|
source venv/bin/activate
|
|
|
pip install -r requirements.txt
|
|
|
```
|
|
|
|
|
|
### 3. 配置防火墙
|
|
|
|
|
|
```bash
|
|
|
sudo firewall-cmd --permanent --add-port=8888/tcp
|
|
|
sudo firewall-cmd --permanent --add-port=8889/udp
|
|
|
sudo firewall-cmd --reload
|
|
|
```
|
|
|
|
|
|
### 4. 设置系统服务
|
|
|
|
|
|
创建 `/etc/systemd/system/p2p-chat.service`：
|
|
|
|
|
|
```ini
|
|
|
[Unit]
|
|
|
Description=P2P Chat Server
|
|
|
After=network.target
|
|
|
|
|
|
[Service]
|
|
|
Type=simple
|
|
|
User=root
|
|
|
WorkingDirectory=/opt/p2p-chat
|
|
|
Environment=PATH=/opt/p2p-chat/venv/bin
|
|
|
ExecStart=/opt/p2p-chat/venv/bin/python run_server.py
|
|
|
Restart=always
|
|
|
|
|
|
[Install]
|
|
|
WantedBy=multi-user.target
|
|
|
```
|
|
|
|
|
|
启用服务：
|
|
|
|
|
|
```bash
|
|
|
sudo systemctl daemon-reload
|
|
|
sudo systemctl enable p2p-chat
|
|
|
sudo systemctl start p2p-chat
|
|
|
sudo systemctl status p2p-chat
|
|
|
```
|
|
|
|
|
|
## 项目结构
|
|
|
|
|
|
```
|
|
|
chatProgram/
|
|
|
├── client/ # 客户端模块
|
|
|
│ ├── ui/ # GUI 组件
|
|
|
│ ├── app.py # 客户端应用
|
|
|
│ ├── connection_manager.py
|
|
|
│ ├── file_transfer.py
|
|
|
│ ├── image_processor.py
|
|
|
│ ├── media_player.py
|
|
|
│ └── voice_chat.py
|
|
|
├── server/ # 服务器模块
|
|
|
│ ├── database.py
|
|
|
│ ├── relay_server.py
|
|
|
│ └── repositories.py
|
|
|
├── shared/ # 共享模块
|
|
|
│ ├── message_handler.py
|
|
|
│ ├── models.py
|
|
|
│ └── security.py
|
|
|
├── tests/ # 测试
|
|
|
├── config.py # 配置
|
|
|
├── run_server.py # 服务器启动脚本
|
|
|
├── run_client.py # 命令行客户端启动脚本
|
|
|
├── run_client_gui.py # GUI 客户端启动脚本
|
|
|
└── requirements.txt # 依赖
|
|
|
```
|
|
|
|
|
|
## 测试
|
|
|
|
|
|
```bash
|
|
|
# 运行所有测试
|
|
|
pytest
|
|
|
|
|
|
# 运行特定测试
|
|
|
pytest tests/test_relay_server.py -v
|
|
|
|
|
|
# 运行集成测试
|
|
|
pytest tests/test_integration.py -v
|
|
|
```
|
|
|
|
|
|
## License
|
|
|
|
|
|
MIT
|
