diff --git a/docs/admin_create_asset.rst b/docs/admin_create_asset.rst
index 8913d2c645fe4371d2e4af8bf0058e64622f5522..e79d9f02f35b19e6e7f03b7c5f5bdcc7ae66f1c6 100644
--- a/docs/admin_create_asset.rst
+++ b/docs/admin_create_asset.rst
@@ -79,6 +79,25 @@ Windows 生成 SSH 密钥可以参考（https://www.cnblogs.com/horanly/p/660410
 
 .. image:: _static/img/coco_check_terminal.jpg
 
+如 coco 不在线或者服务不正常，可以尝试重启 coco
+
+::
+
+    $ cd /opt/coco
+    $ ./cocod restart  # 请确保 jumpserver 已经正常运行。
+
+如 guacamole 不在线或者服务不正常，可以尝试重启容器
+
+::
+
+    $ docker ps  # 查询正在运行的容器，记录下容器的 <CONTAINER ID> ，可以附加 -a 参数查询所有容器
+    CONTAINER ID        IMAGE                                             COMMAND             CREATED             STATUS                   PORTS               NAMES
+    6b15fcf0e5f3        registry.jumpserver.org/public/guacamole:latest   "/init"             2 weeks ago         Exited (0) 10 days ago                       gracious_hugle
+
+    $ docker restart 6b15fcf0e5f3  # 6b15fcf0e5f3 是通过docker ps查询到的，请不要直接复制。
+
+    # docker 用法： docker start|stop|restart|rm|rmi <CONTAINER ID>
+
 命令行登录 Jumpserver 使用如下命令：
 
 ::
diff --git a/docs/faq.rst b/docs/faq.rst
index 4812ac98296a4a40177639621535fd15004d216a..735afe935f1480dff6daa4b00972e327d22fee69 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -1,7 +1,7 @@
 FAQ
 ==========
 
-1. Windows 无法连接
+1. Windows 资产连接错误排查思路
 
 ::
 
@@ -11,7 +11,16 @@ FAQ
     (4). 提示无法连接服务器，请联系管理员或查看日志 一般情况下是登录的系统账户不正确，可以从Windows的日志查看信息
     (5). 提示网络问题无法连接或者超时，请检查网络连接并重试，或联系管理员 一般情况下是防火墙设置不正确，可以从Windows的日志查看信息
 
-2. 用户、系统用户、管理用户的关系
+2. Linux 资产连接错误排查思路
+
+::
+
+    (1). 检查管理用户的权限是否正确，权限需要与root权限一致。
+    (2). 检查资产的防火墙策略，可以在资产上面新建个用户，尝试用此用户进行ssh连接。
+    (3). 检查资产的python，确定版本不小于2.6，不高于3.x。
+    (4). 检查资产的ssh策略，确保可以被jumpserver应用访问。
+
+3. 用户、系统用户、管理用户的关系
 
 ::
 
@@ -24,11 +33,11 @@ FAQ
     Sudo: /usr/bin/git,/usr/bin/php,/bin/cat,/bin/more,/bin/less,/usr/bin/head,/usr/bin/tail
     意思是允许这个系统用户免密码执行 git、PHP、cat、more、less、head、tail 命令，只要关联了这个系统用户的用户在相应的资产都可以执行这些命令。
 
-3. coco或guacamole 注册失败，或重新注册方法
+4. coco或guacamole 注册失败，或重新注册方法
 
 ::
 
-   (1). 停止 coco 或 删掉 guacamole 的docker
+    (1). 停止 coco 或 删掉 guacamole 的docker
 
       $ cd /opt/coco && ./cocod stop
 
