使用安全的夜間定時任務自動執行 ownCloud 資料庫轉儲
為 ownCloud Server 安排受保護的 MariaDB 轉儲,安全地處理維護模式,並在依賴每個備份之前進行驗證。
目前版本說明: ownCloud 的目前文件將 Classic 11.0 列為穩定版本,並指出 Classic 11 僅支援基於 Docker 的安裝。可靠的自動化部署方式是執行主機 cron 任務,該任務從 Docker Compose 專案目錄執行腳本。對於 MariaDB 支援的堆疊,腳本會短暫啟用維護模式,停止 Web 服務,匯出資料庫mysqldump,驗證壓縮文件,然後重新啟動 ownCloud。 ownCloud 在其備份流程文件中記錄了維護模式和資料庫工具轉儲的作業。
本範例使用官方 Compose 服務名稱owncloud。mariadb如果您執行的是 ownCloud Server 10.16、非 Docker 安裝或 PostgreSQL,請使用該部署的服務名稱和資料庫特定命令,而不是原封不動地複製腳本。
從執行 Docker Compose 的主機執行備份,而不是從 ownCloud Web 容器內部執行。在 Compose 專案目錄中,建立一個客戶端選項文件,以便 MariaDB 用戶端無需在備份腳本或 crontab 中設定密碼即可讀取該文件:
mkdir -p secrets
nano secrets/db-backup-client.cnf
輸入用於資料庫轉儲的資料庫帳戶。對於官方範例堆疊,MariaDB root 密碼已在部署環境中配置;對於生產環境,建議使用僅具有 MariaDB 版本所需權限的專用備份帳戶。
[client]
user=root
password=REPLACE_WITH_YOUR_DATABASE_PASSWORD
host=localhost
限制主機上的檔案存取權限,使其僅供部署管理員讀取:
chmod 600 secrets/db-backup-client.cnf
將該檔案作為 Compose 金鑰掛載到 MariaDB 服務上。secrets在現有mariadb服務下新增條目,並在頂層聲明該金鑰。保留 Compose 檔案中的所有其他設定:
services:
mariadb:
secrets:
- db_backup_client
secrets:
db_backup_client:
file: ./secrets/db-backup-client.cnf
Compose 會將此檔案發佈到 MariaDB 容器中/run/secrets/db_backup_client。如果您的 Compose 實作需要套用新的掛載點,請重新建立或重新啟動該服務。請勿在實際安裝中使用文件中的範例密碼。
以 root 使用者身分創建/usr/local/sbin/owncloud-db-backup。此版本假定專案位於/srv/owncloud單獨的主機目錄,並將匯出的檔案寫入該目錄。請將這兩個路徑變更為與您的伺服器相符的路徑。維護模式和停止應用程式服務會在夜間造成短暫中斷,但可以防止 Web 請求在匯出期間更改資料。如果指令失敗,清理陷阱會嘗試重新啟動服務並關閉維護模式。
#!/usr/bin/env bash
set -Eeuo pipefail
cd /srv/owncloud
BACKUP_DIR=/srv/backups/owncloud-db
STAMP=$(date -u +%Y%m%dT%H%M%SZ)
TMP="$BACKUP_DIR/.owncloud-db-$STAMP.sql.gz.tmp"
FINAL="$BACKUP_DIR/owncloud-db-$STAMP.sql.gz"
install -d -m 700 "$BACKUP_DIR"
exec 9>/run/lock/owncloud-db-backup.lock
flock -n 9 || { echo "Backup already running" >&2; exit 1; }
maintenance=0
app_stopped=0
cleanup() {
status=$?
if (( app_stopped )); then docker compose start owncloud || status=1; fi
if (( maintenance )); then docker compose exec -T owncloud occ maintenance:mode --off || status=1; fi
rm -f -- "$TMP"
exit "$status"
}
trap cleanup EXIT
maintenance=1
docker compose exec -T owncloud occ maintenance:mode --on
app_stopped=1
docker compose stop owncloud
docker compose exec -T mariadb /usr/bin/mysqldump \
--defaults-extra-file=/run/secrets/db_backup_client \
--single-transaction owncloud | gzip -c > "$TMP"
gzip -t "$TMP"
test -s "$TMP"
mv -- "$TMP" "$FINAL"
docker compose start owncloud
app_stopped=0
docker compose exec -T owncloud occ maintenance:mode --off
maintenance=0
trap - EXIT
--single-transaction這是 ownCloud MariaDB/MySQL 備份範例中使用的資料庫選項。臨時檔案名稱可以防止未完成的備份看起來像已完成的備份;gzip -t並且test -s必須成功才能重新命名檔案。鎖定機制可防止運轉速度較慢的備份與下一次排程的備份重疊。如果您的 Compose 專案使用不同的資料庫名稱,請變更最後一個owncloud參數以符合它。
安裝腳本並使其可執行,然後在安排其運行之前手動執行一次。手動執行腳本可讓您驗證 Compose 路徑、秘密掛載點、可用磁碟空間以及維護模式復原設置,同時還可以查看日誌。
sudo chmod 700 /usr/local/sbin/owncloud-db-backup
sudo /usr/local/sbin/owncloud-db-backup
如果任務完成且 ownCloud 恢復正常運行,請開啟 root 使用者的 crontab 文件,並新增一個每天凌晨 2:30 運行的任務。 Cron 使用主機的本機時區;請將執行時間變更為您所在環境中的非尖峰時段。
sudo crontab -e
30 2 * * * /usr/local/sbin/owncloud-db-backup >> /var/log/owncloud-db-backup.log 2>&1
該作業以 root 使用者身分執行,因為它需要控制 Docker、寫入受保護的備份目錄並建立鎖定檔案。務必將腳本和資料庫保密,僅管理員可讀。設定日誌輪換,並設定警報或監控檢查,以偵測作業是否非零退出;僅靠 cron 日誌記錄無法證明存在可用的備份。
手動運行後以及首次計劃運行後,檢查是否存在新的帶時間戳記的文件,該文件是否為非空文件,並且是否通過了 gzip 完整性檢查:
ls -lh /srv/backups/owncloud-db/
gzip -t /srv/backups/owncloud-db/owncloud-db-YYYYMMDDTHHMMSSZ.sql.gz
成功僅gzip -t表示壓縮流可讀,並不證明 MariaDB 可以恢復 SQL 語句,也不證明復原後的 ownCloud 實例可以正常運作。請定期使用ownCloud 復原說明將副本還原至暫存環境。切勿透過導入生產資料庫進行測試。
將資料庫轉儲檔案保存在 Compose 項目之外,並將加密副本傳送到單獨的儲存位置。根據恢復需求和可用容量設定保留期限,並監控目標位置,防止其被靜默填滿。僅提供資料庫轉儲檔案並非完整的 ownCloud 備份:目前的復原指南還需要包含 `<path>`、`<path>` 和 `<path>` 資料夾的 Docker 磁碟區數據apps,config以及files任何自訂主題檔案或單獨存放的加密金鑰。
如果您的 ownCloud 安裝使用 PostgreSQL,請切換到文件中指定pg_dump的pg_restore格式;目前的伺服器指南支援 MySQL/MariaDB 和 PostgreSQL 用於生產環境。 SQLite 僅用於評估,不適用於生產環境。另請注意,ownCloud 的「備份定時任務」部分指的是保留現有的www-datacrontab 計劃,它不會建立定期運行的資料庫轉儲。
為 ownCloud Server 安排受保護的 MariaDB 轉儲,安全地處理維護模式,並在依賴每個備份之前進行驗證。
使用支援的應用程式、有序的命令、身份驗證以及需要單獨處理的資料的明確列表,規劃 ownCloud 10 到 oCIS 的遷移。
使用主題應用程式取代 ownCloud Classic 10 標誌並調整 Web UI 顏色,同時避免升級和完整性檢查陷阱。
按角色為新的 ownCloud Infinite Scale 使用者指派基於位元組的儲存限制,並提供 proxy.yaml 範例和安全性驗證清單。
透過檢查伺服器主機名稱、憑證鏈、私有 CA 信任和強制入口網站問題,恢復 ownCloud 桌面同步,而無需停用 TLS 驗證。
使用無效文件報告來識別不匹配的核心文件或應用程式簽名,恢復正確的發布文件,並安全地驗證完整性檢查。
從官方 Compose 範例部署 ownCloud Infinite Scale,配置網域和持久存儲,然後驗證 TLS、容器和首次登入。
設定 S3NG 驅動程式、儲存桶權限、持久性元資料儲存和上傳大小,以便 ownCloud Infinite Scale 可以可靠地儲存檔案內容。
檢查檔案狀態、配額、臨時磁碟空間、PHP 限制和代理逾時,找出 ownCloud 伺服器上傳接近完成時停止的原因。
僅對 ownCloud 的 Web 根目錄設定 AllowOverride All,驗證活動的 Apache 虛擬主機,然後安全地重新載入以恢復 .htaccess 規則。