default··约 5 分钟读完
局域网聊天工具
这是一个基于Rust和Axum框架开发的局域网实时聊天工具，支持文本聊天、图片和文件分享功能。项目采用WebSocket实现实时通信，前端使用Tailwind CSS构建界面。主要功能包括实时消息传递、文件上传下载(限制100MB)、在线用户显示和消息历史记录。部署简单，只需Rust环境，通过Cargo编译运行即可启动服务。系统架构清晰，包含后端处理、前端界面和文件存储模块，适合局域网内团队协作使用。
javascriptrust
局域网聊天工具
一个基于 Rust + Axum 的局域网实时聊天工具，支持文本、图片和文件分享。
功能特性
- ✅ 实时文本聊天
- ✅ 图片上传和预览
- ✅ 文件上传和下载
- ✅ 在线用户数量显示
- ✅ 消息历史记录
- ✅ 消息时间戳
- ✅ 文件大小限制提示（100MB）
- ✅ 消息提示弹窗
- ✅ 自动滚动到最新消息
技术栈
- 后端: Rust + Axum + Tokio + WebSocket
- 前端: HTML + Tailwind CSS + JavaScript
- 通信: WebSocket 实时通信
- 文件处理: Multipart 文件上传
快速开始
环境要求
- Rust 1.70+
- Cargo
安装
# 克隆项目
git clone https://github.com/Sunrisies/lan-share.git
cd lan-share
# 编译项目
cargo build --release
# 运行项目
cargo run
访问
服务器启动后，访问 http://localhost:3000
使用说明
聊天功能
- 发送文本消息
- 在输入框中输入消息
- 按 Enter 键或点击"发送"按钮
- 发送图片
- 点击附件按钮
- 选择图片文件
- 图片会自动上传并显示预览
- 发送文件
- 点击附件按钮
- 选择任意文件
- 文件会自动上传，其他用户可下载
界面说明
- 在线用户数量: 页面顶部显示当前在线用户数
- 消息历史: 新用户加入时可查看之前的消息
- 时间戳: 每条消息显示发送时间
- 消息提示: 操作成功或失败会显示提示弹窗
配置说明
修改端口
编辑 src/main.rs 文件：
let addr = SocketAddr::from(([0, 0, 0, 0], 3000)); // 修改端口号
修改文件大小限制
编辑 src/main.rs 文件：
const MAX_FILE_SIZE: usize = 100 * 1024 * 1024; // 修改大小限制（字节）
修改历史消息数量
编辑 src/main.rs 文件：
if history.len() > 100 { // 修改历史消息数量
history.remove(0);
}
项目结构
synchronization/
├── src/
│ └── main.rs # 后端主程序
├── static/
│ └── index.html # 前端界面
├── shared_files/ # 上传文件存储目录
├── Cargo.toml # 项目依赖
└── README.md # 项目文档
API 接口
WebSocket
- 连接地址:
ws://localhost:3000/ws - 消息格式: JSON
消息类型
- 文本消息
{
"type": "message",
"content": "消息内容",
"sender_id": "用户ID"
}
- 图片消息
{
"type": "image",
"content": "",
"sender_id": "用户ID",
"file_url": "/files/xxx.jpg",
"file_name": "图片.jpg",
"file_type": "image"
}
- 文件消息
{
"type": "file",
"content": "",
"sender_id": "用户ID",
"file_url": "/files/xxx.zip",
"file_name": "文件.zip",
"file_type": "file"
}
HTTP
GET /- 主页面POST /upload- 文件上传GET /files/{filename}- 文件下载GET /files- 文件列表
常见问题
1. 文件上传失败
- 检查文件大小是否超过 100MB
- 检查网络连接是否正常
- 查看服务器控制台错误信息
2. WebSocket 连接失败
- 确保服务器正在运行
- 检查防火墙设置
- 确认端口未被占用
3. 无法访问其他设备
- 确保所有设备在同一局域网
- 检查服务器绑定地址（默认 0.0.0.0）
- 检查防火墙设置