環(huán)境
????系統(tǒng): CentOS 7
????IP: 192.168.244.144
????關閉 selinux 和防火墻
? ??# CentOS 7
????????$ setenforce 0? # 可以設置配置文件永久關閉
????????$ systemctl stop iptables.service
????????$ systemctl stop firewalld.service
????????# 修改字符集,否則可能報 input/output error的問題,因為日志里打印了中文
????????$ 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
????????$ setenforce 0
????????$ service iptables stop????
????????# 修改字符集,否則可能報 input/output error的問題,因為日志里打印了中文
????????$ 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
一. 準備 Python3 和 Python 虛擬環(huán)境
1.1 安裝依賴包
? ??$ yum -y install wget sqlite-devel xz gcc automake zlib-devel openssl-devel epel-release git
????Yum 加速設置請參考 <http://mirrors.163.com/.help/centos.html>
1.2 編譯安裝
????$ wget https://www.python.org/ftp/python/3.6.1/Python-3.6.1.tar.xz
????$ tar xvf Python-3.6.1.tar.xz? && cd Python-3.6.1
????$ ./configure && make && make install
????# 這里必須執(zhí)行編譯安裝,否則在安裝 Python 庫依賴時會有麻煩...
1.3 建立 Python 虛擬環(huán)境
? ??因為 CentOS 6/7 自帶的是 Python2,而 Yum 等工具依賴原來的 Python,為了不擾亂原來的環(huán)境我們來使用 Python 虛擬環(huán)境
? ??$ cd /opt
????$ python3 -m venv py3
????$ source /opt/py3/bin/activate
????# 看到下面的提示符代表成功,以后運行 Jumpserver 都要先運行以上 source 命令,以下所有命令均在該虛擬環(huán)境中運行
????(py3) [root@localhost py3]
1.4 自動載入 Python 虛擬環(huán)境配置
此項僅為懶癌晚期的人員使用,防止運行 Jumpserver 時忘記載入 Python 虛擬環(huán)境導致程序無法運行。使用autoenv
????$ cd /opt
????$ git clone git://github.com/kennethreitz/autoenv.git
????$ echo 'source /opt/autoenv/activate.sh' >> ~/.bashrc
????$ source ~/.bashrc
二. 安裝 Jumpserver
2.1 下載或 Clone 項目
????項目提交較多 git clone 時較大,你可以選擇去 Github 項目頁面直接下載zip包。
????$ cd /opt/
????$ git clone https://github.com/jumpserver/jumpserver.git && cd jumpserver && git checkout master
????$ echo "source /opt/py3/bin/activate" > /opt/jumpserver/.env? # 進入 jumpserver 目錄時將自動載入 python 虛擬環(huán)境
????# 首次進入 jumpserver 文件夾會有提示,按 y 即可
????# Are you sure you want to allow this? (y/N) y
2.2 安裝依賴 RPM 包
????$ cd /opt/jumpserver/requirements
????$ yum -y install $(cat rpm_requirements.txt)? # 如果沒有任何報錯請繼續(xù)
2.3 安裝 Python 庫依賴
????$ pip install -r requirements.txt? # 不要指定-i參數,因為鏡像上可能沒有最新的包,如果沒有任何報錯請繼續(xù)
????Pip 加速設置請參考 <https://segmentfault.com/a/1190000011875306>
2.4 安裝 Redis, Jumpserver 使用 Redis 做 cache 和 celery broke
????????$ yum -y install redis
????????$ systemctl start redis
????# centos6
????????$ service redis start
2.5 安裝 MySQL
本教程使用 Mysql 作為數據庫,如果不使用 Mysql 可以跳過相關 Mysql 安裝和配置
# centos7
$ yum -y install mariadb mariadb-devel mariadb-server # centos7下安裝的是mariadb
$ systemctl enable mariadb
$ systemctl start mariadb
# centos6$ yum -y install mysql mysql-devel mysql-server
$ chkconfig mysqld on
$ service mysqld start
2.6 創(chuàng)建數據庫 Jumpserver 并授權
$ mysql
> create database jumpserver default charset 'utf8';
> grant all on jumpserver.* to 'jumpserver'@'127.0.0.1' identified by 'somepassword';
> flush privileges;
2.7 修改 Jumpserver 配置文件
$ cd /opt/jumpserver
$ cp config_example.py config.py
$ vi config.py
# 注意對齊,不要直接復制本文檔的內容
注意: 配置文件是 Python 格式,不要用 TAB,而要用空格

