桌面接收端
Windows 和 Linux 接收端让柜台整天保持接收,并把每个文件连同发送者记录保存到自己的磁盘上。
开始之前
你需要一台在接收期间保持开机的 Windows 或 Linux 电脑。商家登录和现场模式需要 Business 套餐。个人模式使用你自己手机的配对链接进行配对,无需账户。
步骤
- 从下载页面下载 Windows 安装程序(NSIS)或 Linux 的 AppImage 或 deb,并核对旁边公布的 SHA-256 校验和。目前的构建没有签名,所以请预期操作系统会警告您一次。在 Windows 上,SmartScreen 会显示“Windows 已保护你的电脑”:点击“更多信息”,再点击“仍要运行”。安装程序会请求一次管理员权限,为这台电脑的所有用户安装,并在专用、公用和域网络上为此应用放行防火墙。在 Ubuntu 24.04 上,AppImage 必须用 --no-sandbox 运行才能启动(./WhispShare-Receiver-…AppImage --no-sandbox),因为 Ubuntu 24.04 限制了 Chromium 所需的沙盒;deb 软件包会替您配置好,可以正常启动。
- 选择这台电脑如何接收:商家登录(使用 8 位设备代码,由所有者在浏览器中批准);个人模式(“与我的手机配对”,使用你自己手机的配对链接);或仅现场模式(供此 Wi-Fi 上没有互联网的现场访客使用)。在个人模式下,即使没有打开任何浏览器,这台电脑也会持续接收来自你手机的内容。在手机上打开 WhispShare 并开始配对,然后把配对链接发送到这台电脑(通过电子邮件或发给自己的备忘录)。将其粘贴到“与我的手机配对”页面,然后点按“与我的手机配对”(在有任何配对完成之前,托盘菜单中也有同一项)。发送文件时,手机和电脑都必须在线。这台电脑会作为你手机发起的配对的另一端等待,它不会显示自己的二维码。
- 选择保存文件夹。每个会话都落在各自的文件夹里:<保存文件夹>/<年-月>/<链接标签、房间名称或"Direct">/<日期和时间> <发送方名称或"Visitor"> <会话代码的最后 4 个字符>/,每个文件旁边还有一个随附记录文件(sidecar):<文件>.whispshare.json。随附记录会记下会话、发送方的名称和设备、链接及其标签、发送时和保存时的文件名、大小、类型和 SHA-256,传输结束后还会记下已验证的分段哈希。发送方发来的文本和卡片不在随附记录里:接收端把它们保存在每日日志中(保存文件夹里的 received-<日期>.jsonl)。
- 请让接收端保持运行:它驻留在托盘中,可随电脑启动。托盘菜单会用文字说明接收端正在做什么(正在从手机接收、正在为您的商务接收、已暂停、离线、等待管理员的收件箱密钥、尚未配对),并且始终提供「更改保存文件夹」和「打开保存文件夹」;窗口底部也有相同的两个按钮。接收端跟随电脑的语言(英语、阿拉伯语、德语、西班牙语、法语、希伯来语、意大利语、日语、韩语、荷兰语、波兰语、巴西葡萄牙语、罗马尼亚语、土耳其语或中文),您也可以在托盘菜单或设置中选择其他语言。
- 要收集一个房间的分享,使用“加入房间”:接收端以只接收的身份待在房间里,保存成员分享的内容。
- 若要停止这台电脑接收,请在商务设置中撤销接收端,或在电脑自身的设置中选择「取消此设备的配对」。取消配对时,服务器会使用接收端自己的设备令牌释放其席位,然后从电脑中删除令牌、配对、房间和收件箱密钥。如果无法连接服务器,电脑仍会取消配对,但窗口会提示服务器未确认释放:请让管理员在商务控制台中移除该接收端,否则其席位会继续被计算在内。
密钥保存的位置
接收程序的身份和收件箱密钥使用存放在接收程序状态文件夹中的一个密钥进行加密。桌面应用通过操作系统的安全存储来保护该密钥(Windows 凭据管理器的 DPAPI、macOS 钥匙串,或通过 libsecret 或 KWallet 使用的 Linux 密钥环)。该密钥通过操作系统的密钥存储与这台电脑和这个用户账户绑定,因此从备份、同步客户端或磁盘镜像中取得的状态文件夹副本,不会携带该密钥。About 页面会说明密钥是如何存储的。在没有密钥环的 Linux 电脑上,密钥会保存在受保护的文件中(权限 0600),About 页面会说明这一点;安装 gnome-keyring 或 KWallet 即可对其加以保护。如果登录后密钥环仍处于锁定状态,接收程序会等待大约半分钟。如果之后无法打开密钥(密钥环或账户被重置),它会提供退出或重新开始并重新配对的选项;它从不会悄悄创建新密钥。无界面接收程序(whispshare-receiver)没有操作系统的密钥存储,因此其状态文件夹(<folder>/.whispshare/)本身就是密钥:任何能复制该文件夹的人,都能读取接收程序所读取的内容。请让该文件夹不进入备份、同步客户端和共享驱动器,并且只允许服务账户读取(权限 0700)。要将接收程序迁移到另一台机器,请配对一个新的接收程序。whispshare-receiver --help 也有相同说明。
对方会看到什么
接收端开着时,客户会看到企业显示“正在接收”,用一张请求卡片敲门,只有在某个人或某台值班设备确认之后才实时发送文件。接收端本身绝不会放任何人进入房间,也绝不发出房间授权;它只负责保存,仅此而已。“暂停接收”会同时关闭门铃、房间和个人配对;已在进行的传输会完成,新的传输提议则等到您恢复后再处理。
出了问题怎么办
关着的接收端就是不在接收:链接页面会这样说明,而且只有那一张请求卡片可以等待。在现场模式下,来宾的浏览器会对本地地址显示证书警告;在没有互联网的网络上这个警告是正常的——请如实告诉来宾,并把场地卡片给来宾看,让他们可以核对。如果保存文件夹已满或被移动,请选择新的文件夹,再继续接收;大于可用空间的传输会在开始前被拒绝。如果手机连不上现场地址,请打开现场面板。它会显示 Windows 把这台电脑归入哪个网络,并指出防火墙规则缺失或未覆盖该网络的情况(在 Windows 的提示中勾选“公用网络”,或为所有用户重新安装)。当这台电脑有多个地址(Wi-Fi、VPN、WSL 或 Docker)时,请在那里为二维码选择 Wi-Fi 地址。要报告问题,请依次打开“设置”、“关于”、“复制诊断信息”,并把文本粘贴到您的消息里。其中只有版本、状态和数量:没有文件名、密钥或地址。接收端还会在操作系统的日志文件夹里保存一份同类的、会滚动的小日志。
限制
接收端提高了实时传输的大小上限:个人模式 2 GiB,Away 20 GiB,Business 50 GiB,而浏览器仍是 2 GiB,iPhone 仍是 1 GiB。模板上限仍然约束已确认的会话:文件模板最多 10 个文件、共 50 MB,确认模板 1 个文件、500 MB,除非链接设定了自己的上限。接收端每天检查一次新版本并显示横幅;请从下载页面手动下载并安装。无头接收端(whispshare-receiver)可以把每个收到的文件 POST 到本地 webhook。仅在这台电脑或您的办公网络内使用:该 POST 会写明保存的路径、文件和发送方。设置密钥(--webhook-secret)后,POST 会带有 HMAC 签名,失败的 POST 会重试三次。