SSH 协议资产连接说明
--------------------------------

SSH 协议资产连接错误排查思路

.. code-block:: vim

    (1). 检查管理用户的权限是否正确,权限需要与root权限一致
    (2). 检查资产的防火墙策略,可以在资产上面新建个用户,尝试用此用户在jumpserver服务器上进行ssh连接
    (3). 检查资产的ssh策略,确保可以被jumpserver应用访问

1. 检查终端是否在线

.. image:: _static/img/faq_linux_01.jpg

.. code-block:: shell

    # 确定已经在Jumpserver后台 会话管理-终端管理 里接受 coco 的注册

    # 如果不在线请检查 Linux 组件是否正常运行,箭头指示处 绿色表示正常,红色表示异常

    # 如果重启后 coco 任然不在线,请重新注册
    # 在Jumpserver后台 会话管理-终端管理 删掉 coco 的注册
    # 必须到 Jumpserver后台 会话管理-终端管理  删掉 coco 的注册
    # 一定要先到 Jumpserver后台 会话管理-终端管理  删掉 coco 的注册

    # 正常部署请参照此步骤解决
    $ cd /opt/coco && ./cocod stop
    $ rm /opt/coco/keys/.access_key  # coco, 如果你是按文档安装的,key应该在这里,如果不存在,直接下一步
    $ ./cocod start -d

    # docker 部署请直接删除容器后重建,记得一定要先在 终端管理 删除不在线的组件
    $ docker stop jms_coco
    $ docker rm jms_coco
    $ docker run --name jms_coco -d -p 2222:2222 -p 5000:5000 -e CORE_HOST=http://<Jumpserver_url> -e BOOTSTRAP_TOKEN=nwv4RdXpM82LtSvm wojiushixiaobai/coco:1.4.5

    # 正常运行后到Jumpserver 会话管理-终端管理 里面接受coco注册

2. 访问 luna 界面不显示资产信息

.. code-block:: vim

    # 确定已经授权资产给当前登录用户
    # 确定 Jumpserver 的版本与 luna 的版本一致,如不一致请参考升级文档进行处理

    # Jumpserver 版本可在 jumpserver页面右下角 看到
    # Luna 版本可在 luna页面左下角 看到

    # 注：更新后请清理浏览器缓存后再访问

.. image:: _static/img/faq_linux_02.jpg

3. 访问 Linux 资产无任何提示

.. code-block:: vim

    # 请参考第一条检查终端是否在线
    # 检查 coco 的 ws 端口(默认 5000)
    # 检查 nginx 配置的 socket.io 设置是否有误

.. image:: _static/img/faq_linux_03.jpg

4. 登录资产提示 Authentication failed

.. code-block:: vim

    # 请检查推送
    # 在 资产管理-系统用户 下,点击相应的 系统用户名称 可以看到 系统用户详情,右边可以测试

.. image:: _static/img/faq_linux_04.jpg

5. 推送成功后无法登录资产,或者推送的系统用户 id 不正确 home 目录权限错误

.. code-block:: vim

    # 登录该资产,删除掉错误权限的用户,然后重新推送即可

6. coco 启动时报错 Failed register terminal unknow: xxx-xxx.xxx

.. code-block:: shell

    # 这是因为当前系统的 hostname 有 coco 不支持的字符,需要手动指定 coco 的 NAME
    $ cd /opt/coco/
    $ vi conf.py

    # 项目名称, 会用来向Jumpserver注册, 识别而已, 不能重复
    # NAME = "localhost"
    NAME = "localhost"

7. 测试可连接性 及 更新硬件信息

.. code-block:: vim

    # 注意不要拦截窗口

.. image:: _static/img/faq_linux_05.jpg
.. image:: _static/img/faq_linux_06.jpg

8. 管理用户 测试可连接性

.. code-block:: vim

    # 注意不要拦截窗口

.. image:: _static/img/faq_linux_07.jpg
.. image:: _static/img/faq_linux_08.jpg

9. 系统用户 推送 测试资产可连接性

.. code-block:: vim

    # 注意不要拦截窗口

.. image:: _static/img/faq_linux_09.jpg
.. image:: _static/img/faq_linux_10.jpg

10. ssh 使用key 登录资产提示 所选的用户密钥未在远程主机上注册

.. code-block:: vim

    # 这里是信息填写错误,ip端口应该填coco服务器的ip,端口应该填coco服务的ssh端口(默认2222)

11. 清理celery产生的数据(无法正常推送及连接资产,一直显示........等可以使用,请确定字符集是zh_CN.UTF-8)

.. code-block:: shell

    $ source /opt/py3/bin/activate
    $ cd /opt/jumpserver/apps
    $ celery -A ops purge -f

    # 如果任然异常,手动结束所有jumpserver进程,然后kill掉未能正常结束的jumpserver相关进程,在重新启动jumpserver即可

12. 连接测试常见错误

.. code-block:: vim

    # 提示 Authentication failure
    # 一般都是资产的管理用户不正确

    # 提示Failed to connect to the host via ssh: ssh_exchange_identification: read: Connection reset by peer\r\n
    # 一般是资产的 ssh 或者 防火墙 做了限制,无法连接资产(资产信息填错也可能会报这个错误)
    # 检查防火墙设置以及 /etc/hosts.allow /etc/hosts.deny

    # 提示 "MODULE FAILURE","module_stdout":"/bin/sh: 1: /usr/bin/python: not found\r\n","module_stderr":"Shared connection to xx.xx.xx.xx closed.\r\n"
    # 一般是资产 python 未安装或者 python 异常

其他问题可参考 `FAQ <faq.html>`_
