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

安装 FMX EPOS

64 位 Windows 版 FMX EPOS 以安装程序 FMX-EPOS-Setup-<version>-x64.exe 提供:一个文件就包含 FMX EPOS 所需的一切。32 位 Windows 请向 FMX EPOS 索取便携式安装包(x86)。

请确认:

  • 电脑运行受支持的 Windows 版本,并且时间准确。
  • 下载的文件正确:64 位 Windows(大多数电脑)用安装程序;只有 32 位 Windows 才用 x86 便携式安装包。
  • 你能以管理员身份登录 Windows,或手头有管理员的用户名和密码。安装程序需要管理员权限。
  • 如果这台收银机要使用 SQL Server 或 MySQL,已向该服务器的管理人员要到服务器地址、数据库名和登录信息。

FMX EPOS 会把本机设置和证书保存在安装文件夹中。使用本地存储时,或首次设置在这台电脑上安装了 MySQL 时,餐厅数据库也保存在这里。运行 FMX EPOS 的 Windows 账户必须能写入该文件夹。安装程序不会安装到 Windows 或 Program Files 文件夹中。

请保护好这个文件夹:

  • 只应允许运行 FMX EPOS 的 Windows 账户修改它。FMX EPOS 可能以管理员权限运行,而直接建在 C:\ 下的文件夹(例如安装程序建议的 C:\FMXEPOS)默认允许这台电脑上的所有 Windows 用户修改。如果还有其他人登录这台电脑,请电脑的维护人员限制该文件夹的权限。
  • 文件夹中存有餐厅的安全证书,还可能存有餐厅的数据。请像对待数据库备份一样,妥善保管该文件夹及其备份。
  1. 运行 FMX-EPOS-Setup-<version>-x64.exe。Windows 询问是否允许此应用对设备进行更改时,选择 Yes(是)。

  2. 在 Install FMX EPOS 页面勾选 I agree to the Terms and Conditions and the Privacy Policy(我同意条款和隐私政策),然后选择 Next(下一步)。勾选之前 Next 不可用。如果这台电脑已装有 FMX EPOS,安装程序会改为打开 FMX EPOS is on this PC 页面,见下文“升级、修复或卸载”。

  3. 在 Choose where to install 页面,保留建议的 Installation Folder(安装文件夹),或选择 Browse…(浏览)另选。文件夹必须位于这台电脑上、在 Windows 和 Program Files 文件夹之外,且所在磁盘有足够的可用空间。所需空间和可用空间显示在文件夹下方。

    • 如果选择的是磁盘根目录,或已有其他文件的文件夹,FMX EPOS 会装在其中的 FMXEPOS 文件夹里。文件夹下方的提示会显示具体位置。
    • 如果文件夹中装过 FMX EPOS,或保留着卸载时留下的数据,会按原样使用,其中的数据也会保留。

    选择 Install(安装)。

  4. 等待安装程序复制文件、在电脑没有 Microsoft Edge WebView2 Runtime 时安装它、把 FMX EPOS 加入 Windows 的已安装应用,并为这台电脑的所有用户在开始菜单中添加快捷方式。其中的 Windows Firewall, Clover and HTTPS(Windows 防火墙、Clover 和 HTTPS)步骤会让其他设备通过 Windows 防火墙连接 FMX EPOS(5139 和 5140 端口,只在专用网络和域网络上,并且只允许本地网络中的设备),为 Clover 刷卡机准备好 Windows,并让这台电脑信任收银机的 HTTPS 证书。某一步失败时,安装程序会把该步标记为 Failed(失败)并显示原因。选择 Close,解决问题后重新运行安装程序。如果 Windows Firewall, Clover and HTTPS 步骤显示 Not finished(未完成),安装仍会完成,完成页会说明哪些没有做以及该怎么办;对于 Clover,它会给出一条命令,以管理员身份在 PowerShell 中运行一次即可。

  5. 在 FMX EPOS is installed 页面,选择 FMX EPOS 在这台电脑上的启动方式。三项默认都已勾选:

    • Add a shortcut to the desktop(在桌面添加快捷方式)
    • Start FMX EPOS when anyone signs in to Windows(任何人登录 Windows 时启动 FMX EPOS)
    • Start FMX EPOS now to set up the shop(立即启动 FMX EPOS 设置门店)

    桌面快捷方式和登录时启动,对这台电脑上的所有 Windows 账户生效。如果运行安装程序时 Windows 要求输入另一位管理员的用户名和密码,最后一项不会显示,因为这时 FMX EPOS 会以该管理员的身份运行:请改从快捷方式启动。

    如果这台电脑没有 .NET Framework 4.8.1,页面还会显示 Optional Clover support(可选的 Clover 支持)。Clover 刷卡机需要它。如果这台收银机要使用 Clover,选择 Install .NET Framework 4.8.1(安装 .NET Framework 4.8.1),然后等待结果;安装程序自带 Microsoft 的离线安装包,不需要联网。如果提示 “Restart Windows before using Clover”(使用 Clover 前请重启 Windows),可以先完成安装,稍后再重启。不使用 Clover 就跳过。安装失败或跳过都不影响 FMX EPOS 本身。

  6. 选择 Finish(完成)。勾选了最后一项时,FMX EPOS 会立即启动。页面上还有快速上手指南的链接。

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

