Merge pull request #2431 from wojiushixiaobai/docs

[Fix]更新

docs/admin_create_asset.rst

@@ -49,8 +49,9 @@
 .. code-block:: vim
 
     # "密码认证"和"密钥认证"是 SSH 连接跳板机时所使用的认证方式(都不选会造成无法使用 SSH 方式连接登录跳板机,不影响 web 登录)
+    # "命令存储""录像存储"位置设置
+    # "Telnet成功正则表达式" telnet设备登陆失败需要设置
 
-    # "命令记录""录像存储"位置设置
     # 修改后,需要修改在Jumpserver 会话管理-终端管理 修改terminal的配置 录像存储 命令记录,然后重启 Jumpserver 服务
     # 设置后重启 Coco 才能生效
 
@@ -59,7 +60,7 @@
 
 .. code-block:: vim
 
-    # "MAF二次认证"勾选会开启全局强制"MFA",所有jumpserver用户必须使用动态口令进行认证登录(及时生效)
+    # "MAF二次认证"勾选会开启全局强制"MFA",所有jumpserver用户必须使用动态口令进行认证登录(即时生效)
     # "限制登录失败"和"限制登录时间"设置需要重启jumpserver才能生效
     # "SSH最大空闲时间"设置需要重启jumpserver才能生效
     # "密码校验规则"设置立即生效

docs/faq.rst

@@ -38,11 +38,6 @@ FAQ
     $ 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
-
     # Ubuntu
     $ apt-get install language-pack-zh-hans
     $ echo 'LANG="zh_CN.UTF-8"' > /etc/default/locale
@@ -79,6 +74,16 @@ FAQ
     # 新建超级用户的命令如下命令
     $ python manage.py createsuperuser --username=user --email=user@domain.com
 
+    # 登陆提示密码过期可以直接点击忘记密码, 通过邮箱重置; 如果未设置邮箱, 通过以下代码重置
+    $ source /opt/py3/bin/activate
+    $ cd /opt/jumpserver/apps
+    $ cd /opt/jumpserver/apps
+    $ python manage.py shell
+    > from users.models import User
+    > u = User.objects.get(username='admin')  # admin 为你要修改的用户
+    > u.reset_password('password')  # password 为你要修改的密码
+    > u.save()
+
 6. 修改登录超时时间(默认 10 秒)
 
 .. code-block:: shell
@@ -104,6 +109,8 @@ FAQ
     # SESSION_COOKIE_AGE: 86400
     SESSION_EXPIRE_AT_BROWSER_CLOSE: true
 
+    # 86400 单位是秒(s)
+
 8. 资产授权说明
 
 .. code-block:: vim

docs/faq_telnet.rst

 Telnet 使用说明
 ------------------------------
 
-资产的创建与系统用户的创建与ssh大同小异
+资产的创建与系统用户的创建选择telnet
 
 1. telnet 连不上
 
-.. code-block:: shell
-
-    # 这是因为coco无法判断telnet的返回状态导致的,需要修改如下代码
-    $ vi /opt/coco/coco/connection.py  # 第 174 行
-
-.. code-block:: python
-
-    class TelnetConnection:
-
-        def __init__(self, asset, system_user, client):
-            self.client = client
-            self.asset = asset
-            self.system_user = system_user
-            self.sock = None
-            self.sel = selectors.DefaultSelector()
-            self.incorrect_pattern = re.compile(
-                r'incorrect|failed|失败|错误', re.I
-            )
-            self.username_pattern = re.compile(
-                r'login:\s*$|username:\s*$|用户名:\s*$|账\s*号:\s*$', re.I
-            )
-            self.password_pattern = re.compile(
-                r'password:\s*$|passwd:\s*$|密\s*码:\s*$', re.I
-            )
-            self.success_pattern = re.compile(
-                r'Last\s*login|success|成功', re.I
-            )
-
 .. code-block:: vim
 
-    # 在 'incorrect|failed|失败|错误|在这里加入你设备登录失败的提示符|可以多个|可以正则匹配'
-    # 在 'Last\s*login|success|成功|在这里加入你设备登录成功的提示符|可以多个|可以正则匹配'
-
-    例：XX路由器  使用 telnet 命令登录成功提示符#   登录失败提示Error
-    修改 'incorrect|failed|失败|错误|Error'
-    修改 'Last\s*login|success|成功|#'
-
-    其实就是通过 tenlet 命令登录成功和失败的返回字符串加上，让代码能正确判断登录成功和失败
-
-    是 通过 tenlet 命令登录 成功和失败 的返回字符串
-    是 通过 telnet 命令登录
-    是 telnet 命令登录
+    # 需要在 Web "系统设置"-"终端设置" 添加成功判断代码
+    # 是 通过 "tenlet" 命令登录 telnet设备 "成功" 的返回字符串
 
     # 保存后需要重启coco组件
-
-    # 你也可以把你的设备登录成功和登录失败的信息发到jumpserver的项目问题里面,我们会在下个版本更新代码以支持你的设备

docs/faq_upgrade.rst

@@ -85,7 +85,7 @@
 
     $ 参考升级文档继续升级到最新版本即可
 
-    # 删除原数据库命令
+    # 删除原数据库命令(谨慎操作)
     $ mysql -uroot
     > drop database jumpserver;
     > quit

docs/migration.rst

 服务迁移
 -------------
 
-对 Jumpserver 服务进行迁移, 只需要备份 数据库 和 jumpserver 目录即可
+对 Jumpserver 服务进行迁移, 只需要备份 "数据库" 和 "jumpserver目录" 即可
+注：1.4.5及之后的版本迁移, 只需要迁移 "数据库" "配置文件" 和 "录像目录"
 
 1. 备份数据到新的服务器