局域网传文件不想搭服务器？Teahouse 茶话间的使用方法

在公司内网、实验室或隔离办公区里，临时把文件发给同事，常常会遇到两个问题：公共网盘不方便使用，单独搭建一台文件服务器又显得太重。如果只是需要在可信局域网内聊天、传文件和共享资料，可以看看开源项目 Teahouse（茶话间）。

它采用局域网 P2P 的工作方式：设备启动后发现同网段节点，消息和文件在设备之间直接传输，不需要中心服务器参与日常通信。下面按 v0.57.0 的功能整理一遍实际使用路径和适用边界。

一、它解决的是什么问题

Teahouse 面向的是“设备都在同一个内网里”的协作场景，而不是公网社交或云盘同步。

比较典型的使用情况包括：

• 在没有外网的办公室或实验室里传递文档、图片和项目文件。
• 临时建立一个讨论组，同时处理文字消息和附件。
• 把一整个本地文件夹交给同事浏览或下载，而不是逐个发送文件。
• 处理会议截图、设备报错截图时，在本地图片查看器里直接提取文字。

这种场景下，工具的重点不是“功能越多越好”，而是让内网设备之间少一个中转环节。

二、核心功能和工作方式

1. 自动发现局域网设备

同一广播网段的设备启动后，会通过 UDP 广播发现在线节点。正常情况下不需要先注册账号，也不需要手动维护服务器地址，联系人会出现在左侧列表中。

如果两台设备位于不同路由网段，广播可能无法到达。这时可以在“设置 → 网络”中手动添加对端 IP，或者配置 CIDR 网段探测。也就是说，自动发现适合常见的同网段环境，跨网段场景则需要明确指定网络范围。

2. 单聊、群组和附件传输

点击联系人即可开始单聊，也可以新建讨论组。除了文本消息，项目还支持图片、截图粘贴、引用回复和 @成员等常用操作，并提供消息送达确认、离线暂存和上线补发等机制。

传文件时，可以把单个文件、多个文件或完整文件夹直接拖入聊天窗口。文件传输使用 TCP 点对点连接，并支持断点续传和历史记录，比较适合内网中发送较大的资料。

3. 用“文件柜”共享文件夹

如果资料不需要立即推送给某个人，可以打开“文件柜”，发布一个本地文件夹，让其他设备按需查看或下载。共享时可以设置关闭、只读或读写权限，适合临时资料区、测试包和会议文件等场景。

4. 图片查看与离线 OCR

聊天中的图片可以在独立查看器里缩放、旋转和连续浏览。项目还集成了离线 OCR：打开图片后，在原图文字位置拖选即可复制识别结果。

这个功能适合处理会议截图、终端报错和设备面板照片。它的价值在于识别过程在本地完成，不必为了复制几行文字再把图片上传到外部 OCR 网站。

三、第一次使用的操作步骤

第一步：在局域网设备上启动

在需要互传文件的设备上分别启动 Teahouse。首次运行时，如果 Windows 防火墙询问是否允许应用通信，应根据所在网络环境决定是否放行；不允许网络通信时，自动发现和点对点传输都会受到影响。

项目默认使用以下端口：

• UDP 17878：节点发现。
• TCP 17879：消息和文件传输。

如果设备之间无法互相发现，可以先检查防火墙是否放行这些端口，以及两台设备是否处于可互通的局域网中。

第二步：开始单聊或创建群组

等待联系人出现在左侧列表后，点击联系人开始单聊；需要多人协作时，新建讨论组并邀请相应节点。

第三步：发送文件或文件夹

将文件、多个文件或文件夹拖入聊天窗口，确认传输对象后发送。传输中断时，可以利用断点续传继续处理，不需要从头重新发送。

第四步：改用文件柜按需共享

当资料数量较多，或者接收方不需要立刻下载时，打开“文件柜”发布本地文件夹，再根据需要选择关闭、只读或读写权限。共享结束后及时关闭入口，减少不必要的暴露时间。

第五步：处理跨网段连接

如果两台设备不在同一个广播网段，在“设置 → 网络”里添加对端 IP；网络规划明确时，也可以配置 CIDR 网段探测。配置完成后，再回到联系人列表检查节点是否出现。

四、v0.57.0 的版本信息与平台支持

本文按 Teahouse v0.57.0 整理。该版本加入了 English 模式，覆盖主窗口、设置、文件柜、截图、图片查看器、托盘和通知等界面，并可以在“设置 → 通用 → 语言 / Language”中即时切换。

当前发布包覆盖这些常见平台和架构：

Windows 下载时，普通 64 位系统优先选择 x64；需要免安装运行时选择对应的 portable 便携版。Linux 用户根据发行版优先选择 .deb，其他环境可以考虑 AppImage。macOS 下载包面向 Apple Silicon，不要与 Intel 设备混用。

五、使用边界和注意事项

Teahouse 的定位是受控局域网内的点对点工具，以下几点需要提前确认：

1. 它不是面向互联网的在线聊天服务，公网环境或复杂 NAT 网络不属于它的主要使用场景。
2. 局域网 P2P 依赖网络本身的可信度。对陌生网络使用时，应先评估节点可见性、文件共享权限和防火墙策略。
3. 项目文档没有把它表述为带端到端加密承诺的公网通信工具，因此不应把内网直连等同于完整的安全通信方案。
4. macOS 当前提供 Apple Silicon 构建；首次打开未签名构建时，可能需要在系统设置中手动允许。

如果只是希望在同一办公网络内快速传资料，它的工作方式比较贴合需求；如果需要公网访问、统一账号体系或云端多端同步，则应选择相应的服务器或云服务方案。

六、项目来源

项目主页：

https://github.com/skyjt/teahouse

本文对应版本页：

https://github.com/skyjt/teahouse/releases/tag/v0.57.0

下载

百度网盘（提取码：5ovk）：

百度网盘 请输入提取码