---

大家好，我是尤娜博客(una-boot)的作者樹下魅狐，自2019年9月una-boot-1.0.0版本開源以來，陸續有熱愛技術，鐘愛技術寫作的小伙伴為尤娜提出了寶貴的改進意見和建議，在此表示衷心的感謝，謝謝大家的支持！

簡介

? 尤娜(una-boot)是一款基于Spring Boot 2.0構建的國產Java博客系統，在此之前，我不斷的嘗試使用過不同的博客系統，如基于PHP的WordPress、基于Node.js的靜態博客系統Hexo、基于Java的CMS系統JEECMS和MCMS等，這些系統都有著不錯的表現，能夠滿足絕大多數的需求場景。那問題來了，我為什么還要重復性的造一個“輪子”呢？一個簡單的比喻，前面提到的系統都很強大，有的像“卡車輪子”，有的像“坦克履帶”，有的像“跑車輪子”,它們的性能，功能都很強大。然而，作為一個經常寫博客文章的我，我現在需要的是小巧的“電摩輪子”。基于這樣的一個需求，也參考了上述諸多優秀CMS系統的設計，站在“巨人”的肩膀上，完成了尤娜博客系統的設計和開發。

? 尤娜的初衷是提供一個極簡的內容創作平臺，給熱愛技術，熱愛寫作的小伙伴一個簡潔，易用的寫作軟件。因此，尤娜博客系統在設計之初就只保留了一個博客網站最核心的幾個功能模塊，它們分別是欄目、文章、主題、友鏈、標簽、歸檔、存儲和評論，共計八個主要核心功能。為了盡可能的降低尤娜的使用門檻，尤娜基于Freemarker模板引擎開發了一套內置的博客標簽，通過使用這些標簽，對于不能熟練使用Java編程語言的小伙伴，也能快速的構建出一套漂亮的博客主題。尤娜會自動根據各類標簽加載對應的博客數據，完成主題的渲染。

? 由于抗擊疫情以及工作的原因，原定于2020年1月份上線una-boot-1.2.0版本的計劃推遲到了3月份。在una-boot-1.2.0版本中，新增了在線安裝并初始化博客的功能，免去了部署系統是來回修改配置文件的復雜過程。在新版本中，尤娜使用了動態數據源切換技術，系統安裝完成后，不需要再重啟Apache Tomcat，尤娜會自動切換到博主指定的數據源上。接下來，我將簡要介紹una-boot-1.2.0版本的大致情況。

主要特點

• 完全開源：基于AGPL-3.0協議開源
• 快速初始化：通過安裝向導，快速完成站點初始化工作
• 標簽化建站：尤娜內置了內容標簽和內容函數，可以快速的完成模板的制作
• 多主題：支持多個主題自由切換，快速改變站點風格，而不需重新編譯后臺代碼
• Markdown支持: 內置markdown編輯器
• 文件存儲：支持本地存儲和CDN存儲
• 評論支持：內置了Gitalk評論函數，只需設置相關的Gitalk參數即可擁有評論功能
• Spring Boot: 基于Spring Boot 2.0版本進行構建

開發環境

? 建議您使用下面推薦的環境與尤娜玩耍，以避免版本不一致所帶來的困擾

• OS: Windows 7/10,Linux
• IDE: Eclipse，IntelliJ IDEA(推薦)
• DB：MySQL 5.6+
• JDK: JDK8+
• Web Server: Apache Tomcat 8+
• Maven: Maven 3.0+

技術框架

尤娜所使用的開發框架明細：

快速開始

? 你可以按照下列的方式來獲取并運行尤娜博客系統。

獲取源代碼

? 你可以使用git工具從Github或者Gitee上獲取尤娜博客最新的源代碼：

git clone https://github.com/ramostear/UnaBoot-Pro.git

git clone https://gitee.com/ramostear/UnaBoot-Pro.git

除此之外，我還提供了可在Tomcat中運行的war包，你可以訪問https://gitee.com/ramostear/UnaBoot-Pro/releases/una-boot-v1.2.0或者https://github.com/ramostear/UnaBoot-Pro/releases/tag/una-boot-v1.2.0 下載最新的war到本地運行。

編譯源代碼

? 如果你是直接下載項目war包，請跳過此步驟。代碼克隆到本地后，你可以使用命令行工具或者IDEA對項目源碼進行編譯，命令如下：

mvn compile -Dmaven.test.skip=true

待項目編譯完成后，便可執行打包操作。

