Cenaly Hardware Bridge — 门店硬件

浏览器本身无法在 POS 打印机上打印收据、打开钱箱或从电子秤读取重量。Cenaly Hardware Bridge 负责解决这一问题——一款小型免费应用，安装在收银电脑上，在后台运行，将管理后台/收银页面与门店本地硬件连接起来。

打开：管理面板 → 硬件（admin.cenaly.com）。

可连接的设备#

设备	用途
收据打印机（POS 打印机）	销售和退货收据、预结账单、X/Z 报表、套餐清单
厨房打印机	按工位的出单和 60×40 贴纸——参见厨房和堂食打印
钱箱	销售时自动打开和手动打开
条码扫描仪	收货、销售、标记
电子秤	收货时商品重量和出餐时菜品重量
顾客显示屏	向顾客显示金额和明细
银行终端	刷卡支付、核对汇总和日结
税控机	按国家要求的税务收据——参见税务合规
EGAIS（俄罗斯）	与通用传输模块交换数据
摄像头	收银危险操作的短视频片段——参见损耗控制

打印队列#

通过网桥打印不是“发出后就听天由命”。网桥有自己的带重试的任务队列，可跨重启保留：如果打印机关闭或纸张用完，任务不会丢失，会在设备恢复后打印。

因此打印有五种不同结果，而非“成功/失败”：已打印、已加入队列（还没有纸！）、已由浏览器打印、税控机正在打印（见下文）和未打印。收银端顶部会显示队列指示器及等待中的任务数量。

任务具有幂等性：重复发送同一文档不会产生第二张纸。

税控机不是备用收据打印机。 如果门店没有单独的收据打印机，网桥不会通过税控机打印我们的收据：税务收据由税控机自行打印，而我们的文档是另一张纸。这种情况下收银端会明确提示：“收据由税控机自行打印”。通过税控机仅允许测试打印和预结账单——且打印时会标注这不是税务文档。

详情、打印机与工位的绑定以及西里尔文和格鲁吉亚文的代码页——厨房和堂食打印。

安装网桥#

如果此电脑上未找到网桥，页面会提示安装：

下载适用于您操作系统的版本 — Windows、Linux (x64) 或 Linux (ARM64)（macOS 在计划中）。校验用 SHA-256 已提供。
运行应用。Windows — 双击：网桥转入后台（托盘图标）并打开状态页面。Linux — 更稳妥的做法是直接用「硬件」页面的一行命令将其安装为后台服务（curl … | sudo … bash）：它会在电脑启动时自启并自动重启。手动运行下载的文件（chmod +x 后运行）也可以，但网桥仅在终端打开时存活，重启后不会恢复；Linux 上的状态页面需自行打开 — http://127.0.0.1:9100。
在状态页面确认网桥已启动。在同一台电脑上打开管理后台，选择所需门店和「硬件」板块：浏览器会自动连接。
返回管理后台并点击**「重新搜索」** — 收银会自动找到此电脑上的网桥并连接。

如果 Windows 在下载/运行时显示警告 — 这是正常的：选择「保存」，运行时选择「更多信息」→「仍要运行」。Linux 有一行命令安装为后台服务。

如何从电脑上移除网桥（Linux）。 使用「硬件」页面上的同一行命令，只是加上子命令 — 页面上它隐藏在「Linux — 停止或删除网桥」下：

… | sudo bash -s -- stop — 停止服务并取消其自启；文件和设置保留，重新启用用 start；
… | sudo bash -s -- uninstall — 移除服务并删除程序本身。设置和收银绑定保留，脚本会打印它们所在位置；
… | sudo bash -s -- uninstall --purge — 同上并删除设置：硬件列表和门店绑定。之后需重新关联收银；
… | sudo bash -s -- status — 网桥是否运行及在哪个地址（如果 9100 被占用，网桥会取下一个空闲端口，最高到 9109）。

在 Windows 上，可用普通的「程序和功能」（条目「Cenaly Bridge」）— 卸载程序也会移除自启。

在不打开管理后台的电脑上安装网桥（储藏室的服务器、打印机旁的独立电脑）无法通过自动搜索绑定 — 自动绑定仅在网桥与收银页面位于同一台电脑时有效。这种情况下，所有者需在管理后台生成一次性绑定码（有效期 15 分钟）并在网桥状态页面输入。

网桥绑定到您的品牌：从他人品牌域名下载的网桥不会为您的管理后台服务；如果网桥已绑定到同一所有者的另一门店，页面会显示此情况并提供一键重新绑定到此处。

三种连接方式#

