v1.0.3 · 本地优先 · 零账号

一台机器运行,
全网设备秒互传

LanBeam 是一个本地优先的局域网文件传输与实时共享工具。在同一网络下启动它,任何设备用浏览器就能上传、下载文件,实时共享文字与图片 —— 无需账号,也不经过任何云端。

npm i -g lanbeam

然后执行 lanbeam 即可启动服务。

— lanbeam — 80×24
npm i -g lanbeam
added 15 packages in 4.2s
lanbeam
🚀 文件传输服务器已启动
📁 文件存储目录: /Users/you/lanbeam-files
📏 文件大小限制: 200MB
 
🌐 访问地址:
本地访问: http://localhost:3001
本地访问: http://127.0.0.1:3001
 
🔗 局域网访问:
💡 其他设备可以通过上述局域网地址访问文件传输服务
 
▸

Features

能做什么

一个运行在你的电脑上的轻量服务,覆盖局域网内最常见的共享需求。

拖拽即传

把文件或整个文件夹拖进浏览器即可上传,自动保留目录结构。每台设备都能随时下载或删除。

实时共享

一条共享笔记,在打开的所有设备间实时同步。粘贴一张图片,立即可见 —— 适合互发截图。

零门槛使用

对方不需要安装任何东西 —— 把地址发过去,任何浏览器打开即用,手机电脑都行。

本地优先

文件只存在运行 LanBeam 的那台机器上。无需账号、无需云盘,流量不出局域网。

大文件无压力

默认支持单文件最大 200MB,可用 --max-size 调整。局域网内传输走满带宽。

隐私安全

共享的笔记与图片只保存在内存中,服务器停止即清空。不上传任何数据,也无任何遥测。

Quick Start

三步上手

从安装到第一台设备连接,全程不超过一分钟。

安装 macOS / Linux

macOS 与 Linux 可用一键脚本安装独立程序,无需 Node.js;Windows 使用 winget 或直接下载可执行文件。

curl -fsSL https://lanbeam.k1nz.top/install.sh | bash
Windows
winget install k1nz.LanBeam

启动 任意系统

在终端运行 lanbeam,服务自动从 3001 端口开始,被占用时自动递增寻找可用端口。

lanbeam

连接 任何设备

把终端打印的局域网地址发给同一网络下的任何设备,用浏览器打开即可上传、下载与共享。对方无需安装任何软件。

http://192.168.1.24:3001

Install

想怎么装都行

LanBeam 以 npm 包发布,同时提供 macOS、Linux、Windows 的独立可执行文件与 winget 安装渠道。选择你习惯的那一种。

  • npm 全局安装(需 Node.js 18+):npm i -g lanbeam
  • curl 一键脚本(macOS / Linux,无需 Node.js):curl -fsSL https://lanbeam.k1nz.top/install.sh
  • Windows(winget 或 GitHub Releases):winget install k1nz.LanBeam暂不可用
  • 从源码运行(适合二次开发):git clone && pnpm install && pnpm dev
— lanbeam --help —
lanbeam --help
用法: lanbeam [options]
 
--port <端口> 指定端口 (默认 3001)
--max-size <MB> 单文件大小限制 (默认 200)
--help 显示帮助
 
# 使用指定端口
lanbeam --port 8080
# 限制单文件 500MB
lanbeam --max-size 500
# 端口被占用时自动递增 (3001 → 3020)
lanbeam # 3001 被占用 → 自动切换到 3002

Privacy

数据完全留在你的局域网里

LanBeam 没有服务器端,也不收集任何数据。上传的文件只保存在运行它的那台机器上;共享的文字与图片仅存在于内存中,进程一停就清空。

同一网络下的设备才能访问 —— 局域网之外无法触达,无需账号,也没有云端中转。

  • 无账号、无云端——没有任何服务在中间记录你的活动
  • 文件只在本机——上传的内容存在 lanbeam-files/ 目录,删掉即彻底移除
  • 文字图片仅在内存——服务器停止即清空,不落盘、不持久化
  • 局域网边界——仅绑定局域网地址,外部网络无法访问
  • 开源 MIT 协议——全部代码公开,可自行审计

FAQ

常见问题

不需要。把终端打印的局域网地址发给对方,任何浏览器(手机、平板、电脑)打开即可上传和下载文件。LanBeam 是浏览器即客户端。
不能,LanBeam 定位就是局域网工具。设备需要连接到同一个网络(同一 WiFi 或有线网络)。这保证了任何数据不出局域网,也不经过云端。
默认每个文件最大 200MB。可以用 lanbeam --max-size 500 调整为 500MB,也可以通过环境变量 MAX_FILE_SIZE 设置。
默认从 3001 端口启动;如果被占用,会自动递增尝试(3001 → 3020)直到找到可用端口,并在终端打印实际使用的地址。也可以手动指定 lanbeam --port 8080。
存放在运行 LanBeam 的目录下的 lanbeam-files/(源码运行时是 server/uploads/)。文件直接落盘为普通文件,随时可以在系统里访问、备份或删除。
不会。它们只保存在服务器内存中(图片最多保留最近 20 张、每张最大 10MB),服务器停止即全部清空,不会写入磁盘。
完全不需要。LanBeam 免费、开源(MIT 协议)、无任何账号体系。安装即用,文件与数据全部留在自己的设备上。

文件传输,本不该这么麻烦

安装一次,随时启动。没有账号、没有上传云盘、没有第三方 —— 局域网内最快的传文件方式。