Start FMX EPOS when anyone signs in to Windows 会在任何人登录时,以该 Windows 账户所拥有的最高权限启动 FMX EPOS。如果是管理员账户,FMX EPOS 因此无需询问就能校正 Windows 时钟(见 Windows 时钟检查)。一台电脑同一时间只运行一台收银机:FMX EPOS 已为某个 Windows 用户运行时,以另一个用户登录不会再启动第二个。

以后可以在这台电脑的桌面程序中,打开 Back Office → Local Settings → This Terminal,在 Windows 卡片中更改这些选择。每个按钮都会先请你用 Yes 或 No 确认。

  • Desktop shortcut(桌面快捷方式):Create(创建,或 Update 更新)和 Remove(删除)。在这里创建的快捷方式只属于你当前使用的 Windows 账户。安装程序为所有 Windows 用户添加的桌面快捷方式只能以管理员权限删除:如果 FMX EPOS 显示 “This shortcut is for every Windows user. Start FMX EPOS as an administrator to remove it.”(此快捷方式属于所有 Windows 用户,请以管理员身份启动 FMX EPOS 后再删除),请右键单击 FMX EPOS,选择 Run as administrator,然后重试。
  • Taskbar shortcut(任务栏快捷方式):Set Up 会在文件资源管理器中打开 FMX EPOS 文件夹并选中程序文件。右键单击它,选择 Pin to taskbar(固定到任务栏)。
  • Start at Windows sign-in(登录 Windows 时启动):Enable(启用)或 Disable(停用)。更改此项需要 Windows 管理员权限:如果 FMX EPOS 拒绝更改,请右键单击 FMX EPOS,选择 Run as administrator(以管理员身份运行),然后重试。
  • HTTPS certificate(HTTPS 证书):Trust Certificate(信任证书),见安装门店证书。

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

这台电脑已装有 FMX EPOS 时,安装程序会打开 FMX EPOS is on this PC 页面,并沿用原来的安装文件夹。请先关闭 FMX EPOS,再勾选 I agree to the Terms and Conditions and the Privacy Policy。FMX EPOS 仍在运行(提示 “FMX EPOS is running on this PC. Close it, then try again.”),或磁盘可用空间不足时,安装程序不会继续。安装程序会在改动任何内容之前检查这两项。

  • 安装程序比已装版本新时,显示 Upgrade(升级)。
  • 版本相同时,显示 Repair(修复),重新替换程序文件。
  • Uninstall(卸载)按下文“卸载 FMX EPOS”所述移除 FMX EPOS。

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

升级和修复只替换 FMX EPOS 自身的程序文件,并重新执行 Windows Firewall, Clover and HTTPS 步骤。它们会保留这台电脑的设置、证书、许可证和日志、安装文件夹中的其他文件,以及本地存储模式下的餐厅数据库文件。完成页会预先填入这台电脑当前的快捷方式和登录启动选择,最后一项显示为 Start FMX EPOS now(立即启动 FMX EPOS)。缺少 .NET Framework 4.8.1 时,完成页同样会提供 Optional Clover support。如果升级因错误中断,再次运行安装程序即可完成。

安装程序的升级提示会说明:如果新版本改变了数据库结构,收银机就无法使用现有的数据库,会要求选择一个新的或空的数据库。没有办法升级那个数据库:

  • FMX EPOS 下次启动时会在 Database 阶段打开首次设置,并提示数据库结构与此版本不符。再次选择同一个数据库会被拒绝,提示相同。
  • 要继续使用,请选择一个新的空数据库。旧数据不会转入,旧版本导出的数据也无法导入新版本。

