# locaSend

**Repository Path**: legend0/loca-send

## Basic Information

- **Project Name**: locaSend
- **Description**: locaSend 是一款运行在电脑上的局域网互传工具：同一 Wi-Fi / 网段下，手机无需安装 App，用浏览器扫码即可与电脑互传文件和文本。数据在局域网内点对点直传，不经过任何公网服务器。
- **Primary Language**: NodeJS
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/legend0/loca-send
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-19
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# locaSend

<div align="center">

<img src="assets/tray.png" alt="locaSend tray" width="64" />

**局域网文件互传工具：PC (Electron) 与手机浏览器之间通过 HTTP 直传**

[项目地址](https://gitee.com/legend0/locaSend) · [English](README.en.md)

</div>

#### 介绍

locaSend 是一款运行在电脑上的局域网互传工具：同一 Wi-Fi / 网段下，手机无需安装 App，用浏览器扫码即可与电脑互传文件和文本。数据在局域网内点对点直传，不经过任何公网服务器。

#### 软件架构

- **PC 端**：Electron 桌面应用
  - 主进程：Express HTTP 服务（页面托管 / 文件上传下载）、WebSocket 信令、mDNS 发现（bonjour-service）、系统托盘与通知
  - 渲染进程：原生 HTML / CSS / JavaScript，Remix Icon 图标
- **移动端**：手机浏览器直接访问的 Web 页面，原生实现，无需安装客户端
- **传输通道**：
  - HTTP 直传：分块断点续传上传 + 流式下载
  - WebRTC P2P：本地信令与公网中继双通道并发协商，配对成功后点对点直传（支持自定义 ICE / TURN 服务器）
- **打包分发**：electron-builder + NSIS 安装包

#### 功能特性

- 扫码即连：主界面展示访问地址与二维码，鉴权开启时链接自带访问令牌
- 文件互传：PC 端选择或拖拽文件共享，手机端可直接上传；大文件分块续传
- 文本消息：PC 与手机双向收发，可指定目标设备或广播
- 设备感知：设备上线 / 离线实时提醒（提示音 + 系统通知 + 托盘闪烁）
- mDNS 辅助发现：局域网内自动广播服务
- 安全可控：访问令牌鉴权开关，token 可随时重新生成
- 接收管理：自定义接收目录、媒体预览、另存为、一键清空、文件类型图标
- 个性化设置：设备名称、服务端口（默认 3210，被占用自动向上尝试）、通知与提示音开关、开机自启
- 防火墙自动放行：安装时自动添加 Windows 防火墙 TCP 入站规则（3210-3230）；修改端口后自动同步增删规则
- 托盘常驻：关闭窗口即最小化到托盘，双击恢复

#### 界面预览

![发送文件](assets/预览图.png)

![网络设置（跨网中继 / TURN）](assets/预览图2.png)

#### 安装教程

1. 克隆仓库

   ```bash
   git clone https://gitee.com/legend0/locaSend.git
   cd locaSend
   ```

2. 安装依赖

   ```bash
   npm install
   ```

3. 开发运行

   ```bash
   npm start
   ```

4. 打包安装包（可选）

   ```bash
   npm run dist
   ```

   产物输出至 `dist/`。NSIS 安装包为全机安装（需管理员权限），安装时自动放行 Windows 防火墙端口 3210-3230，卸载时自动清理规则。

> 防火墙说明：若不使用安装包而直接 `npm start` 运行，应用首次启动时会弹出 UAC 授权以自动补齐防火墙规则；拒绝授权或非 Windows 系统请在防火墙中手动放行对应 TCP 端口。

#### 使用说明

1. 启动应用，主界面显示访问地址与二维码；手机浏览器扫码或输入地址打开移动端页面
2. 传文件：PC 端添加或拖入文件加入共享清单发送；手机端选择文件即可上传到电脑
3. 发文本：任意一侧输入消息发送，支持指定接收设备
4. 大文件传输：设备配对后自动协商 WebRTC P2P 直传，也可在设置中配置公网中继与 TURN 服务器
5. 系统设置：接收目录、服务端口、设备名称、通知 / 提示音、开机自启均可自定义
6. 关闭窗口即最小化到系统托盘；双击托盘图标重新打开，托盘菜单可退出

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 开源协议

MIT