注意：

如果使用IDE自帶的Maven工具對項目進行編譯時，請檢查你的IDE是否安裝了Lombok插件，如果缺少Lombok插件，項目編譯將會失敗。

項目打包

? 項目編譯完成后，需要對項目進行打包才能運行，如果你使用的是IntelliJ IDEA或者STS等工具，可以直接運行UnaBootProApplication.java文件中的main()方法來啟動項目。如果你想將項目放到外部的Tomcat中運行，請參照下面的打包命令：

mvn clean package -Dmaven.test.skip=true

打包成功后，你可以在項目的target目錄中找到一份名為una-boot-pro-1.2.0.war的文件包，此文件就是運行項目的最終文件。

啟動項目

? 將打包好的或者下載的una-boot-pro-1.2.0.war文件拷貝到Apache Tomcat安裝目錄下的webapps目錄中，然后啟動Apache Tomcat。

注意：

尤娜博客系統需要在Apache Tomcat 8及以上的版本中運行

Apache Tomcat啟動完成后，在瀏覽器中按照下列的格式輸入訪問地址并訪問

http://[localhost|127.0.0.1]:[8080/你自己的tomcat端口號]/una-boot-pro-1.2.0/unaboot/install.html

提示

如果是第一次啟動并訪問尤娜博客系統，請在MySQL數據庫管理系統中創建一個空的數據庫，該數據庫在的名稱在初始化博客時需要使用。如本次演示所使用的db_una_boot_pro_demo.

安裝并初始化尤娜

安裝向導

? 以我在本地演示為例，瀏覽器中輸入http://localhost:8080/una-boot-pro-1.2.0/unaboot/install.html ,訪問成功后，你將看到入下的安裝向導界面：

請閱讀UnaBoot的許可協議，并勾選同意按鈕后，點擊“下一步”按鈕，填寫數據庫相關的信息。

數據庫信息

? 閱讀完許可協議并同意后，你可進入數據庫配置界面。在此界面中，你需要提供MySQL數據的主機地址(例如localhost或127.0.0.1)，數據庫的端口號(默認端口號為3306)，存儲尤娜博客數據的數據庫名稱(例如在上一步中創建的db_una_boot_pro_demo數據庫)，數據庫的訪問賬號以及訪問密碼。

網站信息

? 在完成數據庫配置后，你可以進入站點信息配置界面，配置站點的名稱，站點域名，管理員賬號以及管理員登錄密碼，界面如下：

信息確認無誤后，點擊“確認”按鈕，開始初始化博客系統。

提示

請牢記你的站點管理員賬號和密碼

系統初始化成功后，你將收到如下的系統提示信息：

點擊“確定”按鈕，系統將跳轉到后臺登錄頁面，輸入此前配置的管理員賬號和密碼，登錄系統后臺。

自此，整個博客的初始化工作完成。接下來，你可以使用自己的管理員賬號和密碼登錄尤娜博客后臺，對博客系統進行管理。

重要提示

如果你在安裝初始化的過程中，沒能成功初始化系統，請檢查war包中的WEB-INF/lib/目錄下有無ibatis-common-2.2.0.jar文件，如果沒有，請將WEB-INF/lib-provided/目錄下的ibatis-common-2.2.0.jar文件拷貝到WEB-INF/lib/目錄中，然后重啟Apache Tomcat。

尤娜博客后臺管理系統一覽

? 在此小結中，我將對尤娜博客后臺管理系統做一個簡要的介紹。

后臺主頁

? 博客后臺主頁不要包括了常用功能的快捷入口，如文檔地址，接口地址，寫作入口，欄目管理入口，網站設置入口，主題管理入口，全文檢索設置按鈕，緩存清理按鈕等。界面如下：

尤娜后臺管理系統將功能分為了三個板塊，分別時內容管理，配置管理和系統管理，下面將分別介紹。

內容管理

? 內容管理板塊包含了用戶管理，欄目管理，博客管理，主題管理，友鏈管理和標簽管理，其相應的界面如下：

配置管理

? 配置管理板塊主要包括網站常規配置(如站點名稱，域名，描述，關鍵詞，Logo，Favicon，郵箱，備案號，主題等)，存儲配置(分為本地存儲或七牛云存儲),評論配置(關閉評論或開啟Gitalk評論插件)。

系統管理

? 系統管理主要時針對尤娜博客的系統級別的管理，包括定時任務管理，API管理，系統實時日志管理和Druid監控。