安装文档

说明

全新安装的 Linux
需要连接 互联网
使用 root 用户执行

可以使用由 华为云 提供的容器镜像服务 ❤

区域镜像仓库地址配置文件 /opt/jumpserver/config/config.txt
华北-北京一swr.cn-north-1.myhuaweicloud.comDOCKER_IMAGE_PREFIX=swr.cn-north-1.myhuaweicloud.com
华北-北京四swr.cn-north-4.myhuaweicloud.comDOCKER_IMAGE_PREFIX=swr.cn-north-4.myhuaweicloud.com
华南-广州swr.cn-south-1.myhuaweicloud.comDOCKER_IMAGE_PREFIX=swr.cn-south-1.myhuaweicloud.com
华东-上海一swr.cn-east-3.myhuaweicloud.comDOCKER_IMAGE_PREFIX=swr.cn-east-3.myhuaweicloud.com
亚太-香港swr.ap-southeast-1.myhuaweicloud.comDOCKER_IMAGE_PREFIX=swr.ap-southeast-1.myhuaweicloud.com
亚太-新加坡swr.ap-southeast-3.myhuaweicloud.comDOCKER_IMAGE_PREFIX=swr.ap-southeast-3.myhuaweicloud.com

安装方式

外置环境要求

  • 推荐使用外置 数据库 和 Redis, 方便日后扩展升级
DBVersionCacheVersion
MySQL>= 5.7Redis>= 6.0
MariaDB>= 10.2

自动部署

  1. # 默认会安装到 /opt/jumpserver-installer-v2.12.1 目录
  2. curl -sSL https://github.com/jumpserver/jumpserver/releases/download/v2.12.1/quick_start.sh | bash

手动部署

  1. cd /opt
  2. wget https://github.com/jumpserver/installer/releases/download/v2.12.1/jumpserver-installer-v2.12.1.tar.gz
  3. tar -xf jumpserver-installer-v2.12.1.tar.gz
  4. cd jumpserver-installer-v2.12.1
  1. # 根据需要修改配置文件模板, 如果不清楚用途可以跳过修改
  2. cat config-example.txt

配置文件说明

  1. # 以下设置如果为空系统会自动生成随机字符串填入
  2. ## 迁移请修改 SECRET_KEY 和 BOOTSTRAP_TOKEN 为原来的设置
  3. ## 完整参数文档 https://docs.jumpserver.org/zh/master/admin-guide/env/
  5. ## 安装配置, amd64 默认使用华为云加速下载, arm64 请注释掉 DOCKER_IMAGE_PREFIX=swr.cn-south-1.myhuaweicloud.com
  6. # DOCKER_IMAGE_PREFIX=swr.cn-south-1.myhuaweicloud.com
  7. VOLUME_DIR=/opt/jumpserver
  8. DOCKER_DIR=/var/lib/docker
  9. SECRET_KEY=
  10. BOOTSTRAP_TOKEN=
  11. LOG_LEVEL=ERROR
  13. ##  MySQL 配置, USE_EXTERNAL_MYSQL=1 表示使用外置数据库, 请输入正确的 MySQL 信息
  14. USE_EXTERNAL_MYSQL=0
  15. DB_HOST=mysql
  16. DB_PORT=3306
  17. DB_USER=root
  18. DB_PASSWORD=
  19. DB_NAME=jumpserver
  21. ##  Redis 配置, USE_EXTERNAL_REDIS=1 表示使用外置数据库, 请输入正确的 Redis 信息
  22. USE_EXTERNAL_REDIS=0
  23. REDIS_HOST=redis
  24. REDIS_PORT=6379
  25. REDIS_PASSWORD=
  27. ## Compose 项目设置, 如果 192.168.250.0/24 网段与你现有网段冲突, 请修改然后重启 JumpServer
  28. COMPOSE_PROJECT_NAME=jms
  29. COMPOSE_HTTP_TIMEOUT=3600
  30. DOCKER_CLIENT_TIMEOUT=3600
  31. DOCKER_SUBNET=192.168.250.0/24
  33. ## IPV6 设置, 容器是否开启 ipv6 nat, USE_IPV6=1 表示开启, 为 0 的情况下 DOCKER_SUBNET_IPV6 定义不生效
  34. USE_IPV6=0
  35. DOCKER_SUBNET_IPV6=2001:db8:10::/64
  37. ## Nginx 配置, USE_LB=1 表示开启, 为 0 的情况下, HTTPS_PORT 定义不生效
  38. HTTP_PORT=80
  39. SSH_PORT=2222
  40. RDP_PORT=3389
  42. USE_LB=0
  43. HTTPS_PORT=443
  45. ## Task 配置, 是否启动 jms_celery 容器, 单节点必须开启
  46. USE_TASK=1
  48. ## XPack, USE_XPACK=1 表示开启, 开源版本设置无效
  49. USE_XPACK=0
  51. # Core 配置, Session 定义, SESSION_COOKIE_AGE 表示闲置多少秒后 session 过期, SESSION_EXPIRE_AT_BROWSER_CLOSE=true 表示关闭浏览器即 session 过期
  52. # SESSION_COOKIE_AGE=86400
  53. SESSION_EXPIRE_AT_BROWSER_CLOSE=true
  55. # Koko Lion XRDP 组件配置
  56. CORE_HOST=http://core:8080
  58. # 额外的配置
  59. CURRENT_VERSION=
  1. ./jmsctl.sh install
  2. ./jmsctl.sh start

使用方式

  1. # 安装完成后配置文件 /opt/jumpserver/config/config.txt
  1. cd /opt/jumpserver-installer-v2.12.1
  3. # 启动
  4. ./jmsctl.sh start
  6. # 停止
  7. ./jmsctl.sh down
  9. # 卸载
  10. ./jmsctl.sh uninstall
  12. # 帮助
  13. ./jmsctl.sh -h
  1. # 重新安装
  2. ./jmsctl.sh uninstall
  3. ./jmsctl.sh install

后续的使用请参考 安全建议 快速入门