# Jump Server 堡垒机搭建及使用

#### 博客作者：联系请[点击](https://hezhiqiang.gitbook.io/about-the-author/lian-xi-zuo-zhe)，搬运不易，希望请作者喝咖啡，可以点击联系[博客作者](https://hezhiqiang.gitbook.io/about-the-author/lian-xi-zuo-zhe)

## 一、**Jump Server简介及环境要求**

{% embed url="http://jumpserver.org/" %}

### 演示视频

{% embed url="https://jumpserver.oss-cn-hangzhou.aliyuncs.com/jms-media/%E3%80%90%E6%BC%94%E7%A4%BA%E8%A7%86%E9%A2%91%E3%80%91Jumpserver%20%E5%A0%A1%E5%9E%92%E6%9C%BA%20V1.5.0%20%E6%BC%94%E7%A4%BA%E8%A7%86%E9%A2%91%20-%20final.mp4" %}

### Jumpserver **官方介绍**

* Jumpserver 是全球首款完全开源的堡垒机, 使用 GNU GPL v2.0 开源协议, 是符合 4A 的专业运维审计系统。
* Jumpserver 使用 Python / Django 进行开发, 遵循 Web 2.0 规范, 配备了业界领先的 Web Terminal 解决方案, 交互界面美观、用户体验好。
* Jumpserver 采纳分布式架构, 支持多机房跨区域部署, 中心节点提供 API, 各机房部署登录节点, 可横向扩展、无并发访问限制。
* Jumpserver 现已支持管理 SSH、 Telnet、 RDP、 VNC 协议资产。

### 架构图

&#x20;JumpServer 分为多个组件，大致的架构如下图所示。其中 [Lina](https://github.com/jumpserver/lina/) 和 [Luna](https://github.com/jumpserver/luna/) 为纯静态文件，最终由 [nginx](http://nginx.org/) 整合。

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-Mhy31TQDP91CQuw-CNP%2F-Mhy3H_goa3bB3OZZQzo%2Fimage.png?alt=media\&token=2fa8b08c-ad7b-4917-8d70-a8c41056700b)

### 官方DEMO

{% embed url="https://demo.jumpserver.org/" %}

### &#x20;环境要求

**JumpServer 组件及其监听端口**

```
Jumpserver  8080/tcp
Redis  6379/tcp
MySQL/Mariadb  3306/tcp
Nginx  80/tcp
Koko  SSH 2222/tcp Web Terminal 5000/tcp
Guacamole  8081/tcp
```

系统: CentOS Linux release 8.4.2105

```bash
$ uname -r
4.18.0-305.3.1.el8.x86_64
```

```bash
$ cat /etc/redhat-release
CentOS Linux release 8.4.2105
```



| Name | Core | Python | MySQL | MariaDB | Redis |
| ---- | ---- | ------ | ----- | ------- | ----- |

| Version | v2.13.1 | >= 3.6 | >= 5.7 | >= 10.2 | >= 6 |
| ------- | ------- | ------ | ------ | ------- | ---- |

#### **关闭 SELinux 和防火墙**

```bash
 setenforce 0             # 可以设置配置文件永久关闭
 sed -i "s/SELINUX=enforcing/SELINUX=disabled/g" /etc/selinux/config
 firewall-cmd --zone=public --add-port=80/tcp –permanent      #nginx 端口
 firewall-cmd --zone=public --add-port=2222/tcp –permanent    #用户SSH登录端口
 firewall-cmd --permanent --add-rich-rule="rule family="ipv4" source address="172.17.0.0/16" port protocol="tcp" port="8080" accept"  # 设置防火墙规则，允许容器ip访问宿主8080端口 
 firewall-cmd –reload     # 重新载入规则
 iptables -F
 iptables-save
```

### 添加镜像源仓库

{% embed url="https://developer.aliyun.com/mirror/" %}

## **二、准备 Python3 和 Python 虚拟环境**

### &#x20;**安装依赖软件包**

```bash
dnf -y install wget gcc epel-release git vim wget unzip make cmake zlib-devel compat-openssl10
```

### &#x20;**安装Python3.6**

{% hint style="danger" %}
这里要注意的是一定要下载官方指导版本，python3.6以上有些模块不支持，启动jump server会报错
{% endhint %}

```
dnf install -y python36 python36-devel
```

{% hint style="warning" %}
如果前面已经正常安装了 Python, 可以跳过此步骤，这里提供两种方式

**编译安装pyhton-3.6.9**

Python官网下载地址：

[**https://www.python.org/**](https://www.python.org/)



```bash
wget https://www.python.org/ftp/python/3.6.9/Python-3.6.9.tgz
tar -xf Python-3.6.9.tgz -C /usr/local/
cd /usr/local/Python-3.6.9/
yum --exclude=kernel* update -y
yum groupinstall -y 'Development Tools'
yum install -y gcc openssl-devel bzip2-devel libffi-devel
./configure && make && make install
```
{% endhint %}

{% embed url="https://www.python.org" %}

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYEhPWmGIXSKaGhQ%2F1.png?generation=1577790628082173\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYEio9kQOrDx7YLc%2F2.png?generation=1577790628077184\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYEkrzm9a0pJ97mg%2F4.png?generation=1577790628006616\&alt=media)

### &#x20;**建立Python虚拟环境**

{% hint style="info" %}
因为 CentOS 6/7 自带的是 Python2，而 Yum 等工具依赖原来的 Python，为了不扰乱原来的环境我们来使用 Python 虚拟环境
{% endhint %}

创建虚拟环境，环境命令自定义为py3

```bash
cd /opt  && python3.6 -m venv py3             
source /opt/py3/bin/activate                 
```

{% hint style="danger" %}
部分系统可能会提示 source: not found , 可以使用 "." 代替 "source"

```
. /opt/py3/bin/activate
```
{% endhint %}

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8cB9zyEgW_tjDU5UK%2F-MK8daZDWZ02ccurpdXt%2Fimage.png?alt=media\&token=a9a6df67-8c41-4d4d-86b4-aa668629db5d)

{% hint style="success" %}
**看到下面的提示符代表成功，以后运行Jumpserver都要先运行以上source命令，以下所有命令均在虚拟环境中运行**
{% endhint %}

```
(py3) [root@JumpServer py3]
```

## **三、安装 Redis**

```bash
 dnf -y install redis
 systemctl enable --now redis
 systemctl status redis
 rpm -qa redis
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8FqYaFcyCPNmeXyTb%2F-MK8HOs0puHKCn44THbR%2Fimage.png?alt=media\&token=3d3b3cf5-c323-419e-85ec-25e0c1e6e64a)

### 设置Redis密码

```
REDIS_PASSWORD=`cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 24`
echo "REDIS_PASSWORD=$REDIS_PASSWORD" >> ~/.bashrc
echo -e "\033[31m 你的REDIS_PASSWORD是 $REDIS_PASSWORD \033[0m"
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKVSOKS1FZx_P-Kn0Vv%2F-MKVUQ_16LwsBmugV5FK%2Fimage.png?alt=media\&token=5037d4c5-bafc-4e96-99a3-098a5c322a3f)

