诊断和支持信息
在出问题的终端上打开 Back Office → Diagnostics(管理后台 → 诊断)。只有管理员能打开这个页面。页面只读,每 5 秒自动刷新一次,标题下方一行显示最近更新的时间。选择 Refresh(刷新)可立即更新。
Updated 14:05:32 · refreshes every 5 s
Database
- Mode
- Remote
- Pending Writes
- 0
Continuity
- Queueing Writes
- No
Integration Host
- Host Terminal
- Front Till
Clover Bridge
- Bridge Process
- Running
Printing
- Failed Jobs
- 0
Network
- Addresses
- 192.168.1.20 (DHCP)
示意图,不是截图。实际界面可能因主题或版本而有所不同。
- Terminal(终端)显示本终端的名称、Terminal ID、电脑名称和 FMX EPOS 版本。
- Database(数据库)显示正在使用哪个数据库(不含任何密码)、它是 Available(可用)、Unavailable(不可用)还是因维护 Paused(已暂停),最近一次检查的时间,Pending Writes(待上传写入)和 Review Writes(待复核写入)的数量,以及最近的连接消息。
- Continuity(断线恢复)显示这台终端是 Synchronised(已同步)、有 Queued(排队)或 Review(待复核)写入,还是处于 Emergency Mode(应急模式),它是不是指定的应急终端,以及在 Attention 下列出阻碍应急上传的问题。在没有 Emergency Terminal 的远程门店,它会警告 “No emergency terminal is chosen, so during a database outage no terminal can sign staff in, open tables or print kitchen tickets. Choose one in Back Office → Database.”(没有选定应急终端,数据库断开期间没有任何终端可以让员工登录、开桌台或打印厨房单;请在 Back Office → Database 中选择一台)。
- Integration Host 显示由哪台终端拉取在线订单(This Terminal、Another Terminal 或 No Host),以及每个平台连接最近一次轮询的时间、连续失败次数和最近一次错误。
- Clover Bridge 显示 Clover 是否开启、bridge 是否在运行,以及 Flex 的状态。Manual Card Mode(手动刷卡模式)表示这台终端没有开启 Clover。
- Telephony(电话)显示所选的来电显示来源、其设备的状态和 Yealink 监听端口,并在 Last Refused Callback(最近被拒绝的回调)下显示最近一次因地址不在允许范围内而被拒绝的 Yealink 事件的地址和时间。
- Printing(打印)显示全店待打印、失败和结果未知的打印任务数量,本终端的小票打印机,以及它的打印程序是否在运行。
- Automatic Backup(自动备份)显示门店的备份计划和文件夹、最近一次备份及执行备份的终端,以及失败、警告、错过或中断的备份。
- Network(网络)显示这台电脑的地址和它所在的 Windows 网络。Public Network 表示 Windows 把店内网络当作公用网络,其他收银机和手机无法连到这台电脑;请在 Windows 网络设置中把该网络设为 Private network。DHCP Address 表示电脑的地址可能变化;请在路由器中保留地址,或在 Windows 中设置固定地址。
- Terminals(终端)列出当前数据库上登记的所有终端,以及各自的版本、最近联系时间、待上传写入和维护状态。
卡片显示绿色,只说明软件此刻能看到的情况。它无法判断纸是否装好、钱箱线缆正常、顾客能访问在线平台,或者刷卡会不会被批准。
Recent Errors
Section titled “Recent Errors”Recent Errors(最近错误)按从新到旧显示今天和昨天记录下来的警告和错误,最多 50 条,例如数据库断开、网络地址变化后 HTTPS 证书没有重新签发、Clover 故障、未完成的刷卡请求、时钟校正、自动备份失败或启动被中止。显示 “No errors logged.” 表示没有记录。
每条记录以 UTC(协调世界时)日期和时间开头,然后是技术编号,最后是消息。英国夏令时期间,UTC 比收银机时钟慢一小时,所以收银机上 14:05 的错误显示为 13:05。
Recent Errors2
Newest first, today and yesterday
- 2026-10-21T12:58:02+00:00 …Remote database unavailable: Remote database connection failed. Check the server, credentials and network. New records remain local until it reconnects.
- 2026-10-21T02:00:41+00:00 …The automatic backup into D:\Backups failed.
示意图,不是截图。实际界面可能因主题或版本而有所不同。
- 把错误的时间与报告问题的时间对上,注意 UTC 的时差。
- 阅读第一条相关提示,以及上方对应的卡片。
- 解决提示中指出的原因,然后选择 Refresh。
- 如果错误仍在列表中,但状态已经正常,请把出错时间和当前状态一起记下来,告诉技术支持。
故障解决后,之前的记录不会从列表中消失。
启动和运行时消息
Section titled “启动和运行时消息”| 提示 | 含义 | 处理方法 |
|---|---|---|
| “The Windows clock is … behind/ahead of … and FMX EPOS could not correct it.”,然后是 “FMX EPOS will now close.” | 时钟偏差达到 10 秒或以上,而 FMX EPOS 没有以 Windows 管理员权限启动,无法校正。 | 右键单击 FMX EPOS,选择 Run as administrator(以管理员身份运行),或在 Windows Settings → Time & language(设置 → 时间和语言)中校正时钟,然后重新启动 FMX EPOS。参见 Windows 时钟检查。 |
| 收银机横幅 “This PC’s clock is … out and could not be corrected. Close FMX EPOS and start it as a Windows administrator.” | Windows 时钟偏差达到 10 秒或以上,FMX EPOS 无法校正。收银机继续营业。 | 以 Windows 管理员身份启动 FMX EPOS,或校正 Windows 时钟。时钟正确后,横幅会在大约 10 分钟内消失。 |
| 所有 FMX EPOS 窗口上显示 “Restarting EPOS…” | FMX EPOS 或其浏览器引擎意外停止。桌面应用会重新启动它,并让每个窗口回到原来的页面。 | 等待,不要关闭应用。之后先检查当时正在进行的付款或打印,再决定是否重做。 |
| “The local FMX EPOS service keeps stopping … restarts did not keep it running” | 六次重启都没有成功,桌面应用已停止尝试,选择 OK 后会关闭。提示末尾给出错误日志文件夹。 | 检查数据库连接,记下提示内容,并按下方清单联系技术支持。 |
| “FMX EPOS could not start”,并显示 “Another program is using port 5139” | 另一个程序占用了 FMX EPOS 需要的端口。页面会写出这个程序的名称。 | 如果可以关闭那个程序,选择 Close It and Start(关闭并启动)并确认,它未保存的内容会丢失。也可以自己关闭它后选择 Try Again(重试)。Exit 会关闭 FMX EPOS。 |
| 端口页面显示 “It is another copy of FMX EPOS …” | 这台电脑上已经在运行另一个 FMX EPOS 安装。同一时间只能运行一个。 | 关闭另一个 FMX EPOS,然后选择 Try Again。 |
| 端口页面显示 “Windows is using it for a web service, such as IIS.” | 端口被 Windows 服务占用,所以不提供 Close It and Start。 | 请负责维护这台电脑的人停止该服务,或把它移出 5139 端口,然后选择 Try Again。 |
| “The local FMX EPOS service did not answer within 10 minutes and was stopped.” | 启动时间过长,通常是因为连不上数据库。 | 检查数据库服务器和网络,然后重新启动 FMX EPOS。如果再次出现,请联系技术支持。 |
| “FMX EPOS … cannot start the local service … Run FMX EPOS Setup and choose Repair, or copy the complete release folder again, then start FMX EPOS.” | 更新只复制了一部分。 | 运行 FMX EPOS Setup 并选择 Repair(修复),或联系技术支持。 |
| “Microsoft Edge WebView2 Runtime is required.” | 缺少 FMX EPOS 使用的浏览器引擎。它的安装程序随 FMX EPOS 提供。 | 选择 Yes 安装,然后重新启动 FMX EPOS。如果提示说缺少离线安装程序,请重新运行 FMX EPOS 安装程序。 |
| “The local HTTPS root certificate is missing”、“… is incomplete”、“… is invalid or expired” 或 “The HTTPS certificate … is damaged or cannot be opened.” | 这个安装自己的安全证书文件被删除或改动了。 | 不要替换或删除任何文件,请联系技术支持。 |
| “FMX EPOS could not start”,并显示其他原因 | 启动失败。提示会给出原因,必要时还会给出错误日志文件夹。 | 原因明确的话就解决它,否则联系技术支持。 |
| “FMX EPOS is already running for another Windows user on this PC.” | 每台电脑只能运行一个 FMX EPOS,而另一个 Windows 用户已经打开了它。 | 在那个用户的会话中关闭 FMX EPOS,或改用那个会话。 |
| Terminal Identity In Use | 两台电脑在运行同一个复制出来的安装。 | 参见终端身份冲突。 |
| 收银机横幅 New sales are paused,并附原因 | 许可证不允许这台收银机进行新的销售,例如 Licence 页面显示 No Seat、Expired、Clock Behind 或 Virtual Machine。已经开着的订单仍可完成。 | 按提示的原因处理,然后参见许可状态处理。 |
| 登录页警告 “Update this till to EPOS … or later for cloud sync.” 或收银机横幅 Cloud sync stopped | FMX EPOS Cloud 需要更新版本的收银机软件。本地营业不受影响。 | 与技术支持安排更新。参见Till 与 Cloud 版本兼容和 Cloud 同步和门店状态。 |
| 收银机横幅 Database offline、“Sales are kept on this till.”,之后是 Syncing … local writes | 无法连接共享数据库,之后收银机正在发送它保留的工作。 | 让收银机保持运行。参见数据库连不上。 |
| 收银机横幅 No Integration Host is running | 没有终端在拉取在线订单。 | 参见在线平台和 Integration Host。 |
| 收银机横幅 “… polling failing. Check Online Platforms” | 某个平台连接连续三次检查失败。 | 参见某个连接拉不到订单。 |
| 收银机横幅 “Printer …: N jobs need attention” | 本终端的打印任务需要有人处理。 | 参见收银机上出现打印机横幅。 |
| 收银机横幅 Automatic backup failed,并附原因 | 定时备份失败了。到下一个计划时间会再试一次。 | 确认备份文件夹存在且可以写入,然后查看 Automatic Backup 卡片。参见管理数据库存储和维护。 |
| 收银机横幅 Automatic backup missed 或 Automatic backup interrupted,以及 “The backup due … was not made.” 或 “… was interrupted.” | 没有终端执行这次定时备份,通常是因为当时 Integration Host 关机或正忙,或备份中途停止。 | 在备份时间让 Integration Host 保持运行,并查看 Automatic Backup 卡片。 |
| 收银机横幅 Automatic backup warning | 备份已完成,但有其他问题,例如没有删除较旧的备份。 | 阅读原因并检查备份文件夹。 |
备份横幅只显示在 Integration Host 所在的收银机上。
Another program is using port 5139
Example Web Server · process 4120
FMX EPOS needs port 5139 to run. Close that program, or ask whoever maintains this PC to move it to another port, then select Try Again.
示意图,不是截图。实际界面可能因主题或版本而有所不同。
收银机的警告横幅显示在右下角。红色横幅表示会影响营业或钱款的问题:许可证、刷卡机、需要处理的在线订单、打印失败、平台连接失败,以及没有运行 Integration Host。琥珀色横幅是提醒:数据库连接、时钟、备份和云同步。平台关闭了轮询,或外送、自取已关闭或暂停时,不显示横幅,而是在左侧栏的 Platforms 按钮上显示琥珀色数字;Platforms 工作区会显示是哪个平台以及原因。桌台对话框打开时,横幅会隐藏。在付款和退款界面上,横幅会收起成一个带数字的警告三角,点三角就能在该界面上展开。打开功能工作区(Tables、Orders、Customers、Cash & Card、Platforms 或 Insights)时,横幅也会收进三角,以免遮住工作区;点三角可以展开,有新警告时也会自动展开。回到收银界面(包括桌台的点单)后,横幅照常显示。点任意横幅上的收起按钮(一条短横线),所有横幅都会收进三角;点三角可以重新显示。有新警告时,横幅也会自动重新展开,但在付款和退款界面上不会。三角里只要有一条红色警告就显示红色,否则显示琥珀色。三角挡住内容时可以拖动它,它会停靠到最近的屏幕边缘,一直停在那里,直到收银界面重新加载。收起只是把横幅藏起来,不会解决或确认任何问题。
Open Print Jobs
The backup folder is not available.
Online orders are not polled and scheduled courses are not released. Check the host in Online Platforms.
示意图,不是截图。实际界面可能因主题或版本而有所不同。
Windows 启动后 FMX EPOS 没有自动启动
Section titled “Windows 启动后 FMX EPOS 没有自动启动”通常,无论谁登录这台电脑的 Windows,FMX EPOS 都会自动启动。
- 在桌面应用中打开 Back Office → Local Settings → This Terminal(本机设置 → 本终端),找到 Windows 区域。
- 确认 Start at Windows sign-in(登录 Windows 时启动)显示 Enabled。如果不是,选择 Enable。
- Windows 询问 “Start FMX EPOS automatically when anyone signs in to Windows?”(任何人登录 Windows 时都自动启动 FMX EPOS?),选择 Yes。
- 如果收银机提示 “Starting FMX EPOS at sign-in can only be changed with Windows administrator rights.”,请关闭 FMX EPOS,右键单击它,选择 Run as administrator,然后再试一次。
Windows
- Start at Windows sign-inDisabledEnable
- HTTPS certificateTrust Certificate
Starting FMX EPOS at sign-in can only be changed with Windows administrator rights. Right-click FMX EPOS, choose Run as administrator, then try again.
示意图,不是截图。实际界面可能因主题或版本而有所不同。
通过这种方式从 Windows 管理员账户启动时,FMX EPOS 在启动时还能直接校正 Windows 时钟,不会再询问。
复制支持摘要
Section titled “复制支持摘要”选择 Copy Summary(复制摘要),把同样的状态复制为纯文本。页面会显示 “Summary copied.”(摘要已复制)。分享之前:
- 把它粘贴到这台电脑上的文本编辑器中。
- 检查其中的终端和电脑信息、文件夹和数据库名称、平台名称以及最近的错误文本。
- 删掉错误信息中出现的顾客资料或其他业务信息。
- 只发送技术支持需要的部分。
诊断页面不会显示数据库密码、平台密码或保存的登录令牌。但仍要检查复制出的文本,因为文件夹路径、服务器名称和最近的错误信息对你的门店来说可能也是敏感信息。
联系技术支持
Section titled “联系技术支持”每次联系技术支持时,请附上:
- 终端名称,即 Terminal 卡片或本机设置中显示的名称。
- Terminal 卡片上的 FMX EPOS 版本。
- 问题发生的日期和时间。
- 提示原文的截图或照片。
- 按上述方法检查过的 Copy Summary 文本。
如果 FMX EPOS 无法启动,也打不开诊断页,就发送启动时的提示。如果提示中给出了错误日志文件夹,也请发送该文件夹中出问题那天的文件;这些文件按 UTC 日期命名,保留 30 天。不要删除或移动安装文件夹。
Diagnostics 读取不到数据库时
Section titled “Diagnostics 读取不到数据库时”远程数据库不可用时,诊断页中凡是从数据库读取的内容都无法刷新:打印任务数量保持为 0,Automatic Backup 的计划显示 Unknown,Terminals 卡片显示 “Terminals are read once the database answers.”。请按数据库与断线恢复故障排除处理,不要因为某个区域缺失或为空就以为数据库是空的。
Back Office 需要数据库才能登录,所以断线期间只能在已经打开了 Back Office 的终端上查看诊断页。