跳转到内容
FMX EPOS
下载
知识库首页

安全和网络访问故障排除

FMX EPOS 通过 HTTPS 在 5139 端口上运行。收银电脑上的桌面应用在本机连接它。其他浏览器或设备都必须通过终端的网页访问设置、可选的允许 IP 地址列表以及正常的登录规则。只有管理员能修改这些设置,而且只能在设备所连接的那台收银机的桌面应用中修改。

页面会显示以下提示之一:

  • “… access is disabled on this till. Open the desktop app and enable it in Local Settings → Security.” 提示开头会写明被拦截的区域:Back office web、Till web、Kitchen screen web、Host stand web、App 或 Remote。
  • PIN 页面显示 “Till Web, Kitchen Screen Web and Host Stand Web access are disabled on this till. Open the desktop app and enable one in Local Settings → Security.”。三项中任意一项都能打开它;请勾选你正在设置的设备所需的那一项。
  • “This device’s IP address is not allowed. Ask the till administrator to add it in Local Settings → Security.”
  • “The IP allowlist on this till cannot be read. Open the desktop app and correct it in Local Settings → Security.”
  • “This computer is a kitchen-only terminal and takes no phone orders. Connect the phone to a till.”
  • “This computer is a host-stand-only terminal: it takes no orders. Use a till.” 如果有人在那台电脑的桌面应用中打开收银界面,也会出现这条提示。
  • “Open the desktop app on the till computer to access these settings.”,因为首次设置只能在桌面应用中完成。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

在主机终端上,用 FMX EPOS 桌面应用打开 Back Office → Local Settings → Security(管理后台 → 本机设置 → 安全)。在浏览器中这个页面是只读的,并显示 “Open the desktop app on this computer to change these settings.”。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

  1. 在 Remote Access(远程访问)下,勾选被拦截区域对应的复选框:
    • Back Office Web Pages:在浏览器中使用 Back Office。
    • Till Web — PC, Mobile & Customer Display:收银、浏览器手机点单和 /display。
    • Kitchen Screen Web:/kitchen 及其登录。
    • Host Stand Web — PCs & Tablets:/host 及其登录。
    • Mobile App:Android 应用。
  2. 在 IP Allow List(IP 允许列表)下,如果勾选了 Only Allow Listed IP Addresses(仅允许列表中的 IP 地址),在 Allowed IP Addresses(允许的 IP 地址)中添加设备的确切 IPv4 或 IPv6 地址。每个地址单独一行。
  3. 选择 Save Security Settings(保存安全设置)。页面会显示 “Security settings saved.”(安全设置已保存)。
  4. 在另一台设备上重新加载页面。

列表不接受主机名、端口、地址范围或子网。填错时无法保存,并提示 “Invalid IP address: … Enter one IPv4 or IPv6 address per line, without a port or subnet.”。列表为空时不能保存 Only Allow Listed IP Addresses(提示 “Enter at least one IP address before you turn on Only Allow Listed IP Addresses.”)。请填写直接连接收银机的那台设备的地址。

如果保存的列表无法读取,页面会显示 “The saved list cannot be read:” 及原因。这时只要勾选着 Only Allow Listed IP Addresses,在你改正之前,所有远程设备都会被拒绝。

开启网页访问并不会跳过登录、角色、许可证或业务权限。用配对码添加新收银机时,不受这些设置限制。

  1. 在主机上确认 FMX EPOS 正在运行,并且桌面应用能打开收银界面。
  2. 在另一台设备上访问 https://<terminal-address>:5139。
  3. 确认两台设备在正确的网络上,并且主机的地址没有变。
  4. 在主机上打开 Back Office → Diagnostics,查看 Network 卡片。如果显示 Public Network,Windows 会阻止该网络上的其他设备:在 Windows 网络设置中打开店内网络的属性,把它设为 Private network。
  5. 在主机的防火墙中允许来自店内网络的 TCP 5139 入站连接(以及 UDP 5140,其他收银机用它查找这台收银机)。FMX EPOS 安装程序在每次安装、升级和修复时都会添加这些规则,只针对专用网络和域网络,并且只允许同一局域网内的设备。如果规则缺失,请再次运行安装程序并选择 Repair(修复)。位于网络其他部分的设备,可能需要电脑的维护人员在 Windows Defender 防火墙中添加规则。
  6. 确认 Remote Access 设置和允许的 IP 地址都放行了这台设备。

