安装Jumpserver

Posted 2020-12-03 huangyanqi

 全程安装官方文档流程：

文档地址：http://docs.jumpserver.org/zh/docs/step_by_step.html

一、系统环境

Centos7 x64
setenforce 0  # 可以设置配置文件永久关闭：/etc/selinux/config
systemctl stop iptables.service
systemctl stop firewalld.service

# 修改字符集，否则可能报 input/output error的问题，因为日志里打印了中文
localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8
echo ‘LANG="zh_CN.UTF-8"‘ > /etc/locale.conf

#更换源地址
mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup
wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.163.com/.help/CentOS7-Base-163.repo
yum clean all
yum makecache

 

二、准备 Python3 和 Python 虚拟环境

1、安装依赖包
yum -y install wget sqlite-devel xz gcc automake zlib-devel openssl-devel epel-release git

2、编译安装
cd /usr/local/src/
wget https://www.python.org/ftp/python/3.6.6/Python-3.6.6.tar.xz
tar xf Python-3.6.6.tar.xz && cd Python-3.6.6
./configure && make && make install
# 这里必须执行编译安装，否则在安装 Python 库依赖时会有麻烦..

3、建立Python虚拟环境
#因为 CentOS 6/7 自带的是 Python2，而 Yum 等工具依赖原来的 Python，为了不扰乱原来的环境我们来使用 Python 虚拟环境
[[email protected] Python-3.6.6]# cd /opt/
[[email protected] opt]# pwd
/opt
[[email protected] opt]# python3 -m venv py3
[[email protected] opt]# source /opt/py3/bin/activate
(py3) [[email protected] opt]# 

4、 自动载入 Python 虚拟环境配置
#此项仅为懒癌晚期的人员使用，防止运行 Jumpserver 时忘记载入 Python 虚拟环境导致程序无法运行。使用autoenv
cd /opt
git clone git://github.com/kennethreitz/autoenv.git
echo ‘source /opt/autoenv/activate.sh‘ >> ~/.bashrc
source ~/.bashrc

 

三、安装Jumpserver

 

1、下载或Clone项目
项目提交较多 git clone 时较大，你可以选择去 Github 项目页面直接下载zip包
cd /opt/
git clone https://github.com/jumpserver/jumpserver.git && cd jumpserver && git checkout master
echo "source /opt/py3/bin/activate" > /opt/jumpserver/.env  # 进入 jumpserver目录时将自动载入 python 虚拟环境

# 首次进入 jumpserver 文件夹会有提示，按 y 即可
Are you sure you want to allow this? (y/N) y

2、安装依赖 RPM 包
cd /opt/jumpserver/requirements
yum -y install $(cat rpm_requirements.txt)  # 如果没有任何报错请继续

3、安装 Python 库依赖
pip install -r requirements.txt  # 不要指定-i参数，因为镜像上可能没有最新的包，如果没有任何报错请继续
注释：Pip 加速设置请参考 <https://segmentfault.com/a/1190000011875306>

4、安装 Redis, Jumpserver 使用 Redis 做 cache 和 celery broke
yum -y install redis
systemctl start redis

5、安装 mysql
本教程使用 Mysql 作为数据库，如果不使用 Mysql 可以跳过相关 Mysql 安装和配置
# centos7下安装的是mariadb
yum -y install mariadb mariadb-devel mariadb-server 
systemctl enable mariadb
systemctl start mariadb

6、创建数据库 Jumpserver 并授权
$ mysql
create database jumpserver default charset ‘utf8‘;
grant all on jumpserver.* to ‘jumpserver‘@‘127.0.0.1‘ identified by ‘somepassword‘;
flush privileges;

7、修改 Jumpserver 配置文件
cd /opt/jumpserver
cp config_example.py config.py
vi config.py

 

#注意: 不要直接复制本文档的内容；配置文件是 Python 格式，不要用 TAB，而要用空格

"""
    jumpserver.config
    ~~~~~~~~~~~~~~~~~

    Jumpserver project setting file

    :copyright: (c) 2014-2017 by Jumpserver Team
    :license: GPL v2, see LICENSE for more details.
"""
import os

BASE_DIR = os.path.dirname(os.path.abspath(__file__))

class Config:
    # Use it to encrypt or decrypt data

    # Jumpserver 使用 SECRET_KEY 进行加密，请务必修改以下设置
    # SECRET_KEY = os.environ.get(‘SECRET_KEY‘) or ‘2vym+ky!997d5kkcc64mnz06y1mmui3lut#(^wd=%s_qj$1%x‘
    SECRET_KEY = ‘请随意输入随机字符串（推荐字符大于等于 50位）‘

    # Django security setting, if your disable debug model, you should setting that
    ALLOWED_HOSTS = [‘*‘]

    # DEBUG 模式 True为开启 False为关闭，默认开启，生产环境推荐关闭
    # 注意：如果设置了DEBUG = False，访问8080端口页面会显示不正常，需要搭建 nginx 代理才可以正常访问了
    DEBUG = False

    # 日志级别，默认为DEBUG，可调整为INFO, WARNING, ERROR, CRITICAL，默认INFO
    LOG_LEVEL = ‘ERROR‘
    LOG_DIR = os.path.join(BASE_DIR, ‘logs‘)

    # 使用的数据库配置，支持sqlite3, mysql, postgres等，默认使用sqlite3
    # See https://docs.djangoproject.com/en/1.10/ref/settings/#databases

    # 默认使用SQLite，如果使用其他数据库请注释下面两行
    # DB_ENGINE = ‘sqlite3‘
    # DB_NAME = os.path.join(BASE_DIR, ‘data‘, ‘db.sqlite3‘)

    # # 如果需要使用mysql或postgres，请取消下面的注释并输入正确的信息,本例使用mysql做演示
    DB_ENGINE = ‘mysql‘
    DB_HOST = ‘127.0.0.1‘
    DB_PORT = 3306
    DB_USER = ‘jumpserver‘
    DB_PASSWORD = ‘somepassword‘
    DB_NAME = ‘jumpserver‘

    # Django 监听的ip和端口，生产环境推荐把0.0.0.0修改成127.0.0.1，这里的意思是允许x.x.x.x访问，127.0.0.1表示仅允许自身访问
    # ./manage.py runserver 127.0.0.1:8080
    HTTP_BIND_HOST = ‘127.0.0.1‘
    HTTP_LISTEN_PORT = 8080

    # Redis 相关设置
    REDIS_HOST = ‘127.0.0.1‘
    REDIS_PORT = 6379
    REDIS_PASSWORD = ‘‘

    def __init__(self):
        pass

    def __getattr__(self, item):
        return None

class DevelopmentConfig(Config):
    pass

class TestConfig(Config):
    pass

class ProductionConfig(Config):
    pass

# Default using Config settings, you can write if/else for different env
config = DevelopmentConfig()

 

继续如下操作

1、生成数据库表结构和初始化数据
cd /opt/jumpserver/utils
bash make_migrations.sh

2、运行 Jumpserver
cd /opt/jumpserver
./jms start all  # 后台运行使用 -d 参数./jms start all -d

#新版本更新了运行脚本，使用方式./jms start|stop|status|restart all  后台运行请添加 -d 参数

 

运行不报错，请浏览器访问 http://192.168.244.144:8080/ 默认账号: admin 密码: admin 页面显示不正常先不用处理，跟着教程继续操作就行，后面搭建 nginx 代理就可以正常访问了！

未完待续。。。。。。