局域网聊天工具
局域网聊天工具
一个基于 Rust + Axum 的局域网实时聊天工具,支持文本、图片和文件分享。
功能特性
- ✅ 实时文本聊天
- ✅ 图片上传和预览
- ✅ 文件上传和下载
- ✅ 在线用户数量显示
- ✅ 消息历史记录
- ✅ 消息时间戳
- ✅ 文件大小限制提示(100MB)
- ✅ 消息提示弹窗
- ✅ 自动滚动到最新消息
技术栈
- 后端: Rust + Axum + Tokio + WebSocket
- 前端: HTML + Tailwind CSS + JavaScript
- 通信: WebSocket 实时通信
- 文件处理: Multipart 文件上传
快速开始
环境要求
- Rust 1.70+
- Cargo
安装
1
# 克隆项目
2
git clone https://github.com/Sunrisies/lan-share.git
3
cd lan-share
4
5
# 编译项目
6
cargo build --release
7
8
# 运行项目
9
cargo run
访问
服务器启动后,访问 http://localhost:3000
使用说明
聊天功能
- 发送文本消息
- 在输入框中输入消息
- 按 Enter 键或点击"发送"按钮
- 发送图片
- 点击附件按钮
- 选择图片文件
- 图片会自动上传并显示预览
- 发送文件
- 点击附件按钮
- 选择任意文件
- 文件会自动上传,其他用户可下载
界面说明
- 在线用户数量: 页面顶部显示当前在线用户数
- 消息历史: 新用户加入时可查看之前的消息
- 时间戳: 每条消息显示发送时间
- 消息提示: 操作成功或失败会显示提示弹窗
配置说明
修改端口
编辑 src/main.rs 文件:
1
let addr = SocketAddr::from(([0, 0, 0, 0], 3000)); // 修改端口号
修改文件大小限制
编辑 src/main.rs 文件:
1
const MAX_FILE_SIZE: usize = 100 * 1024 * 1024; // 修改大小限制(字节)
修改历史消息数量
编辑 src/main.rs 文件:
1
if history.len() > 100 { // 修改历史消息数量
2
history.remove(0);
3
}
项目结构
1
synchronization/
2
├── src/
3
│ └── main.rs # 后端主程序
4
├── static/
5
│ └── index.html # 前端界面
6
├── shared_files/ # 上传文件存储目录
7
├── Cargo.toml # 项目依赖
8
└── README.md # 项目文档
API 接口
WebSocket
- 连接地址:
ws://localhost:3000/ws - 消息格式: JSON
消息类型
- 文本消息
1
{
2
"type": "message",
3
"content": "消息内容",
4
"sender_id": "用户ID"
5
}
- 图片消息
1
{
2
"type": "image",
3
"content": "",
4
"sender_id": "用户ID",
5
"file_url": "/files/xxx.jpg",
6
"file_name": "图片.jpg",
7
"file_type": "image"
8
}
- 文件消息
1
{
2
"type": "file",
3
"content": "",
4
"sender_id": "用户ID",
5
"file_url": "/files/xxx.zip",
6
"file_name": "文件.zip",
7
"file_type": "file"
8
}
HTTP
GET /- 主页面POST /upload- 文件上传GET /files/{filename}- 文件下载GET /files- 文件列表
常见问题
1. 文件上传失败
- 检查文件大小是否超过 100MB
- 检查网络连接是否正常
- 查看服务器控制台错误信息
2. WebSocket 连接失败
- 确保服务器正在运行
- 检查防火墙设置
- 确认端口未被占用
3. 无法访问其他设备
- 确保所有设备在同一局域网
- 检查服务器绑定地址(默认 0.0.0.0)
- 检查防火墙设置
相关文章
查看同分类文章MAVLink 消息处理指南
MAVLink消息处理系统摘要 本系统实现了一套完整的MAVLink消息处理机制,用于无人机通信与控制。核心功能包括: 消息接收:通过UDP连接持续接收飞控消息,支持心跳维持机制 消息处理:分类处理多种MAVLink消息类型,包括心跳、位置、姿态和航点相关消息 航点管理:实现航点下载状态机,支持分片请求和接收航点数据 消息转发:将处理后的消息通过MQTT发布到指定主题 系统采用多线程架构,包含独立的消息接收线程和主处理循环,通过通道进行线程间通信。关键特性包括航点下载状态机、错误处理和日志记录机制,确保通信
304 浏览
M3U8 下载助手油猴脚本 - 技术实现解析
M3U8下载助手技术解析 该油猴脚本通过注入拦截脚本实现对M3U8链接的全面捕获。核心架构包括: 请求拦截层:劫持XHR、fetch和WebSocket请求 DOM监听层:通过MutationObserver监控动态元素变化 跨域通信:iframe间使用postMessage传递数据 UI展示层:提供浮动按钮等交互界面 关键技术点: 使用document-start确保早期注入 通过保存原始方法实现API劫持 在send时而非open时检测URL 全面覆盖各种属性(src/href/data-src等) 脚
362 浏览
我做了一个局域网传文件的小工具,记录一下
本文记录了作者开发局域网文件传输工具的过程。起因是工作中遇到大文件传输不便的问题,作者选择用Rust语言开发,解决了WebSocket状态管理、大文件上传限制等技术难点。最终成品通过浏览器即可使用,支持文字聊天和文件传输,内存占用低。同事们试用后反馈良好,建议增加拖拽上传等功能。作者认为Rust虽开发较繁琐但运行高效稳定,并将项目开源供社区参与改进。
291 浏览
彻底解决 Windows 下无法删除 nul 文件的问题
摘要:Windows系统下无法删除名为nul的文件,因为它是系统保留设备名。常见解决方法如\\.\路径可能失效,更可靠的方案是使用Git Bash的rm命令直接删除,或使用\\?\前缀的扩展路径。备选方案包括安全模式、PE系统或第三方工具。Git Bash方案操作简单成功率最高,\\?\路径是原生解决方案,建议根据实际情况选择最佳方法。
1312 浏览