升级前,请备份餐厅数据,并向 FMX EPOS 技术支持确认新版本是否会改变数据库结构。

如果安装程序比已装版本旧,安装不会继续:请使用该版本或更新版本的安装程序。

  1. 把完整的 x86 安装包复制到电脑上。
  2. 把整个压缩包解压到最终使用的文件夹。不要在压缩包内直接运行 FMX EPOS,并保持所有文件放在一起:单独的主程序文件无法运行。
  3. 如果缺少 Microsoft Edge WebView2 Runtime,运行安装包 prerequisites 文件夹中的安装程序。如果这台收银机要使用 Clover 刷卡机,而 Windows 没有 .NET Framework 4.8.1,也从同一文件夹运行它的安装程序。
  4. 打开该文件夹,运行 FMXEPOS.exe。

便携式安装包不会添加快捷方式,也不会在登录时启动。完成设置后,可在 Back Office → Local Settings → This Terminal 的 Windows 卡片中添加。

  1. 启动 FMX EPOS:可以从安装程序的最后一页、快捷方式,或安装文件夹中的 FMXEPOS.exe 启动。正常启动 FMX EPOS 时,Windows 不会请求权限。
  2. 等待 FMX EPOS 检查 Windows 时钟并启动。第一次启动耗时会长一些。
  3. 如果 Windows 显示关于 FMX EPOS 证书的 Security Warning(安全警告),选择 Yes(见安装门店证书)。正常安装后不会出现这个警告。
  4. 完成首次设置。

桌面程序会全屏打开收银界面,同时打开已配置的顾客显示屏和厨房屏幕。如果收银窗口中的页面像是卡住了,按 Ctrl+R 重新加载。要关闭 FMX EPOS,在收银登录页面选择 Exit(退出),或按 Ctrl+Shift+Q,然后确认。

每台电脑只运行一个 FMX EPOS。在同一个 Windows 账户中再次启动,不会打开第二个。如果这台电脑上另一个 Windows 用户已在运行 FMX EPOS,会显示 “FMX EPOS is already running for another Windows user on this PC.”(FMX EPOS 已在这台电脑的另一个 Windows 用户下运行)并关闭:请先在该用户的会话中关闭 FMX EPOS。

每次安装都会生成一份专属的安全证书,供本机的安全(HTTPS)连接使用。安装程序会为每个 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 完全无法添加证书,FMX EPOS 会显示 Certificate Setup Failed(证书设置失败),并继续工作。参见收银机电脑上的浏览器。

打开收银机页面的手机、平板和其他电脑,需要在各自的设备上安装证书。收银机的 HTTPS Certificate(HTTPS 证书)页面提供 iPhone 和 iPad、Android 以及其他 Windows 电脑的步骤;参见浏览器显示证书警告和浏览器员工点餐。

订单时间、许可证有效期和安全连接都依赖准确的时间,所以 FMX EPOS 会检查 Windows 时钟。

启动时,FMX EPOS 会把电脑时钟与互联网时间比对,能校正就会校正。校正时钟需要管理员权限,以下情况下 FMX EPOS 具备该权限:

  • 在 Windows 管理员账户上随 Windows 登录启动;或
  • 右键单击 FMX EPOS,选择 Run as administrator 启动。

从快捷方式启动时,FMX EPOS 以普通权限运行,无法校正时钟。

时钟偏差达到 10 秒或以上、而 FMX EPOS 又无法校正时,FMX EPOS 会显示时钟偏差了多少,然后关闭:

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

  1. 右键单击 FMX EPOS,选择 Run as administrator。FMX EPOS 通常就能自行校正时钟。
  2. 或者打开 Windows Settings → Time & language(设置 → 时间和语言),检查时区以及当前日期和时间;网络条件允许时开启自动同步时间,然后立即同步时钟。
  3. 重新启动 FMX EPOS。

偏差不到 10 秒时,即使无法校正,也不会阻止 FMX EPOS 运行。如果互联网时间没有响应,而收银机使用远程数据库,FMX EPOS 会改为与数据库服务器的时间比对,提示中也可能写出数据库服务器的时间。如果启动时无法检查时钟,FMX EPOS 会每 10 分钟再检查一次。之后如果发现时钟偏差达到 10 秒或以上且无法校正,收银界面会一直显示 “This PC’s clock is … out and could not be corrected. Close FMX EPOS and start it as a Windows administrator.”(这台电脑的时钟偏差 …,无法校正。请关闭 FMX EPOS,并以 Windows 管理员身份启动),直到时钟恢复准确。如果这台电脑有意不连互联网,维护人员必须用其他可靠的方法保持时钟准确。

