如何使用VSCode 连接 JumpServer 资产

一时失言乱红尘 2024-03-27 10:42 77阅读 0赞

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

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

### 概述 ###

本文主要介绍如何通过 Visual Studio Code（以下简称VSCode）的 Remote-SSH 插件直连 JumpServer 所纳管的 Linux-SSH 协议资产，从而进行远程开发。  
VSCode 是一个运行于 Mac OS X、Windows 和 Linux 之上的，针对于编写现代 Web 和云应用的跨平台源代码编辑器。它支持几乎所有主流的开发语言的语法高亮、智能代码补全、自定义快捷键、括号匹配和颜色区分、代码片段、代码对比 Diff、GIT 命令 等特性，支持插件扩展，并针对网页开发和云端应用开发做了优化。  
需注意：

1. VScode 在连接服务器时，需要在服务器上安装客户端，即 ".vscode-server" 。默认安装于登陆的用户名下，例如：使用 root 用户，即安装至 /root 下；  
2. 服务器连接外网时，可直接下载 VScode 客户端安装使用；服务器无法连接外网时，需要自行下载 VScode 的客户端或者复制安装好的".vscode-server"，再使用 VScode 连接服务器。  
\#注意复制的 .vscode-server 的权限与用户从属，权限和从属都应该属于需要连接的用户。  
小贴士：可将原本的 .vscode-server 打包之后解压，防止权限和从属发生改变。

优点

VSCode 有非常丰富的插件系统，无论是编辑 HTML、CSS、JS、TS、Vue、React 等前端代码，还是 JAVA、Python 等后端代码，都可以找到相对应的插件。  
VSCode 相比较于其他的 xshell、putty 等软件使用 ssh 命令行方式连接服务器，它可以通过直连资产更优的编辑文件 。  
针对于修改代码的操作，VSCode 可以直接编辑代码。xshell 等软件需要把源代码在本地修改好之后进行上传。  
针对于服务器操作，VSCode 除了可以直接进行文件的修改之外，还可以对服务器进行命令操作。

缺点

该方式直连 JumpServer 所纳管的 Linux-SSH 协议资产进行的操作并不会在 JumpServer 中留下操作内容与录像，无法实现审计功能。  
注：只会在登录日志中留下登录信息。

### 下载软件 ###