```
sed -i "s/# requirepass foobared/requirepass $REDIS_PASSWORD/g"  /etc/redis.conf
systemctl restart redis
```

#### 验证密码是否能正常登录成功、查询等

```
redis-cli -h 127.0.0.1 -p 6379 -a $REDIS_PASSWORD
127.0.0.1:6379> keys *
127.0.0.1:6379> config get requirepass
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKV_RUv5N9pXDOP6zK9%2F-MKVbTs4yupodWniFXnG%2Fimage.png?alt=media\&token=2251f68c-b788-445d-9083-deb57fe6cfc3)

## &#x20;四、**安装Mariadb数据库**

```bash
 dnf -y install mariadb mariadb-devel mariadb-server
 systemctl enable --now mariadb
 systemctl status mariadb
 rpm -aq mariadb
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8FqYaFcyCPNmeXyTb%2F-MK8JVU5rbtBDLGedzT3%2Fimage.png?alt=media\&token=3c77dd3c-ae76-49de-a1f0-29275b0783e4)

### 初始化数据库

```
mysql_secure_installation

```

```
Enter current password for root (enter for none): # 输入root的当前密码（不输入密码）
New password:                                     # 新密码：
Re-enter new password:                            # 重新输入新的密码：
Set root password                                 # 设置root密码
Remove anonymous users?                           # 删除匿名用户？
Disallow root login remotely?                     # 禁止远程root登录？
Remove test database and access to it?            # 删除测试数据库并访问它？
Reload privilege tables now?                      # 现在重新加载特权表？
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8KdGXg--vU2wQH02T%2F-MK8Ndr-9gPa_zLY33fy%2Fimage.png?alt=media\&token=b128d361-ebd6-4444-8301-794eab4f8a89)

### **创建数据库 Jumpserver 并授权验证**

&#x20;**生成随机数据库密码**

```bash
 DB_PASSWORD=`cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 24`
 echo -e "\033[31m 你的数据库密码是 $DB_PASSWORD \033[0m"
```

&#x20; **数据库配置**

{% hint style="danger" %}
**注意：这里数据库授权时**$DB\_PASWORD**变量，需替换成您自己生成的密码**
{% endhint %}

```bash
 mysql -uroot -p
 create database jumpserver default charset 'utf8' collate 'utf8_bin';
 grant all on jumpserver.* to 'jumpserver'@'127.0.0.1' identified by '$DB_PASWORD';   
 grant all on jumpserver.* to 'jumpserver'@'localhost' identified by '$DB_PASWORD';    
 flush privileges;
```

#### 数据库用户更改密码SQL语句

```
set password for 'username'@'host' = password('newpassword');
flush privileges;
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKUEyfMbNVCzK0KOD8u%2F-MKU_KKtYs-403vbo9aa%2Fimage.png?alt=media\&token=85e96982-531f-437c-99c5-95cbbce996ec)

#### 验证授权是否正确，是否能正常登录成功

```
mysql -ujumpserver -p
show databases;
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKU_OaXg5Mn2JlIERtO%2F-MKUaazqAjWHcALdvovZ%2Fimage.png?alt=media\&token=1f4f539b-5651-46ef-9e74-d3ce8190030b)

## **五、安装 Jump Server**

### **下载 Jump Server 项目源码**

```bash
cd /opt && \
git clone git://github.com/jumpserver/jumpserver.git
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-Mhz7xVUOoHFFdX9EuXZ%2F-Mhz8WeRAOX6I_OPg1Q7%2Fimage.png?alt=media\&token=30ef4c64-3577-4bd1-bbae-38378de751fa)

{% hint style="success" %}
**网络问题参考文档：**[**国内常用加速配置**](https://he.zhiqiang.cloud/yun-wei-gong-ju-shi-yong/chang-yong-guo-nei-jia-su-yuan-shi-yong-ji-pei-zhi)
{% endhint %}

### 安装 **软件环境依赖**

```
dnf  -y install gcc krb5-devel libtiff-devel libjpeg-devel libzip-devel freetype-devel libwebp-devel tcl-devel tk-devel sshpass openldap-devel mariadb-devel libffi-devel openssh-clients telnet openldap-clients
```

### **安装 Python 库依赖**

```
vim  ~/.pydistutils.cfg
[easy_install]
index_url = https://mirrors.aliyun.com/pypi/simple/
```

```bash
cd /opt/jumpserver/requirements
source /opt/py3/bin/activate  
pip install wheel && \
pip install --upgrade pip setuptools && \
pip install -r requirements.txt
```

### 解决报错：

#### 错误一：

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8jE8kELTDGcuvlFFc%2F-MK8kAHNkdTKb1eI9zgA%2Fimage.png?alt=media\&token=f3763a64-7090-4c09-b0e7-1b970839a780)

#### 解决方法：

{% embed url="https://github.com/jumpserver/setuptools/blob/master/scripts/pypi/.pydistutils.cfg" %}

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8jE8kELTDGcuvlFFc%2F-MK8oGudt64lp37mBDwR%2Fimage.png?alt=media\&token=363f6558-b05c-44a2-a6f1-beffbfb9168d)

#### 步骤一：按照上面链接复制的两行内容，修改如下文件

```
vim  ~/.pydistutils.cfg
[easy_install]
index_url = https://mirrors.aliyun.com/pypi/simple/
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8jE8kELTDGcuvlFFc%2F-MK8okc_UfrrDrg8aQCN%2Fimage.png?alt=media\&token=a31af739-bde9-4e60-b63a-1b601e3dc0ec)

#### 步骤二：修改保存好，执行如下命令，完美解决

```
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8pAMgTBGc3obyJ7XV%2F-MK8pIrqRMfkk_BGLbVu%2Fimage.png?alt=media\&token=495c131a-02c3-440b-b1dc-f2f340ad2eef)

{% hint style="danger" %}
确保已经载入 py3 虚拟环境, 中间如果遇到报错一般是依赖包没装全。
{% endhint %}

#### 错误二：

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MK8qIk7djzr1v1qul_1%2F-MK8qbn1Yo7mdp2-s4nK%2Fimage.png?alt=media\&token=195bd115-4eaf-4838-be5f-3cf72e98c8b4)

