診斷與支援資料
在受影響的終端機上打開 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.」。
- 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
「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。
- 如錯誤仍然列出,但狀態已回復正常,請把錯誤時間和目前狀態一併記下,交給支援人員。
修正故障後,之前的記錄不會從列表移除。
啟動及運行時的訊息
「啟動及運行時的訊息」一節| 訊息 | 含義 | 處理方法 |
|---|---|---|
| 「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 需要較新版本的收銀機。本機營業不受影響。 | 與支援人員安排更新。參閱收銀機與雲端的版本兼容和雲端同步和店舖狀態。 |
| 收銀機橫額顯示 Database offline(數據庫離線)、「Sales are kept on this till.」,之後顯示 Syncing … local writes(正在同步本機寫入) | 無法連接共用數據庫,之後收銀機正在送出它保留的工作。 | 讓收銀機繼續運行。參閱數據庫無法使用。 |
| 收銀機橫額顯示 No Integration Host is running(沒有運行中的 Integration Host) | 沒有終端機在擷取網上訂單。 | 參閱網上平台與 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.
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
FMX EPOS 沒有隨 Windows 啟動
「FMX EPOS 沒有隨 Windows 啟動」一節一般來說,無論誰登入這部電腦的 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?」。選擇 Yes。
- 如收銀機顯示「Starting FMX EPOS at sign-in can only be changed with Windows administrator rights.」,即需要 Windows 管理員權限才能更改,請關閉 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 時鐘,無須詢問。
複製支援摘要
「複製支援摘要」一節選擇 Copy Summary(複製摘要),把相同的狀態複製為純文字。頁面會顯示「Summary copied.」。分享前:
- 把它貼到電腦上的文字編輯器。
- 細看其中的終端機和電腦資料、資料夾和數據庫名稱、平台名稱,以及最近的錯誤文字。
- 移除錯誤訊息中出現的任何顧客資料或其他業務資料。
- 只傳送支援人員需要的部分。
Diagnostics 頁面不會顯示數據庫密碼、平台密碼或已儲存的登入權杖。儘管如此,仍請檢查複製的文字,因為資料夾路徑、伺服器名稱和最近的錯誤訊息,對店舖來說都可能屬於敏感資料。
聯絡支援
「聯絡支援」一節每次要求支援時,請附上以下資料:
- 終端機名稱,即 Terminal 卡片或 Local Settings(本機設定)中顯示的名稱。
- Terminal 卡片上的 FMX EPOS 版本。
- 問題發生的日期和時間。
- 確實訊息的截圖或相片。
- 按上述方法檢查過的 Copy Summary 文字。
如 FMX EPOS 無法啟動,也打不開 Diagnostics,請改為傳送啟動訊息。如訊息列出錯誤記錄資料夾,也請傳送該資料夾內問題發生當天的檔案;檔案以 UTC 日期命名,保留 30 天。不要刪除或移動安裝資料夾。
Diagnostics 無法讀取數據庫時
「Diagnostics 無法讀取數據庫時」一節遠端數據庫無法使用期間,Diagnostics 中任何從數據庫讀取的內容都不能更新:打印工作數目維持為 0,Automatic Backup 的時間表顯示 Unknown(未知),而 Terminals 卡片顯示「Terminals are read once the database answers.」。請按照數據庫與斷線應變疑難排解處理,不要因為某個部分缺失或空白,便以為數據庫是空的。
登入管理後台需要數據庫,因此斷線期間只可在已打開管理後台的終端機上查看 Diagnostics。