2.8 生成數據庫表結構和初始化數據
????$ cd /opt/jumpserver/utils
????$ bash make_migrations.sh
2.9 運行 Jumpserver
????$ cd /opt/jumpserver
????$ ./jms start all? # 后臺運行使用 -d 參數./jms start all -d
????# 新版本更新了運行腳本,使用方式./jms start|stop|status|restart all? 后臺運行請?zhí)砑?-d 參數
????運行不報錯,請瀏覽器訪問?http://192.168.244.144:8080/?
????默認賬號: admin 密碼: admin 頁面顯示不正常先不用處理,跟著教程繼續(xù)操作就行,后面搭建 nginx 代理就可以正常訪問了(此處頁面和服務還未完全搭建完成,暫時頁面無法訪問)
三. 安裝 SSH Server 和 WebSocket Server: Coco
3.1 下載或 Clone 項目
????新開一個終端,連接測試機,別忘了 source /opt/py3/bin/activate
$ cd /opt
$ source /opt/py3/bin/activate
$ git clone https://github.com/jumpserver/coco.git && cd coco && git checkout master
$ echo "source /opt/py3/bin/activate" > /opt/coco/.env? # 進入 coco 目錄時將自動載入 python 虛擬環(huán)境
# 首次進入 coco 文件夾會有提示,按 y 即可
# Are you sure you want to allow this? (y/N) y
3.2 安裝依賴
$ cd /opt/coco/requirements
$ yum -y? install $(cat rpm_requirements.txt)
$ pip install -r requirements.txt -i https://pypi.org/simple
3.3 修改配置文件并運行
$ cd /opt/coco
$ cp conf_example.py conf.py? # 如果 coco 與 jumpserver 分開部署,請手動修改 conf.py
$ vi conf.py # 注意對齊,不要直接復制本文檔的內容
注意: 配置文件是 Python 格式,不要用 TAB,而要用空格

