百灵快传 B0Pass 使用手册：手机电脑互传的局域网文件传输工具

百灵快传 B0Pass 使用手册：手机电脑互传的局域网文件传输工具

【免费下载链接】b0pass百灵快传(B0Pass)：基于Go语言的高性能 "手机电脑超大文件传输神器"、"局域网共享文件服务器"。LAN large file transfer tool。项目地址: https://gitcode.com/gh_mirrors/b0/b0pass

百灵快传（B0Pass）是一款 Go 语言编写的单文件工具，把一台电脑变成纯 HTTP 的局域网文件传输服务。把几个 G 的文件丢进共享目录，手机扫个码就能下。不需要安装客户端、不需要注册账号，浏览器就是全部界面。

它和常规方案差在哪

差异的本质有两点：整个服务就是一个 HTTP 网页，任何带浏览器的设备都是合格客户端；整个工具就是一个可执行文件，没有服务端部署这回事。

30 秒跑起来

1. 下载与你系统对应的压缩包（Windows、Linux、macOS 均有），解压到桌面或 D 盘等普通目录。
2. 双击可执行文件，程序会自动创建默认config.ini，并拉起浏览器。
3. 看一眼控制台窗口，确认端口和访问地址：

-------------------------------------------- 百灵快传主电脑端 B0Pass 端口配置为：:8888 主电脑参数：192.168.1.100:8888 访问主电脑： http://192.168.1.100:8888 需特别注意：本机【防火墙】设为：允许访问 --------------------------------------------

:8888是监听端口，192.168.1.100是本机在局域网里的 IP，两者拼成访问地址；若弹出防火墙提示，选"允许访问"。

4. 打开页面后点顶部"扫码"按钮，手机连接同一个 WiFi 扫码，免安装文件传输即刻生效。

用三个场景把核心能力讲透

场景 A：3GB 屏摄文件，同事手机直接拿走。把录好的 3GB 视频复制进共享根目录，把扫码地址或二维码发给同事，对方手机打开后直接下载。这里有个技术点：上传走的是流式分片处理，apps/pass/lib/stream/upload.go 里的ReadToBoundary用 4KB 缓冲边读边写，不把整个文件读进内存，所以多文件、大文件同传也不会卡死或崩溃。

场景 B：虚拟机日志回宿主机，免配 SSH。开发环境里虚拟机跑了一晚上任务，日志想拿到宿主机的电脑上看。以前要配 SSH 或共享盘，现在把日志拖进浏览器的共享目录即可，宿主机直接打开下载。纯 HTTP 协议意味着跨平台是免费的：虚拟机传给物理机、Windows 传给 macOS，都不需要任何额外客户端。

场景 C：家庭媒体目录，边下边看。把电影目录设为共享根目录，电视或手机的浏览器打开地址就能在线播放。文件列表接口会自动识别图片、视频、HTML、PDF 等类型并给出对应预览（见 apps/pass/lib/files/file_list.go 的GetDirTree），媒体目录因此可以直接当轻量媒体库用。

配置只读写权限

config.ini里只有三行跟权限有关：

[pass] CodeReadOnly = "123" CodeReadWrite = "admin"

只读密码给访问者，只能浏览和下载；读写密码自己留，才能上传、删除、重命名。登录时密码校验通过后签发 JWT 令牌，令牌里带有 ro / rw 等级，后续每个请求都按它放行，中间件实现在 apps/pass/app.go。两个密码都留空则是全开放，适合临时用。

五个"其实很简单"的排查项

• 手机扫码连不上：多半是路由器开了 AP 隔离，同网段设备互相看不见。进路由器后台把"AP 隔离 / 访客隔离"关掉即可。
• 主电脑传大文件明显变慢：流式上传会占满上行带宽，其他网页操作自然被挤占。主电脑插网线，无线留给手机端。
• 启动报权限错误：可执行文件放进了系统受保护目录。挪到桌面或 D 盘等普通目录，无需管理员权限。
• 改了 config.ini 没生效：配置只在启动时读取一次。保存后重启服务才会应用。
• 跑源码依赖报错：先确认 Go 版本不低于 1.23，然后：

git clone https://gitcode.com/gh_mirrors/b0/b0pass cd b0pass go mod tidy

把桌面那个几 G 的安装镜像拖进共享目录，让同事扫一次码，三分钟收工。

【免费下载链接】b0pass百灵快传(B0Pass)：基于Go语言的高性能 "手机电脑超大文件传输神器"、"局域网共享文件服务器"。LAN large file transfer tool。项目地址: https://gitcode.com/gh_mirrors/b0/b0pass