default··约 5 分钟读完·350 次观看

局域网聊天工具

这是一个基于Rust和Axum框架开发的局域网实时聊天工具,支持文本聊天、图片和文件分享功能。项目采用WebSocket实现实时通信,前端使用Tailwind CSS构建界面。主要功能包括实时消息传递、文件上传下载(限制100MB)、在线用户显示和消息历史记录。部署简单,只需Rust环境,通过Cargo编译运行即可启动服务。系统架构清晰,包含后端处理、前端界面和文件存储模块,适合局域网内团队协作使用。
javascriptrust

局域网聊天工具

仓库地址:https://github.com/Sunrisies/lan-share.git

一个基于 Rust + Axum 的局域网实时聊天工具,支持文本、图片和文件分享。

功能特性

  • ✅ 实时文本聊天
  • ✅ 图片上传和预览
  • ✅ 文件上传和下载
  • ✅ 在线用户数量显示
  • ✅ 消息历史记录
  • ✅ 消息时间戳
  • ✅ 文件大小限制提示(100MB)
  • ✅ 消息提示弹窗
  • ✅ 自动滚动到最新消息

技术栈

  • 后端: Rust + Axum + Tokio + WebSocket
  • 前端: HTML + Tailwind CSS + JavaScript
  • 通信: WebSocket 实时通信
  • 文件处理: Multipart 文件上传

快速开始

环境要求

  • Rust 1.70+
  • Cargo

安装

bash
      
        
          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

使用说明

聊天功能

  1. 发送文本消息
    • 在输入框中输入消息
    • 按 Enter 键或点击"发送"按钮
  2. 发送图片
    • 点击附件按钮
    • 选择图片文件
    • 图片会自动上传并显示预览
  3. 发送文件
    • 点击附件按钮
    • 选择任意文件
    • 文件会自动上传,其他用户可下载

界面说明

  • 在线用户数量: 页面顶部显示当前在线用户数
  • 消息历史: 新用户加入时可查看之前的消息
  • 时间戳: 每条消息显示发送时间
  • 消息提示: 操作成功或失败会显示提示弹窗

配置说明

修改端口

编辑 src/main.rs 文件:

rust
      
        
          1
          
          let addr = SocketAddr::from(([0, 0, 0, 0], 3000)); // 修改端口号
        
      
    

修改文件大小限制

编辑 src/main.rs 文件:

rust
      
        
          1
          
          const MAX_FILE_SIZE: usize = 100 * 1024 * 1024; // 修改大小限制(字节)
        
      
    

修改历史消息数量

编辑 src/main.rs 文件:

rust
      
        
          1
          
          if history.len() > 100 { // 修改历史消息数量
        
          2
          
              history.remove(0);
        
          3
          
          }
        
      
    

项目结构

text
      
        
          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. 文本消息
json
      
        
          1
          
          {
        
          2
          
            "type": "message",
        
          3
          
            "content": "消息内容",
        
          4
          
            "sender_id": "用户ID"
        
          5
          
          }
        
      
    
  1. 图片消息
json
      
        
          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. 文件消息
json
      
        
          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 浏览

这篇文章对你有帮助吗?