centos7上部署新版 jumpserver 跳板機服務

CentOS 7 建議在一個純淨的 centos7上進行下面的安裝部署

關閉 selinux 和防火牆

[root@jumpserver ~]# setenforce 0 [root@jumpserver ~]# systemctl stop firewalld.service # 修改字符集，不然可能報 input/output error的問題，由於日誌裏打印了中文 [root@jumpserver ~]# localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8 [root@jumpserver ~]# export LC_ALL=zh_CN.UTF-8 [root@jumpserver ~]# echo 'LANG="zh_CN.UTF-8"' > /etc/locale.conf

準備 Python3 和 Python 虛擬環境

最新的jumpserver環境依賴於Python3

安裝依賴包

[root@jumpserver ~]# yum -y install wget sqlite-devel xz gcc automake zlib-devel openssl-devel epel-release git # 下載python3 編譯 安裝 [root@jumpserver ~]# wget https://www.python.org/ftp/python/3.6.1/Python-3.6.1.tar.xz [root@jumpserver Python-3.6.1]# tar xf Python-3.6.1.tar.xz && cd Python-3.6.1 [root@jumpserver Python-3.6.1]# ./configure && make && make install # 這裏必須執行編譯安裝，不然在安裝 Python 庫依賴時會有麻煩...

創建 Python 虛擬環境

CentOS 7 自帶的是 Python2，而 yum 等工具依賴原來的 Python，爲了避免擾亂原來的環境咱們來使用 Python 虛擬環境

[root@jumpserver Python-3.6.1]# cd /opt [root@jumpserver opt]# python3 -m venv py3 [root@jumpserver opt]# source /opt/py3/bin/activate # 看到下面的提示符表明成功，之後運行 Jumpserver 都要先運行以上 source 命令，如下全部命令均在該虛擬環境中運行 (py3) [root@jumpserver opt]# 

自動載入 Python 虛擬環境配置

此項僅爲懶癌晚期的人員使用，防止運行 Jumpserver 時忘記載入 Python 虛擬環境致使程序沒法運行。使用autoenv

(py3) [root@jumpserver ~]# cd /opt
(py3) [root@jumpserver opt]# git clone git://github.com/kennethreitz/autoenv.git (py3) [root@jumpserver opt]# echo 'source /opt/autoenv/activate.sh' >> ~/.bashrc (py3) [root@jumpserver opt]# source ~/.bashrc

安裝 Jumpserver

下載或 Clone 項目

項目提交較多 git clone 時較大，你能夠選擇去 Github 項目頁面直接下載zip包

(py3) [root@jumpserver opt]# git clone https://github.com/jumpserver/jumpserver.git && cd jumpserver && git checkout master (py3) [root@jumpserver jumpserver]# echo "source /opt/py3/bin/activate" > /opt/jumpserver/.env # 進入 jumpserver 目錄時將自動載入 python 虛擬環境 (py3) [root@jumpserver jumpserver]# cd requirements/ # 首次進入 jumpserver 文件夾會有提示，按 y 便可 # Are you sure you want to allow this? (y/N) y

 安裝依賴 RPM 包

(py3) [root@jumpserver requirements]# yum -y install $(cat rpm_requirements.txt) 安裝 Python 庫依賴 (py3) [root@jumpserver requirements]# pip install -r requirements.txt

安裝 Redis, Jumpserver 使用 Redis 作 cache 和 celery broke

(py3) [root@jumpserver requirements]# yum -y install redis (py3) [root@jumpserver requirements]# systemctl enable redis Created symlink from /etc/systemd/system/multi-user.target.wants/redis.service to /usr/lib/systemd/system/redis.service. (py3) [root@jumpserver requirements]# systemctl start redis

安裝 MySQL

(py3) [root@jumpserver requirements]# yum -y install mariadb mariadb-devel mariadb-server (py3) [root@jumpserver requirements]# systemctl enable mariadb Created symlink from /etc/systemd/system/multi-user.target.wants/mariadb.service to /usr/lib/systemd/system/mariadb.service. (py3) [root@jumpserver requirements]# systemctl start mariadb

