正文

jumpserver注意事项以及报错处理

IP云
IP云V管理员/7 阅读
10/26
提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

需要注意下面亮点 
在使用jumpserver过程中，有一步是系统用户推送，要推送成功，client（后端服务器）要满足以下条件：

  • 后端服务器需要有python、sudo环境才能使用推送用户，批量命令等功能
  • 后端服务器如果开启了selinux，请安装libselinux-python

在使用Jumpserver过程中的一些名词解释

  • 用户：用户是授权和登陆的主体，将来为每个员工建立一个账户，用来登录跳板机， 将资产授权给该用户，查看用户登陆记录命令历史等。
  • 用户组：多个用户可以组合成用户组，为了方便进行授权，可以将一个部门或几个用户 组建成用户组，在授权中使用组授权，该组中的用户拥有所有授权的主机权限。
  • 资产：资产通常是我们的服务器、网络设备等，将资产授权给用户，用户则会有权限登 录资产，执行命令等。
  • 管理账户：添加资产时需要添加一个管理账户，该账户是该资产上已有的有管理权限的用户， 如root，或者有 NOPASSWD: ALL sudo权限的用户，该管理账户用来向资产推送系统用户， 为系统用户添加sudo，获取资产的一些硬件信息。
  • 资产组：同用户组，是资产组成的集合，为了方便授权。
  • 机房：又称IDC，这个不用解释了吧。
  • Sudo：这里的sudo其实是Linux中的sudo命令别名，一个sudo别名包含多个命令， 系统用户关联sudo就代表该系统用户有权限sudo执行这些命令。
  • 系统用户：系统用户是服务器上建立的一些真实存在的可以ssh登陆的用户,如 dev, sa, dba等，系统用户可使用jumpserver推送到服务器上，也可以利用自己公司 的工具进行推送，授权时将用户、资产、系统用户关联起来则表明用户有权限登陆该资产的这个系统用户，比如用户小明 以 dev系统用户登录 172.16.1.1资产, 简单理解就是 将某个资产上的某个系统用户映射给这个用户登录。
  • 推送系统用户：添加完系统用户，需要推送，推送操作是使用ansible，把添加的系统用户和系统用户管理的sudo，推送到资产上，具体体现是在资产上useradd该系统用户，设置它的key,然后设置它的sudo，为了让用户可以登录它。
  • 授权规则：授权规则是将资产系统用户和用户关联起来，用来完成授权。 这样用户就可以以某个系统用户账号登陆资产。大家对这好像不是很理解，其实也是对系统用户， 用户这里没有搞清楚。我们可以把用户当做虚拟的用户，而系统用户是真实再服务器上存在的用户， 系统用户可以使用jumpserver推送，也可以自己手动建立，但是推送的过程一定要有，哪怕是模拟 推送（不选择秘钥和密码推送，如网络设备），因为添加授权规则会检查推送记录。为了简化理解， 我们暂时 以 用户 资产 系统用户 来理解，暂时不考虑组，添加这样的规则意思是 授权 用户 在这个资产上 以这个系统用户来登陆, 系统用户是一组具有通用性，具有sudo的用户， 不同的用户授权不同的 系统用户，比如 dba可能有用数据库的sudo权限。
  • 日志审计：分为以下5个方式：1）在线：查看当前在线的用户(非web在线)，可以监控用户的命令执行，强制结束用户 登录；2）实时监控：实时监控用户的操作；3）登录历史：查看以往用户的登录历史，可以查看用户登陆操作的命令，可以回放用户 执行命令的录像；4）命令记录：查看用户批量执行命令的历史，包含执行命令的主机，执行的命令，执行的结果；5）上传下载：查看用户上传下载文件的记录。
  • 默认设置：默认设置里可以设置 默认管理账号信息，包括账号密码密钥，默认信息为了方便添加资产 而设计，添加资产时如果选择使用默认管理账号，则会使用这里设置的信息，端口是资产的ssh端口，添加 资产时，默认会使用该端口。

--------------------------------------------Jumpserver中的用户，系统用户，管理用户对比---------------------------------------

1
2
3
4
5
6
为了简单的描述这个问题，可以举例来说明，：
1）用户：小王(公司员工)，
2）系统用户：dev(后端服务器上存在的账号),
授权时将系统用户dev在某台后段服务器授权给小王，这样小王登陆后端服务器，其实是登陆了服务器上的dev用户,类似执行"ssh dev@somehost"
3)管理账号: 是为了帮助大家推送系统用户用的
在jumpserver上新建系统用户并推送， 其实相当于执行了"ssh 管理账户@somehost -e 'useradd 系统账号'", 这个是用ansible完成这样的操作。

下面简单说下在Jumpserver的web界面里添加用户、推送用户等操作流程：