{% hint style="info" %}
pip用法参考：[https://www.runoob.com/w3cnote/python-pip-install-usage.html](https://www.runoob.com/w3cnote/python-pip-install-usage.html)
{% endhint %}

#### 解决方法：

```
pip install 包名 -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com
```

{% hint style="info" %}
如果下载速度很慢, 可以换国内源

```
$ pip install --upgrade pip setuptools -i https://mirrors.aliyun.com/pypi/simple/
$ pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
```
{% endhint %}

### **修改 Jumpserver 配置文件**

```bash
 cd /opt/jumpserver
 cp config_example.yml config.yml
 SECRET_KEY=`cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 50`      
 echo "SECRET_KEY=$SECRET_KEY" >> ~/.bashrc
 BOOTSTRAP_TOKEN=`cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 16` 
 echo "BOOTSTRAP_TOKEN=$BOOTSTRAP_TOKEN" >> ~/.bashrc
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYEpusFBe4tc0F7x%2F9.png?generation=1577790627940429\&alt=media)

```bash
 sed -i "s/SECRET_KEY:/SECRET_KEY: $SECRET_KEY/g" /opt/jumpserver/config.yml
 sed -i "s/BOOTSTRAP_TOKEN:/BOOTSTRAP_TOKEN: $BOOTSTRAP_TOKEN/g" /opt/jumpserver/config.yml
 sed -i "s/# DEBUG: true/DEBUG: false/g" /opt/jumpserver/config.yml
 sed -i "s/# LOG_LEVEL: DEBUG/LOG_LEVEL: ERROR/g" /opt/jumpserver/config.yml
 sed -i "s/# SESSION_EXPIRE_AT_BROWSER_CLOSE: false/SESSION_EXPIRE_AT_BROWSER_CLOSE: true/g" /opt/jumpserver/config.yml
 sed -i "s/DB_PASSWORD: /DB_PASSWORD: $DB_PASSWORD/g" /opt/jumpserver/config.yml
 sed -i "s/# REDIS_PASSWORD: /REDIS_PASSWORD: $REDIS_PASSWORD/g" /opt/jumpserver/config.yml
 sed -i "s/# REDIS_DB_CELERY: 3/REDIS_DB_CELERY: 3/g" /opt/jumpserver/config.yml
 sed -i "s/# REDIS_DB_CACHE: 4/REDIS_DB_CACHE: 4/g" /opt/jumpserver/config.yml
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYEqqiO4W3VHi3tl%2F10.png?generation=1577790627992412\&alt=media)

```bash
 echo -e "\033[31m 你的SECRET_KEY是 $SECRET_KEY \033[0m"
 echo -e "\033[31m 你的BOOTSTRAP_TOKEN是 $BOOTSTRAP_TOKEN \033[0m"
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYErs-FpZnXJjM1H%2F11.png?generation=1577790627943235\&alt=media)

#### 确认内容有没有错误

```bash
 cat /opt/jumpserver/config.yml  | grep -Evn "^$|#"
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKodFGDzXmbj2hYRV17%2F-MKolii9xuAyO0FzStqe%2Fimage.png?alt=media\&token=80745159-995c-4bc6-88af-7f8db965160c)

{% hint style="danger" %}
注意 SECRET\_KEY 和 BOOTSTRAP\_TOKEN 不能使用纯数字字符串
{% endhint %}

### **启动 Jumpserver**

**确保已经载入 py3 虚拟环境**&#x20;

```bash
 source /opt/py3/bin/activate
 cd /opt/jumpserver
 ./jms start all -d     
```

{% hint style="info" %}
新版本更新了运行脚本, 使用方式`./jms start|stop|status all` 后台运行请添加 `-d` 参数
{% endhint %}

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MhzAJ22X0ndvhiTd7Mx%2F-MhzAjRm2B5uocAdS2vF%2Fimage.png?alt=media\&token=d12f7b57-1ef0-46f7-a903-457a2cf921a6)

{% hint style="success" %}
运行不报错, 请继续往下操作
{% endhint %}

## **六、安装 KoKo 组件**

KoKo 是 Go 版本的 coco，重构了 coco 的 SSH/SFTP 服务和 Web Terminal 服务。

### 环境要求

| Name    | KoKo    | Go   |
| ------- | ------- | ---- |
| Version | v2.13.1 | 1.15 |

### 安装 Go

从 [Go](https://golang.google.cn/) 官方网站参考文档部署 golang，请根据 环境要求，通过命令行中判断是否安装完成：

{% embed url="https://github.com/jumpserver/koko/releases/" %}

```bash
wget https://golang.google.cn/dl/go1.17.linux-amd64.tar.gz
tar -xf go1.17.linux-amd64.tar.gz -C /usr/local/
chown -R root:root /usr/local/go
export PATH=/usr/local/go/bin:$PATH
echo 'export PATH=/usr/local/go/bin:$PATH' >> ~/.bashrc
```

```bash
go version
```

#### **设置** Go 国内加速镜像

```
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
```

### 下载 KoKo 项目源代码

```
cd /opt && \
git clone https://github.com/jumpserver/koko.git
```

#### 在 KoKo 项目下构建应用

```
chown -R root:root /opt/koko  && \
cd koko  && make
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MhyWiq8HStxOJL6-k6_%2F-MhyXAi6QaDExgYGvYYJ%2Fimage.png?alt=media\&token=0338b8dd-e758-49bc-81a8-9a05f69cd551)

{% hint style="success" %}
**网络问题参考文档：**[**国内常用加速配置**](https://he.zhiqiang.cloud/yun-wei-gong-ju-shi-yong/chang-yong-guo-nei-jia-su-yuan-shi-yong-ji-pei-zhi)
{% endhint %}

{% hint style="danger" %}
**注意：构建完成后, 生成在 `build` 目录下，以 Linux amd64 服务器为例**
{% endhint %}

#### &#x31;**、**&#x62F7;贝压缩包文件到对应的服务器

```
通过 make 构建默认的压缩包，文件名如下: 
koko-[branch name]-[commit]-linux-amd64.tar.gz
```

#### 2、解压编译的压缩包

```
cd /opt/koko/build/
tar -xzvf koko-*-linux-amd64.tar.gz
```

#### **3、修改配置文件并运行**

{% hint style="danger" %}
BOOTSTRAP\_TOKEN 需要从 jumpserver/config.yml 里面获取, 保证一致
{% endhint %}

```bash
 cd /opt/koko/build/koko-master-*-linux-amd64
 cp config_example.yml config.yml
 sed -i "s/BOOTSTRAP_TOKEN: <PleasgeChangeSameWithJumpserver>/BOOTSTRAP_TOKEN: $BOOTSTRAP_TOKEN/g" config.yml 
 sed -i "s/# LOG_LEVEL: INFO/LOG_LEVEL: ERROR/g" config.yml
 sed -i "s/# SHARE_ROOM_TYPE: local/SHARE_ROOM_TYPE: redis/g" config.yml
 sed -i "s/# REDIS_HOST: 127.0.0.1/REDIS_HOST: 127.0.0.1/g" config.yml
 sed -i "s/# REDIS_PORT: 6379/REDIS_PORT: 6379/g" config.yml
 sed -i "s/# REDIS_PASSWORD:/REDIS_PASSWORD: $REDIS_PASSWORD/g" config.yml
 sed -i "s/# REDIS_DB_ROOM:/REDIS_DB_ROOM: 6/g" config.yml
```

```bash
 cat /opt/koko/build/koko-master-*-linux-amd64/config.yml  | grep -Evn "^$|#"
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MhyxGehbGILQLVTODY0%2F-Mhz-Ty-GySIlpf0L4bK%2Fimage.png?alt=media\&token=17f235fc-0113-403e-b701-6c43a35f1de6)

