在 Linux 伺服器上安裝（進階）

以下文檔用於將 Bookings ONE 安裝到 Linux 伺服器上。

先決條件

Linux 環境支援 Docker，而大部分 Linux 發行版（如 Redhat、CentOS、Ubuntu、Oracle Linux 等）都會支援 Docker
根據您環境的 Linux 操作系統安裝 Docker Engine，您可以按照官方指南
安裝 Docker Compose。您應該在 Linux 操作系統上選擇 linux Standalone binary，您可以遵循官方指南
對於虛擬機器（如 Hyper-v 或 WMWare），它需要支援超線程並能夠運行嵌套虛擬化。請在虛擬機器中啟用這些配置
MySQL 8 或以上
有效的 SSL 證書

信息

要確認 Docker Engine 是否安裝正確，請使用命令 sudo docker images

要確認 Docker Compose 是否安裝成功，請使用命令 sudo docker-compose version

設置程序

將 Bookings ONE 伺服器鏡像 bookings-one.tar 放入文件夾 /bookings-one

警告

Bookings Bookings ONE Server 圖片沒有直接下載鏈接。如需安裝 Bookings ONE 伺服器鏡像，請聯繫 ONES Software

將以下腳本保存到 /bookings-one/docker-compose.yml

version: '3.1'

services:
  bookings-one:
    image: ones-software/bookings-one:latest
    restart: always
    volumes:
      - /bookings-one:/etc/bookings-one
    environment:
      BackgroundJob__TimeZone: 'Asia/Hong_Kong'
      File__BaseDirectory: '/etc/bookings-one/upload-files'
      Logging__ErrorLog__FileLogDirectory: '/etc/bookings-one/error-logs/error-logs-{Date}.txt'
      Logging__InfoLog__FileLogDirectory: '/etc/bookings-one/info-logs/info-logs-{Date}.txt'
      Logging__DbLog__FileLogDirectory: '/etc/bookings-one/db-logs/db-logs-{Date}.txt'
      WebPush__PrivateKey: WEB_PUSH_PRIVATE_KEY
      WebPush__PublicKey: WEB_PUSH_PUBLIC_KEY
      Architecture__Database: 'Mysql'
      ConnectionStrings__MainDatabase: 'Server=DATABASE_SERVER_ADDRESS;Port=3306;Database=Bookings.ONE;Uid=DATABASE_USERNAME;Pwd=DATABASE_PASSWORD;Allow User Variables=true'
      ASPNETCORE_URLS: 'https://+;http://+'
      ASPNETCORE_HTTPS_PORT: 443
      ASPNETCORE_Kestrel__Certificates__Default__Password: CERTIFICATE_PASSWORD
      ASPNETCORE_Kestrel__Certificates__Default__Path: '/etc/bookings-one/certificate/bookings-one.pfx'

    ports:
      - 443:443

.yml 文件的間距非常重要，請保持與示例相同的縮進

修改 docker-compose.yml:
1. 將 DATABASE_SERVER_ADDRESS, DATABASE_USERNAME 和 DATABASE_PASSWORD 替換為您的數據庫連接字符串
  如果您的 Mysql 與 Docker 在同一台伺服器上運行，則必須將 DATABASE_SERVER_ADDRESS 設置為 host.docker.internal,1433
2. 將 WEB_PUSH_PRIVATE_KEY 和 WEB_PUSH_PUBLIC_KEY 替換為您的密鑰對。此密鑰為 VAPID 密鑰，您可以自己生成或使用某些在線密鑰生成器生成
3. 將 CERTIFICATE_PASSWORD 替換為您的證書密碼
將證書文件放到 /bookings-one/certificate/，證書名稱必須是 bookings-one.pfx
打開終端，進入文件夾 /bookings-one
加載最新的 Bookings ONE 伺服器鏡像，運行命令 sudo docker load --input ./bookings-one.tar
開始 Bookings ONE: 運行命令 sudo docker-compose up -d
現在您可以通過 https://localhost 訪問 Bookings One 控制台

以下是一個示例 docker-compose.yml 供您參考

version: '3.1'

services:
  bookings-one:
    image: ones-software/bookings-one:latest
    restart: always
    volumes:
      - /c/bookings-one:/etc/bookings-one
    environment:
      BackgroundJob__TimeZone: 'Asia/Hong_Kong'
      File__BaseDirectory: '/etc/bookings-one/upload-files'
      Logging__ErrorLog__FileLogDirectory: '/etc/bookings-one/error-logs/error-logs-{Date}.txt'
      Logging__InfoLog__FileLogDirectory: '/etc/bookings-one/info-logs/info-logs-{Date}.txt'
      Logging__DbLog__FileLogDirectory: '/etc/bookings-one/db-logs/db-logs-{Date}.txt'
      WebPush__PublicKey: 'BJszfqip7Ii_lKSXCd_ZZJXT5FeQwJCZx79mLpr3nY8_rvRzSBLuaTx5dOp4rQZtzI511UvoyRXIwPoZ4_PALFA'
      WebPush__PrivateKey: 'C-RkwJZGooRiI0CGNwAmShlaSWsh4SRNkol-ni5LGAk'
      Architecture__Database: 'Mysql'
      
      ConnectionStrings__MainDatabase: 'Server=host.docker.internal;Port=3306;Database=Bookings.ONE;      ASPNETCORE_URLS: 'https://+;http://+'
      ASPNETCORE_HTTPS_PORT: 443
      ASPNETCORE_Kestrel__Certificates__Default__Password: Password1234
      ASPNETCORE_Kestrel__Certificates__Default__Path: '/etc/bookings-one/certificate/bookings-one.pfx'
    ports:
      - 443:443

更新 Bookings ONE 伺服器

將最新的 Bookings ONE 伺服器映像下載到 C:\bookings-one
在 C:\bookings-one 中打開 PowerShell
停止 Bookings ONE: 運行命令 docker-compose down
加載最新的 Bookings ONE 伺服器鏡像，運行命令 docker load --input ./bookings-one.tar
更新並啟動 Bookings ONE，運行命令 docker-compose up

無需將圖像放在文件夾 C:\bookings-one 中，任何驅動器或文件夾都可以使用，如果要移動到其他文件夾，請將“/c/bookings-one”替換為目標文件夾（例如 /d/server/bookings-one)

如果您需要為伺服器配置主機表/共享驅動器，您可以在此處找到說明

設置程序​

更新 Bookings ONE 伺服器​

設置程序

更新 Bookings ONE 伺服器