跳至主要内容

AppFuse 應用系統部署指南

本文件提供基於 AppFuse 框架建構的應用系統之建構、安裝、配置及管理指引。

架構總覽​

本系統採用前後端分離架構，所有模組皆以 WAR 檔案部署於 Apache Tomcat 環境：

模組說明​

模組技術棧說明
app-serverSpring Boot 4.0.1 + JDK 25後端 RESTful API
app-web-hostReact 19 + TypeScript + Vite前台 SPA（封裝為 WAR 部署）

快速開始​

建構與部署流程​

  1. 建構：參閱 建構指南
  2. 安裝：參閱 安裝指南
  3. 配置：參閱 配置說明

安裝媒體​

建構完成後應具備：

檔案說明
app-server.war後端 API 模組
app-web-host.war前台 SPA 模組（含靜態託管層）
application.properties配置檔範本

文件導覽​

主要文件​

文件說明
建構指南如何建構部署檔案
系統需求軟硬體需求、前置準備
安裝指南Tomcat + Nginx 部署步驟（Ubuntu）
配置說明後端、前端、資料庫配置
維運管理啟動停止、監控、備份還原
故障排除常見問題與解決方案
系統安裝與管理手冊系統安裝、配置與管理指南 (客戶交付版本)

附錄​

文件說明
MySQL 安裝Ubuntu 上 MySQL 完整安裝配置
Windows 安裝Windows Server 部署指南
維運工具Screen、tmux、Glances 等工具

版本資訊​

元件版本判定依據
Spring Boot4.0.1app-server/build.gradle.kts
Java25app-server/build.gradle.kts
Apache Tomcat11.0.xSpring Boot 4.0 → Jakarta EE 11 → Servlet 6.1 → Tomcat 11.0+
React19.xapp-web/package.json
Node.js22.x（建構用）app-web/package.json
Nginx1.26+原廠支援週期，穩定版每年 4 月更替

版本更新原則：Spring Boot、Java、React、Node.js 版本以原始碼建構檔為準。Tomcat 版本由 Spring Boot 所需的 Jakarta Servlet 版本決定（參考 Apache Tomcat 版本對照）。Nginx 版本以原廠仍在提供安全更新的穩定版為最低要求。

相關資源​