@@ -45,67 +54,67 @@ FAQ
       $ rm /opt/guacamole/key/*  # guacamole, 如果你是按文档安装的，key应该在这里
 
 
-4. Ansible报错汇总
+5. Ansible报错汇总
 
 ::
 
-   (1). 资产是centos5.x Python版本 2.4，
+    (1). 资产是centos5.x Python版本 2.4，
 
-       $ yum -y install python26
-       $ mv /usr/bin/python /usr/bin/python.bak
-       $ ln -s /usr/bin/python2.6 /usr/bin/python
+        $ yum -y install python26
+        $ mv /usr/bin/python /usr/bin/python.bak
+        $ ln -s /usr/bin/python2.6 /usr/bin/python
 
-       # 修改 /bin/yum 使用原来的python
-       $ sed -i 's@/usr/bin/python$@/usr/bin/python2.4@g' /bin/yum
+        # 修改 /bin/yum 使用原来的python
+        $ sed -i 's@/usr/bin/python$@/usr/bin/python2.4@g' /bin/yum
 
-5. input/output error, 通常jumpserver所在服务器字符集问题
+6. input/output error, 通常jumpserver所在服务器字符集问题
 
 ::
 
-   # Centos7
-   $ localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8
-   $ export LC_ALL=zh_CN.UTF-8
-   $ echo 'LANG=zh_CN.UTF-8' > /etc/locale.conf
+    # Centos7
+    $ localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8
+    $ export LC_ALL=zh_CN.UTF-8
+    $ echo 'LANG=zh_CN.UTF-8' > /etc/locale.conf
 
-   # Centos6
-   $ localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8
-   $ export LC_ALL=zh_CN.UTF-8
-   $ echo 'LANG=zh_CN.UTF-8' > /etc/sysconfig/i18n
+    # Centos6
+    $ localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8
+    $ export LC_ALL=zh_CN.UTF-8
+    $ echo 'LANG=zh_CN.UTF-8' > /etc/sysconfig/i18n
 
-   如果任然报input/output error，尝试执行 yum update 后重启服务器（仅测试中参考使用，实际运营服务器请谨慎操作）
+    如果任然报input/output error，尝试执行 yum update 后重启服务器（仅测试中参考使用，实际运营服务器请谨慎操作）
 
-6. 运行 sh make_migrations.sh 报错，
-   CommandError: Conflicting migrations detected; multiple ... django_celery_beat ...
-   这是由于 django-celery-beat老版本有bug引起的
+7. 运行 sh make_migrations.sh 报错，
+    CommandError: Conflicting migrations detected; multiple ... django_celery_beat ...
+    这是由于 django-celery-beat老版本有bug引起的
 
 ::
 
-   $ rm -rf /opt/py3/lib/python3.6/site-packages/django_celery_beat/migrations/
-   $ pip uninstall django-celery-beat
-   $ pip install django-celery-beat
+    $ rm -rf /opt/py3/lib/python3.6/site-packages/django_celery_beat/migrations/
+    $ pip uninstall django-celery-beat
+    $ pip install django-celery-beat
 
-7. 连接测试常见错误
+8. 连接测试常见错误
 
 ::
 
-   (1). to use the 'ssh' connection type with passwords, you mast install the sshpass program
+    (1). to use the 'ssh' connection type with passwords, you mast install the sshpass program
 
-       # Centos
-       $ yum -y install sshpass
+        # Centos
+        $ yum -y install sshpass
 
-       # Ubuntu
-       $ apt-get -y install sshpass
+        # Ubuntu
+        $ apt-get -y install sshpass
 
     注意，在 coco 服务器上面安装完成后需要重启服务。
 
-   (2). Authentication failure
+    (2). Authentication failure
 
-       # 一般都是资产的管理用户不正确
+        # 一般都是资产的管理用户不正确
 
-   (3). Failed to connect to the host via ssh: ssh_exchange_identification: read: Connection reset by peer\r\n
+    (3). Failed to connect to the host via ssh: ssh_exchange_identification: read: Connection reset by peer\r\n
 
-       # 一般是资产的 ssh 或者 防火墙 做了限制
+        # 一般是资产的 ssh 或者 防火墙 做了限制
 
-   (4). "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"
+    (4). "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 异常，此问题多发生在 ubuntu 资产上
+        # 一般是资产 python 未安装或者 python 异常，此问题多发生在 ubuntu 资产上
diff --git a/docs/fool_install.rst b/docs/fool_install.rst
index f8128c6d3d07deac109a4b3746697c5819b674c4..64eff68899a3804825119227474d5a211520bca1 100644
--- a/docs/fool_install.rst
+++ b/docs/fool_install.rst
@@ -22,10 +22,11 @@
 错误情况
 ```````````````
 
-如果遇到错误，本脚本会以中文的形式大致叙述一下解决方法，请自行尝试解决，意外问题
+如果遇到错误，本脚本会以中文的形式大致叙述一下解决方法，请自行尝试解决，如网络原因文件下载失败，请删除未下载完成的文件后手动执行该命令。
 
 
 安装后期
 ```````````````
 
-安装后期请参阅配置文档做安全配置。
\ No newline at end of file
+后续的使用请参考 `快速入门 <admin_create_asset.html>`_
+如遇到问题可参考 `FAQ <faq.html>`_
diff --git a/docs/quickstart.rst b/docs/quickstart.rst
index 73b0fe357ec12af180a53b8f190800ebd2eda0a8..b40aff11b98db3ba6b4515391264378469ab8599 100644
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -6,7 +6,7 @@ Jumpserver 封装了一个 All in one Docker，可以快速启动。该镜像集
 Tips: 不建议在生产中使用, 因为所有软件都打包到一个Docker中了，不是Docker最佳实践，
 生产中请使用 详细安装 `CentOS <step_by_step.html>`_ `Ubuntu <setup_by_ubuntu.html>`_
 
-CentOS7 自动安装脚本脚本见 `自动安装 <fool_install.html>`_
+CentOS7 自动安装脚本脚本见: `自动安装 <fool_install.html>`_
 
 Docker 安装见: `Docker官方安装文档 <https://docs.docker.com/install/>`_
 
diff --git a/docs/setup_by_ubuntu.rst b/docs/setup_by_ubuntu.rst
index 1c2674a9ebe95420298d567511b3fddfcd3c8740..854e6edfc2aa00d5de33e58fde64fc92364ce3e6 100644
--- a/docs/setup_by_ubuntu.rst
+++ b/docs/setup_by_ubuntu.rst
@@ -140,7 +140,7 @@
 
     # 新版本更新了运行脚本，使用方式./jms start|stop|status|restart all  后台运行请添加 -d 参数
 
-运行不报错，请浏览器访问 http://192.168.244.144:8080/ 页面显示不正常先不用处理，能显示 jumpserver 页面即可继续往下操作
+运行不报错，请浏览器访问 http://192.168.244.144:8080/ 页面显示不正常先不用处理，继续往下操作
 
 三. 安装 SSH Server 和 WebSocket Server: Coco
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -173,26 +173,12 @@
 
     # 新版本更新了运行脚本，使用方式./cocod start|stop|status|restart 后台运行请添加 -d 参数
 
-后面设置好 nginx 后，记得去 Jumpserver 管理后台-会话管理-终端管理（http://192.168.244.144:8080/terminal/terminal/）接受 Coco 的注册
-
 ::
 
     Coco version 1.0.0, more see https://www.jumpserver.org
     Starting ssh server at 0.0.0.0:2222
     Quit the server with CONTROL-C.
 
-**3.4 测试连接**
-
-::
-
-    $ ssh -p2222 admin@192.168.244.144
-    密码: admin
-
-    如果是用在 Windows 下，Xshell Terminal 登录语法如下
-    $ssh admin@192.168.244.144 2222
-    密码: admin
-    如果能登陆代表部署成功
-
 四. 安装 Web Terminal 前端: Luna
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -296,7 +282,7 @@ Luna 已改为纯前端，需要 Nginx 来运行访问
 
         location /guacamole/ {
             proxy_pass       http://localhost:8081/;
-            ## 请手动修改 localhost:8081 为自己 guacamole 的地址, 不能使用 localhost 和 127.0.0.1
+            ## 请手动修改 localhost:8081 为运行 docker 服务的服务器地址, windows资产连接白屏的问题多数是出现在这里
             proxy_buffering off;
             proxy_http_version 1.1;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -324,7 +310,19 @@ Luna 已改为纯前端，需要 Nginx 来运行访问
 
 默认账号: admin 密码: admin
 
-到管理后台-会话管理-终端管理 接受 Coco Guacamole 等应用的注册
+到会话管理-终端管理 接受 Coco Guacamole 等应用的注册
+
+** 测试连接**
+
+::
+
+    $ ssh -p2222 admin@192.168.244.144
+    密码: admin
+
+    如果是用在 Windows 下，Xshell Terminal 登录语法如下
+    $ssh admin@192.168.244.144 2222
+    密码: admin
+    如果能登陆代表部署成功
 
 后续的使用请参考 `快速入门 <admin_create_asset.html>`_
 如遇到问题可参考 `FAQ <faq.html>`_
diff --git a/docs/step_by_step.rst b/docs/step_by_step.rst
index 342a9916ceebf7781092ffd577d5d956d48212e8..298b73417dc86d722257152496d80f48d467e9e5 100644
--- a/docs/step_by_step.rst
+++ b/docs/step_by_step.rst
@@ -168,7 +168,7 @@ Pip 加速设置请参考 <https://segmentfault.com/a/1190000011875306>
 
     # 新版本更新了运行脚本，使用方式./jms start|stop|status|restart all  后台运行请添加 -d 参数
 
-运行不报错，请浏览器访问 http://192.168.244.144:8080/ 页面显示不正常先不用处理，需要搭建 nginx 代理就可以正常访问了
+运行不报错，请浏览器访问 http://192.168.244.144:8080/  页面显示不正常先不用处理，搭建 nginx 代理就可以正常访问了
 
 附上重启的方法
 
@@ -208,26 +208,12 @@ Pip 加速设置请参考 <https://segmentfault.com/a/1190000011875306>
 
     # 新版本更新了运行脚本，使用方式./cocod start|stop|status|restart  后台运行请添加 -d 参数
 
-后面设置好 nginx 后，记得去 Jumpserver 管理后台-会话管理-终端管理（http://192.168.244.144:8080/terminal/terminal/）接受 Coco 的注册
-
 ::
 
     Coco version 1.0.0, more see https://www.jumpserver.org
     Starting ssh server at 0.0.0.0:2222
     Quit the server with CONTROL-C.
 
-**3.4 测试连接**
-
-::
-
-    $ ssh -p2222 admin@192.168.244.144
-    密码: admin
-
-    如果是用在 Windows 下，Xshell Terminal 登录语法如下
-    $ssh admin@192.168.244.144 2222
-    密码: admin
-    如果能登陆代表部署成功
-
 四. 安装 Web Terminal 前端: Luna
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -339,7 +325,7 @@ Jumpserver 会话管理-终端管理（http://192.168.244.144:8080/terminal/term
         }
 
         location /guacamole/ {
-            proxy_pass       http://localhost:8081/;  # 如果guacamole安装在别的服务器，请填写它的ip
+            proxy_pass       http://localhost:8081/;  # 请修改成运行docker服务的服务器IP，windows资产连接白屏的问题多数是出现在这里
             proxy_buffering off;
             proxy_http_version 1.1;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -376,7 +362,19 @@ Jumpserver 会话管理-终端管理（http://192.168.244.144:8080/terminal/term
 
 默认账号: admin 密码: admin
 
-到管理后台-会话管理-终端管理 接受 Coco Guacamole 等应用的注册
+到会话管理-终端管理 接受 Coco Guacamole 等应用的注册
+
+** 测试连接**
+
+::
+
+    $ ssh -p2222 admin@192.168.244.144
+    密码: admin
+
+    如果是用在 Windows 下，Xshell Terminal 登录语法如下
+    $ssh admin@192.168.244.144 2222
+    密码: admin
+    如果能登陆代表部署成功
 
 后续的使用请参考 `快速入门 <admin_create_asset.html>`_
 如遇到问题可参考 `FAQ <faq.html>`_