连接对象	操作
装有网桥的电脑上的浏览器	在「硬件」中打开所需门店。本地配对自动创建。
另一台电脑上的网桥	所有者点击「连接另一台电脑上的网桥」，然后在另一台电脑上于「账户与门店 → 按码连接」中输入代码。代码有效期 15 分钟。
同一网络中的 Android 应用	在网桥页面打开「Wi-Fi 设备」并点击「配对设备」。在应用中输入 PIN；访问终端需核对指纹。PIN 有效期 10 分钟。

「设备」板块中的员工登录码是另一套机制。如果 PIN 或代码已过期，用相应按钮创建新的。

管理与检查#

网桥连接后，页面上可见：

设备 — 含各设备状态的列表（已连接 / 注意 / 错误 / 未找到）；
硬件检查 — 打印、扫描、称重的快速测试；
硬件设置；
活动 — 实时事件流（扫描、称重、打印）；
更新 — 如果网桥有新版本，可直接从此处安装。

添加打印机时选择其用途：小票、厨房或标签。用途显示在设备卡片中。它设定网桥内部的用途；将硬件分配到各个独立工作站是另一层设置。如果读取设置失败，向导会提示重试并保留现有列表。

找到的硬件可以停用或删除。「停用」将设备保留在列表中并保留所有设置，但不加载驱动：COM 端口空闲、不再轮询、用途让给其他设备 — 一键即可重新启用。「删除」（需确认）会永久移除设备，且下次启动网桥时自动识别熟悉硬件不会再将其恢复。之前配置过、但当前搜索未发现的硬件会单独分组显示 — 否则将无法管理。

一个账户可以有多个网桥，每个网桥可设定角色：通用、硬件、摄像头或电话。门店网桥单独列出 — 可重命名并设为默认网桥。

整个账户的硬件与云端工作#

除了“这台电脑”的网桥，页面上还有账户硬件登记表——一张贯穿所有门店的网桥、设备和摄像头的总表：可以看到什么设备装在哪里、网桥是否在线、它为哪些门店服务硬件。如果网桥当时在线，可以把设备移到另一个门店；网桥离线时，登记表只能查看，不能修改。

登记表中每台机器都可以展开**“PC 详情”卡片：计算机名称、IP 和 MAC、系统、型号、处理器、按插槽显示的内存、带可用空间和状态的存储设备、所有已连接的硬件以及所有 COM 端口**——并标注哪个端口被谁占用、哪个空闲。当“打印机本来在，现在却看不到”或收银 PC 空间不足时，这里是第一个该看的地方。数据由网桥自己采集；旧版网桥的硬件列表可能为空——这时只需更新网桥。

除了本地通道（浏览器 ↔ 本机网桥），还有云端通道：命令通过服务器发给网桥，因此可以从另一台设备打印收据或检查打印机——例如服务员用自己的手机打印到吧台的收银打印机。页面上这表现为网桥的“云端绑定”和单独的云端测试打印按钮。

打印到相邻电脑的打印机。 如果打印机物理连接在另一台 PC 上，不必通过网络“共享”它或拉一根线。登记表中的**“从另一台 PC 打印”**操作会在这台机器上创建指向他人打印机的引用：选择所属电脑、门店和名称，之后该行会标注“经云端 → 所属 PC”，打印任务由那台电脑的队列执行。不需要共享文件夹、VPN 或机器之间直接可见——只要两个网桥服务于同一门店即可。

收银远程屏幕。 在同一页面（或通过工作聊天中的邀请）可以查看收银电脑的屏幕——例如亲眼看看收银上显示什么。决定权始终在对方：在其所有者未开启自己的远程访问前，没有连接按钮，且每次会话都需要其单独同意——故意没有“不再询问”。查看和控制是两种不同的权限，关闭窗口会确保结束会话。

常见问题#

需要输入绑定码吗？#

通常不需要：网桥运行在打开收银的同一台 PC 上，收银会通过“重新搜索”按钮自己找到它。只有网桥装在不开管理后台的电脑上时才需要绑定码——这时所有者生成一次性绑定码，并在网桥页面输入。

网桥支持哪些操作系统？#

Windows 和 Linux（x64 和 ARM64）。macOS 版本在计划中。

看不到硬件——该检查什么？#

确认网桥已启动（状态页面），然后点击“重新搜索”。每个设备的状态和快速检查都在“硬件”页面。如果设备没有出现，请在硬件登记表中打开这台机器的**“PC 详情”**卡片：那里能看到电脑本身识别到的所有硬件，以及所有 COM 端口及其占用者标注——通常足以判断问题出在线缆、端口，还是某个占用端口的其他程序。