建立數據庫 Jumpserver 並受權

(py3) [root@jumpserver requirements]# mysql
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 2 Server version: 5.5.56-MariaDB MariaDB Server Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [(none)]> create database jumpserver default charset 'utf8'; Query OK, 1 row affected (0.00 sec) MariaDB [(none)]> grant all on jumpserver.* to 'jumpserver'@'127.0.0.1' identified by 'somepassword'; Query OK, 0 rows affected (0.00 sec) MariaDB [(none)]> flush privileges; Query OK, 0 rows affected (0.00 sec)

修改 Jumpserver 配置文件

(py3) [root@jumpserver requirements]# cd /opt/jumpserver
(py3) [root@jumpserver jumpserver]# cp config_example.py config.py (py3) [root@jumpserver jumpserver]# vim config.py # 注意對其縮進，不要直接複製本文檔的內容 # 配置文件是 Python 格式，不要用 TAB，而要用空格 內容以實際文件爲準 本文僅供參考 """  jumpserver.config ~~~~~~~~~~~~~~~~~ Jumpserver project setting file :copyright: (c) 2014-2017 by Jumpserver Team :license: GPL v2, see LICENSE for more details. """ import os BASE_DIR = os.path.dirname(os.path.abspath(__file__)) class Config: # Use it to encrypt or decrypt data # Jumpserver 使用 SECRET_KEY 進行加密，請務必修改如下設置 # SECRET_KEY = os.environ.get('SECRET_KEY') or '2vym+ky!997d5kkcc64mnz06y1mmui3lut#(^wd=%s_qj$1%x' SECRET_KEY = '請隨意輸入隨機字符串（推薦字符大於等於 50位）' # Django security setting, if your disable debug model, you should setting that ALLOWED_HOSTS = ['*'] # DEBUG 模式 True爲開啓 False爲關閉，默認開啓，生產環境推薦關閉 # 注意：若是設置了DEBUG = False，訪問8080端口頁面會顯示不正常，須要搭建 nginx 代理才能夠正常訪問 DEBUG = os.environ.get("DEBUG") or False # 日誌級別，默認爲DEBUG，可調整爲INFO, WARNING, ERROR, CRITICAL，默認INFO LOG_LEVEL = os.environ.get("LOG_LEVEL") or 'WARNING' LOG_DIR = os.path.join(BASE_DIR, 'logs') # 使用的數據庫配置，支持sqlite3, mysql, postgres等，默認使用sqlite3 # See https://docs.djangoproject.com/en/1.10/ref/settings/#databases  # 默認使用SQLite3，若是使用其餘數據庫請註釋下面兩行 # DB_ENGINE = 'sqlite3' # DB_NAME = os.path.join(BASE_DIR, 'data', 'db.sqlite3') # 若是須要使用mysql或postgres，請取消下面的註釋並輸入正確的信息,本例使用mysql作演示(mariadb也是mysql) DB_ENGINE = os.environ.get("DB_ENGINE") or 'mysql' DB_HOST = os.environ.get("DB_HOST") or '127.0.0.1' DB_PORT = os.environ.get("DB_PORT") or 3306 DB_USER = os.environ.get("DB_USER") or 'jumpserver' DB_PASSWORD = os.environ.get("DB_PASSWORD") or 'somepassword' DB_NAME = os.environ.get("DB_NAME") or 'jumpserver' # Django 監聽的ip和端口，生產環境推薦把0.0.0.0修改爲127.0.0.1，這裏的意思是容許x.x.x.x訪問，127.0.0.1表示僅容許自身訪問 # ./manage.py runserver 127.0.0.1:8080 HTTP_BIND_HOST = '127.0.0.1' HTTP_LISTEN_PORT = 8080 # Redis 相關設置 REDIS_HOST = os.environ.get("REDIS_HOST") or '127.0.0.1' REDIS_PORT = os.environ.get("REDIS_PORT") or 6379 REDIS_PASSWORD = os.environ.get("REDIS_PASSWORD") or '' REDIS_DB_CELERY = os.environ.get('REDIS_DB') or 3 REDIS_DB_CACHE = os.environ.get('REDIS_DB') or 4 def __init__(self): pass def __getattr__(self, item): return None class DevelopmentConfig(Config): pass class TestConfig(Config): pass class ProductionConfig(Config): pass # Default using Config settings, you can write if/else for different env config = DevelopmentConfig()

