下面給出 Linux 系統安裝與使用 <span style="color:red">HHDBCS</span> 的可執行方案（適配主流發行版，含命令與解釋、流程圖與要點）。<span style="color:red">HHDBCS</span> 是一款 <span style="color:red">純 Java</span> 的通用數據庫桌面管理工具，支持多數據庫與多架構（x86/ARM），需 <span style="color:red">JDK 1.8+</span> 環境。(dbcs.hhdatabase.com.cn, hhdatabase.com.cn)

一、環境要求與準備

• <span style="color:red">JDK ≥ 1.8</span>（推薦 11/17 LTS）。(dbcs.hhdatabase.com.cn)
• 桌面/圖形會話（本地或遠程），或採用 X11 轉發/Wayland 會話運行 GUI。
• 普通用户運行，避免以 root 啓動。

常用發行版安裝 JDK（擇一）

# Debian/Ubuntu
sudo apt update && sudo apt install -y openjdk-17-jdk
# RHEL/CentOS/AlmaLinux/Rocky
sudo dnf install -y java-17-openjdk
# openSUSE
sudo zypper install -y java-17-openjdk

解釋：分別使用各發行版包管理器安裝 <span style="color:red">OpenJDK 17</span>，滿足 HHDBCS 的 Java 運行依賴（11/17 皆可，17 較新）。安裝完成後可用 java -version 驗證。

二、獲取與部署（無網也可離線）

官方提供 Linux 發行包，解壓即用；以下以 /opt/hhdbcs 為例組織為“系統級”應用目錄。(dbcs.hhdatabase.com.cn, GitHub)

# 1) 準備目錄與賬號
sudo mkdir -p /opt/hhdbcs && sudo chown -R "$USER":"$USER" /opt/hhdbcs

# 2) 將下載得到的 HHDBCS 壓縮包放到 ~/Downloads 後解壓
tar -xf ~/Downloads/HHDBCS-*.tar.gz -C /opt/hhdbcs --strip-components=1

# 3) 可選：校驗完整性（若提供校驗文件）
cd /opt/hhdbcs && sha256sum -c HHDBCS-*.sha256

# 4) 創建啓動器（方便 PATH 調用）
printf '%s\n' '#!/usr/bin/env bash' 'exec java -Xms512m -Xmx2g -jar /opt/hhdbcs/hhdbcs.jar "$@"' | sudo tee /usr/local/bin/hhdbcs >/dev/null
sudo chmod +x /usr/local/bin/hhdbcs

解釋：

• 步驟1：創建程序目錄，並把所有權授予當前用户，便於後續維護；
• 步驟2：將官方壓縮包解壓到目標目錄；--strip-components=1 去掉最外層目錄；
• 步驟3：如有 <span style="color:red">SHA256</span> 文件則進行校驗，防止包損壞；
• 步驟4：寫入簡易啓動腳本 hhdbcs，統一用 <span style="color:red">Java</span> 運行主 <span style="color:red">JAR</span>（包名以實際文件為準）。

三、首次啓動與界面

# 直接啓動
hhdbcs
# 或指定 JDK 路徑啓動（多 JDK 並存時）
/usr/lib/jvm/java-17-openjdk/bin/java -Xms512m -Xmx2g -jar /opt/hhdbcs/hhdbcs.jar

解釋：

• 第一行：調用前面創建的啓動器；
• 第二行：當系統存在多個 Java 版本時，顯式使用特定 JDK 啓動，避免兼容性問題。

HHDBCS 提供標準/高級等多視圖、對象樹、SQL 查詢器、監控、快捷命令器等功能，適配不同角色。(dbcs.hhdatabase.com.cn)

四、連接數據庫（以 MySQL / PostgreSQL / Oracle 為例）

1. 打開 <span style="color:red">新建連接</span> → 選擇數據庫類型。
2. 填寫 <span style="color:red">主機/端口/數據庫/用户名/密碼</span>。
3. 測試連接並保存。

若個別數據庫（如 Oracle）因許可證原因不內置 JDBC 驅動，請在連接嚮導中“選擇驅動 JAR”並指向本地 <span style="color:red">ojdbc8.jar</span> 等驅動文件，再測試連接。這一做法與通行的 JDBC 裝載方式一致。(dbcs.hhdatabase.com.cn, Opensource.com, IBM)

可選：集中放置第三方驅動

mkdir -p ~/.hhdbcs/drivers
# 示例：把 Oracle 驅動置於自定義目錄，連接嚮導中手動選取該 JAR
cp ~/Downloads/ojdbc8.jar ~/.hhdbcs/drivers/

解釋：

• 創建用户級驅動目錄，便於統一管理；
• 連接時在 UI 中指向該 JAR，HHDBCS 會按所選驅動初始化 JDBC 連接。

五、常用操作與排錯

# A. 查看 Java 版本與路徑
which java && java -version

# B. 若 GUI 無法啓動（遠程服務器）
echo $XDG_SESSION_TYPE  # 確認 X11/Wayland
# 使用 SSH X11 轉發示例
ssh -X user@server hhdbcs

# C. 日誌/臨時文件清理（依據解壓目錄結構）
find /opt/hhdbcs -type f -name "*.log" -size +50M

解釋：

• A：驗證 JDK 是否可用；
• B：服務器端一般需圖形轉發或桌面會話；
• C：定位大體積日誌，便於清理與歸檔。

六、快速對照表（vditor/Markdown）

七、安裝—使用流程圖（vditor/mermaid）

flowchart TD
  A[檢查JDK(>=1.8)] --> B[下載並解壓HHDBCS到/opt/hhdbcs]
  B --> C[創建hhdbcs啓動器/驗證SHA256]
  C --> D[啓動程序並選擇視圖]
  D --> E[新建連接: 主機/端口/庫/賬號]
  E --> F{是否需要外部JDBC?}
  F -- 是 --> G[在嚮導中選JAR(如ojdbc8.jar)]
  F -- 否 --> H[直接測試並保存]
  G --> H
  H --> I[執行SQL/對象管理/監控/任務]

八、實用小貼士

• 按需設置 JVM 內存（-Xms/-Xmx），大型數據集建議 <span style="color:red">2\~4GB</span>；
• JDBC 驅動儘量與數據庫版本匹配，避免奇怪異常；
• 使用普通用户啓動，權限最小化，避免誤改系統目錄；
• ARM 設備可直接使用（已在 ARM 場景測試過）。(dbcs.hhdatabase.com.cn)

以上步驟即能在 Linux 上完成 <span style="color:red">HHDBCS</span> 的安裝、啓動與連接配置；如需更深入的功能説明（如“數據庫任務”“快捷命令器”等），可在應用內的幫助/社區文檔中查看對應模塊説明。(dbcs.hhdatabase.com.cn, GitHub)