mirror of
https://github.com/acepanel/acepanel.github.io.git
synced 2026-02-04 20:37:20 +08:00
112 lines
2.1 KiB
Markdown
112 lines
2.1 KiB
Markdown
# Java 專案
|
||
|
||
Java 專案用於部署 Spring Boot、Tomcat 等 Java 應用。
|
||
|
||
## 前置要求
|
||
|
||
1. 安裝 Java 執行環境：**應用** > **執行環境** > **Java**（Corretto JDK）
|
||
2. 打包好的 JAR 檔案或 WAR 檔案
|
||
|
||
## 部署 Spring Boot 應用
|
||
|
||
### 打包專案
|
||
|
||
```bash
|
||
# Maven
|
||
mvn clean package -DskipTests
|
||
|
||
# Gradle
|
||
./gradlew build -x test
|
||
```
|
||
|
||
### 上傳並部署
|
||
|
||
1. 上傳 JAR 檔案到伺服器（如 `/opt/ace/project/myapp/app.jar`）
|
||
2. 建立專案：
|
||
- **專案名**：`myapp`
|
||
- **專案目錄**：`/opt/ace/project/myapp`
|
||
- **啟動命令**：`java21 -jar app.jar`
|
||
3. 開啟 **反向代理**
|
||
|
||
## 啟動命令範例
|
||
|
||
```bash
|
||
# 基本啟動
|
||
java21 -jar app.jar
|
||
|
||
# 指定配置檔案
|
||
java21 -jar app.jar --spring.profiles.active=prod
|
||
|
||
# 設定 JVM 參數
|
||
java21 -Xms512m -Xmx1024m -jar app.jar
|
||
|
||
# 指定連接埠
|
||
java21 -jar app.jar --server.port=8080
|
||
```
|
||
|
||
## JVM 參數建議
|
||
|
||
```bash
|
||
# 生產環境推薦配置
|
||
java21 \
|
||
-Xms512m \
|
||
-Xmx1024m \
|
||
-XX:+UseG1GC \
|
||
-XX:MaxGCPauseMillis=200 \
|
||
-jar app.jar
|
||
```
|
||
|
||
常用參數說明：
|
||
|
||
| 參數 | 說明 |
|
||
| ---------------------- | ----------- |
|
||
| `-Xms` | 初始堆積記憶體大小 |
|
||
| `-Xmx` | 最大堆積記憶體大小 |
|
||
| `-XX:+UseG1GC` | 使用 G1 垃圾收集器 |
|
||
| `-XX:MaxGCPauseMillis` | 最大 GC 停頓時間 |
|
||
|
||
## 多版本 JDK
|
||
|
||
AcePanel 支援安裝多個 JDK 版本，路徑如 `/opt/ace/server/java/{version}/bin/java`，已預設連結 `java{version}` 命令方便使用。
|
||
|
||
## 配置檔案
|
||
|
||
Spring Boot 配置檔案 `application.yml` 範例：
|
||
|
||
```yaml
|
||
server:
|
||
port: 8080
|
||
|
||
spring:
|
||
datasource:
|
||
url: jdbc:mysql://localhost:3306/mydb
|
||
username: root
|
||
password: your_password
|
||
```
|
||
|
||
## 常見問題
|
||
|
||
### 記憶體不足
|
||
|
||
增加 JVM 堆積記憶體：
|
||
|
||
```bash
|
||
java21 -Xms1g -Xmx2g -jar app.jar
|
||
```
|
||
|
||
### 連接埠衝突
|
||
|
||
修改啟動連接埠：
|
||
|
||
```bash
|
||
java21 -jar app.jar --server.port=8081
|
||
```
|
||
|
||
### 啟動慢
|
||
|
||
檢查是否有外部依賴連線逾時，或新增以下參數加速啟動：
|
||
|
||
```bash
|
||
-XX:TieredStopAtLevel=1 -noverify
|
||
```
|