升级须知

v3 版本与 v2 版本存在一定的差异,如需 v2 版本升级至 v3 版本 请先阅读此文档

v2.20 =< Version <= v2.23 之间的版本需先升级到 v2.28 版本,再升级到 v3 版本,否则会出现资产连接失败的问题

注意

v3.6 版本为了安全,要求强制填写 DOMAINS 可信任域名才能正常访问服务,否则会提示错误码 400/403 导致无法无法访问页面,DOMAINS 配置如下。

  • 如果服务器是一键安装并且旧版本就已经使用 JumpServer 开启了 HTTPS,则不需要进行任何更改。
  • 需要使用 IP 地址来访问 JumpServer 的场景,可以根据自己的 IP 类型来填写 config.txt 配置文件中 DOMAINS 字段为公网 IP 还是内网 IP。
  1. # 打开config.txt 配置文件,定义 DOMAINS 字段
  2. vim /opt/jumpserver/config/config.txt
  3. # 可信任 DOMAINS 定义,
  4. # 定义可信任的访问 IP, 请根据实际情况修改, 如果是公网 IP 请改成对应的公网 IP。
  5. # DOMAINS="demo.jumpserver.org" # 使用域名访问
  6. # DOMAINS="172.17.200.191" # 使用 IP 访问
  7. # DOMAINS="demo.jumpserver.org,172.17.200.191" # 使用 IP 和 域名一起访问
  8. DOMAINS=
  9. # 重启 JumpServer 服务生效
  10. jmsctl restart

在进行升级或者迁移操作前,请先做好备份工作

注意

环境说明

  • 从 v2.5 版本开始,要求 MySQL Server >= 5.7
  • 从 v2.6 版本开始,要求 Redis Server >= 6.0
  • 推荐使用外置 DB Server 和 Redis Server,方便日后扩展升级

外置数据库要求

名称版本
MySQL>= 5.7
MariaDB>= 10.6
Redis>= 6.0