餐厅网络中的其他设备,可以通过 5139 端口的 HTTPS,从主收银机打开厨房屏幕、迎宾台、顾客显示屏和员工点餐页面。

新安装时,其他设备一律被拒绝,直到你允许为止。这项设置只能在收银电脑的桌面程序中更改:

  1. 打开 Back Office → Local Settings → Security。
  2. 在 Remote Access(远程访问)下勾选其他设备需要的项目:Back Office Web Pages、Till Web — PC, Mobile & Customer Display、Kitchen Screen Web、Host Stand Web — PCs & Tablets 或 Mobile App。
  3. 选择 Save Security Settings(保存安全设置)。

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

各开关允许哪些访问,见安全与网络访问。然后准备网络:

  1. 给收银电脑分配固定的局域网地址。通常最简单的做法是在路由器中做地址保留。
  2. 确认 Windows 把餐厅网络视为 Private(专用)网络。安装程序只在专用网络和域网络上打开 FMX EPOS 的防火墙端口,并且只允许同一局域网内的设备。如果仍有设备连不上,请再次运行安装程序并选择 Repair。
  3. 如果 Windows 防火墙弹出提示,允许 FMX EPOS 在餐厅的专用网络上通信。
  4. 让员工设备与收银机连在同一个局域网中。FMX EPOS 自行添加的防火墙规则只接受这个网络中的设备。
  5. 在使用浏览器页面的设备上,通过 FMX EPOS 显示的链接安装收银机的证书。详见浏览器员工点餐。

切勿把 5139 端口开放到公网。浏览器和 Android 员工点餐都应通过餐厅网络访问收银机。

请按顺序检查:

  1. 确认安装程序已完成;如果使用便携式安装包,确认已完整解压,且文件仍放在一起。
  2. 确认 Windows 账户可以在安装文件夹中新建和修改文件。
  3. 如果 FMX EPOS 提示安装 Microsoft Edge WebView2 Runtime,选择 Yes,等安装完成后重新启动 FMX EPOS。也可以运行安装文件夹中 prerequisites 文件夹里的安装程序。
  4. 如果出现时钟提示,校正 Windows 时钟。见 Windows 时钟检查。
  5. 如果 FMX EPOS 显示 Another program is using port 5139(另一个程序正在使用 5139 端口),它会给出该程序的名称:
    • 如果是另一个 FMX EPOS(例如第二个安装),请关闭它。一台电脑同一时间只能运行一个 FMX EPOS。
    • 如果是 Windows 用这个端口运行网页服务(例如 IIS),请电脑的维护人员停止该服务或将其改用其他端口,然后选择 Try Again(重试)。
    • 如果是其他程序,选择 Close It and Start(关闭它并启动)。FMX EPOS 会请你确认,然后关闭该程序并继续。该程序未保存的内容会丢失。也可以自己关闭该程序,再选择 Try Again。
    • Exit 会关闭 FMX EPOS。
  6. 如果 FMX EPOS 提示它已在另一个 Windows 用户下运行,请在该用户的会话中关闭它。
  7. 如果之前的 FMX EPOS 进程没有正常退出,重启 Windows。
  8. 问题依旧时,记下完整的错误信息,请 FMX EPOS 技术支持检查安装。不要删除应用文件夹:里面可能有餐厅数据库和本机设置。

如果 FMX EPOS 在运行中停止,它的窗口会显示 Restarting EPOS…(正在重启 EPOS)并自动重新启动。如果一直停止,它会显示一条以 “The local FMX EPOS service keeps stopping” 开头的提示,然后关闭。请确认数据库服务器正在运行并且可以访问,再重新启动 FMX EPOS。如果提示再次出现,把提示的完整内容发给 FMX EPOS 技术支持。

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

配置好的安装只属于它所在的电脑。把它复制到另一台电脑,等于复制了这台收银机的终端身份。离线许可证不会随之转移:它属于原来的电脑,所以复制出的安装在 Licence 页面上显示 Other Computer。