1. 添加用户
用户管理 - 查看用户 - 添加用户 填写基本信息，完成用户添加。
用户添加完成后，根据提示记住用户账号密码，换个浏览器登录下载key，
ssh登录jumpserver测试

2. 添加资产
资产管理 - 查看资产 - 添加资产 填写基本信息，完成资产添加

3. 添加sudo
授权管理 - Sudo - 添加别名 输入别名名称和命令，完成sudo添加

4. 添加系统用户
授权管理 - 系统用户 - 添加 输入基本信息，完成系统用户添加

5. 推送系统用户
授权管理 - 推送 - 选择需要推送的资产或资产组完成推送

推送只支持服务器，使用密钥是指用户从跳板机跳转时使用key，反之使用密码，
授权时会检查推送记录，如果没有推送过则无法完成系统用户在该资产上的授权。
如果资产时网络设备，请不要选择密码和秘钥，模拟一下推送，目的是为了生成
推送记录。

6. 添加授权规则
授权管理 - 授权规则 - 添加规则 选择刚才添加的用户，资产，系统用户完成授权

7. 测试登录
用户下载key 登录跳板机，会自动运行connect.py，根据提示登录服务器
用户登陆web 查看授权的主机，点击后面的链接，测试是否可以登录服务器

8. 监控和结束会话
日志审计 - 在线 查看当前登录的用户登录情况，点击监控查看用户执行的命令， 点击阻断，结束用户的会话

9. 查看历史记录
日志审计 - 登录历史 查看登录历史,点击统计查看命令历史，点击回放查看录像

10. 执行命令
同7 测试命令的执行，命令记录查看 批量执行命令的日志

11. 上传下载
同7 测试文件的上传下载，日志审计 - 上传下载 查看上传下载记录

下面分享几个问题的排查注意点：

1）查看日志
tail -f logs/jumpserver.log
里面包含了详细的日志，包含了账号和密码，一切完成后，请将 jumpserver.conf中的log改为 warning等

2）推送系统用户失败
在系统用户列表，点击系统用户名称，查看系统用户详情，把鼠标放到失败按钮上，会看到失败的原因，通常是因为 管理账号添加的不对（见管理账号名称解释），或服务器没有安装sudo(推送系统用户时，会推送sudo设置)

3）邮件发送失败
如果出现mail,smtp等错误通常都是由于发送邮件导致的，请尝试不同提供商的邮件设置

4）service启动失败
请进入/opt/jumpserver目录，手动运行
# python manage.py runserver 0.0.0.0:80
# python run_websocket.py
如果启动失败，可能是由于 80端口和3000端口已经被占用，或者数据库账号密码不对，请检查

5)监控，websocket, web命令执行失败
它们会像运行的websocket服务发起请求， 可能是websocket没有启动，可能是Jumpserver.conf中websocket的地址不正确(注意这个文件里的ip地址的配置，内外网地址？端口通不通？)，务必保证设置的地址用户可以访问到(映射或防火墙等), service.sh先关掉服务器，手动运行, 查看websocket的console输出

6）Crypto，HAVE_DECL_MPZ_POWM_SEC等错误
很常见的错误，通常是由 pycrypto的版本问题，请卸载重新安装
# pip uninstall pycrypto
# rm -rf /usr/lib64/python2.6/site-packages/Crypto/
# pip install pycrypto

==================================================
问题记录一：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
默认跳板机的上传文件有限制大小为256M,可以修改dropzone.js
[root@test-vm001 ~]# vim /opt/jumpserver/static/js/dropzone/dropzone.js ，296 行
maxFilesize: 5000,
  
还要安装一个nginx代理，以用来改善它的80端口访问和改善WEB大文件上传，加上一个http://jumpserver.venic.com/doc
来链接使用说明
  
[root@test-vm001 http]# vi uploadbigfile.conf
server {
        listen  80;
        client_max_body_size 5g;
  
        proxy_connect_timeout 300;
        proxy_read_timeout 300;
        proxy_send_timeout 300;
        proxy_buffer_size 64k;
        proxy_buffers 4 32k;
        proxy_busy_buffers_size 64k;
        proxy_temp_file_write_size 64k;
  
        location ^~ /ws/ {
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header Host $host;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_http_version 1.1;
                proxy_set_header Upgrade $http_upgrade;
                proxy_set_header Connection "upgrade";
                proxy_pass http://127.0.0.1:8000/ws/;
        }
        location / {
                     proxy_pass http://127.0.0.1:8000;
        }
        location /file/upload/ {
  
                     proxy_pass http://127.0.0.1:8083;
        }
        location ^~ /doc/ {
                proxy_pass http://127.0.0.1:8088/;
        }
}
  
server {
        listen  8088;
        location / {
            root   /opt/jumpserver/docs/;
            index  index.html index.htm;
        }
}
  
  
 
