# FastSend
**Repository Path**: labs/FastSend
## Basic Information
- **Project Name**: FastSend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 4
- **Forks**: 5
- **Created**: 2024-12-25
- **Last Updated**: 2026-04-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
FastSend 文件快传 🚀
## 📖 项目介绍
FastSend 是一个基于 WebRTC 技术的点对点文件传输工具，支持快速的目录同步和文件传输。通过浏览器即可实现安全、高效的文件共享。
🌐 在线体验：[fastsend.ing](https://fastsend.ing)
## ✨ 特性
- 🔒 点对点加密传输，确保数据安全
- 📁 支持文件和文件夹传输
- 🚀 局域网自动优化，传输更快
- 🎯 简单易用的界面设计
- 🌍 支持中英文界面
- 📲 支持PWA轻量安装
## 🛠️ 技术栈
- WebRTC
- Vue.js
- Nuxt 4
- Pinia
- TypeScript
- Modern File System API
## 🗂️ 目录结构
项目已按 Nuxt 4 默认约定迁移为 `app/` 目录结构：
- `app/`：前端应用层源码，包括页面、组件、stores、composables、utils、全局样式与 `app.vue`
- `server/`：Nitro 服务端接口与 WebSocket 信令逻辑
- `public/`：静态资源与 PWA 相关文件
- `presets/`：PrimeVue 主题预设
这样可以更清晰地分离前端应用层与服务端上下文，也更符合 Nuxt 4 的默认扫描方式。
## 📦 安装与构建
```bash
# 安装依赖
yarn install
# 构建项目
yarn build
```
## 🚀 使用方法
```bash
# 启动服务
node .output/server/index.mjs
```
> [!IMPORTANT]
> 目录传输和同步需要 `HTTPS` 以及浏览器支持，一般新版本的桌面浏览器都支持
>
> 本项目自身的 HTTPS 配置方式（测试环境）请参考：
>
> - [置顶 Issue](https://github.com/ShouChenICU/FastSend/issues/9#issuecomment-2562353775)
> - [Nuxt 部署教程（英文）](https://nuxt.com/docs/4.x/getting-started/deployment#entry-point)
>
> FastSend 不建议直接以 HTTPS 形式进行生产环境部署，而应当位于反向代理服务器之后，请参考：
>
> - [Nginx](https://nginx.org/en/docs/http/configuring_https_servers.html)
> - [Apache httpd](https://httpd.apache.org/docs/current/ssl/)
> - [Caddy](https://caddyserver.com/docs/quick-starts/https)
> - [Windows IIS](https://learn.microsoft.com/zh-cn/iis/manage/configuring-security/how-to-set-up-ssl-on-iis)
## 🐳 Docker 和 Docker Compose
### 使用 Docker Hub 发行版
```bash
docker run -d --name fastsend -p 3000:3000 shouchenicu/fastsend:latest
```
> [!CAUTION]
>
> `shouchenicu/fastsend` 是此项目在 Docker Hub 上的 **唯一** 官方镜像！
>
> 当前已发现 12 个第三方镜像，其中5个[^1]的下载使用量高于官方镜像。请注意甄别，风险自负！
[^1]: 比如 `niliaerith/fastsend`
### Docker 构建
```bash
docker build -t fastsend .
docker run -d --name fastsend -p 3000:3000 fastsend
```
### Docker Compose
将项目拉取到本地，然后运行：
```bash
docker-compose up -d
```
访问 `http://localhost:3000` 即可使用。
## 💡 使用提示
1. 确保浏览器启用了 WebRTC 功能
2. 如需传输文件夹或同步目录，请确保浏览器支持现代文件系统 API 并已启用 HTTPS 传输
3. 在同一局域网内传输速度最快
4. 建议在网络状态良好时使用，部分网络环境可能会阻止 P2P / WebRTC 正确建立连接，从而导致传输失败
## 👨💻 作者
**ShouChen**
- 博客: [shouchen.blog](https://shouchen.blog)
- X: [@ShouChen\_](https://x.com/ShouChen_)
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！
[](https://github.com/shouchenicu/fastsend/graphs/contributors)
## 📝 开源协议
本项目基于 MIT 协议开源。
## ⭐ 支持项目
如果这个项目对你有帮助，欢迎给一个 star 支持一下！
---
