如何自訂 BigBlueButton 介面和徽標

BigBlueButton 品牌客製化可以包含三種不同的內容：更改伺服器預設網頁上的徽標、在會議中顯示徽標或重新設計會議用戶端本身。請選擇能夠滿足您目標的最小改動。前兩種改動屬於文件記錄的配置或資源變更；而重新設計配色方案、措詞或用戶端佈局通常需要建立客製化的 HTML5 用戶端。

本指南遵循 2026 年 10 月 6 日發布的 BigBlueButton 4.0 管理文件。路徑和部署打包方式可能因版本或託管服務提供者而異。在修改檔案之前，請確認伺服器上已安裝的版本，並先進行備份。

選擇您需要的品牌變更

目標	已記錄的方法	如何檢查
替換 BigBlueButton 預設網頁上的徽標	替換`logo.png`到預設資產目錄中	在隱私瀏覽視窗中開啟伺服器的公共主頁。
在會議中展示徽標	在 HTML5 用戶端設定中啟用品牌識別區域，並`logo`在建立會議時提供圖片 URL。	加入新建立的測試會議，並查看參與者清單上方的區域。
變更顏色、介面文字或其他客戶端設計	基於 BigBlueButton 原始碼建置並部署客製化的 HTML5 用戶端	在支援的桌面和行動瀏覽器上測試完整的會議流程。

伺服器登入頁面徽標和會議內徽標是分開的。替換其中一個不會自動替換另一個。

編輯伺服器之前

您需要擁有修改 BigBlueButton 伺服器的權限才能存取 shell，並且您應該了解主機是由您自己維護還是由託管服務提供者維護。如果伺服器由服務提供者控制，請詢問是否支援自訂品牌，以及是否會在維護期間保留變更。

檢查您已安裝的版本，並將其與對應的BigBlueButton 伺服器自訂指南進行比較。
儲存目前商標和任何您計劃編輯的設定檔副本。
請準備一個清晰的徽標文件，確保其在網站或會議中顯示的尺寸下仍能保持可識別性。文件中並未規定統一的像素尺寸，因此請檢查實際顯示區域，而不要依賴假定的尺寸。
使用會議參與者無需登入即可存取的圖片 URL。建議使用 HTTPS，並在使用前從伺服器外部驗證 URL。

更改預設網頁徽標

BigBlueButton 4.0 的管理指南中指明了預設徽標的位置/var/www/bigbluebutton-default/assets/images/logo.png。這會影響伺服器提供的預設網站，但不會設定 HTML5 會議用戶端中顯示的徽標。

連接到伺服器並確認檔案是否存在於文件指定的路徑。如果路徑不同，請暫停並查看已安裝版本的文檔，而不是隨意將文件複製到猜測的目錄中。
備份現有資產。例如，管理員可以在替換之前，將其複製到同一目錄下的某個帶有日期標記的備份檔案中。安裝替換檔案時，請務必注意原始資產的權限和所有權。
使用檔案名稱將新徽標放置在文件指定的位置logo.png。檢查圖像檔案是否為 PNG 格式，並確保其與頁面背景有足夠的對比。
請在隱私權瀏覽視窗中開啟 BigBlueButton 的公開登入頁面，或清除瀏覽器快取。確認新標記顯示正常，沒有拉伸、裁剪或模糊的情況。

官方指南提供了資源檔案的位置，但並未保證本地替換檔案在每次軟體包更新後都能保留。請將原始文件和替換文件保存在部署記錄中，並在升級後重新檢查登入頁面。如果更新後標誌消失，請將已安裝的檔案與已儲存的資源檔案進行比較，並在查看目前版本說明後再重新套用變更。

在會議中展示徽標

BigBlueButton 官方文件中提供的會議品牌識別選項，會在與會者清單上方的品牌識別區域顯示徽標。但有兩個條件必須滿足：HTML5 用戶端的displayBrandingArea相應設定必須啟用，且會議必須使用logo圖片 URL 建立。僅新增徽標參數無法顯示隱藏的品牌識別區域。

在 HTML5 用戶端配置中，啟用該選項displayBrandingArea。在目前已記錄的安裝中，/etc/bigbluebutton/bbb-html5.yml建議使用本機覆蓋檔案；該檔案中的設定條目會覆寫對應的打包用戶端設定。編輯該檔案時，請保留其他現有的 YAML 值。
請重新啟動 BigBlueButton 以使配置變更生效：sudo bbb-conf --restart。請在合適的維護窗口期間安排此操作，因為重新啟動可能會中斷正在進行的會議。
當您的應用程式或 API 用戶端建立會議時，請在表單中包含自訂參數logo=https://your-domain.example/brand.png。自訂參數的具體輸入位置取決於發送 BigBlueButton/create請求的整合。請遵循該整合的相關說明，並且不要在客戶端程式碼中暴露伺服器的共用金鑰。
建立一個新的測試會議並加入。確認徽標顯示在與會者清單上方，並且對於未登入圖像託管服務的參與者，圖像也能加載。

請參閱官方設定檔參考文檔，以了解建議的覆蓋位置；並參閱 API 參考文檔，以了解建立參數。如果您的伺服器版本不是 4.0，請使用與您的伺服器版本相符的文件。

當您需要進行完整的介面品牌重塑時

會議品牌區域內的標誌與白標會議應用程式並不相同。如果您需要取代介面顏色、標籤或其他內建用戶端元素，BigBlueButton 的常見問題會指導管理員設定開發環境並建立自己的 HTML5 用戶端版本。該專案的品牌常見問題和開髮指南是入門指南。

這條路線需要開發和部署工作。它並非快速的伺服器設置，而且隨著 BigBlueButton 的不斷發展，變更可能需要維護。在投入資源進行自訂建置之前，請詳細記錄哪些螢幕或元素需要更改，並檢查內建的登入頁面或會議徽標選項是否足夠。如果決定進行自訂，請將自訂內容保存在原始程式碼控制系統中，記錄如何重新構建，並在更新到生產環境之前在測試環境中測試升級。

驗證結果並根據症狀進行故障排除。

登入頁面徽標未更改：請確認您已替換活動伺服器bigbluebutton-default資源目錄中的文件，然後繞過瀏覽器快取。如果公共頁面由代理商或獨立入口網站提供服務，請檢查該頁面的擁有者。
會議標誌未顯示：請驗證品牌區域設定是否已啟用、伺服器是否已重新啟動、是否已使用該logo參數建立新會議，以及圖像 URL 是否適用於未經驗證的瀏覽器。
Logo 顯示出來了，但看起來不對勁：請檢查來源影像的比例、透明區域和對比度。調整來源影像，而不是在介面中拉伸它。
部分參與者會看到空白區域：請嘗試從其他網路和裝置測試圖片 URL。防火牆、存取限制、無效的 TLS 憑證或 URL 過期都可能導致參與者的瀏覽器無法載入圖片。
顏色或文字保持不變：伺服器徽標的更換不會改變會議客戶端的外觀。如果這些介面元素必須更改，請使用自訂用戶端開發方案。

判斷是否成功，應考慮結果的位置和一致性：登入頁面應顯示替換標記；新建的測試會議應在已記錄的品牌區域顯示會議徽標；如果您建立了自訂客戶端，則請求的介面變更應在整個加入和會議流程中保持有效。相較之下僅檢查一個快取的瀏覽器標籤頁，小型測試會議是更安全的驗證方式。

BigBlueButton 在配置層面有意限制了品牌客製化選項。內建的徽標方案可以滿足常見的品牌識別需求，而完整的介面重新設計則需要擁有自訂客戶端並進行持續維護。