### 启动 KoKo

```bash
 cd /opt/koko/build/koko-master-*-linux-amd64 && ./koko  -d    
```

{% hint style="info" %}
新版本更新了运行脚本, 使用方式`./koko -s start|stop|status` 后台运行请添加 `-d` 参数
{% endhint %}

#### 查看启动状态

```
./koko  -s status
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MhycBua2FdxCOHuisnm%2F-MhycO2-IQQkEVZqsffS%2Fimage.png?alt=media\&token=ec8f7fe8-0387-4487-b41c-b9ac4fa7610f)

## 七、部署 Guacamole **Server**

```
wget http://download.jumpserver.org/public/guacamole-server-1.3.0.tar.gz && \
tar -xf guacamole-server-1.3.0.tar.gz
```

```
cd /opt/guacamole-server-1.3.0 && \
wget http://download.jumpserver.org/public/ssh-forward.tar.gz && \
tar -xf ssh-forward.tar.gz -C /bin/ && \
chmod +x /bin/ssh-forward
```

{% hint style="danger" %}
&#x20;根据 [Guacamole官方文档](http://guacamole.apache.org/doc/gug/installing-guacamole.html) 文档安装对应的依赖包
{% endhint %}

{% hint style="warning" %}
Guacamole具有许多依赖关系，此步骤解决了大多数依赖关系。从官方存储库获取软件包是一个挑战，因此您会注意到我使用了Devel存储库中的一些软件包。一旦安装了所有必需的软件包，请禁用它们。
{% endhint %}

#### 更新所有的包和依赖 <a href="#geng-xin-suo-you-de-bao-he-ta-men-de-yi-lai" id="geng-xin-suo-you-de-bao-he-ta-men-de-yi-lai"></a>

要更新所有的包和它们的依赖，在root权限下执行如下命令：

```
 dnf update -y 
 dnf config-manager --set-enabled PowerTools
 dnf config-manager --enable Devel
 dnf -y install libtool libwebsockets-devel libtheora opus lame-libs libjpeg-turbo-devel  ghostscript   
 dnf config-manager --disable Devel
```

```
dnf -y install SDL2 ffmpeg libtelnet-devel
```

```
dnf -y install cairo-devel libjpeg-devel libpng-devel uuid-devel libvncserver-devel pulseaudio-libs-devel freerdp-devel libssh2-devel openssl-devel pango-devel  pango-devel ffmpeg-devel libvorbis-devel libwebp-devel freerdp-plugins  
```

### **编译安装 guacamole 服务**

```
cd /opt/guacamole-server-1.3.0
autoreconf -fi
./configure --with-init-dir=/etc/init.d && \
make && \
make install && ldconfig
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MXJgtpq5PhWOX6LRV7h%2F-MXJoT3goOkOCwAh0fL_%2Fimage.png?alt=media\&token=8198543b-c865-48ca-b2fd-65c205fa7c09)

#### 更新systemd以找到/etc/init.d/目录中安装的guacd （Guacamole）服务

```
systemctl daemon-reload
```

### 设置 Guacamole 环境变量

{% hint style="danger" %}
**勿多次执行以下环境设置**
{% endhint %}

```bash
export JUMPSERVER_SERVER=http://127.0.0.1:8080
echo "export JUMPSERVER_SERVER=http://127.0.0.1:8080" >> ~/.bashrc
export BOOTSTRAP_TOKEN="$BOOTSTRAP_TOKEN"
echo "export BOOTSTRAP_TOKEN=$BOOTSTRAP_TOKEN" >> ~/.bashrc
export JUMPSERVER_KEY_DIR=/config/guacamole/data/keys
echo "export JUMPSERVER_KEY_DIR=/config/guacamole/data/keys" >> ~/.bashrc
export GUACAMOLE_HOME=/config/guacamole
echo "export GUACAMOLE_HOME=/config/guacamole" >> ~/.bashrc
export GUACAMOLE_LOG_LEVEL=ERROR
echo "export GUACAMOLE_LOG_LEVEL=ERROR" >> ~/.bashrc
export JUMPSERVER_ENABLE_DRIVE=true
echo "export JUMPSERVER_ENABLE_DRIVE=true" >> ~/.bashrc
```

{% hint style="danger" %}
环境变量说明



```
JUMPSERVER_SERVER 指 core 访问地址
BOOTSTRAP_TOKEN 为 Jumpserver/config.yml 里面的 BOOTSTRAP_TOKEN 值
JUMPSERVER_KEY_DIR 认证成功后 key 存放目录
GUACAMOLE_HOME 为 guacamole.properties 配置文件所在目录
GUACAMOLE_LOG_LEVEL 为生成日志的等级
JUMPSERVER_ENABLE_DRIVE 为 rdp 协议挂载共享盘
```
{% endhint %}

### **启动 Guacamole**

```bash
 systemctl start   guacd
 systemctl enable  guacd
```

```
systemctl status guacd
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKpHsx7iujrKBvCA-dT%2F-MKp_l2JV3IwcAsBAaZP%2Fimage.png?alt=media\&token=5fac576a-9560-4fdc-85d4-792e28189fac)

## **八、安装** Lion 组件

&#x20;[Lion](https://github.com/jumpserver/lion-release) 使用了 [Apache](http://www.apache.org/) 软件基金会的开源项目 [Guacamole](http://guacamole.apache.org/)，JumpServer 使用 Golang 和 Vue 重构了 Guacamole 实现 RDP/VNC 协议跳板机功能。

#### 环境要求 <a href="#id-18" id="id-18"></a>

| Name    | JumpServer | Guacd                                                                        | Lion    |
| ------- | ---------- | ---------------------------------------------------------------------------- | ------- |
| Version | v2.13.1    | [1.3.0](http://download.jumpserver.org/public/guacamole-server-1.3.0.tar.gz) | v2.13.1 |

&#x20;Lion 是基于 [Apache Guacamole](http://guacamole.apache.org/) 开发，原生部署 Lion 需要有 [Guacamole Server](https://github.com/apache/guacamole-server) （版本 >= 1.3.0）。

### 下载 Lion 项目源代码

```
cd /opt
wget https://github.com/jumpserver/lion-release/releases/download/v2.13.1/lion-v2.13.1-linux-amd64.tar.gz
tar -xf lion-v2.13.1-linux-amd64.tar.gz

