JumpServer 常见问题处理

超、凢脫俗 2024-03-27 10:59 110阅读 0赞

> 官网地址：[JumpServer - 开源堡垒机 - 官网][JumpServer - _ -]
> 
> 在线电话：400-052-0755
> 
> 技术支持：[JumpServer 技术咨询][JumpServer]

--------------------

### 1 概述 ###

本篇文章主要说明使用JumpServer堡垒机时遇到的各种小问题，这些可能是操作不当、系统环境、资产环境等各类原因导致的。本文划分了几个篇章，对常见问题进行整理总结，希望能对使用者快速定位、处理问题提供帮助。

### 2 前端页面 ###

#### 2.1 登陆堡垒机 ####

2.1.1 设置你的浏览器支持cookie

**问题现象：**

登陆堡垒机时页面提示“设置你的浏览器支持cookie”。

![5530d3349f26df7322496009b7b69410.png][]

**问题原因：**

页面缓存问题。

**解决方案：**

清空缓存，重新打开浏览器，地址栏只填域名不加后缀，重新进入页面再次填写账号&Password即可。

2.1.2 IP已被锁定

**问题现象：**

登陆堡垒机时页面提示“IP已被锁定”。

![b8fb282c4caeaff46e80fe48fc02f22a.png][]

**问题原因：**

系统管理员设置了登陆黑名单，由于某些原因你的IP属于黑名单里的，一般通过互联网登陆时会出现这种问题。

**解决方案：**

联系系统管理员打开<系统设置><安全设置><登录限制>，将你的IP添加进<IP登陆白名单>。

2.1.3 server error occur，contact administrator

**问题现象：**

登陆堡垒机时页面提示“server error occur，contact administrator”。

![b7df56b253b4edd88e564c254ab037e1.png][]

**问题原因：**

一般启用了外部的身份认证系统时会出现该报错，如 LDAP、OpenID等。可能的原因有，LDAP 服务连接失败，OpenID 认证连接失败。也可能跟数据库有关。

**解决方案：**

后台查看 jumpserver.log 根据报错原因进行处理。

常见报错有无法连接到认证端，该用户的邮箱与其他用户相同。

2.1.4 虚拟 MFA 验证码错误

**问题现象：**

登陆堡垒机时页面提示“虚拟 MFA 验证码错误，或者服务器端时间不对，您还可以尝试 6 次（账号将被临时锁定 30 分钟）”。

![f8c1233aa09f4f5b2e752af1b0b4eb54.png][]

**问题原因：**

一般是验证码输入错误，或者JumpServer服务器时间不对导致的。

**解决方案：**

确认验证码输入正确，去后台检查系统时间，使用 ntpdate -u ntp.api.bz 重新同步时间，或者用 date -s “20140225 20:16:00” 直接改成正确的时间。

#### 2.2 日常使用 ####

2.2.1 连接WebSocket失败

**问题现象：**

页面提示“连接WebSocket失败”。

![25c31eafdd116b3db1c8a9e5e6fd90dc.png][]

**问题原因：**

这个问题有两种情况，如果不影响使用，资产连接也正常，重启服务就可以。如果资产连接时也报类似的错误那就是 lb 没有支持 websocket 长连接，或者防火墙设备拦截导致的。打开 F12 检查 ws:// 开头的请求，这是 WebSocket 相关的，它的状态码正常是101，其他状态码会导致该问题。

**解决方案：**

不影响使用，重启服务就可以恢复。

