jumpserver注意事项以及报错处理

时间:2024-01-31 16:31:06

需要注意下面亮点 
在使用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