架構規劃
- JDK: Oracle JDK 11 / 17 (LTS) 或 OpenJDK,Jira 9.x 需 JDK 11/17
- 數據庫: MySQL 8.0 / PostgreSQL 13+ (官方推薦 PostgreSQL),字符集 utf8mb4、排序規則 utf8mb4_bin
- 應用服務器: Jira 內嵌 Tomcat (Standalone 版),無需單獨安裝 Tomcat
- 反向代理: Nginx 終結 SSL、靜態資源緩存、限流
- 專用用戶: `jira` 用戶運行服務,最小權限原則
步驟 1:創建專用用戶與目錄
groupadd -r jira
useradd -r -g jira -d /opt/jira -s /bin/bash -m jira
mkdir -p /opt/jira/data # Jira Home 目錄 (數據、索引、附件、日誌)
chown -R jira:jira /opt/jira
步驟 2:安裝 JDK 17 (以 OpenJDK 為例)
# RHEL 系
dnf install -y java-17-openjdk java-17-openjdk-devel
# Debian 系
apt-get update && apt-get install -y openjdk-17-jdk
# 驗證
java -version
# 設置 JAVA_HOME (全局)
cat > /etc/profile.d/java.sh <<'EOF'
export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))
export PATH=$JAVA_HOME/bin:$PATH
EOF
source /etc/profile.d/java.sh
步驟 3:安裝並配置 MySQL 8.0
# 安裝 (RHEL 9 示例)
dnf install -y @mysql:8.0/server
systemctl enable --now mysqld
# 安全初始化
mysql_secure_installation
# 設置 root 密碼、移除匿名用戶、禁止 root 遠程登錄、移除 test 库
# 創建 Jira 數據庫與用戶
mysql -u root -p
CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'jira'@'localhost' IDENTIFIED BY 'StrongPassword123!';
GRANT ALL PRIVILEGES ON jiradb.* TO 'jira'@'localhost';
FLUSH PRIVILEGES;
EXIT;
步驟 4:安裝 Jira (Standalone 版)
# 1. 下載 (官網需登錄,此處示例鏈接)
cd /tmp
wget -O jira.bin "https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-9.12.0-x64.bin"
chmod +x jira.bin
# 2. 以 jira 用戶運行安裝向導 (圖形/控制台模式)
su - jira
./jira.bin
# 選擇: Custom Install
# 安裝目錄: /opt/jira/app (默認)
# 數據目錄: /opt/jira/data (預創建)
# 端口: HTTP 8080, Control 8005 (避開衝突)
# 作為服務安裝: Yes (生成 systemd unit)
# 3. 安裝完成後,修改 server.xml 配置數據庫 (若向導未完成)
# /opt/jira/app/conf/server.xml
# 在 內添加 :
#
#
#
# 4. 複製 MySQL 驅動到 lib
cp /usr/share/java/mysql-connector-java.jar /opt/jira/app/lib/
# 或下載: wget -P /opt/jira/app/lib/ https://repo1.maven.org/maven2/com/mysql/mysql-connector-j/8.0.33/mysql-connector-j-8.0.33.jar
步驟 5:配置 JVM 參數 (關鍵性能調優)
# /opt/jira/app/bin/setenv.sh (或 setenv.bat)
# 根據物理內存設置 (建議 Heap 不超過物理內存 50%,留給 OS、Lucene 索引、緩存)
# 示例 8GB 內存服務器:
JVM_MINIMUM_MEMORY=2g
JVM_MAXIMUM_MEMORY=4g
JVM_RESERVED_CODE_CACHE_SIZE=512m
# GC 策略 (JDK 11+ 推薦 G1)
JVM_SUPPORT_RECOMMENDED_ARGS="
-XX:+UseG1GC
-XX:MaxGCPauseMillis=200
-XX:+ParallelRefProcEnabled
-XX:+UnlockExperimentalVMOptions
-XX:-OmitStackTraceInFastThrow
-Djava.awt.headless=true
-Datlassian.plugins.enable.wait=300
"
# 關鍵:設置 Jira Home
export JIRA_HOME="/opt/jira/data"
步驟 6:Systemd 服務管理
# 安裝向導已生成 /etc/systemd/system/jira.service
# 內容示例:
[Unit]
Description=Atlassian Jira
After=network.target mysqld.service
Requires=mysqld.service
[Service]
Type=forking
User=jira
Group=jira
Environment=JIRA_HOME=/opt/jira/data
PIDFile=/opt/jira/app/work/catalina.pid
ExecStart=/opt/jira/app/bin/start-jira.sh
ExecStop=/opt/jira/app/bin/stop-jira.sh
TimeoutStartSec=300
TimeoutStopSec=60
LimitNOFILE=65536
LimitNPROC=32768
[Install]
WantedBy=multi-user.target
# 重載並啟動
systemctl daemon-reload
systemctl enable --now jira
systemctl status jira -l
步驟 7:Nginx 反向代理 + SSL (Let's Encrypt)
# /etc/nginx/conf.d/jira.conf
upstream jira {
server 127.0.0.1:8080;
keepalive 32;
}
server {
listen 80;
server_name jira.example.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
server_name jira.example.com;
ssl_certificate /etc/letsencrypt/live/jira.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/jira.example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
client_max_body_size 100M; # 附件上傳大小
proxy_read_timeout 300s;
proxy_send_timeout 300s;
location / {
proxy_pass https://jira;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
# 靜態資源緩存
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
proxy_pass https://jira;
expires 30d;
add_header Cache-Control "public, immutable";
}
}
步驟 8:許可證導入與首次啟動向導
- 瀏覽器訪問 `https://jira.example.com`
- 選擇 "I'll set it up myself" → Database: MySQL → 填寫 JDBC 連接信息 (若 server.xml 已配置則自動檢測)
- 導入許可證 (License Key) 或生成評估許可證
- 設置管理員賬號、郵件服務器、語言、時區
- 完成安裝
常見故障排查
| 故障 | 排查方向 |
| 啟動卡在 "Starting Jira" / 端口佔用 | `netstat -tlnp | grep 8080`、`lsof -i:8005`、`kill -9 PID`、修改 server.xml 端口 |
| 數據庫連接失敗 | 驅動 jar 是否在 lib/、URL 參數 (useSSL, serverTimezone)、用戶權限、防火牆 3306 |
| JIRA has been locked (.jira-home.lock) | `find /opt/jira/data -name '.jira-home.lock' -delete` 後重啟 |
| 內存溢出 (OOM) / GC 頻繁 | 調大 Heap、啟用 G1GC、檢查大附件/索引重建、升級實例規格 |
| 附件上傳失敗 | Nginx client_max_body_size、Jira 附件大小限制 (管理 → 系統 → 附件)、磁盤空間 |
| 中文亂碼 | 數據庫 utf8mb4_bin、JVM -Dfile.encoding=UTF-8、URL characterEncoding=utf8mb4 |
備份與升級策略
- 每日備份: 數據庫 `mysqldump --single-transaction jiradb > backup.sql` + Jira Home 目錄 `/opt/jira/data` (排除 `log/`, `export/`, `caches/`)。
- 升級前: 閱讀 Release Notes、測試環境驗證、完整備份、關閉應用、運行升級安裝包 (覆蓋安裝目錄)、啟動驗證。
- 零停機升級: Jira Data Center 版支援滾動升級,Server 版需停機。