资产连接受到影响，检查 lb 参考“[https://docs.jumpserver.org/zh/master/admin-guide/proxy/\#2-nginx”，如果有负载设备测试绕过该设备看登陆看是否正常，使用4层负载不会出现该问题，如果有类似][https_docs.jumpserver.org_zh_master_admin-guide_proxy_2-nginx_4] WAF 的防火墙设备，检查是否出现了拦截，或者关闭 WAF 看是否会正常。

2.2.2 Request failed with status code 502

**问题现象：**

页面提示“Request failed with status code 502”。

![fb8b5561a8912d6153d561a1759f1da8.png][]

**问题原因：**

这种报错一般是 core 组件异常导致的，常见的原因是磁盘空间满。

**解决方案：**

去后台查看 jumpserver.log 有具体的报错原因，处理异常点后需重启 JumpServer。

2.2.3 此操作需要验证您的 MFA

**问题现象：**

执行查看或导出Password 操作时，页面提示“此操作需要验证您的MFA”。

![b711694008f11fa7c65e3924bb77c2a8.png][]

**问题原因：**

出于安全考虑，执行涉及查看系统用户Password 的操作时要验证 MFA，如果该用户没有配置多因子认证就会出现这个提示。

**解决方案：**

右上角点击<个人信息>进入账号信息页面,设置多因子认证。如果觉得麻烦还可以修改 config.txt 文件，添加下面参数，重启生效，但不建议这样。

\#查看或导出Password 时认证 MFA，true 需要，false不需要

SECURITY\_VIEW\_AUTH\_NEED\_MFA=false

2.2.4 站内信提示组件异常

**问题现象：**

对于管理员，看到站内信里提醒“终端健康状况检查警告”或“终端离线”。

![4faadc17650c37b1750e8479f40af605.png][]

**问题原因：**

这些说明堡垒机的组件出现异常，甚至会影响使用。当组件的资源（CPU、内存、磁盘空间）使用率过高时会有健康状况警告，这是系统资源不够用的表现。如果是终端离线，则是组件出现异常或连接不到core容器。

**解决方案：**

说明：社区版有 Celery、Core、KoKo、Lion 和 Magnus 共5个组件，企业版另外增加 OmniDB 和 Razor 两个组件。

去<系统设置><终端设置><终端管理>检查组件状态，如果 CPU、内存和磁盘使用率高则需要扩容。如果组件状态为离线，则将离线的组件删除，然后检查数量是否正确，如果少了就去后台重启该组件，命令：docker restart 容器名。

2.2.5 无法提交或删除配置

**问题现象：**  
配置好某些资源后点提交没有反映，或无法删除某些配置信息。  
**问题原因：**  
这种情况是被 WAF 之类的防火墙设备拦截了。  
**解决方案：**  
打开 F12 检查 API 相关的请求是否异常，尤其是没有返回状态码的，大概率是被拦截了，联系负责网络或安全的同事进行排查处理。

2.2.6 点击邮件内的链接访问不到堡垒机

**问题现象：**

忘记Password 或申请工单时 JumpServer 会给相关人发送邮件，点开邮件链接登陆的地址不是 JumpServer 的地址而是 http://localhost:8080。

**问题原因：**

没有修改<基本设置>里当前站点的 URL 导致的。

**解决方案：**

联系管理，打开<系统设置><基本信息>将<当前站点URL> 改为登陆 JumpServer 的实际地址并提交。完成后需重新发送邮件。

![f3481256e9b8655286d91e8423169ad5.png][]

#### 2.3 资产维护 ####

2.3.1 测试资产连接性报错

**问题现象1：**

![8937ee336ca2466550ddd91b3b80983d.png][]

**问题现象2：**

![0b5d805379b68d4441b362553de29fc2.png][]

**问题原因：**

现象1的原因是没有给该资产配特权用户，或者虽然配了特权用户，但创建特权用户时忘记配Password 。

现象2的原因是特权用户的Password 不对。

**解决方案：**

在资产详情检查是否配置了特权用户，如果没有则点更新添加后再重试。进入koko容器（命令：docker exec -it jms\_koko bash）使用 ssh 命令测试是否可以正常登陆到该资产。如果正常，在账号列表找到特权用户查看Password 是否正确，不正确可以在本页<更多><更新>Password 。

![b239140999557bcbf36fc1a51a9d7c07.png][]

2.3.2 测试资产连接性报错-资产没有ssh协议

**问题现象：**

![2df38dfbfa15bd08d290d35bd8bd4265.png][]

**问题原因：**

这个提示资产的<协议组>没有配置 ssh 的协议，经常出现在 Windows 的系统上。

**解决方案：**

更新资产在<协议组>添加 ssh 的协议。

2.3.3 测试资产连接性报错-无法创建 ~/.ansible 目录

**问题现象：**

![2e182eea8c061d18c130d2ec7c37a3b7.png][]

**问题原因：**

这个提示要创建 ~/.ansible/tmp/ansible-tmp-\*\*\* 目录。有两种可能，一是没有这个目录的权限或者磁盘空间满导致创建不出来，第二种这是个 Windows 资产但是系统平台写的是 Linux。这里要说明下，Linux 平台用的是 python 而 Windows 平台用的是 PowerShell 做的连接性测试。

**解决方案：**

Linux 资产需检查该目录是否有权限或磁盘空间，可根据提示通过手动创建测试。Windows 资产检查系统平台是否正确。

2.3.4 定时任务不执行

**问题现象：**  
配置的定时改密、定时同步资产等定时任务不执行。  
**问题原因：**  
定时任务是由 celery 组件执行的，如果任务不执行是由于该组件异常导致。  
**解决方案：**  
登陆堡垒机后台，执行 docker exec -it jms\_celery ps -ef 命令检查是否存在僵尸进程，如果有则重启该组件，命令 docker restart jms\_celery。

### 3 Web 终端 ###

#### 3.1 连接资产 ####

3.1.1 复用连接并提示改密

**问题现象：**

连接资产时提示“复用SSH连接”，并且Password 没有到期也提示改密。

![28efeea4b5610ec5729576cb29676b3f.png][]

**问题原因：**

复用了之前连接这个资产的连接，出现了异常。

**解决方案：**

修改 config.txt 文件，添加下面参数，不复用 SSH 连接，重启生效。

\#是否复用同一用户的 SSH 连接，true 复用，false 不复用

REUSE\_CONNECTION=false

3.1.2 没有系统用户

**问题现象：**

连接资产时提示“没有系统用户”。

![c397e8ecb45191ffc225ca8439d66b4e.png][]

**问题原因：**

这是有资产授权，但是没有系统用户，或系统用户和资产不匹配。

**解决方案：**

检查资产授权规则里，资产和系统用户的协议是否一致。

3.1.3 504 Gateway Time-out

**问题现象：**

Web 终端连接资产时报错“504 Gateway Time-out”。

![af0181958d066f4c237eab4f503a82ea.png][]

**问题原因：**

504状态码是网关超时，这说明后台组件出异常了。

**解决方案：**

登陆堡垒机后台，重启组件，命令：docker restart 容器名。或者整体重启，命令：jmsctl restart。

#### 3.2 文件管理 ####

3.2.1.无法上传

**问题现象：**

文件管理，上传文件时报错“无法上传”。

![53033103e968fd8bd3eadbd1151fbc0e.png][]

**问题原因：**

常见的原因是磁盘空间满，或者系统用户没有该目录的权限。

**解决方案：**

系统用户点<更新>能看到<SFTP根路径>的配置。登陆资产，检查该系统用户对这个路径是否有权限，同时检查磁盘空间是否满。

[JumpServer - _ -]: https://jumpserver.org/
[JumpServer]: https://jinshuju.net/f/sQ91MK
[5530d3349f26df7322496009b7b69410.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/1175e74855c14e3faa5565edf599e875.png
[b8fb282c4caeaff46e80fe48fc02f22a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/c439b4196cb34dd9a999cb46a78eb422.png
[b7df56b253b4edd88e564c254ab037e1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/4cf22a10214f4d4aa1ff83b98f927220.png
[f8c1233aa09f4f5b2e752af1b0b4eb54.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/6245780c956c4324984235dac43495b5.png
[25c31eafdd116b3db1c8a9e5e6fd90dc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/0c77fba3f1df4750b719fc5f68e0f4b9.png
[https_docs.jumpserver.org_zh_master_admin-guide_proxy_2-nginx_4]: https://docs.jumpserver.org/zh/master/admin-guide/proxy/#2-nginx%E2%80%9D%EF%BC%8C%E5%A6%82%E6%9E%9C%E6%9C%89%E8%B4%9F%E8%BD%BD%E8%AE%BE%E5%A4%87%E6%B5%8B%E8%AF%95%E7%BB%95%E8%BF%87%E8%AF%A5%E8%AE%BE%E5%A4%87%E7%9C%8B%E7%99%BB%E9%99%86%E7%9C%8B%E6%98%AF%E5%90%A6%E6%AD%A3%E5%B8%B8%EF%BC%8C%E4%BD%BF%E7%94%A84%E5%B1%82%E8%B4%9F%E8%BD%BD%E4%B8%8D%E4%BC%9A%E5%87%BA%E7%8E%B0%E8%AF%A5%E9%97%AE%E9%A2%98%EF%BC%8C%E5%A6%82%E6%9E%9C%E6%9C%89%E7%B1%BB%E4%BC%BC
[fb8b5561a8912d6153d561a1759f1da8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/9b15e8525091474ea79e91934e0380e0.png
[b711694008f11fa7c65e3924bb77c2a8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/bce4dd229aab4486bc30408b7ec3e528.png
[4faadc17650c37b1750e8479f40af605.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/2cea12f7ff7044a5a5034546ef181351.png
[f3481256e9b8655286d91e8423169ad5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/e35f172cf8d8452d9e1b96e37260dd20.png
[8937ee336ca2466550ddd91b3b80983d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/dc2d7856a3c44896a266b80e50acef23.png
[0b5d805379b68d4441b362553de29fc2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/dc6847c9cac94217b187a22e124d9af6.png
[b239140999557bcbf36fc1a51a9d7c07.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/db0ba3f602c44e94acb5365aa09ece43.png
[2df38dfbfa15bd08d290d35bd8bd4265.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/27c9c982b3ea42989d44cdfbe727f416.png
[2e182eea8c061d18c130d2ec7c37a3b7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/858e8dfaf58b4a9fa9dcd6ede1adc2c8.png
[28efeea4b5610ec5729576cb29676b3f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/d841124862394294a89f7b94dcf291bf.png
[c397e8ecb45191ffc225ca8439d66b4e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/a0526bf3ec744e8e9dfea861dbcfaf53.png
[af0181958d066f4c237eab4f503a82ea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/3d26d004b5894f198be919c0bb740827.png
[53033103e968fd8bd3eadbd1151fbc0e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/a4f6f2a10fb64a3f964672676708ccbd.png