專案使用常見問題

  • 最後修改時間:2026-04-24
  • 部署專案

    問:想部署多個專案,需要部署多個維運平台嗎?

    不需要,一個維運平台支援部署、對接多個專案

    問:內網環境可以用維運平台部署專案嗎?

    只要是Linux環境,無論內網還是外網,均可使用維運平台部署專案。

    非Linux環境(Windows/信創)暫不支援使用維運平台部署專案

    問:維運平台部署的專案版本是多少?

    維運平台自帶/雲端的帆軟產品鏡像,均為帆軟產品最新版本。

    只要你的維運平台可以獲取到該版本,那麼就會部署最新版本的帆軟產品。

    問:如何部署FineBI&FineReport整合工程?

    維運平台部署的FineBI專案,自帶FineReport和FineDataLink功能相關JAR包。

    因此只需要部署FineBI專案,並在購買工程授權時,選購FineReport相關功能點即可。

    問:如何部署帶Demo的專案?

    維運平台部署的專案,只包含內建FRDemo.db/BI Demo.db資源,不包含Demo。

    使用者可參考「如何添加Demo资源到运维项目」文檔,在部署成功後自行引入Demo資源

    問:維運平台接入已有專案需要重啟專案嗎?

    維運平台接入已有專案,本身並不需要重啟專案。

    但非維運平台部署的專案,如需使用維運平台的「鏈路追蹤」功能,需要進行相關配置並重啟。

    問:為什麼網路互通,但維運平台和專案對接不上?

    1)對比維運平台和 系統維運插件 的版本,是否匹配。

    2)版本匹配的情況下,禁用再啟動專案的系統維運插件。

    問:維運平台與專案正常對接,但是無法監視到任何資料

    檢查維運平台和專案所在伺服器,時區是否一致,時間誤差是否超過5秒

    伺服器時區和時間的差異,會導致監視無法獲取資料。修改方法可參考:Linux系統時區調整

    專案維護

    問:專案組件佔用了許多埠,都要對外開放嗎?

    不需要,專案組件佔用埠,只是確定組件可以運作。

    對外開放的埠,只有nginx/frbifdl工程埠

    問:如何給專案配置短域名?

    需要在部署專案時就進行相關配置,詳情可參考「使用IP/域名存取專案

    問:如何自訂工程啟動參數?

    請使用「更改專案組件配置」功能,妥善修改啟動參數。

    建議不要擅自修改,可先使用「系統巡檢」功能對配置進行檢查,再根據建議值調整。

    問:如何修改工程的記憶體?

    請使用「更改專案組件配置」功能,妥善修改工程內容。

    建議不要擅自修改,可先使用「系統巡檢」功能對配置進行檢查,再根據建議值調整。

    問:刪除專案是不是等於卸載專案?

    維運管理中,對專案進行「刪除」操作,是指切斷維運平台與專案之間的管理關係。

    但專案自身仍是存在的、正常運作的、不受到任何的影響。

    如需卸載維運平台部署的專案,請聯絡帆軟技術支援協助操作。

    問:維運平台部署的專案,用什麼註冊方式最好?

    使用維運平台部署的維運專案,推薦使用容器私有雲認證方式,對工程進行註冊授權。

    維運平台提供前端介面化「註冊新專案」,幫助使用者快速進行容器私有雲註冊。

    問:維運平台部署的MySQL組件密碼是多少?

    管理者可透過「匯出專案部署資訊」查看mysql、elasticsearch、minio等組件的帳號和密碼

    請注意,該MySQL組件是用作專案的配置庫,應當保持獨立性。切勿使用該組件作為專案的資料庫,儲存業務資料!

    問:為什麼專案明明可以存取,維運平台卻顯示不可用?

    1)對比維運平台和 系統維運插件 的版本,是否匹配。

    2)版本匹配的情況下,禁用再啟動專案的系統維運插件。

    3)叢集專案,請排查是否有部分節點當機。老版本維運平台會因為部分節點當機導致對接失敗,建議升級維運平台到最新後重新對接。

    問:ElasticSearch狀態異常,請確定ElasticSearch正在運作且狀態非標紅

    出現該報錯,請排查:

    1)檢查ElasticSearch組件是否處於running狀態,如果不,請將組件恢復存活

    2)檢查ElasticSearch所在伺服器,與維運平台伺服器,是否內網互通,請確定網路通訊正常

    問:存取維運平台部署的專案失敗,且 URL 會自動追加 /v10/deployment/recommendation

    出現該問題時,請先檢查專案的檔案伺服器配置是否正常 。

    注:可能存在維運平台中顯示檔案伺服器「已連結」,但實際已斷聯的情況 。

    專案使用

    問:如何上傳自訂驅動?

    不支援手動上傳,請使用「驅動管理」功能上傳。

    驅動管理上傳的驅動,會存放在工程外掛目錄/assets/drivers資料夾中,會自動同步到工程WEB-INF/drivers資料夾中

    問:自訂工程JAR包放哪兒?

    工程外掛目錄/customlib資料夾,可用於存放客戶自訂的工程JAR包。等同於直接放置在Tomcat/lib下

    注意,此處所指的是自訂工程JAR包,而非自訂驅動包

    問:自訂的資源檔案上傳到哪裏?

    對於維運平台部署的專案,檔案如果上傳到非持久化目錄中,會因重啟而丟失。

    建議對於必需上傳的資源檔案,可透過「檔案管理」上傳到工程外掛目錄/help資料夾中

    例如上傳了 xxx.jsp 檔案,存取該資源的路徑即為http://ip:port/webroot/help/xxx.jsp

    問:想新增字體怎麼辦?

    工程外掛目錄/customlib/fonts資料夾,可用於存放客戶自訂的字體檔案,等同於直接放置在/usr/share/fonts下

    1)請將字體檔案上傳到工程外掛目錄/customlib/fonts資料夾

    2)確定賦予字體檔案足夠高權限,建議777

    3)重啟對應工程組件,啟動時會進行載入字體檔案

    注:維運平台部署的帆軟專案,預設內建了文泉驛系列字體(可免費商用,無版權糾紛) 。

           如需安裝其他字體,請自行尋找相關安裝包資源,帆軟不提供此部分資源 。

    問:可以修改FineBI抽取資料存放路徑嗎?

    對於維運平台部署的FineBI專案,工程容器內資料存放路徑禁止修改。

    請確定資料存放路徑為:/usr/local/tomcat/webapps/webroot/bi-data/spider/db

    問:微信整合,可信域名歸屬校驗檔案需要上傳到域名根目錄下,應該上傳到哪裏?

    工程外掛目錄/ROOT資料夾,可用於存放微信可信域名歸屬校驗檔案

    問:如何修改專案的瀏覽器圖示和標題

    1)修改專案瀏覽器圖示

    準備好你的.ico格式的新圖示檔案,命名為favicon.ico

    將該檔案上傳至專案的每個工程節點(bi-web/fr/fdl)的外掛目錄/ROOT資料夾中,重新整理瀏覽器視窗即可取代成功

    Group 1 (2).png

    2)修改專案瀏覽器標題

    登入帆軟應用,點選「管理系統>外掛配置>平台樣式」,修改平台標題即可取代成功

    1777009845955906.png

    問:為什麼找不到WEB-INF資料夾?

    對於維運平台部署的專案,WEB-INF資料夾的命名為APP,與非維運平台部署的專案不同 。

    在檔案管理功能中,APP資料夾中展示的檔案即為原非維運平台部署的WEB-INF資料夾路徑內容 。

    問:FineBI的自訂函式不生效

    1)請上傳class檔案至每個bi-engine-worker容器外掛目錄/polars/classes資料夾對應路徑下

    • 檔案儲存位置需要與 java檔案裏 package 下的位置相對應,classes下如無相關package路徑,請自行建立子資料夾

    • 請注意如有多個bi-engine-worker,需要一一上傳

    • 本範例將 StringCat.class 檔案存放至每個bi-engine-worker容器外掛目錄/polars/classes/com/fr/function目錄下

    Group 4 (1).png


    2)請上傳class檔案至每個bi-web容器外掛目錄/classes資料夾對應路徑下

    • 檔案儲存位置需要與 java檔案裏 package 下的位置相對應,classes下如無相關package路徑,請自行建立子資料夾

    • 請注意如有多個bi-web,需要一一上傳

    • 本範例將 StringCat.class 檔案存放至每個bi-web容器外掛目錄/classes/com/fr/function目錄下

    Group 5.png

    3)如該class檔案依賴第三方JAR包,請上傳對應JAR包至每個bi-engine-worker容器外掛目錄/polars/customlib資料夾下

    • 請注意如有多個bi-engine-worker,需要一一上傳

    • 本文範例將第三方JAR包存放至每個bi-engine-worker容器外掛目錄/polars/customlib資料夾下

    Group 6.png

    4)如該class檔案依賴第三方JAR包,請上傳對應JAR包至每個bi-web容器外掛目錄/customlib資料夾下

    請注意如有多個bi-web,需要一一上傳

    本文範例將第三方JAR包存放至每個bi-web容器外掛目錄/customlib資料夾下

    Group 7.png

    5)全部放置完畢後,請使用維運平台的「維護>組件管理」功能重啟全部bi-web和bi-engine-worker容器,以使功能生效2026-04-24_14-37-11.png

    附件列表


    主題: 常見問題
    • 有幫助
    • 沒幫助
    • 只是瀏覽

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

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

    不再提示

    10s後關閉

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

    反馈已提交

    网络繁忙