生成數據庫表結構和初始化數據

(py3) [root@jumpserver jumpserver]# cd /opt/jumpserver/utils
(py3) [root@jumpserver utils]# bash make_migrations.sh

運行 Jumpserver

(py3) [root@jumpserver utils]# cd /opt/jumpserver
(py3) [root@jumpserver jumpserver]# ./jms start all # 新版本更新了運行腳本，使用方式./jms start|stop|status|restart all 後臺運行請添加 -d 參數

瀏覽器訪問 http://192.168.1.23:8080/  默認帳號: admin 密碼: admin 

頁面顯示不正常先不用處理 ，後面搭建 nginx 代理就能夠正常訪問了

安裝 SSH Server 和 WebSocket Server: Coco

新開一個終端，別忘了 source /opt/py3/bin/activate

[root@DaMoWang ~]# cd /opt
[root@DaMoWang opt]# source /opt/py3/bin/activate (py3) [root@DaMoWang opt]# git clone https://github.com/jumpserver/coco.git && cd coco && git checkout master (py3) [root@DaMoWang coco]# echo "source /opt/py3/bin/activate" > /opt/coco/.env # 進入 coco 目錄時將自動載入 python 虛擬環境 # 首次進入 coco 文件夾會有提示，按 y 便可 # Are you sure you want to allow this? (y/N) y 安裝依賴 (py3) [root@DaMoWang coco]# cd requirements/ (py3) [root@DaMoWang requirements]# yum -y install $(cat rpm_requirements.txt) (py3) [root@DaMoWang requirements]# pip install -r requirements.txt -i https://pypi.org/simple

修改配置文件

(py3) [root@DaMoWang requirements]# cd /opt/coco
(py3) [root@DaMoWang coco]# cp conf_example.py conf.py (py3) [root@DaMoWang coco]# vim conf.py #!/usr/bin/env python3 # -*- coding: utf-8 -*- # import os BASE_DIR = os.path.dirname(__file__) class Config: """ Coco config file, coco also load config from server update setting below """  # 項目名稱, 會用來向Jumpserver註冊, 識別而已, 不能重複 # NAME = "localhost" NAME = "coco" # Jumpserver項目的url, api請求註冊會使用, 若是Jumpserver沒有運行在127.0.0.1:8080，請修改此處 # CORE_HOST = os.environ.get("CORE_HOST") or 'http://127.0.0.1:8080' CORE_HOST = 'http://127.0.0.1:8080' # 啓動時綁定的ip, 默認 0.0.0.0 # BIND_HOST = '0.0.0.0' # 監聽的SSH端口號, 默認2222 # SSHD_PORT = 2222 # 監聽的HTTP/WS端口號，默認5000 # HTTPD_PORT = 5000 # 項目使用的ACCESS KEY, 默認會註冊,並保存到 ACCESS_KEY_STORE中, # 若是有需求, 能夠寫到配置文件中, 格式 access_key_id:access_key_secret # ACCESS_KEY = None # ACCESS KEY 保存的地址, 默認註冊後會保存到該文件中 # ACCESS_KEY_STORE = os.path.join(BASE_DIR, 'keys', '.access_key') # 加密密鑰 # SECRET_KEY = None # 設置日誌級別 ['DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL', 'CRITICAL'] # LOG_LEVEL = 'INFO' LOG_LEVEL = 'WARN' # 日誌存放的目錄 # LOG_DIR = os.path.join(BASE_DIR, 'logs') # Session錄像存放目錄 # SESSION_DIR = os.path.join(BASE_DIR, 'sessions') # 資產顯示排序方式, ['ip', 'hostname'] # ASSET_LIST_SORT_BY = 'ip' # 登陸是否支持密碼認證 # PASSWORD_AUTH = True # 登陸是否支持祕鑰認證 # PUBLIC_KEY_AUTH = True # 和Jumpserver 保持心跳時間間隔 # HEARTBEAT_INTERVAL = 5 # Admin的名字，出問題會提示給用戶 # ADMINS = '' COMMAND_STORAGE = { "TYPE": "server" } REPLAY_STORAGE = { "TYPE": "server" } config = Config()