cd /opt && \
git clone git://github.com/jumpserver/lion-release.git
```

{% hint style="success" %}
**网络问题参考文档：**[**国内常用加速配置**](https://he.zhiqiang.cloud/yun-wei-gong-ju-shi-yong/chang-yong-guo-nei-jia-su-yuan-shi-yong-ji-pei-zhi)
{% endhint %}

### **修改 Lion 配置文件**

{% hint style="info" %}
&#x20;Lion 的启动配置，参考 [config\_example](https://github.com/jumpserver/lion-release/blob/master/config_example.yml)
{% endhint %}

```bash
cd cd /opt/lion-release
cp config_example.yml config.yml
sed -i "s/BOOTSTRAP_TOKEN: <PleasgeChangeSameWithJumpserver>/BOOTSTRAP_TOKEN: $BOOTSTRAP_TOKEN/g" config.yml
```

### **启动** Lion

&#x20;在 `/etc/systemd/system` 目录创建 `lion-v2.10.0.service` 文件并配置以下内容

```
vi /etc/systemd/system/lion.service

[Unit]
Description=JumpServer Lion Service
After=network.target

[Service]
Type=simple
User=root
Group=root

WorkingDirectory=/opt/lion-v2.13.1-linux-amd64
ExecStart=/opt/lion-v2.13.1-linux-amd64/lion -f /opt/lion-release/config.yml
Restart=on-failure

[Install]
WantedBy=multi-user.target
```

#### 重载系统服务

```
systemctl daemon-reload
```

```
systemctl start  lion
systemctl enable lion
```

#### 查看 Lion 服务状态

```
systemctl status lion
```

## **九**、安装 Node

```
curl -fsSL https://rpm.nodesource.com/setup_16.x | bash -
```

```
yum install -y nodejs
```

### 检查是否安装成功及查看安装的版本

```
[root@sz-test lion-release]# node -v
v16.7.0
[root@sz-test lion-release]# npm -v
7.20.3
```

## 十、安装 Lina 组件

[Lina](https://github.com/jumpserver/lina/) 是 JumpServer 的前端 UI 项目，主要使用 [Vue](https://cn.vuejs.org/)，[Element UI](https://element.eleme.cn/) 完成。

#### 环境要求 <a href="#id-6" id="id-6"></a>

| Name    | Lina    | Node |
| ------- | ------- | ---- |
| Version | v2.13.1 | 10   |

### 下载 Lina 项目源代码

```
cd /opt && \
git clone git://github.com/jumpserver/lina.git
```

#### &#x20;<a href="#node" id="node"></a>

```
npm config set sass_binary_site https://npm.taobao.org/mirrors/node-sass
npm config set registry https://registry.npm.taobao.org
npm install -g yarn
yarn config set registry https://registry.npm.taobao.org
```

#### 安装依赖 <a href="#id-8" id="id-8"></a>

```
npm install -g yarn
yarn install
```

#### 修改配置文件[⚓︎](https://docs.jumpserver.org/zh/master/dev/build/#_9) <a href="#id-9" id="id-9"></a>

```
sed -i "s/VUE_APP_CORE_HOST = 'http://localhost:8080'/VUE_APP_CORE_HOST = $JUMPSERVER_SERVER:8080/g" /opt/lina/.env.development
```

#### 运行 Lina[⚓︎](https://docs.jumpserver.org/zh/master/dev/build/#lina_1) <a href="#lina_1" id="lina_1"></a>

```
yarn serve
```

#### 构建 Lina[⚓︎](https://docs.jumpserver.org/zh/master/dev/build/#lina_2) <a href="#lina_2" id="lina_2"></a>

构建完成后的 lina 包为 html 文件，可以直接移到到 nginx 服务器。

```
yarn build:prod
```

构建完成后, 生成在 build 目录下

## 十一、安装 Luna 组件

[Luna](https://github.com/jumpserver/luna/) 是 JumpServer 的前端 UI 项目，主要使用 [Angular CLI](https://github.com/angular/angular-cli) 完成。

#### 环境要求[⚓︎](https://docs.jumpserver.org/zh/master/dev/build/#_10) <a href="#id-10" id="id-10"></a>

| Name    | Luna    | Node |
| ------- | ------- | ---- |
| Version | v2.13.1 | 10   |

### 下载 Luna 项目源代码

&#x20;这个项目是用[Angular CLI](https://github.com/angular/angular-cli) 1.3.2 版生成的。

```
cd /opt && \
git clone git://github.com/jumpserver/luna.git
```

### 安装依赖

```
npm -i
npm rebuild node-sass
```

### 修改 Luna 配置文件

```
vi proxy.conf.json
```

```
{
  "/koko": {
    "target": "http://localhost:5000",  # KoKo 地址
    "secure": false,
    "ws": true
  },
  "/media/": {
    "target": "http://localhost:8080",  # Core 地址
    "secure": false,
    "changeOrigin": true
  },
  "/api/": {
    "target": "http://localhost:8080",  # Core 地址
    "secure": false,                    # https ssl 需要开启
    "changeOrigin": true
  },
  "/core": {
    "target": "http://localhost:8080",  # Core 地址
    "secure": false,
    "changeOrigin": true
  },
  "/static": {
    "target": "http://localhost:8080",  # Core 地址
    "secure": false,
    "changeOrigin": true
  },
  "/lion": {
    "target": "http://localhost:9529",  # Lion 地址
    "secure": false,
    "pathRewrite": {
      "^/lion/monitor": "/monitor"
    },
    "ws": true,
    "changeOrigin": true
  },
  "/omnidb": {
    "target": "http://localhost:8082",
    "secure": false,
    "ws": true,
    "changeOrigin": true
  }
}
```

### 运行 Luna

```
ng serve
```

### 构建 Luna

可以加 -prod 来进行生产构建 `ng build -prod`

```
ng build
```

{% hint style="info" %}
构建完成后, 生成在 build 目录下
{% endhint %}

## **十二、安装 Nginx**

```bash
vim /etc/yum.repos.d/nginx.repo
```

```bash
[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true
```

```bash
 dnf makecache timer
 dnf info nginx
 dnf install -y nginx
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MhzJel5qTiHAFZtRkJ2%2F-MhzN5BlJ_QzbgLr90F_%2Fimage.png?alt=media\&token=1bc7a30f-f0a5-4d6f-b7b5-16f6e06042e0)

### **配置 Nginx 整合各组件**

#### **修改配置文件**

```bash
vim /etc/nginx/conf.d/jumpserver.conf
```