由于多了一个8083端口，还要启动这个
[root@test-vm001 ~]# cd /opt/jumpserver
[root@test-vm001 ~]# python manage.py runserver 127.0.0.1:8083 &
*************************************************
xshell工具的上传大小还没解决，以下是刚才修改配置的位置，但测试最终提示不超过2G的单文件。
  
上传文件有限制大小为256M,可以修改dropzone.js
[root@test-vm001 ~]# vi /opt/jumpserver/static/js/dropzone/dropzone.js ，296 行
maxFilesize: 5000,
  
[root@test-vm001 ~]# /opt/jumpserver/service.sh restart

问题记录二：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
问题记录二：
Web console登录机器，会产生过大的CPU，单开一个WEB console就消耗了44%的CPU，2核中占满一个。而使用Xshell公钥匙则没有问题
如果要禁用Web Console的话，修改Web前端，但我没有删掉
进入/opt/jumpserver/templates/jasset/asset_cu_list.html     -----修改130行，这个是修改普通用户界面的
进入/opt/jumpserver/templates/jasset/asset_list.html    --------修改135行，这个是修改管理员界面的
  
比如我把它修改成跳转方式到其它网站连接去
<a value="{{ asset.id }}" class="conn btn btn-xs btn-warning">连接</a>
<a href="http://jumpserver.venic.com/doc" class="conn btn btn-xs btn-warning">连接</a>
  
而我没有取消，是因我调高CPU配置为8核后，发现开了8个窗口，最终还是最多消耗2个核，所以我没有禁用web console
-------------------------------------------------------------------------------------------------------------
  
需求变更一：
  
修改web console的窗口宽一点
[root@test-vm001 ~]# vim /opt/jumpserver/static/js/webterminal.js
改里面所有100值为160的值
  
修改webconsole 窗口，加个注释，禁用用户修改窗口大小
  
<!--
<div class="termChangBar">
    <input type="number" min="100" value="100" placeholder="col" id="term-col"/>
    <input type="number" min="35" value="35" placeholder="row" id="term-row"/>
    <button id="col-row">修改窗口大小</button>
</div>
-->
  
修改弹窗的窗口体大小（非terminal），
进入/opt/jumpserver/templates/jasset/asset_cu_list.html  -----修改237行和249行  这个是修改普通用户界面的
进入/opt/jumpserver/templates/jasset/asset_list.html     --------248行和259 这个是修改管理员界面的
  
window.open(new_url+data, "_blank", 'width=1000, height=600');
  
---------------------------------------------------------------------------------------------------------------
需求变更二：
修改左侧导航栏的访问官网链接
进入/opt/jumpserver/templates/nav.html   52行和80行
  
<a href="http://jumpserver.venic.com/doc" target="_blank"><i class="fa fa-database"></i> <span class="nav-label">访问官网</span></a>
上传一个用word文档写的“操作指引”到如下链接，

这个word文档转成html，这里只是使用另存为html自己保存成2个新文件（index.files和index.htm）

1
2
3
4
5
6
7
8
9
10
11
12
13
然后我在htm文件的<head></head>标签中，添加了一个<style></style>如下标签，目的是让图片自动伸缩和居中
<style>
html{
    
}
body{width:800px;
    margin:auto;
     padding: 0px !important; border-radius: 0px !important; background: none !important; border: 0px !important; bottom: auto !important; float: none !important; height: auto !important; left: auto !important; line-height: 1.8em !important; outline: 0px !important; overflow: visible !important; position: static !important; right: auto !important; top: auto !important; vertical-align: baseline !important; width: auto !important; box-sizing: content-box !important; font-family: Consolas, "Bitstream Vera Sans Mono", "Courier New", Courier, monospace !important; min-height: auto !important; color: rgb(0, 130, 0) !important;">#FFFFFF;
   }
img {max-width:800px;}
</style>
  
然后把这2个文件上传至服务器的/opt/jumpserver-master/docs目录下。所以才上面的nginx多一条跳转的配置

1
2
3
然后我们还要修改首页的前代码，让“连接使用说明”指到这个 http://jumpserver.venic.com/doc/
修改处在
/opt/jumpserver-master/templates/nav.html

测试跳转后的显示界面样式如下：

问题记录三：

1
2
3
4
5
修改sshd配置，禁止密码登录#
[root@test-vm001 ~]# vim /etc/sshd/sshd_config
......
PasswordAuthentication no
[root@test-vm001 ~]# service sshd restart

问题记录四：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
非admin的普通用户登录jumpserver界面，通过webshell登录服务器的时候，连接报错！报错信息为：
Connection Reset By Peer
   
