備份專案

  • 最後修改時間:2026-10-08
  • 1. 概述

    「備份管理」用於統一備份維運專案的工程檔案、配置和相關組件資料,並透過手動備份、自動備份及最小儲存格備份降低誤操作或故障造成的資料丟失風險。

    1.1 版本

    維運平台版本
    功能變更
    V1.5.5-
    V1.12.0

    提高備份前磁碟空間檢查要求,防止備份導致磁碟爆滿

    調整維運專案備份還原要求,存在24小時內備份即可還原

    V1.16.0備份管理支援FineDataLink應用
    V2.7.0

    備份內容精簡,取消備份以下資料夾,防止時間過長

    1)FineReport單機取消備份歷史版本範本:/assets/vcs

    2)FineDataLink單機取消備份歷史快照:/dpworks/records

    3)叢集取消備份Excel源檔案:/assets/temp_attach

    4)FineDataLink叢集取消備份歷史快照:/dpworks/records

    V2.10.0備份內容精簡,取消備份FineBI6.1的資料儲存組件內容,僅對資料儲存組件的配置進行備份
    V2.29.01)新增「專案備份狀態異常」警報,備份失敗時自動觸發警報提醒

    2)新增備份完整性校驗邏輯,以防備份檔案無效

    V2.34.01)新增「最小儲存格備份」方案,定期強制備份必要內容,作為資料安全兜底

    2)新增對自備配置庫配置檔案的備份支援,進一步保障資料安全

    V2.40.0支援設定備份儲存位置,可選擇維運平台本地目錄或自備 S3 儲存 。

    1.2 應用場景

    FineReport、FineBI、FineDataLink應用本身存在備份還原功能,但是存在一些短板:

    1)應用備份檔案,只能備份至工程目錄下,無法異地備份,誤操作時若刪除工程,可能會將備份也刪除掉。

    2)應用中的範本、資料越多,應用備份的速度越慢。

    3)應用備份時,jar包、範本、配置都是分開備份還原的,但是大多時候需要將這些內容按照時間點統一備份還原。

    維運平台備份容器化專案時,對於自備的組件不會進行備份,也無法進行還原

    建議使用者在進行專案備份時,自行手動對這些組件進行備份,並在還原時同步還原

    1.3 功能簡介

    維運平台提供「備份管理」功能。

    • 支援一鍵備份,支援自動備份

    • 支援將專案備份到維運平台所在伺服器,實現異地備份。

    • 支援介面化管理備份,查看備份失敗記錄等情況。

    1720602459973457.png

    2. 使用前提

    檢查專案說明
    管理權限使用維運平台管理者帳號。無管理權限時,無法設定全局備份策略或執行專案備份。
    鏡像倉庫

    維運平台與鏡像倉庫需正常連結。

    未配置鏡像倉庫時,系統提示「請配置鏡像倉庫後使用此功能」,無法執行備份。

    詳情請參見:鏡像管理

    備份範圍

    確認需備份的組件。

    使用者自備組件或外接組件未被改寫時,需另行備份並在還原時同步恢復。

    本地空間使用本地目錄時,需預留足夠的磁碟空間;空間不足會阻止備份。

    3. 設定備份策略與儲存位置

    「備份設定」對維運平台內所有專案生效。

    3.1 設定備份上限和磁碟限制

    由於備份會佔用伺服器記憶體,因此需要對備份個數和佔用磁碟空間進行限制。

    管理者登入維運平台,點選「設定>備份設定」,設定後點選「儲存」生效。

    此設定對維運平台內所有專案生效。

    設定內容
    說明
    備份上限

    限制每一個維運專案的備份個數上限

    當某個專案的手動/自動備份檔案個數達到上限時,會自動清理最早的一份備份檔案

    預設支援分別保留3份手動/自動備份檔案

    磁碟限制

    支援對維運平台的備份儲存目錄的磁碟剩餘可用空間設定一個約束值

    一般儲存在維運平台掛載目錄/ops/resources/backup資料夾

    • 若不存在備份,首次備份時,備份儲存目錄剩餘可用空間<2*設定值時,不進行備份

    • 若已存在備份,再次備份時,備份儲存目錄剩餘可用空間<(2*最近一次備份大小+設定值)時,不再進行備份

    • 預設設定值為5G

    3.2 設定備份儲存位置

    V2.40.0 及之後版本支援自訂備份儲存位置。

    備份位置適用場景
    本地目錄本地掛載磁碟空間充足
    S3 物件儲存本地磁碟空間不足、物理磁碟擴容或重新掛載成本較高,或需要將備份與維運平台伺服器分開存放

    1)管理者進入「設定>備份設定」。

    2)在「備份位置」中選擇「本地目錄」/「S3 物件儲存」,輸入相關資訊,按「儲存」即可。

    • 選擇本地目錄時,路徑不支援自訂,預設為維運平台掛載目錄下的 /ops/resources/backup資料夾。

    • 選擇「S3物件儲存」時,請填寫自備的 S3 連結資訊。

    配置項填寫說明
    Endpoint

    S3 服務的存取域名

    請確定維運平台伺服器能存取 S3 Endpoint

    RegionS3 服務所在物理位置。注意不包含前綴的Bucket
    AccessKey

    用於標識用戶

    請確定該帳號具備目標 Bucket 的讀寫權限

    SecretKey

    與 AccessKey 配套的存取金鑰

    SecretKey 通常僅在建立時可見,請提前安全存檔

    Bucket用於存放備份物件的儲存桶名稱

    建議為專案備份使用獨立 Bucket 或獨立目錄,避免與其他業務資料混放

    路徑前綴

    Bucket 記憶體放備份的目錄前綴

    預設為fineops-backup/

    Path-style access

    一般無需配置

    S3 服務要求以路徑樣式存取,或出現憑證、域名解析類連結錯誤時,再開啟

    Signer

    一般留空

    要求指定簽章類型時再填寫。

    4. 確認備份內容

    專案備份的改寫內容取決於專案部署方式和組件來源。

    4.1 維運平台部署的專案

    組件來源

    維運平台部署的專案組件備份範圍:下文備份內容全部備份
    使用者自備的專案組件
    • V2.34.0 及之後版本:備份專案配置庫中的配置檔案,其他內容不備份

    • V2.33.0 及之前版本:完全不備份下文內容

    建議使用者在進行專案備份時,自行手動對這些自備組件進行備份,並在還原時同步還原。

    主要備份內容如下:

    組件備份內容(容器內路徑)說明

    bi-web/bi6/fr/fdl

    應用

    /usr/local/tomcat/webapps/webroot/APP/classes工程呼叫的預設和自訂class檔案
    /usr/local/tomcat/webapps/webroot/APP/config平台呼叫的配置庫(finedb)相關檔案
    /usr/local/tomcat/webapps/webroot/APP/customlib工程客製/外部引入的JAR包、字體等
    /usr/local/tomcat/webapps/webroot/APP/drivers驅動管理上傳的驅動
    /usr/local/tomcat/webapps/webroot/APP/plugins插件相關檔案

    bi6/fr/fdl

    應用

    僅單應用專案備份此部分內容

    /usr/local/tomcat/webapps/webroot/APP/assets

    備份該資料夾下除temp_attach和vcs以外的內容

    通用的共享持久化目錄
    /usr/local/tomcat/webapps/webroot/APP/dashboards老版本FineBI儀表板相關檔案(如無相關目錄則不備份)

    /usr/local/tomcat/webapps/webroot/APP/dpworks

    備份該資料夾下除record和records以外的內容

    FineDataLink任務相關的配置檔案(如無相關目錄則不備份)
    /usr/local/tomcat/webapps/webroot/APP/reportletsFineReport範本存放目錄
    /usr/local/tomcat/webapps/webroot/APP/resources工程相關的資源配置檔案
    /usr/local/tomcat/webapps/webroot/APP/schedule排程管理生成的檔案

    bi-engine-master

    bi6.1引擎元資料

    /data/polars/rocks_datameta資訊持久化儲存
    bi-engine-worker

    bi6.1引擎計算

    不備份目錄,只備份容器配置-

    bi-minio

    bi6.1資料儲存

    不備份目錄,只備份容器配置-

    nginx

    帆軟內網關

    /usr/local/nginx/conf

    Nginx 的配置檔案

    /usr/local/nginx/luaLua 腳本檔案

    mysql

    外接配置庫

    /var/lib/mysql

    備份該資料夾下除mysql.sock以外的內容

    MySQL 資料庫的實際資料檔案

    elasticsearch

    日誌服務

    /usr/share/elasticsearch/config/elasticsearch.yml

    Elasticsearch 的配置檔案

    /run/secretsElasticSearch一些敏感資訊或者安全相關的檔案

    filebeat

    日誌採集

    /usr/share/filebeat/filebeat.ymlfilebeat的配置檔案
    /usr/share/filebeat/datafilebeat的資料目錄
    /usr/share/filebeat/configinput檔案
    redis

    狀態服務

    /data

    redis的資料目錄

    minio

    檔案儲存

    assets

    備份該資料夾下除temp_attach和vcs以外的內容

    通用的共享持久化目錄
    dashboards老版本FineBI儀表板相關檔案(如無相關目錄則不備份)

    dpworks

    備份該資料夾下除record和records以外的內容

    FineDataLink任務相關的配置檔案(如無相關目錄則不備份)
    reportletsFineReport範本存放目錄
    resources存放工程相關的資源配置檔案
    schedule排程管理生成的檔案

    nacos

    服務註冊中心

    /home/nacos/data資料庫derby等資料

    nacos_mysql

    nacos服務所需的配置儲存

    /var/lib/mysql

    備份該資料夾下除mysql.sock以外的內容

    MySQL 資料庫的實際資料檔案

    kafka

    管道服務

    不備份目錄,只備份容器配置-

    4.2 非維運平台部署的專案

    僅對工程相關檔案進行備份。外接配置庫、日誌儲存等組件,均不進行備份。

    建議使用者在進行專案備份時,自行手動對這些必要組件進行備份,並在還原時同步還原。

    位置備份內容說明

    bi/fr/fdl應用節點

    /webroot/WEB-INF/classes工程呼叫的預設和自訂class檔案
    /webroot/WEB-INF/config平台呼叫的配置庫(finedb)相關檔案
    /webroot/WEB-INF/customlib工程客製/外部引入的JAR包、字體等
    /webroot/WEB-INF/drivers驅動管理上傳的驅動
    /webroot/WEB-INF/plugins插件相關檔案

    單機:bi/fr/fdl應用節點下

    叢集:檔案伺服器中

    /webroot/WEB-INF/assets

    備份該資料夾下除temp_attach和vcs以外的內容

    通用的共享持久化目錄
    /webroot/WEB-INF/dashboards老版本FineBI儀表板相關檔案(如無相關目錄則不備份)

    /webroot/WEB-INF/dpworks

    備份該資料夾下除record和records以外的內容

    FineDataLink任務相關的配置檔案(如無相關目錄則不備份)
    /webroot/WEB-INF/reportletsFineReport範本存放目錄
    /webroot/WEB-INF/resources工程相關的資源配置檔案

    5. 備份專案

    兩種備份方式:

    • 手動備份:管理者可手動觸發對專案的備份

    • 自動備份:可設定自動備份時間,維運平台在指定時間點對專案自動備份

    5.1 發起手動備份

    1)管理者進入「專案管理」,選擇專案,再進入「維護>備份管理」。

    2)按專案類型選擇是否同時備份鏡像或 JAR 包。

    專案類型
    選擇備份內容
    維運平台部署的專案

    不勾選

    備份鏡像

    備份4.1節列出的所有內容

    注:僅對維運平台部署的專案組件進行備份。使用者自備組件不會備份

           建議使用者在進行專案備份時,自行手動對這些自備組件進行備份,並在還原時同步還原

    勾選

    備份鏡像

    1)備份專案組件當前版本的鏡像檔案

    2)備份4.1節列出的所有內容

    注:僅對維運平台部署的專案組件進行備份。使用者自備組件不會備份

           建議使用者在進行專案備份時,自行手動對這些自備組件進行備份,並在還原時同步還原

    非維運平台部署的專案

    不勾選

    備份jar包

    備份4.2節列出的所有內容

    注:僅對工程相關檔案進行備份。外接配置庫、日誌儲存等組件,均不進行備份

           建議使用者在進行專案備份時,自行手動對這些必要組件進行備份,並在還原時同步還原

    勾選

    備份jar包

    1)備份專案當前使用版本的JAR包檔案

    2)備份4.2節列出的所有內容

    注:僅對工程相關檔案進行備份。外接配置庫、日誌儲存等組件,均不進行備份

           建議使用者在進行專案備份時,自行手動對這些必要組件進行備份,並在還原時同步還原

    3)按「開始備份」,填寫不重複的備份名稱,再按「確定」。

    開始備份後,使用者可切換到其他頁面進行操作,備份可在後台進行。

    注1:手動備份超出備份上限時,提醒「此專案已存在X個手動備份,此次備份將改寫最早一次手動備份,是否繼續?」。

    注2:使用本地目錄且剩餘空間未達到第 3.1 節要求時,備份失敗。

    注3:備份檔案禁止命名重複。

    5.2 定時自動備份

    1)管理者進入「專案管理」,選擇專案,再進入「維護>備份管理」。

    2)按專案類型選擇是否同時備份鏡像或 JAR 包。

    專案類型
    選擇備份內容
    維運平台部署的專案

    不勾選

    備份鏡像

    備份4.1節列出的所有內容

    注:僅對維運平台部署的專案組件進行備份。使用者自備組件不會備份

           建議使用者在進行專案備份時,自行手動對這些自備組件進行備份,並在還原時同步還原

    勾選

    備份鏡像

    1)備份專案組件當前版本的鏡像檔案

    2)備份4.1節列出的所有內容

    注:僅對維運平台部署的專案組件進行備份。使用者自備組件不會備份

           建議使用者在進行專案備份時,自行手動對這些自備組件進行備份,並在還原時同步還原

    非維運平台部署的專案

    不勾選

    備份jar包

    備份4.2節列出的所有內容

    注:僅對工程相關檔案進行備份。外接配置庫、日誌儲存等組件,均不進行備份

           建議使用者在進行專案備份時,自行手動對這些必要組件進行備份,並在還原時同步還原

    勾選

    備份jar包

    1)備份專案當前使用版本的JAR包檔案

    2)備份4.2節列出的所有內容

    注:僅對工程相關檔案進行備份。外接配置庫、日誌儲存等組件,均不進行備份

           建議使用者在進行專案備份時,自行手動對這些必要組件進行備份,並在還原時同步還原

    3)開啟「自動備份」,設定執行頻率和時間。

    維運平台在指定時間自動建立備份,備份名稱為執行時間。

    注1:自動備份超出3.1節的備份上限時,自動刪除最早 1 份。

    注2:若備份儲存目錄剩餘可用空間小於3.1節的限制,則不再進行自動備份。


    5.3 最小儲存格備份

    V2.34.0 及之後版本提供最小儲存格備份,作為未開啟自動備份時的資料安全兜底。

    專案說明
    啟動規則

    如果開啟了「自動備份」,則不啟動「最小儲存格備份」

    如果未開啟「自動備份」,則「最小儲存格備份」預設開啟、強制執行,無法透過介面關閉

    備份內容專案外接配置庫的配置檔案,改寫維運平台部署和非維運平台部署的專案,以及維運平台部署和使用者自備的外接配置庫。
    執行頻率每天 1 次,預設在 02:00 執行。
    保留份數與第 3.1 節的備份上限一致;生成新備份後自動刪除舊備份。
    大小上限專案外接配置庫配置檔案不超過 4 GB,超出時無法完成備份。
    還原方式不支援在前端頁面還原。如需使用,請聯絡帆軟維運人員透過底層方式操作。

    在備份列表介面,綠色備份圖示,即代表最小儲存格備份正常進行中。


    6. 管理備份

    6.1 查看備份資訊

    在「備份管理>全部備份」中查看以下資訊。

    在維運平台「全部備份」中,以明細表格式展示每一個備份的詳細情況。右上角展示備份儲存目錄剩餘可用空間。

    展示項說明
    備份名稱備份檔案的名稱
    備份類型備份的類型,包括:手動備份、自動備份
    開始時間備份開始的時間,精確到秒
    結束時間備份結束的時間,精確到秒
    備份大小備份檔案的大小

    6.2 刪除備份

    勾選需要刪除的備份,點選「刪除」,即可刪除備份。如下圖所示:


    6.3 重新命名備份

    點選備份後方的「重新命名」按鈕,對備份進行重新命名,點選「確定」,重新命名生效。

    注:備份檔案禁止命名重複。

    6.4 備份及還原失敗記錄

    點選「備份及還原失敗記錄」,可查看備份及還原失敗的記錄明細表。如下圖所示:

    V2.29.0及之後版本,維運平台內建了「專案備份狀態異常」警報,當備份失敗時自動觸發警報提醒。

    6.5 查看備份目錄名

    非容器化部署的工程,手動生成的備份,在維運平台的備份目錄中顯示的檔案名稱均為ID。使用者很難判斷每個備份檔案對應的前端顯示內容,在進行還原時十分不方便。

    對於非容器化部署的工程,手動生成的備份,滑鼠懸浮即可查看備份目錄名,點選按鈕時可複製名稱到剪貼簿。

    附件列表


    主題: 專案管理
    已經是第一篇
    已經是最後一篇
    • 有幫助
    • 沒幫助
    • 只是瀏覽

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    獲取幫助
    線上支援
    獲取專業技術支援,快速幫助您解決問題
    工作日9:00-12:00,13:30-17:30在线
    頁面反饋
    針對當前網頁的建議、問題反饋
    售前咨詢
    業務咨詢
    電話:0933-790886或 0989-092892
    郵箱:taiwan@fanruan.com
    頁面反饋
    *問題分類
    不能為空
    問題描述
    0/1000
    不能為空

    反馈已提交

    网络繁忙