用固定地址或 DHCP 保留地址让主机的地址保持不变;地址可能变化时,Network 卡片会显示 DHCP Address。Kitchen-Only Terminal(仅厨房终端)会有意拒绝手机点单和手机应用的连接,即使对应的设置已经打开。Host-Stand-Only Terminal(仅迎宾台终端)还会拒绝收银界面本身。

每次安装都有自己的本地证书颁发机构。桌面应用已经信任本安装的证书。其他浏览器或设备都要先设置为信任这个安装的根证书。

  1. 打开终端的 HTTPS Certificate(HTTPS 证书)页面:https://<terminal-address>:5139/certificates。至少要开启一项 Remote Access 设置,允许的 IP 地址规则同样适用。
  2. 确认你打开的是自己门店收银机地址上的页面。页面显示证书名称、序列号和有效日期。
  3. 选择 Download Certificate(下载证书)。下载并不会安装或信任证书。
  4. 在页面上打开 iPhone / iPad、Android 或 Windows,按其中的步骤安装并信任证书。在另一台 Windows 电脑上(例如厨房屏幕或打开 Back Office 的浏览器):打开下载的 FMX-EPOS-Root-CA.cer,选择 Install Certificate(安装证书),选择 Current User(当前用户),然后选择 Place all certificates in the following store(将所有的证书都放入下列存储)、Browse(浏览)和 Trusted Root Certification Authorities(受信任的根证书颁发机构)。选择 Next、Finish,并在安全警告中选择 Yes。
  5. 关闭所有浏览器窗口,然后再次访问同一个终端地址。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

只分发这个页面上提供的证书。在收银机电脑本身上,请改用桌面应用,见下文。

FMX EPOS 安装程序会为这台电脑上的每个 Windows 用户信任收银机的证书,所以收银机电脑上的浏览器打开 FMX EPOS 时通常不会出现警告。如果安装程序没能完成这一步,最后一页会说明,桌面应用启动时也会询问。

证书尚未受信任时(例如不是用安装程序安装的 FMX EPOS 副本),桌面应用每次启动都会请 Windows 为当前登录的 Windows 用户信任它。Windows 会显示一次 Security Warning(安全警告),询问来自本店 FMX EPOS 根证书的证书。选择 Yes(是)。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

如果选择 No,FMX EPOS 会继续运行,不再提示,这台电脑上的浏览器可能会显示证书警告。要在其他时间再次被询问,在桌面应用中打开 Back Office → Local Settings → This Terminal(本机设置 → 本终端),在 Windows 区域选择 Trust Certificate(信任证书)。之后会显示 “Windows trusts this till’s certificate.”(Windows 已信任这台收银机的证书。)或 “Windows does not trust this till’s certificate: the Security Warning was answered No, or did not complete.”(Windows 不信任这台收银机的证书:安全警告被回答为 No,或没有完成。)如果 Windows 完全无法添加证书,FMX EPOS 会显示 Certificate Setup Failed。无论哪种情况,收银机都照常工作。

如果警告说地址不匹配,请确认你使用的是终端当前的 IP 地址或它的 Windows 计算机名。证书只涵盖这两者,不包括电脑的其他名称。电脑的网络地址变化后,FMX EPOS 会自动签发新的服务器证书,不需要重启。如果警告仍在,在 Back Office → Diagnostics(诊断)的 Recent Errors(最近错误)中查找 “The HTTPS server certificate could not be reissued for this PC’s new network address.”,然后重启 FMX EPOS。

  • 设备可能通过 DHCP 拿到了新地址,而新地址不在 Allowed IP Addresses 中。
  • 管理员可能关闭了某项 Remote Access 设置。修改会立即生效。
  • 终端自己的网络地址可能变了。
  • 某个用户可能被停用、换了角色,或改了 PIN 或密码。
  • 自动锁定可能结束了会话。

查看主机上的 Diagnostics 和 Local Settings → Security。用户方面的修改记录在 Reports → Audit Log(报表 → 审计日志)中;Local Settings → Security 的修改不会记录。Yealink 回调请参见来电显示和拨号,因为那个监听服务有自己的 Allowed Callback IPs 列表和端口。