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

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

先決條件

Linux 環境支援 Docker，而大部分 Linux 發行版（如 Redhat、CentOS、Ubuntu、Oracle Linux 等）都會支援 Docker
根據您環境的 Linux 操作系統安裝 Docker Engine，您可以按照官方指南
安裝 Docker Compose。您應該在 Linux 操作系統上選擇 linux Standalone binary，您可以遵循官方指南
MySQL 8 或以上
有效的 SSL 證書

信息

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

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

設置程序

將 Offision 伺服器鏡像 offision.tar 放入文件夾 /offision

警告

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

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

version: '3.1'

services:
  offision:
    image: ones-software/offision:latest
    restart: always
    volumes:
      - /offision:/etc/offision
    environment:
      BackgroundJob__TimeZone: 'Asia/Hong_Kong'
      File__BaseDirectory: '/etc/offision/upload-files'
      Logging__ErrorLog__FileLogDirectory: '/etc/offision/error-logs/error-logs-{Date}.txt'
      Logging__InfoLog__FileLogDirectory: '/etc/offision/info-logs/info-logs-{Date}.txt'
      Logging__DbLog__FileLogDirectory: '/etc/offision/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/offision/certificate/offision.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 替換為您的證書密碼
將證書文件放到 /offision/certificate/，證書名稱必須是 offision.pfx
打開終端，進入文件夾 /offision
加載最新的 Offision 伺服器鏡像，運行命令 sudo docker load --input ./offision.tar
開始 Offision: 運行命令 sudo docker-compose up -d
現在您可以通過 https://localhost 訪問 Offision 控制台

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

version: '3.1'

services:
  offision:
    image: ones-software/offision:latest
    restart: always
    volumes:
      - /c/offision:/etc/offision
    environment:
      BackgroundJob__TimeZone: 'Asia/Hong_Kong'
      File__BaseDirectory: '/etc/offision/upload-files'
      Logging__ErrorLog__FileLogDirectory: '/etc/offision/error-logs/error-logs-{Date}.txt'
      Logging__InfoLog__FileLogDirectory: '/etc/offision/info-logs/info-logs-{Date}.txt'
      Logging__DbLog__FileLogDirectory: '/etc/offision/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/offision/certificate/offision.pfx'
    ports:
      - 443:443

更新 Offision 伺服器

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

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

設置程序​

更新 Offision 伺服器​

設置程序

更新 Offision 伺服器