通过jumpserver的log日志，可以看出Websocket连接失效了
[root@test-vm001 install]# tail -f /data/jumpserver/logs/jumpserver.log
2018-01-18 09:18:40,660 - views.py - DEBUG - 获取授权系统用户: ops,app,dev
2018-01-18 09:18:46,429 - run_websocket.py - DEBUG - Websocket: session_key:
2018-01-18 09:18:46,430 - run_websocket.py - WARNING - Websocket: Request auth failed.
2018-01-18 09:18:46,486 - run_websocket.py - DEBUG - Websocket: Close request
2018-01-18 09:18:48,589 - run_websocket.py - DEBUG - Websocket: session_key:
2018-01-18 09:18:48,589 - run_websocket.py - WARNING - Websocket: Request auth failed.
2018-01-18 09:18:48,645 - run_websocket.py - DEBUG - Websocket: Close request
 
通过重启jumpserver服务重新建立Websocket链接即可此问题，但是过了一段时间后，Websocket链接会再次失效。
所以可以结合crontab定时重启jumpserver。
[root@test-vm001 install]# crontab -e
*/2 * * * * /data/jumpserver/service.sh restart > /dev/null 2>&1

问题记录五：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
jumpserver运行一段时间后，突然发现服务器的CPU负载很高，zabbix报警jumpserver服务器利用率已高达85%！
 
[root@jumpserver01 ~]# uptime
 14:03:49 up 52 days, 22:36,  4 users,  load average: 33, 35, 38
 
[root@jumpserver01 ~]# top
top - 14:04:12 up 52 days, 22:37,  4 users,  load average: 1.02, 1.05, 0.80
Tasks: 902 total,   3 running, 899 sleeping,   0 stopped,   0 zombie
Cpu(s):  2.6%us,  0.1%sy,  0.0%ni, 97.3%id,  0.0%wa,  0.0%hi,  0.0%si,  0.0%st
Mem:  65724264k total,  4008704k used, 61715560k free,   257600k buffers
Swap: 32767996k total,        0k used, 32767996k free,   230724k cached
 
   PID USER      PR  NI  VIRT  RES  SHR S %CPU %MEM    TIME+  COMMAND                                                              
 20299 chengjun  20   0  360m  35m 4768 R 100.0  0.1  20:49.54 python                                                               
 32661 502      20   0  303m  25m 3720 S 100.0  0.1   0:00.22 python
 20299 chengjun  20   0  360m  35m 4768 R 100.0  0.1  20:49.54 python                                                               
 32661 502      20   0  303m  25m 3720 S 100.0  0.1   0:00.22 python
 25149 chengjun  20   0  360m  35m 4768 R 100.0  0.1  20:49.54 python                                                               
 38315 502      20   0  303m  25m 3720 S 100.0  0.1   0:00.22 python
 42299 chengjun  20   0  360m  35m 4768 R 100.0  0.1  20:49.54 python                                                               
 23161 502      20   0  303m  25m 3720 S 100.0  0.1   0:00.22 python
 ......
 
jumpserver服务器的配置是128G内存、40核CPU，按照这个配置，服务器硬件配置方面是绝对不会出现瓶颈的！
 
经排查是由于之前有些用户登录jumpserver后没有退出程序，从而导致一直占用cpu资源。
[root@jumpserver01 ~]# ps -ef|grep python
root     20299  20284 98 13:42?       00:30:02 python /data/jumpserver/connect.py
root     37155  37153  0 14:12?       00:00:00 python /data/jumpserver/manage.py runserver 0.0.0.0:80
502      37156  37154  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
502      37171  37155  0 2017 ?       00:00:00 /usr/bin/python /data/jumpserver/manage.py runserver 0.0.0.0:80
root     37228  37156  0 14:12?       00:00:00 python /data/jumpserver/run_websocket.py
root     37229  37156  0 14:12?       00:00:00 python /data/jumpserver/run_websocket.py
502      37230  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
zhenyj   37231  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
502      37232  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
502      37228  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
zhenyj   37229  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
zhenyj   37230  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
502      37231  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
root     37232  37156  0 14:12?       00:00:00 python /data/jumpserver/run_websocket.py
502      37228  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
502      37229  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
wangbin  37230  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
root     37231  37156  0 14:12?       00:00:00 python /data/jumpserver/run_websocket.py
root     37232  37156  0 14:12?       00:00:00 python /data/jumpserver/run_websocket.py
502      37228  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
502      37229  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
xiaof    37230  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
525      37228  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
525      37229  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
wangbin  37230  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
chengwq  47230  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
chengwq  43230  37156  0 2017 ?       00:00:00 python /data/jumpserver/run_websocket.py
 
如上信息，那些第五列显示"2017 ?"信息的，即是之前登陆jumpserver后没有完全退出以至于系统资源一直被占用。
批量kill掉这些程序的pid即可降低jumpserver服务器的CPU利用率。
[root@jumpserver01 ~]# ps -ef|grep python |awk '$5=2017 {print $2}'|xargs kill -9