Jira安装及配置的核心结论是：多数中小团队选择Server版自托管，按“环境准备数据库安装包系统配置跑通验证”五步走，半小时内可完成，但数据库连接和授权文件这两步最容易卡住。
jira安装教程2026：先搞清你到底该装哪个版本
动手之前,先别急着下载，Jira家族分Cloud（云托管）和Server/Data Center（自托管），2026年这个节点，Atlassian已经停止Server版的新销售，只对既有许可证提供维护，如果你是新用户，想省事就上Cloud，数据放别人机房；如果团队对数据敏感、有合规要求，或者网络环境不允许连外网，那还是得走Data Center或找第三方代理。
Jira安装和配置的两种核心路径对比
- Cloud版：不需要安装，注册即用，官方帮你维护升级，按用户数订阅付费，适合50人以下、没有运维的团队。
- Data Center版：下载安装包自己部署，需要准备Java环境、数据库、反向代理，适合200人以上或对可用性有要求的组织。
- 第三方商业版（如Jira Align、极狐Jira）：国内一些厂商做二次分发，价格更灵活，但升级路径和插件兼容性要额外确认。
行业共识认为,大部分国内企业在Jira安装及配置调研阶段，最终选型会纠结在Cloud合规性和Data Center成本之间，据公开信息，Atlassian官方定价中，Data Center的入门门槛在200用户档位，少于这个规模买Server或Cloud更划算。
环境准备：内存、JDK、数据库一个都不能少
这一步决定你后续Jira安装及配置流程顺不顺畅,建议准备一台至少4核CPU、8GB内存的Linux服务器（CentOS 7+或Ubuntu 20.04+），硬盘留出50GB以上空间，Jira的索引和附件增长比你想象得快。
JDK版本怎么选
Jira 9.x系列要求Java 11或Java 17，别装Java 8，启动直接报错，用以下命令安装OpenJDK：
sudo yum install java-11-openjdk -y java -version
看到openjdk version “11.x.x”就说明环境没问题，如果你公司已有Nginx，后面配置反向代理时记得把端口映射好。
数据库：MySQL还是PostgreSQL
- MySQL 5.7/8.0：国内使用率最高，遇到问题百度能找到一堆踩坑帖。
- PostgreSQL 12+：Atlassian官方更推荐，事务处理更稳，但国内运维熟悉度稍低。
创建数据库时,字符集务必指定utf8，否则中文显示乱码：
CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
数据库连接驱动方面,MySQL需要把mysql-connector-java-8.x.jar放到Jira安装目录的lib文件夹里再启动，这一步漏了，配置向导里测试连接永远报“找不到驱动”。
jira安装包下载与破解授权边界
官方安装包在Atlassian官网下载,但国内直连速度很慢，多数人会找国内镜像站，这里提醒一句：下载后先校验MD5，避免下到带后门的修改版。
安装过程分三步走
-
解压到
/opt/atlassian/jira，确保当前用户对目录有写权限:tar -zxvf atlassian-jira-software-9.x.tar.gz -C /opt/atlassian chown -R jira:jira /opt/atlassian/jira
-
修改
jira-software-standalone/bin/setenv.sh，把JVM_MINIMUM_MEMORY和JVM_MAXIMUM_MEMORY设为1024m和4096m，内存太小的话用几天就会频繁Full GC。 -
浏览器访问
http://服务器IP:8080，进入图形化配置向导，填数据库连接信息和应用属性（比如站点标题、Base URL）。
授权文件那点事
试用授权30天,过期后界面会锁死。不建议用网上流传的无限试用脚本，有安全风险且可能被官方检测封IP，预算有限的团队，可以考虑购买国内代理商的Data Center授权，单机部署时比官方价便宜不少。
配置核心参数：JVM、反向代理与邮件通知
Jira安装及配置完成后,跑起来只是第一步，调优才是关键。
内存参数在哪里改
编辑/opt/atlassian/jira/bin/setenv.sh，找到这行：
JVM_SUPPORT_RECOMMENDED_ARGS="-Xms4096m -Xmx4096m"
堆内存不要超过物理内存的50%，但要留足给操作系统和MySQL，同时确认-XX:+UseG1GC在参数里，G1垃圾回收器在处理Jira这种“大量小对象、频繁创建索引”的场景比CMS强很多。
Nginx反向代理配置
如果想要通过域名访问且走HTTPS,在/etc/nginx/conf.d/jira.conf写入：
server {
listen 80;
server_name jira.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
重点：Jira系统设置里的“Base URL”必须改成https://jira.example.com，否则邮件通知里的链接全是IP加8080端口，点不进去。
邮件SMTP设置
在“管理→系统→外发邮件”里配置SMTP服务器时，国内企业常用腾讯企业邮或阿里企业邮。多数情况下，不要开TLS加密，端口用465或587取决于邮件服务商，填错的话测试邮件发不出去，日志里会看到Connection reset错误。
常见卡壳场景：jira配置完成后登录不了怎么办
这是搜索量非常高的场景词,我自己部署时，在浏览器里看到登录页却无法登录的情况遇到过三次，分别排查如下：
数据库连接失败或权限不足
- 错误表现：配置向导最后一步提示“无法创建数据源”
- 解决思路：用命令行
mysql -ujira -p -h127.0.0.1 test验证账号能否远程登录，注意Jira默认通过TCP连接，MySQL的bind-address要设成0.0.0，并且账号的host不能是localhost。
端口被占用或防火墙拦截
- 错误表现：页面一直转圈，浏览器控制台报
ERR_CONNECTION_TIMED_OUT - 解决思路：先
netstat -lntp | grep 8080看进程是否在监听，再检查云安全组和服务器firewall-cmd --list-ports，国内云厂商的安全组规则经常漏放8080，这个坑概率很大。
插件兼容性引发的白屏
- 错误表现：安装完第三方插件后重启，HTTP 500，日志里有
NoClassDefFoundError - 解决思路：进入
/opt/atlassian/jira/plugins目录，把最近添加的.jar文件移走重启即可。Jira安装及配置好后，不要急着装一堆插件，先跑两星期再生产环境使用，这是减少维护量的最佳路径。
日常运维要点与备份还原
备份策略
Jira安装及配置之后,备份是保命手段，官方推荐使用
jira-config.properties里配置的备份路径，但更稳妥的方式是直接备份/var/atlassian/application-data/jira目录，同时用mysqldump备份数据库：
mysqldump -ujira -p --single-transaction jiradb > /backup/jiradb_$(date +%F).sql
备份文件建议存到异地或者对象存储，服务器磁盘坏了还有回旋余地。
升级路线注意事项
从9.4升级到9.12时，会要求先升级到9.8过渡版本，如果你跳过中间大版本，直接覆盖安装可能导致数据库结构不兼容，升级前先备份，且升级过程中不能有用户在线操作。
Q&A：关于jira安装需要多大内存及配置的疑问
问题1：Jira安装需要多大内存？
8GB起步,如果并发用户超过30人，建议16GB，内存不足时系统变慢最明显的特征是点击看板卡顿、索引重建失败，不由地让人怀疑是CPU瓶颈，但其实看后台top命令会发现Java进程内存占用接近上限。
问题2：jira配置完成后登录不了，提示“远端服务器返回错误: (401) 未经授权。”，是哪里出了问题？
根本原因是Jira Base URL或认证方式配置不一致，导致回跳地址被判定为非法来源。 解决办法：直接编辑jira-software-standalone/conf/server.xml，将<Context>标签内的path=""和docBase路径与安装目录匹配，然后重启，如果用的是Jira Service Management的客户门户，确认“系统设置→通用设置”里的服务器基础URL使用了公网可访问的地址，而不是localhost。
问题3：服务器上已经装了MySQL 5.7，但配置向导总报“数据库版本不受支持”，还能继续吗？
临时绕过方案是修改Jira启动参数，加入-Datlassian.database.class=com.atlassian.jira.ofbiz.DatabaseFactory强制兼容模式，但这只适用于测试环境。 生产环境不建议这样干，官方其实从Jira 9.x开始才正式支持MySQL 8.0，5.7在运行一段时间后，jiraissue表的数据量上来，慢查询会把数据库拖垮，最稳妥的做法是调用mysqldump迁移到MySQL 8.0，注意导出加上--default-character-set=utf8mb4参数。