VibePOS Logo
登入免費試用

安裝指南

詳細的安裝步驟和設定說明

Windows 安裝指南
推薦
在 Windows 系統上安裝 VibePOS Local Agent

步驟 1: 下載檔案

從下載頁面下載 Windows 版本的執行檔

步驟 2: 解壓縮並安裝

  1. 找到下載的檔案 VibePOS-Agent-Windows-v1.0.0.zip
  2. 右鍵點擊檔案，選擇「解壓縮全部」
  3. 進入解壓縮的資料夾
  4. 執行 setup.exe 安裝程式
  5. 如果出現安全性警告，點擊「仍要執行」
  6. 等待安裝完成

步驟 3: 設定硬體

  1. 連接出單機和錢箱到電腦
  2. 開啟程式設定檔 config.json
  3. 修改印表機和錢箱的 vendor_id 和 product_id
  4. 儲存設定檔並重新啟動程式

步驟 4: 測試連接

開啟瀏覽器前往以下網址測試：

http://localhost:8080/hardware/printer-statushttp://localhost:8080/hardware/cash-drawer-status

💡 提示

  • • 首次安裝需要管理員權限
  • • 建議將程式設定為開機自動啟動
  • • 如果遇到問題，請檢查防火牆設定
常見問題
安裝過程中可能遇到的問題和解決方案

Q: 程式無法啟動怎麼辦？

A: 檢查是否已安裝 Python 3.8+，並確認所有依賴套件已正確安裝。

Q: 硬體無法連接怎麼辦？

A: 確認硬體連接正常，檢查 vendor_id 和 product_id 設定是否正確。

Q: 列印內容亂碼怎麼辦？

A: 檢查印表機編碼設定，建議使用 big5 編碼。