運行coco

(py3) [root@DaMoWang coco]# ./cocod start -d

# 新版本更新了運行腳本，使用方式./cocod start|stop|status|restart  後臺運行請添加 -d 參數

啓動成功後去Jumpserver 會話管理-終端管理（http://192.168.94.22:8080/terminal/terminal/）接受coco的註冊，若是頁面不正常能夠等部署完成後再處理

安裝 Web Terminal 前端: Luna

Luna 已改成純前端，須要 Nginx 來運行訪問

訪問（https://github.com/jumpserver/luna/releases）下載對應版本的 release 包，直接解壓，不須要編譯

(py3) [root@DaMoWang coco]# cd /opt
(py3) [root@DaMoWang opt]# wget https://github.com/jumpserver/luna/releases/download/1.3.3/luna.tar.gz (py3) [root@DaMoWang opt]# tar xf luna.tar.gz (py3) [root@DaMoWang opt]# ll 總用量 5224 drwxr-xr-x 4 root root 154 8月 5 21:37 autoenv drwxr-xr-x 9 root root 296 8月 5 22:15 coco drwxr-xr-x 12 root root 301 8月 5 22:03 jumpserver drwxr-xr-x 5 501 games 8192 7月 19 12:27 luna -rw-r--r-- 1 root root 5335554 7月 19 12:32 luna.tar.gz drwxr-xr-x 6 root root 120 8月 5 21:49 py3 (py3) [root@DaMoWang opt]# chown -R root.root luna

安裝 Windows 支持組件

若是不須要管理 windows 資產，能夠直接跳過這一步

由於手動安裝 guacamole 組件比較複雜，這裏提供打包好的 docker 使用, 啓動 guacamole

 

安裝Docker

 

(py3) [root@DaMoWang opt]# yum remove docker-latest-logrotate  docker-logrotate  docker-selinux dockdocker-engine (py3) [root@DaMoWang opt]# yum install -y yum-utils device-mapper-persistent-data lvm2 # 添加docker官方源 (py3) [root@DaMoWang opt]# yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo (py3) [root@DaMoWang opt]# yum makecache fast (py3) [root@DaMoWang opt]# yum install docker-ce # 國內部分用戶可能沒法鏈接docker官網提供的源，這裏提供阿里雲的鏡像節點供測試使用 (py3) [root@DaMoWang opt]# yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo (py3) [root@DaMoWang opt]# rpm --import http://mirrors.aliyun.com/docker-ce/linux/centos/gpg (py3) [root@DaMoWang opt]# yum makecache fast (py3) [root@DaMoWang opt]# yum -y install docker-ce (py3) [root@DaMoWang opt]# systemctl start docker (py3) [root@DaMoWang opt]# systemctl status docker

 

啓動 Guacamole

# 注意：這裏須要修改下 http://<填寫jumpserver的url地址> 例: http://192.168.1.23, 不然會出錯 # 不能使用 127.0.0.1 ，能夠更換 registry.jumpserver.org/public/guacamole:latest (py3) [root@DaMoWang opt]# docker run --name jms_guacamole -d \ -p 8081:8080 -v /opt/guacamole/key:/config/guacamole/key \ -e JUMPSERVER_KEY_DIR=/config/guacamole/key \ -e JUMPSERVER_SERVER=http://<填寫jumpserver的url地址>:8080 \ registry.jumpserver.org/public/guacamole:1.0.0

 