```bash
server {
    server_name zhiqiang.cloud;
    listen 80;                                # 代理端口, 通过此端口重定向到443访问, 不再通过8080端口
    if ($host = zhiqiang.cloud) {             # 修改成你的域名或者注释掉，多个域名，以空格分开
      return 301 https://$host$request_uri;   # 将 http 重定向 https
    }
      return 404;                             # 访问80端口跳转404状态码
}


server {

    listen 443 ssl;                     # 服务器开启443端口, 以后将通过此端口进行访问, 不再通过8080端口
    server_name zhiqiang.cloud;         # 修改成你的域名或者注释掉，多个域名，以空格分开

    ssl_certificate /etc/nginx/conf.d/ssl/zhiqiang.cloud.pem;     # pem文件的路径
    ssl_certificate_key /etc/nginx/conf.d/ssl/zhiqiang.cloud.key; # key文件的路径

    ssl_session_timeout 5m;              # 缓存有效期
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # 安全链接可选的加密协议
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;  # 加密算法
    ssl_prefer_server_ciphers on;        # 使用服务器端的首选算法
    client_max_body_size 100m;           # 录像及文件上传大小限制



  # Luna 配置
  location /luna/ {
    proxy_pass http://luna:4200;
  }

  # Core data 静态资源
  location /media/replay/ {
    add_header Content-Encoding gzip;
    root /opt/jumpserver-v2.13.1/data/;
  }

  location /media/ {
    root /opt/jumpserver-v2.13.1/data/;
  }

  location /static/ {
    root /opt/jumpserver-v2.13.1/data/;
  }

  # KoKo Lion 配置
  location /koko/ {
    proxy_pass       http://koko:5000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_http_version 1.1;
    proxy_buffering off;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

  # lion 配置
  location /lion/ {
    proxy_pass http://lion:8081;
    proxy_buffering off;
    proxy_request_buffering off;
    proxy_http_version 1.1;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $http_connection;
    proxy_ignore_client_abort on;
    proxy_connect_timeout 600;
    proxy_send_timeout 600;
    proxy_read_timeout 600;
    send_timeout 6000;
  }

  # Core 配置
  location /ws/ {
    proxy_pass http://core:8070;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_http_version 1.1;
    proxy_buffering off;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

  location /api/ {
    proxy_pass http://core:8080;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }

  location /core/ {
    proxy_pass http://core:8080;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }

  # 前端 Lina
  location /ui/ {
    proxy_pass http://lina:9528;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }

  location / {
    rewrite ^/(.*)$ /ui/$1 last;
  }
}
```

### **运行 Nginx**

{% hint style="success" %}
确保配置没有问题, 有问题请先解决
{% endhint %}

```bash
nginx -t    
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKtP-FXUCntnPBV6H7H%2F-MKtQH2ns3bGKXUoNm7x%2Fimage.png?alt=media\&token=a67a5d2e-6a40-4b94-8ac5-4aee5f2673fc)

```bash
 systemctl enable --now nginx
```

## **十三、开始使用 Jumpserver**

{% hint style="info" %}
检查应用是否已经正常运行

服务全部启动后, 访问 JumpServer 服务器 nginx 代理的 80 端口, 不要通过8080端口访问 默认账号: admin 密码: admin

默认账号: admin 密码: admin

到Jumpserver 会话管理-终端管理 检查 koko Guacamole 等应用的注册。
{% endhint %}

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKtShIzqkKNnZ9Ka3jp%2F-MKtSvo16rq1F2cOJ5WE%2Fimage.png?alt=media\&token=0a8015a0-1ff6-41a5-8d7f-4c28e3ef0ca0)

### **测试连接**

如果登录客户端是 macOS 或 Linux, 登录语法如下

```bash
ssh -p2222 admin@87.111.61.140
sftp -P2222 admin@87.111.61.140
```

密码: admin

如果登录客户端是 Windows, Xshell Terminal 登录语法如下

```
ssh admin@87.111.61.140 2222
sftp admin@87.111.61.140 2222
```

密码: admin

如果能登陆代表部署成功

_# sftp默认上传的位置在资产的 /tmp 目录下_

_# windows拖拽上传的位置在资产的 Guacamole RDP上的 G 目录下_

```
 ssh -p2222 admin@87.111.61.140
