Repolode
提交项目
polius

polius/FileSync

一款可自托管的网页应用，通过 WebRTC 点对点实时将文件从一台设备发送给多台设备，不限文件大小。

在 GitHub 查看官网
Star
1,892
Fork
188
未关闭 Issue
1
最近提交
前天

这是什么？

FileSync 可以让一台设备同时把文件分享给多个接收方。发送方创建房间后分享链接或二维码，接收方在浏览器中打开即可，无需安装应用或注册账号，房间还可以设置密码。

文件通过加密的 WebRTC 在浏览器之间直接传输，服务器只负责辅助建立连接；在无法直连时会自动切换到 TURN 中继。接收的文件边收边写入磁盘，内存占用基本保持稳定，传输中断后也会自动重连并续传。

项目以单个 Docker 镜像发布。使用域名并通过 Caddy 配置 HTTPS 后，浏览器可以启用流式保存方式；纯 HTTP 适合本地测试，但会将整个文件缓存在内存中。

核心功能

  • 01文件通过加密的 WebRTC 在浏览器之间直接传输。
  • 02接收的文件边写入磁盘，大文件不会占满内存。
  • 03传输中断后自动重连并续传。
  • 04通过共享的房间链接或二维码，一次发送给多台设备。
  • 05直连受阻时自动切换到 TURN 中继。
  • 06接收方无需安装或注册，房间可设置密码。

适用场景

  • 在不经过第三方云盘的情况下，把大文件发送给一组同事或客户。
  • 通过自托管实例在局域网内或跨网络分享文件。
  • 借助浏览器在自己的手机和电脑之间传输文件。

快速上手

  1. 1

    从仓库下载 deploy/docker-compose.yml

  2. 2

    使用 Docker Compose 启动 FileSync

    docker compose up -d
  3. 3

    在运行 Docker 的机器上打开 http://localhost

使用前须知

  • HTTP 方案仅用于快速本地测试，不适合生产环境。
  • 在纯 HTTP 下，接收的文件会完整缓存在内存中，因此大文件传输并不安全。
  • 生产环境需要使用自有域名并配置 Caddy 的 HTTPS。
  • 需要在防火墙中开放 80/443、3478 端口以及 UDP 50000–50100 端口范围。

收录于专题

自托管网盘与文件共享自托管应用

标签

#file-sharing#webrtc#peer-to-peer#self-hosted#docker#fastapi#fileshare#javascript

常见问题

FileSync 是什么？
一款可自托管的网页应用，通过 WebRTC 点对点实时将文件从一台设备发送给多台设备，不限文件大小。 FileSync 可以让一台设备同时把文件分享给多个接收方。发送方创建房间后分享链接或二维码，接收方在浏览器中打开即可，无需安装应用或注册账号，房间还可以设置密码。
FileSync 可以免费使用吗？用的什么许可证？
FileSync 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
FileSync 还在维护吗？
活跃维护中。FileSync 最近一次提交是在 2026年11月5日。
FileSync 适合用来做什么？
在不经过第三方云盘的情况下，把大文件发送给一组同事或客户。 通过自托管实例在局域网内或跨网络分享文件。 借助浏览器在自己的手机和电脑之间传输文件。
FileSync 怎么安装和运行？
从仓库下载 deploy/docker-compose.yml 使用 Docker Compose 启动 FileSync: docker compose up -d 在运行 Docker 的机器上打开 http://localhost
在哪里获取 FileSync？
源代码和安装说明在 GitHub 上：https://github.com/polius/FileSync

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目