這裏所須要注意的是 guacamole 映射出來的端口是 8081，若與主機上其餘端口衝突請自定義

啓動成功後去Jumpserver 會話管理-終端管理（http://192.168.1.23:8080/terminal/terminal/）接受[Gua]開頭的一個註冊，若是頁面顯示不正常能夠等部署完成後再處理

 

安裝 Nginx 根據喜愛選擇安裝方式和版本

(py3) [root@DaMoWang opt]# yum -y install nginx

準備配置文件 修改 /etc/nginx/nginx.conf

(py3) [root@DaMoWang opt]# vim /etc/nginx/nginx.conf
# 把默認server配置塊改爲這樣，原有的內容請保持不動

server {
    listen 80; # 代理端口，之後將經過此端口進行訪問，再也不經過8080端口 location /luna/ { try_files $uri / /index.html; alias /opt/luna/; # luna 路徑，若是修改安裝目錄，此處須要修改 } location /media/ { add_header Content-Encoding gzip; root /opt/jumpserver/data/; # 錄像位置，若是修改安裝目錄，此處須要修改 } location /static/ { root /opt/jumpserver/data/; # 靜態資源，若是修改安裝目錄，此處須要修改 } location /socket.io/ { proxy_pass http://localhost:5000/socket.io/; # 若是coco安裝在別的服務器，請填寫它的ip  proxy_buffering off; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header X-Real-IP $remote_addr; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; access_log off; } location /guacamole/ { proxy_pass http://localhost:8081/; # 若是guacamole安裝在別的服務器，請填寫它的ip  proxy_buffering off; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $http_connection; proxy_set_header X-Real-IP $remote_addr; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; access_log off; client_max_body_size 100m; # Windows 文件上傳大小限制 } location / { proxy_pass http://localhost:8080; # 若是jumpserver安裝在別的服務器，請填寫它的ip proxy_set_header X-Real-IP $remote_addr; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } 

(py3) [root@DaMoWang opt]# nginx -t 

開啓nginx服務  (py3) [root@DaMoWang opt]# systemctl start nginx  (py3) [root@DaMoWang opt]# systemctl enable nginx  Created symlink from /etc/systemd/system/multi-user.target.wants/nginx.service to /usr/lib/systemd/system/nginx.service.

開始使用 Jumpserve

檢查應用是否已經正常運行

(py3) [root@DaMoWang opt]# cd jumpserver/
(py3) [root@DaMoWang jumpserver]# ./jms status # 肯定jumpserver已經運行，若是沒有運行請從新啓動jumpserver gunicorn is running: 18443 celery is running: 18462 beat is running: 18465 (py3) [root@DaMoWang jumpserver]# cd /opt/coco # 肯定jumpserver已經運行，若是沒有運行請從新啓動coco (py3) [root@DaMoWang coco]# ./cocod status Coco is running: 18749 # 若是安裝了 Guacamole (py3) [root@DaMoWang coco]# docker ps # 檢查容器是否已經正常運行，若是沒有運行請從新啓動Guacamole CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES a4572da64996 jumpserver/guacamole:latest "/init" 10 minutes ago Up 10 minutes 0.0.0.0:8081->8080/tcp jms_guacamole

服務所有啓動後，訪問 http://192.168.1.23，訪問nginx代理的端口，不要再經過8080端口訪問

默認帳號: admin 密碼: admin

測試鏈接

若是登陸客戶端是 macOS 或 Linux ，登陸語法以下
$ ssh -p2222 admin@192.168.1.23
$ sftp -P2222 admin@192.168.1.23密碼: admin

若是登陸客戶端是 Windows ，Xshell Terminal 登陸語法以下
$ ssh admin@192.168.1.23 2222
$ sftp admin@192.168.1.23 2222
密碼: admin
若是能登錄表明部署成功

# sftp默認上傳的位置在資產的 /tmp 目錄下
# windows拖拽上傳的位置在資產的 Guacamole RDP上的 G 目錄下