????$ ./cocod start? # 后臺運行使用 -d 參數 ./cocod start -d
????# 新版本更新了運行腳本,使用方式./cocod start|stop|status|restart? 后臺運行請?zhí)砑?-d 參數
????啟動成功后去Jumpserver 會話管理-終端管理(http://192.168.244.144:8080/terminal/terminal/)接受coco的注冊,如果頁面不正??梢缘炔渴鹜瓿珊笤偬幚?此處頁面和服務還未完全搭建完成,暫時頁面無法訪問)
四. 安裝 Web Terminal 前端: Luna
Luna 已改為純前端,需要 Nginx 來運行訪問
訪問(https://github.com/jumpserver/luna/releases)下載對應版本的 release 包,直接解壓,不需要編譯
4.1 解壓 Luna
$ cd /opt
$ wget https://github.com/jumpserver/luna/releases/download/1.3.2/luna.tar.gz
$ tar xvf luna.tar.gz
$ chown -R root:root luna
五. 安裝 Windows 支持組件(如果不需要管理 windows 資產,可以直接跳過這一步)
????因為手動安裝 guacamole 組件比較復雜,這里提供打包好的 docker 使用, 啟動 guacamole
????5.1 Docker安裝 (僅針對CentOS7,CentOS6安裝Docker相對比較復雜)
????$ yum remove docker-latest-logrotate? docker-logrotate? docker-selinux dockdocker-engine$ yum install -y yum-utils? device-mapper-persistent-data? lvm2?
# 添加docker官方源
????$ yum-config-manager? ? --add-repo? ? https://download.docker.com/linux/centos/docker-ce.repo
????$ yum makecache fast
? ? $ yum install docker-ce????
# 國內部分用戶可能無法連接docker官網提供的源,這里提供阿里云的鏡像節(jié)點供測試使用
????$ yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
????$ rpm --import http://mirrors.aliyun.com/docker-ce/linux/centos/gpg
????$ yum makecache fast
????$ yum -y install docker-ce
????$ systemctl start docker
????$ systemctl status docker
5.2 啟動 Guacamole
這里所需要注意的是 guacamole 暴露出來的端口是 8081,若與主機上其他端口沖突請自定義
修改下面 docker run 里的 JUMPSERVER_SERVER 參數,填上 Jumpserver 的 url 地址, 啟動成功后去 Jumpserver 會話管理-終端管理(http://192.168.244.144:8080/terminal/terminal/)接受[Gua]開頭的一個注冊,如果頁面顯示不正??梢缘炔渴鹜瓿珊笤偬幚?/p>
# 注意:這里需要修改下 http://<填寫jumpserver的url地址> 例: http://192.168.244.144, 否則會出錯, 帶寬有限, 下載時間可能有點長,可以喝杯咖啡,撩撩對面的妹子
$ 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:latest
六. 配置 Nginx 整合各組件
????6.1 安裝 Nginx 根據喜好選擇安裝方式和版本
????$ yum -y install nginx
????6.2 準備配置文件 修改 /etc/nginx/nginx.conf
????內容如下:
? ??$ vim /etc/nginx/nginx.conf
... 省略
# 把默認server配置塊改成這樣
server {
? ? listen 80;? # 代理端口,以后將通過此端口進行訪問,不再通過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 /luna/ {
? ? ? ? try_files $uri / /index.html;
? ? ? ? alias /opt/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安裝在別的服務器,請?zhí)顚懰膇p
? ? ? ? proxy_buffering off;
? ? ? ? proxy_http_version 1.1;
? ? ? ? proxy_set_header Upgrade $http_upgrade;
? ? ? ? proxy_set_header Connection "upgrade";
? ? }
? ? location /guacamole/ {
? ? ? ? proxy_pass? ? ? http://localhost:8081/;? # 如果guacamole安裝在別的服務器,請?zhí)顚懰膇p
? ? ? ? proxy_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;
? ? ? ? access_log off;
? ? ? ? client_max_body_size 100m;? # Windows 文件上傳大小限制
? ? }
? ? location / {
? ? ? ? proxy_pass http://localhost:8080;? # 如果jumpserver安裝在別的服務器,請?zhí)顚懰膇p
? ? }
}
... 省略
6.3 運行 Nginx
nginx -t? # 確保配置沒有問題, 有問題請先解決
# CentOS 7
????$ systemctl start nginx
????$ systemctl enable nginx ????
# CentOS 6
????$ service nginx start
????$ chkconfig nginx on
????6.4 開始使用 Jumpserver ????檢查應用是否已經正常運行
????$ cd /opt/jumpserver
????$ ./jms status? # 確定jumpserver已經運行,如果沒有運行請重新啟動jumpserver
????$ cd /opt/coco????
????$ ./cocod status? # 確定jumpserver已經運行,如果沒有運行請重新啟動coco
????# 如果安裝了 Guacamole
????$ docker ps? # 檢查容器是否已經正常運行,如果沒有運行請重新啟動Guacamole
????服務全部啟動后,訪問?http://192.168.244.144,訪問nginx代理的端口,不要再通過8080端口訪問
????默認賬號: admin 密碼: admin
????如果部署過程中沒有接受應用的注冊,需要到Jumpserver 會話管理-終端管理 接受 Coco Guacamole 等應用的注冊。
** 測試連接**