```

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYF9AKfacso1EeJ6%2F30.png?generation=1577790628016673\&alt=media)

### **系统设置**

{% hint style="info" %}
**修改 url 的"localhost"为你的实际 url 地址, 否则邮件收到的地址将为"localhost" 也无法创建新用户**
{% endhint %}

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lx53lMutrsyPUks5pJf%2F-MKtRKw2Y4aJrtNqMUn5%2F-MKtRyfAAomzFLdL9cNA%2Fimage.png?alt=media\&token=3c2cbd84-8ddb-4704-853f-b4e74cc06a49)

### **邮件设置**

_# 点击页面上边的"邮件设置", 进入邮件设置页面_

_# 默认使用 25 端口, 不勾选 SSL 和 TLS; 如果需要勾选 SSL, 端口需要修改成 465; 如果需要勾选 TLS, 端口需要改成 587_

_# 不可以同时勾选 SSL 和 TLS_

_# 配置邮件服务后, 点击页面的"测试连接"按钮, 如果配置正确, Jumpserver 会发送一条测试邮件到您的 SMTP 账号邮箱里面, 确定收到测试邮件后点击保存即可使用_

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFBsBCgmNPz33pi%2F32.png?generation=1577790628056287\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFCq5TwICR4ouH8%2F33.png?generation=1577790628022997\&alt=media)

#### **点测试后会收到一封测试邮件**

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFD3z2_Vri5mLDy%2F34.png?generation=1577790628083691\&alt=media)

#### **邮件设置的查看方法**

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFEOW-9JEZqmvvQ%2F35.png?generation=1577790628113845\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFFZJYzzvVax5D1%2F36.png?generation=1577790628059532\&alt=media)

### &#x20;**LDAP设置**

_# 如果不需要使用"ldap"用户登陆 jumpserver, 可以直接跳过, 不需要设置_

_# 先"测试"通过才能保存_

_# DN 和 OU 一定要完整(如 "DN:cn=Manage,ou=Jumpserver,dc=jumpserver,ou=org")_

_# 注：可借用第三方 gui 工具查看 ldap 用户的属性, 新版本已经支持中文名登录, 即cn=中文也可正常使用_

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFG0rnNa_c5WjpH%2F37.png?generation=1577790628032006\&alt=media)

### **终端设置**

_# "密码认证"和"密钥认证"是 SSH 连接跳板机时所使用的认证方式(都不选会造成无法使用 SSH 方式连接登录跳板机, 不影响 web 登录)_

_# "Telnet成功正则表达式" telnet设备登陆失败需要设置_

_# "命令存储""录像存储"位置设置_

_# "命令存储""录像存储"修改后, 需要在Jumpserver 会话管理-终端管理 修改terminal的配置 录像存储 命令记录, 然后重启 Jumpserver 服务_

_# 设置后重启 Coco 才能生效_

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFHwOk20snY-9Lt%2F38.png?generation=1577790628048915\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFIW8df76S5vA6z%2F39.png?generation=1577790628016503\&alt=media)

### **安全设置**

_# "MAF二次认证"勾选会开启全局强制"MFA", 所有 jumpserver 用户必须使用动态口令进行认证登录(即时生效)_

_# "限制登录失败"和"限制登录时间"设置需要重启 jumpserver 才能生效_

_# "SSH最大空闲时间"设置需要重启 coco 才能生效_

_# "密码校验规则"设置立即生效_

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFJhUbgXvmonXXT%2F40.png?generation=1577790628054869\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFK4EO35lvbFiQo%2F41.png?generation=1577790628194732\&alt=media)

## **十四、用户管理**

### &#x20;**创建 Jumpserver 用户**

_# 点击页面左侧"用户列表"菜单下的"用户列表", 进入用户列表页面_

_# 点击页面左上角"创建用户"按钮, 进入创建用户页面, (也可以通过右上角导入模版进行用户导入)_

_# 其中, 用户名即 Jumpserver 登录账号(具有唯一性, 不能重名)。名称为页面右上角用户标识(可重复)_

_# 成功提交用户信息后, Jumpserver 会发送一条设置"用户密码"的邮件到您填写的用户邮箱_

_# 点击邮件中的设置密码链接, 设置好密码后, 您就可以用户名和密码登录 Jumpserver 了。_

_# 用户首次登录 Jumpserver, 会被要求完善用户信息, 按照向导操作即可。_

_注：MFA 即 Google Authenticator, 使用此软件需要APP时间与浏览器时间同步_

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFLN2Y3cCAzpktl%2F42.png?generation=1577790628057445\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFMf20RGR1i-sCQ%2F43.png?generation=1577790628109758\&alt=media)

### **资产管理**

_# "节点"不能重名, 右击节点可以添加、删除和重命名节点, 以及进行资产相关的操作_

_注：如果有 linux 资产和 windows 资产, 建议先建立 Linux 节点与 Windows 节点, 不然"授权"时不好处理_

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFNFSgmSWED1oXd%2F44.png?generation=1577790628050042\&alt=media)

查看主机名及IP地址添加资产

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFOcMi0ODmndxT0%2F45.png?generation=1577790628004497\&alt=media)

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFPFRgtHG2-pqz2%2F46.png?generation=1577790628022027\&alt=media)

### **创建管理用户**

_"管理用户"是资产上的 root, 或拥有 NOPASSWD: ALL sudo 权限的用户, Jumpserver 使用该用户来推送系统用户、获取资产硬件信息等。 Windows或其它硬件可以随意设置一个_

_# "名称" 不能重复_

_# "ssh私钥" 如果私钥有密码, 请把key的密码填在密码栏上, 目前仅支持 RSA DSA 格式私钥_

![](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFQ8fOSnnZoipzP%2F47.png?generation=1577790628093940\&alt=media)

### **创建系统用户**

_# "系统用户"是 Jumpserver 跳转登录资产时使用的用户, 用户使用该用户登录资产_

_# "自动生成密码"、"自动推送"、"Sudo"等功能需要对应资产的"管理用户"是且有root权限, 否则自动推送失败_

_# ssh 协议的 "Sudo" 栏设定用户的 sudo 权限,_

_# ssh 协议如果创建的"系统用户"已在资产上面存在, "推送"将会覆盖掉原用户的"home"目录权限(注: 替换成700权限)_

_# ssh 协议的 "ssh私钥" 如果私钥有密码, 请把key的密码填在密码栏上, 目前仅支持 RSA DSA 格式私钥_

_# 这里简单举几个 "sudo" 设置例子_

_Sudo /bin/su # 当前系统用户可以免sudo密码执行sudo su命令_

_Sudo /usr/bin/git, /usr/bin/php, /bin/**cat**, /bin/more, /bin/less, /usr/bin/tail_

_# 当前系统用户可以免sudo密码执行git php_ _**cat**_ _more less tail_

_Sudo !/usr/bin/yum # 当前系统用户不可以执行sudo yum命令_

_# 此处的权限应该根据使用用户的需求汇总后定制, 原则上给予最小权限即可_

_# "系统用户"创建时, 如果选择了"自动推送" Jumpserver 会使用"Ansible"自动推送系统用户到资产中, "root"用户不支持推送_

_# 如果资产(交换机、Windows)不支持"Ansible", 请去掉"自动生成密钥"、"自动推送"勾选。手动填写资产上已有的账号及账号密码_

_# 如果想让用户登录资产时自己输入密码, 可以在创建系统用户时选择"手动登录"_

![http://docs.jumpserver.org/zh/latest/\_images/admin\_assets\_system-user\_create\_01.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFR_nAaC80BiSRW%2F48.jpeg?generation=1577790628162615\&alt=media)

![http://docs.jumpserver.org/zh/latest/\_images/admin\_assets\_system-user\_create\_02.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFSM0es0w1P1YOq%2F49.jpeg?generation=1577790628070027\&alt=media)

### **创建命令过滤**

**如无需要, 可忽略此步骤, 目前仅支持 ssh 与 telnet 协议**

_# "系统用户"可以绑定一些"命令过滤器"，一个过滤器可以定义一些"规则"_

_# 当"用户"使用这个"系统用户"登录资产，然后执行一个命令 这个命令需要被绑定过滤器的所有规则匹配，高优先级先被匹配_

_# 当一个规则匹配到了，如果规则的动作是 "允许" 这个命令会被放行； 如果规则的动作是 "禁止" 命令将会被禁止执行； 否则就匹配下一个规则，如果最后没有匹配到规则，则允许执行_

![http://docs.jumpserver.org/zh/latest/\_images/admin\_assets\_cmd-filter\_create.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFTXrq8BHofzJFh%2F50.jpeg?generation=1577790628055342\&alt=media)

_# 点击 "命令过滤器列表" 规则下方的数字进入 "命令过滤器规则列表" , 点击新建规则创建相应规则_

_# 拒绝所有命令可以使用正则表达式 .\*_

![http://docs.jumpserver.org/zh/latest/\_images/admin\_assets\_cmd-filter\_rule\_create.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFUlj99-LxkSNDo%2F51.jpeg?generation=1577790628082938\&alt=media)

### **创建网域网关**

如无需要, 可忽略此步骤, 支持代理SSH、RDP和VNC

_# "网域"功能是为了解决部分环境无法直接连接而新增的功能, 原理是通过网关服务器进行跳转登录_

_# 点击页面左侧的"网域列表"按钮, 查看所有网域列表_

_# 点击页面左上角的"创建网域"按钮, 进入网域创建页面, 选择资产里用作网域的网关服务器_

_注：混合云适用_

![http://docs.jumpserver.org/zh/latest/\_images/admin\_assets\_domain\_create.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFV8eu7mAtDYgjt%2F52.jpeg?generation=1577790628142694\&alt=media)

_# 点击"网域"的名称, 进入"网域详情"列表。_

_# 点击页面的"网关"按钮, 选择网关列表的"创建网关"按钮, 进入网关创建页面, 填写网关信息_

_# IP信息一般默认填写网域资产的IP即可(如用作网域的资产有多块网卡和IP地址, 选能与jumpserer通信的任一IP即可)_

_注：用户名与密码可以使用网关资产上已存在的任一拥有执行 ssh 命令权限的用户_

![http://docs.jumpserver.org/zh/latest/\_images/admin\_assets\_domain\_gateway\_create.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFWNurC1cJjts2c%2F53.jpeg?generation=1577790628096257\&alt=media)

_注: 保存信息后点击"测试连接", 确定设置无误后到资产列表添加需要使用"网关"登录的资产即可_

_注: "Windows资产"可以使用"ssh网关"_

### **创建资产**

_# 点击页面左侧的"资产管理"菜单下的"资产列表"按钮, 查看当前所有的资产列表。_

_# 点击页面左上角的"创建资产"按钮, 进入资产创建页面, 填写资产信息。_

_# IP 地址和管理用户要确保正确, 确保所选的管理用户的用户名和密码能"牢靠"地登录指定的 IP 主机上。_

_# 资产的系统平台也务必正确填写。公网 IP 信息只用于展示, 可不填, Jumpserver 连接资产使用的是 IP 信息。_

![http://docs.jumpserver.org/zh/latest/\_images/admin\_assets\_asset\_create.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFXG_phYsy_Oh6g%2F54.jpeg?generation=1577790628114828\&alt=media)

_# 资产创建信息填写好保存之后, ssh 协议资产可"测试资产"是否能正确连接, 其他协议暂不支持_

_注：被连接资产需要"python"组件, 且版本大于等于2.6, Ubuntu等资产默认不允许root用户远程ssh登录, 请自行处理_

_# 如果资产不能正常连接, 请检查"管理用户"的用户名和密钥是否正确以及该"管理用户"是否能使用 SSH 从 Jumpserver 主机正确登录到资产主机上_

SSH 协议参考 [SSH 协议资产连接说明](http://docs.jumpserver.org/zh/latest/faq_ssh.html)

RDP 协议参考 [RDP 协议资产连接说明](http://docs.jumpserver.org/zh/latest/faq_rdp.html)

Telnet 协议参考 [Telnet 协议资产连接说明](http://docs.jumpserver.org/zh/latest/faq_telnet.html)

### **创建授权规则**

**为用户分配资产**

_# "名称", 授权的名称, 不能重复_

_# "用户"和"用户组"二选一, 不推荐即选择用户又选择用户组_

_# "资产"和"节点"二选一, 选择节点会包含节点下面的所有资产_

_# "系统用户", 及所选的用户或用户组下的用户能通过该系统用户使用所选节点或者节点下的资产_

_# 用户(组), 资产(节点), 系统用户是一对一的关系, 所以当拥有 Linux、Windows 不同类型资产时, 应该分别给 Linux 资产和 Windows 资产创建授权规则_

一般情况下, 资产授权给个人, 节点授权给用户组, 一个授权只能选择一个系统用户

![http://docs.jumpserver.org/zh/latest/\_images/admin\_perms\_asset-permission\_create.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFYHGhN1i6yEQeo%2F55.jpeg?generation=1577790628064367\&alt=media)

## **十五、用户登录**

### **登录 Jumpserver**

_# 用户只能看到自己被管理员授权了的"资产", 如果登录后无资产, 请联系管理员进行确认_

![http://docs.jumpserver.org/zh/latest/\_images/user\_assets\_user-asset\_list.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFZlFMlBPMpNXhg%2F56.jpeg?generation=1577790628126819\&alt=media)

### **连接资产**

_# 在我的资产点击资产右边的 "连接" 快速连接资产_

_# 也可以点击左侧栏的 "Web终端"_

![http://docs.jumpserver.org/zh/latest/\_images/user\_terminal\_web-terminal\_list.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYF_2yMeAAVnNK69%2F57.jpeg?generation=1577790628122119\&alt=media)

_# 点击 "资产" 名字, 就连上资产了_

_# 如果显示连接超时, 请参考 FAQ 文档进行处理_

### **断开资产**

_# 点击页面顶部的 "Server" 按钮会弹出选个选项, 第一个断开所选的连接, 第二个断开所有连接。_

### **文件管理**

_# 点击 "文件管理"_

_# 先在左边选择资产, 目前只支持自动登录的 SSH 协议资产_

_# 也可以使用 sftp 方式进行文件管理_

参考 [SFTP 连接说明](http://docs.jumpserver.org/zh/latest/faq_sftp.html)

![http://docs.jumpserver.org/zh/latest/\_images/user\_terminal\_web-sftp\_list.jpg](https://139036132-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fabout-the-author%2F-LxQbYvJOaZUj9lDeShz%2F-LxQdYFaKEoW21Yummjb%2F58.jpeg?generation=1577790628028141\&alt=media)

## 十六、安全建议 <a href="#id-1" id="id-1"></a>

{% hint style="danger" %}
Jumpserver 对外需要开放 80 和 2222 端口，如果你配置了 ssl 还需要开放 443 端口, 8080 端口开放给 koko 和 guacamole 组件访问
{% endhint %}

* JumpServer 所在服务器操作系统应该升级到最新
* JumpServer 依赖的软件升级到最新版本
* 服务器、数据库、redis 等依赖组件请勿使用弱口令密码
* 不推荐关闭 firewalld 和 selinux
* 只开放必要的端口，必要的话请通过 vpn 或者 sslvpn 访问 JumpServer
* 如果必须开放到外网使用，你应该部署 web 应用防火墙做安全过滤
* 请部署 ssl 证书通过 https 协议来访问 JumpServer
* JumpServer 不要使用弱口令密码，应立即改掉默认的 admin 密码
* 推荐开启 MFA 功能，避免因密码泄露导致的安全问题

{% hint style="success" %}
&#x20;关注官方更新，及时更新修复漏洞的版本\
如发现 JumpServer 安全问题，请反馈给官方邮箱 [ibuler@fit2cloud.com](mailto:ibuler@fit2cloud.com)
{% endhint %}



本文档参考官方文档编写，更多内容请访问官方网站 [http://docs.jumpserver.org/zh/master/](https://docs.jumpserver.org/zh/master/)







