jumpserver/docs/install.md

Jumpserver v0.4.0 版本安装详细过程

环境

• 系统: CentOS 6.5 x86_64 mini
• Python: 版本 3.6 大部分功能兼容 2.7
• 安装目录
  • /opt/jumpserver
  • /opt/coco

一. 环境准备

1.1 安装基本工具和库

$ yum -y install sqlite-devel git epel-release
$ yum -y install sshpass python-devel libffi-devel openssl-devel
$ yum -y install gcc gcc-c++

1.2 安装Python 3.6 和 虚拟环境

略

二. Jumpserver安装

2.1 下载仓库代码

$ cd /opt
$ git clone https://github.com/jumpserver/jumpserver.git
$ cd jumpserver
$ git checkout dev

2.2 安装依赖

$ cd requirements 
$ sudo yum -y install `cat rpm_requirements.txt`
$ pip install -r requirements.txt -i https://pypi.doubanio.com/simple

// 解决Mac安装ldap提示 Modules/LDAPObject.c:18:10: fatal error: 'sasl.h' file not found
 pip install python-ldap \
    --global-option=build_ext \
    --global-option="-I$(xcrun --show-sdk-path)/usr/include/sasl"

2.3 准备配置文件

$ cd ..
$ cp config_example.py config.py
$ vim config.py

// 默认使用的是 DevelpmentConfig 所以应该去修改这部分
class DevelopmentConfig(Config):
EMAIL_HOST = 'smtp.exmail.qq.com'
EMAIL_PORT = 465
EMAIL_HOST_USER = 'ask@jumpserver.org'
EMAIL_HOST_PASSWORD = 'xxx'
EMAIL_USE_SSL = True   // 端口是 465 设置 True 否则 False
EMAIL_USE_TLS = False  // 端口是 587 设置为 True 否则 False
SITE_URL = 'http://localhost:8080'  // 发送邮件会使用这个地址 

2.4 初始化数据库

$ cd utils
$ sh make_migrations.sh
$ sh init_db.sh

2.5 安装redis server

$ yum -y install redis
$ service redis start  

2.6 启动

$ cd ..
$ python run_server.py

访问 http://ip:8080 账号密码： admin admin

2.7 测试使用

• 创建用户
  会发送邮件，测试是否正常修改密码，登录

• 创建管理用户 创建一个管理用户， 创建资产时需要关联

• 创建资产 创建一个 资产，关联刚创建的管理用户

• 创建系统用户 系统用户是用来登录资产的，授权时需要

• 创建授权规则 关联用户，资产，系统用户 形成授权规则，授权的系统用户会自动推送到资产上

三. 安装 SSH SERVER - COCO

3.1 下载代码库

$ cd /opt
$ git clone https://github.com/jumpserver/coco.git

3.2 安装依赖

$ cd coco
$ pip install -r requirements.txt  # -i https://pypi.doubanio.com/simple

3.3 启动

$ python run_server.py

说明： Coco启动后会向jumpserver注册，请去 jumpserver页面 - 应用程序 - terminal - coco - Accept 允许， 这时 coco就 运行在 2222端口，可以ssh来连接

命令行：

ssh admin@YourServerIP -p2222

3.5 测试

• 测试登录 ssh server
• 测试跳转
• 测试命令记录回