如果使用远程数据库的复制安装在原安装仍在使用时运行,其中一台会显示 Terminal Identity In Use(终端身份已被占用)。在复制出的那台电脑上,于收银窗口中选择 Create a New Terminal Identity(创建新的终端身份)。复制出的安装随即成为一台新终端,它的打印机需要在 Local Settings 中重新选择。详见数据库与断线恢复。

要增加收银机,请在新电脑上安装 FMX EPOS,在设置时选择同一个远程餐厅数据库,再为这台电脑激活或连接许可证。如果是更换原电脑,请保留原电脑的数据,先请技术支持规划好迁移,再删除任何内容。

如果这台收银机的数据已删除,或者收银机有了新地址,它的证书或地址就变了。请在每部员工手机上选择 Pair With Another Till 重新配对,并在所有浏览器设备上安装新证书。

  1. 关闭 FMX EPOS:在收银登录页面选择 Exit,或按 Ctrl+Shift+Q,然后确认。
  2. 在 Windows 中打开 Settings → Apps → Installed apps(设置 → 应用 → 已安装的应用),找到 FMX EPOS,选择 Uninstall(卸载)。也可以运行安装程序,选择 Uninstall。
  3. Windows 询问是否允许此应用对设备进行更改时,选择 Yes。移除 FMX EPOS 需要管理员权限。如果选择 No,不会删除任何内容。
  4. 在 Remove FMX EPOS 页面上,选择 Next。选择 Remove 之前不会移除任何内容。
  5. 在 Choose what to delete(选择要删除的内容)页面上,只勾选要删除的项目。没有勾选的内容会留在这台电脑上,供重新安装时使用。
    • Delete this till’s data(删除这台收银机的数据):设置、证书、许可证、日志,以及(本地存储模式下的)餐厅数据库。它还会删除这台收银机尚未发送到远程数据库的销售和应急账单,以及保存的 MySQL 密码,所以请先记下连接信息和 root 密码(Back Office → Database 中 This PC’s MySQL Server 卡片上的 Show Root Password)。
    • Remove the MySQL server(移除 MySQL 服务器):FMX EPOS 在这台电脑上安装了 MySQL 时才显示。使用它的其他收银机会失去访问权限。
    • Delete the MySQL databases too(同时删除 MySQL 数据库):这台服务器上的所有数据库,包括门店的订单、付款、菜单和会员。
  6. 选择 Remove。如果勾选了会删除数据的项目,请在 Delete the data for good?(永久删除数据?)处确认 Delete and Remove(删除并移除)。Cancel 返回你的选择。
  7. FMX EPOS is removed(FMX EPOS 已移除)页面会说明保留了哪些内容。窗口关闭时,最后的程序文件才会删除。

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

如果选择 Remove 时 FMX EPOS 仍在运行,页面会显示 “FMX EPOS is running on this PC. Close it, then try again.”(FMX EPOS 正在这台电脑上运行,请关闭后重试),并且不会移除任何内容。

如果安装文件夹中的程序文件被手动删除,安装程序无法卸载,会提示 “The program files are missing from …. Choose Repair, then Uninstall.”(程序文件已从……中丢失,请先选择 Repair,再选择 Uninstall)。请先选择 Repair,然后再次运行安装程序并选择 Uninstall。

FMX EPOS 会删除自己的快捷方式、随 Windows 登录启动的设置、Windows 防火墙规则和已安装应用中的条目,在程序关闭后再删除程序文件。安装文件夹中的其他文件会保留;文件夹中仍有内容时,文件夹本身也会保留。由 FMX EPOS 安装的 MySQL 服务器会保留,除非你勾选 Remove the MySQL server。如果它的数据库保留下来,在同一文件夹重新安装 FMX EPOS 后可以重新使用它们:参见首次设置。

如果这台收银机的数据已删除,它的证书就变了。请在每部员工手机上选择 Pair With Another Till 重新配对,并在所有浏览器设备上安装新证书。

卸载会取消安装程序为整台电脑授予的门店证书信任。通过在 Security Warning 中选择 Yes 而信任证书的 Windows 账户会继续信任它。要在那里删除证书,请登录该账户,从 Windows 搜索框打开 Manage user certificates(管理用户证书),进入 Trusted Root Certification Authorities → Certificates(受信任的根证书颁发机构 → 证书),删除名称以 FMX EPOS Root CA 开头的证书。

便携式安装包不会出现在已安装的应用中。请关闭 FMX EPOS 后自行删除其文件夹;如果以后可能还需要其中的数据,先保留一份 web\.runtime。