VSCode 的下载地址：[https://code.visualstudio.com/download][https_code.visualstudio.com_download]

### 配置 JumpServer ###

实现通过 Visual Studio Code 的 Remote-SSH 插件直连 JumpServer 所纳管的 Linux-SSH 协议资产还需要在 JumpServer 的配置文件（config.txt）中修改如下：

ENABLE_LOCAL_PORT_FORWARD=true
    ENABLE_VSCODE_SUPPORT=true

### VSCode 配置 ###

安装 VSCode 后下载 Remote-ssh 插件。

具体步骤：在“扩展”中搜索“ Remote\_ssh ”,得到插件进行安装。安装后左下角出现绿色小标，如下图所示。

![9b91139589b7e29a2ebc518b0c9ba4bc.png][]

![6518062623250b496297486c6797fd6e.png][]

使用 VSCode 连接 JumpServer 所纳管的 Linux-SSH 协议资产有以下两种方法。

#### 直连法 ####

1、点击左下角绿色标识，中间上方选择“ Connect to Host ”。

![75a8e2f55ebd60eb87981db1046d3694.png][]

2、选择“ Add New SSH Host ”。

![86fa81b8345164f2142345c7856d871d.png][]

3、 输入如下图所示。

![db0177ba01cb8c195b20d5c46a00d3a3.png][]

ssh jumpserverUsername@systemUsername@AssetIP@jumpserverHostIP -p2222
    解释：
    - jumpserverUsername：登录 JumpServer 的用户
    - systemUsername：连接资产指定的系统用户
    - AssetIP：指定要连接的资产
    - jumpserverHostIP：JumpServer 服务 IP
    - 2222：KOKO 端口
    注：
    systemUsername 是该资产所有授权中，唯一的登录用户名，只匹配一条
    AssetIP 是所有资产授权中，唯一匹配到 IP，只匹配一条

4、 选择 ssh 配置更新存储的文件位置。如下图所示。

![0c7ce3ce5ece07e5e13197b1d61b3496.png][]

5、选择“ content ”。

![b4250bb96e8267aa95bf17362aa38095.png][]

6、输入 JumpServer 的登录密码。

![887c4e0ee5ef6463e287c61e0c0307b3.png][]

7、连接资产成功。

![c56bd6b7e859eb31aff5bfb18f5ad030.png][]

8、打开资产文件，即可进行操作。

![5c385ffcf0865ba916379bd807580fa0.png][]

![83b8cb61c600db61f8cb2836fd20c725.png][]

9、对资产进行命令操作。

![17791a6a82fc38413b5d39939d8da4a8.png][]

#### 编辑配置文件法 ####

1、直接编辑 ssh 配置文件。

![ad8dc8415cea7a74c6d3fcf8235fbb48.png][]

文件内容如下图所示：

![e7055e7dc0efe2499575f569f15a7f7c.png][]

2、选择连接的资产，输入登录 JumpServer 的密码。

![17b999c299981c7bf989d7e7f18c8f6f.png][]

![184aa10e84efab6ac81c0a00bf494d85.png][]

3、资产连接成功

![f193492a6a822656ad91bf043c5d2401.png][]

### JumpServer 开启 MFA 使用 VScode 登录资产 ###

默认情况下，使用 VScode 连接 JumpServer纳管的资产在连接时，输入密码后会一直卡在MFA输入环节，不弹出任何页面。如下图所示：

![55cd21a423a2b2297fd52af0654cfda8.png][]

此时点击右下角的“details”会出现终端页面，在此页面进行MFA输入，如下图所示：

![818fd3ec19ee2c60b50e32d7d967737d.png][]

输入后，页面顶端再次出现密码输入弹框，输入JumpServer用户密码即可登录资产。

重新开启新终端即可打开如下界面：

![d6855df28871883d568b7fcb567ad034.png][]

[JumpServer - _ -]: https://jumpserver.org/
[JumpServer]: https://jinshuju.net/f/sQ91MK
[https_code.visualstudio.com_download]: https://code.visualstudio.com/download
[9b91139589b7e29a2ebc518b0c9ba4bc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/74cf1a790d72493fa06415cf3a5fd856.png
[6518062623250b496297486c6797fd6e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/cb57ec0f88e74b57ba6d9f021468c64d.png
[75a8e2f55ebd60eb87981db1046d3694.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/8bc0bf99d735456c8c95c14d4b23a023.png
[86fa81b8345164f2142345c7856d871d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/63d70a813fc34c27b3ecf5973415cd39.png
[db0177ba01cb8c195b20d5c46a00d3a3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/052650842cf34814abe9b3fa6e430c6d.png
[0c7ce3ce5ece07e5e13197b1d61b3496.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/ab4b17f3ee8a49bfa9953bef58b2d1de.png
[b4250bb96e8267aa95bf17362aa38095.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/bf1c54b42db54020bd2aa97cf90fff8e.png
[887c4e0ee5ef6463e287c61e0c0307b3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/c8fa1da4e17a4653b948997e5dd1da94.png
[c56bd6b7e859eb31aff5bfb18f5ad030.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/fb31f7c80f4e4e0993f44bb441f0f835.png
[5c385ffcf0865ba916379bd807580fa0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/52e833ece4f94eecbbad6e547cb00f41.png
[83b8cb61c600db61f8cb2836fd20c725.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/cbf76b1cecc44b058faa1eb2073c8345.png
[17791a6a82fc38413b5d39939d8da4a8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/18498b7cf1c24bbe9ae0e55f7ce4404c.png
[ad8dc8415cea7a74c6d3fcf8235fbb48.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/ac5cf959539f4844b018a4726f284d4f.png
[e7055e7dc0efe2499575f569f15a7f7c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/e7b2ab2ddc4846349dbe69c8bc676ce2.png
[17b999c299981c7bf989d7e7f18c8f6f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/e3df288b75264f609b1d7dc38fcb67e2.png
[184aa10e84efab6ac81c0a00bf494d85.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/7ffa92674db24aa782753c3c73b6f8b7.png
[f193492a6a822656ad91bf043c5d2401.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/695eaf784f894d90a2eb17e62d7e075a.png
[55cd21a423a2b2297fd52af0654cfda8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/b894d0d388834a7b8fa8cef90a7bbc9e.png
[818fd3ec19ee2c60b50e32d7d967737d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/b49bf8d88772481db7b243bd250d8808.png
[d6855df28871883d568b7fcb567ad034.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/fab92be2da794fb88d17bebc87148172.png