开源项目学习之(一)------zheng环境搭建

ゝ一世哀愁。 2022-06-02 08:46 191阅读 0赞

**一、项目简介**

17年初就接触了zheng这个项目，感觉挺牛的，看他的架构图就知道了

![SouthEast][]

现在都已经18年了，时间好快，特此记录下zheng的环境搭建，虽然，先看下码云上zheng的简介吧:[https://gitee.com/shuzheng/zheng][https_gitee.com_shuzheng_zheng]。

zheng是基于Spring+SpringMVC+Mybatis分布式敏捷开发系统架构，提供整套公共微服务服务模块：集中权限管理（单点登录）、内容管理、支付中心、用户管理（支持第三方登录）、微信平台、存储系统、配置中心、日志分析、任务和通知等，支持服务治理、监控和追踪，努力为中小型企业打造全方位J2EE企业级开发解决方案。

**二、导入项目**

导入项目的方式有两种，一种是通过git，一种是直接下载源码然后导入到IDEA中，我这里以下载源码来演示，下载之后的源码如下:

![SouthEast 1][]

有如下一些模块:

zheng-common--公共配置、MybatisGenerator扩展插件、通用BaseService、工具类等  
zheng-admin--通用后台管理系统，zheng项目所有后台系统都是使用该模块界面作为前端展示。  
zheng-ui--各个子系统前台thymeleaf模板，前端资源模块，使用nginx代理，实现动静分离。  
zheng-upms--基于RBAC授权和基于用户授权的细粒度权限控制通用平台，并提供单点登录、会话管理和日志管理。  
zheng-cms--内容管理系统  
zheng-oss--文件存储系统  
zheng-ucenter--通用用户管理系统， 实现最常用的用户注册、登录、资料管理、个人中心、第三方登录等基本需求，支持扩展二次开发。  
zheng-wechat-mp--微信公众号管理平台，除实现官网后台自动回复、菜单管理、素材管理、用户管理、消息群发等基础功能外，还有二维码推广、营销活动、微网站、会员卡、优惠券等。  
zheng-wechat-app--微信小程序后台  
zheng-pay--一站式支付解决方案，统一下单接口，支持支付宝、微信、网银等多种支付方式。不涉及业务的纯粹的支付平台。  
zheng-api--服务网关，对外暴露统一规范的接口和包装响应结果，包括各个子系统的交互接口、对外开放接口、开发加密接口、接口文档等服务，可在该模块支持验签、鉴权、路由、限流、监控、容错、日志等功能。

然后打开IDEA---->File---->New---->Module from Existing Sources导入一个存在的Module

![SouthEast 2][]

![SouthEast 3][]

![SouthEast 4][]

![SouthEast 5][]

然后点击Finsh.导入成功之后，如下:

![SouthEast 6][]

找到每个项目的跟pom.xml更新下依赖:

![SouthEast 7][]

然后下载zheng-common中的依赖

![SouthEast 8][]

**三、环境搭建**

要想成功运行项目，必须要安装一下一些工具:

1、JDK  
2、Mysql  
3、maven  
4、Redis  
5、Zookeeper  
6、ActiveMQ  
7、Nginx

**4、Redis安装**

至于JDK,Mysql,maven,的安装太简单了,这里就不演示了,Redis安装如下,去github下载最新的安装包：[https://github.com/MSOpenTech/redis/releases][https_github.com_MSOpenTech_redis_releases]

![SouthEast 9][]

下载Redis-x64-3.2.100-windows.msi安装过程比较简单，一路next就可以了。然后还得安装Redis可视化工具Redis Desktop Manager下载地址如下:[https://redisdesktop.com/download][https_redisdesktop.com_download]

![SouthEast 10][]

选择最新的版本进行下载、下载之后，然后进行安装

![SouthEast 11][]

![SouthEast 12][]

![SouthEast 13][]

![SouthEast 14][]

安装之后，打开软件

![SouthEast 15][]

**![SouthEast 16][]**

这里要登录密码，由于我装的是安装版，以下是设置密码，在CMD下:

config get requirepass //获取当前密码
    config set requirepass "root"//设置当前密码,服务重新启动后又会置为默认，即无密码；不建议此种方式

**![SouthEast 17][]**

**5、Zookeeper安装**

首先去官网下载:[http://www.apache.org/dyn/closer.cgi/zookeeper/][http_www.apache.org_dyn_closer.cgi_zookeeper]

![SouthEast 18][]

![SouthEast 19][]

选择3.5.2版本。

**6、ActiveMQ**

官网下载地址为:http://activemq.apache.org/download-archives.html 选择最新版本进行下载

![SouthEast 20][]

这里选择5.9.0版本进行下载。

**7、Nginx**

官网下载地址为:[http://nginx.org/][http_nginx.org]

![SouthEast 21][]

![SouthEast 22][]

**四、运行项目**

A.后台启动顺序:

(一)、初始化数据库

下面就是启动项目了，在启动项目前还得准备下，首先新建zheng数据库

![SouthEast 23][]

导入project-datamodel文件夹下的zheng.sql

![SouthEast 24][]

工具使用的是navicat for premium

![SouthEast 25][]

导入成功之后，有如下表

![SouthEast 26][]

(二)、数据库连接配置工作

修改各模块下profiles的数据库连接等配置信息

![SouthEast 27][]

有如下一些module下有这些配置文件

![SouthEast 28][]像如下这种密码使用了AES加密，使用com.zheng.common.util.AESUtil工具类修改这些值

![SouthEast 29][]

在zheng-upms中有个generator.properties

![SouthEast 30][]

AESUtil使用如下，替换其中的root为数据库密码，然后运行就会有以下信息输出:

![SouthEast 31][]

![SouthEast 32][]

比如我这里redis和mysql都是root,所有我把密码修改成如下的密码:

![SouthEast 33][]

**(三)、修改本地Host**

进入到"C:\\Windows\\System32\\drivers\\etc"目录下:

![SouthEast 34][]

![SouthEast 35][]

127.0.0.1 ui.zhangshuzheng.cn
    127.0.0.1 upms.zhangshuzheng.cn
    127.0.0.1 cms.zhangshuzheng.cn
    127.0.0.1 pay.zhangshuzheng.cn
    127.0.0.1 ucenter.zhangshuzheng.cn
    127.0.0.1 wechat.zhangshuzheng.cn
    127.0.0.1 api.zhangshuzheng.cn
    127.0.0.1 oss.zhangshuzheng.cn
    127.0.0.1 config.zhangshuzheng.cn
    127.0.0.1 zkserver
    127.0.0.1 rdserver
    127.0.0.1 dbserver
    127.0.0.1 mqserver

**(四)、启动并运行相关程序工作**

我把有关的工具都解压到该目录下了:

![20180110105111734][]

1.启动Zookeeper

进入到zookeeper的bin目录，双击zkServer.cmd启动服务。

![SouthEast 36][]

启动成功之后，输入信息如下:

![SouthEast 37][]

![SouthEast 38][]

2、启动ActiveMQ：

1)进入MQ的bin目录D:\\zheng\_start\\apache-activemq-5.9.0-bin\\apache-activemq-5.9.0\\bin\\win64，双击activemq.bat

![SouthEast 39][]

启动成功之后

![SouthEast 40][]

2)在浏览器中输入http://localhost:8161/admin/输入默认的admin admin

3)出现这样的界面则MQ安装成功。

![SouthEast 41][]

**3、启动Nginx**

在zheng/project-tools/nginx下提供了ngxin的一些配置

![SouthEast 42][]

将这两个文件复制到nginx/conf下

![SouthEast 43][]

修改其中的项目路径:

![20180110105600058][]

或者可以直接修改nginx.conf为如下内容:

#user  nobody;
    worker_processes  1;
    
    #error_log  logs/error.log;
    #error_log  logs/error.log  notice;
    #error_log  logs/error.log  info;
    
    #pid        logs/nginx.pid;
    
    
    events {
        worker_connections  1024;
    }
    
    
    http {
        include       mime.types;
        default_type  application/octet-stream;
    
        #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
        #                  '$status $body_bytes_sent "$http_referer" '
        #                  '"$http_user_agent" "$http_x_forwarded_for"';
    
        #access_log  logs/access.log  main;
    
        sendfile        on;
        #tcp_nopush     on;
    
        #keepalive_timeout  0;
        keepalive_timeout  65;
    
        #gzip  on;
    
        server {
    		#监听的端口号，配置这里访问的时候浏览器里可以访问http://localhost:1000/zheng-cms-web/测试是否能看到页面内容（没有直接访问http://localhost:1000，因为这个路径zheng-ui下没有index.html之类的文件，会出现访问错误提示，不好作为判定是否nginx启动配置成功的标志）
            listen       1000;
            server_name  localhost;
    
            #charset koi8-r;
    
            #access_log  logs/host.access.log  main;
    
            location / {
    	    #root后面内容需要修改为本机的zheng-ui项目的绝对路径位置
                root   F:/GitHub/zheng/zheng-ui/;
                index  index.html index.htm;
                add_header Access-Control-Allow-Origin *;
            }
    
            #error_page  404              /404.html;
    
            # redirect server error pages to the static page /50x.html
            #
            error_page   500 502 503 504  /50x.html;
            location = /50x.html {
                root   html;
            }
    
            # proxy the PHP scripts to Apache listening on 127.0.0.1:80
            #
            #location ~ \.php$ {
            #    proxy_pass   http://127.0.0.1;
            #}
    
            # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
            #
            #location ~ \.php$ {
            #    root           html;
            #    fastcgi_pass   127.0.0.1:9000;
            #    fastcgi_index  index.php;
            #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
            #    include        fastcgi_params;
            #}
    
            # deny access to .htaccess files, if Apache's document root
            # concurs with nginx's one
            #
            #location ~ /\.ht {
            #    deny  all;
            #}
        }
    
    
        # another virtual host using mix of IP-, name-, and port-based configuration
        #
        #server {
        #    listen       8000;
        #    listen       somename:8080;
        #    server_name  somename  alias  another.alias;
    
        #    location / {
        #        root   html;
        #        index  index.html index.htm;
        #    }
        #}
    
    
        # HTTPS server
        #
        #server {
        #    listen       443 ssl;
        #    server_name  localhost;
    
        #    ssl_certificate      cert.pem;
        #    ssl_certificate_key  cert.key;
    
        #    ssl_session_cache    shared:SSL:1m;
        #    ssl_session_timeout  5m;
    
        #    ssl_ciphers  HIGH:!aNULL:!MD5;
        #    ssl_prefer_server_ciphers  on;
    
        #    location / {
        #        root   html;
        #        index  index.html index.htm;
        #    }
        #}
    
    }

然后在CMD下执行nginx.exe

![SouthEast 44][]

或者可以在该目录下新建一个nginx.bat文件内容如下:

@echo off
    rem zheng-tools
    rem author: shuzheng http://www.zhangshuzheng.cn
    rem GitHub: https://github.com/shuzheng
    rem OsChina: http://git.oschina.net/shuzheng/zheng
    
    echo ==================begin========================
    
    cls 
    SET NGINX_PATH=D:
    SET NGINX_DIR=D:\自己的nginx安装路径\nginx-1.11.4\ 
    color 0a 
    TITLE zheng-tools Power By shuzheng (http://www.zhangshuzheng.cn)
    
    CLS 
    
    ECHO. 
    ECHO.    ********************************************************************
    ECHO.    *                                                                  *
    ECHO.    *                                                                  *
    ECHO.    *   zheng-tools Power By shuzheng (http://www.zhangshuzheng.cn)    *
    ECHO.    *                                                                  *
    ECHO.    *                                                                  *
    ECHO.    ********************************************************************
    ECHO. 
    
    :MENU 
    
    ECHO.---------------------------- nginx 进程列表 --------------------------------
    tasklist|findstr /i "nginx.exe"
    if ERRORLEVEL 1 (echo nginx未启动) else (echo nginx已启动)
    ECHO.----------------------------------------------------------------------------
    
    
    ECHO. 
    	ECHO.  [1] 启动Nginx  
    	ECHO.  [2] 关闭Nginx  
    	ECHO.  [3] 重启Nginx  
    	ECHO.  [4] 退 出 
    ECHO. 
    
    ECHO.请输入选择项目的序号:
    set /p ID=
    	IF "%id%"=="1" GOTO start 
    	IF "%id%"=="2" GOTO stop 
    	IF "%id%"=="3" GOTO restart 
    	IF "%id%"=="4" EXIT
    PAUSE 
    
    :start 
    	call :startNginx
    	ECHO.============================================================================
    	ECHO. 
    	ECHO. 
    	GOTO MENU
    
    :stop 
    	call :shutdownNginx
    	ECHO.============================================================================
    	ECHO. 
    	ECHO. 
    	GOTO MENU
    :restart 
    	call :shutdownNginx
    	call :startNginx
    	ECHO.============================================================================
    	ECHO. 
    	ECHO. 
    	GOTO MENU
    
    :shutdownNginx
    	ECHO. 
    	ECHO.关闭Nginx...... 
    	taskkill /F /IM nginx.exe > nul
    	ECHO.OK,关闭所有nginx 进程
    	goto :eof
    
    :startNginx
    	ECHO. 
    	ECHO.启动Nginx...... 
    	IF NOT EXIST "%NGINX_DIR%nginx.exe" ECHO "%NGINX_DIR%nginx.exe"不存在 
    
    	%NGINX_PATH% 
    
    	cd "%NGINX_DIR%" 
    
    	IF EXIST "%NGINX_DIR%nginx.exe" (
    		echo "start '' nginx.exe"
    		start "" nginx.exe
    	)
    	ECHO.OK
    	goto :eof

运行效果如下:

**![20180110121314562][]**

**4、启动Tomcat**

在tomcat中部署dubbo应用。这里用的是2.5.4,可从这下载:[http://download.csdn.net/download/u011781521/10197867][http_download.csdn.net_download_u011781521_10197867] 下载之后解压，删除Tomcat目录下的ROOT目录，然后复制dubbo中的ROOT到该目录下:

![20180110103736258][]

然后修改下tomcat的默认端口以防止和下面的jetty冲突，最后在D:\\zheng\_start\\apache-tomcat-8.0.45\\bin目录下执行startup.bat启动tomcat,成功之后输出如下:

![20180110104843534][]

访问tomcat的dubbo后台: localhost:8089 用户名与密码都是root

![20180110105026636][]

**5、启动Service**

首先启动 zheng-upms-rpc-service(直接运行src目录下的ZhengUpmsRpcServiceApplication\#main方法启动)

![SouthEast 45][]

启动成功之后如下:

![SouthEast 46][]

**6、启动Web服务**

打开Maven视图

![SouthEast 47][]

debug运行jetty。然后按需启动对应子系统xxx的zheng-xxx-rpc-service(main方法) => zheng-xxx-webapp(jetty)

然后在dubbo管控台上就会有一些服务已经注册了

![20180110105831967][]

**7、访问页面**

然后访问 [ http://upms.zhangshuzheng.cn:1111/][http_upms.zhangshuzheng.cn_1111]，子系统菜单已经配置到zheng-upms权限中，不用直接访问子系统，默认帐号密码：admin/123456

![SouthEast 48][]

![SouthEast 49][]

**B、zheng-cms启动**

zheng-cms-admin：启动ActiveMQ-启动 => 启动zheng-rpc-service => 启动zheng-cms-admin

![20180110115736721][]

![20180110115938155][]

zheng-cms-web：启动nginx代理zheng-ui静态资源,然后访问: [ http://upms.zhangshuzheng.cn:1111][http_upms.zhangshuzheng.cn_1111 1]

![20180110120839709][]

切换到CMS系统

![20180110120921404][]

此时访问CMS首页: [ http://cms.zhangshuzheng.cn:2224/][http_cms.zhangshuzheng.cn_2224]

![20180110121001025][]

[SouthEast]: /images/20220602/208113774e1d47be9a4ade3cf264da6b.png
[https_gitee.com_shuzheng_zheng]: https://gitee.com/shuzheng/zheng
[SouthEast 1]: /images/20220602/eec24945b8dd4d408fd82cdfa8cb21b8.png
[SouthEast 2]: /images/20220602/a6fb9877036d4361962a881c4202052f.png
[SouthEast 3]: /images/20220602/2018878477b847469e4c0dec03a2035f.png
[SouthEast 4]: /images/20220602/c13dfba99724498ebc150c679fd0b25d.png
[SouthEast 5]: /images/20220602/2acd73c07aae46ca90b6bb6f85baa864.png
[SouthEast 6]: /images/20220602/ce5d97bb996e4f9191bd846ab149503e.png
[SouthEast 7]: /images/20220602/ef3d1284e2e44a49a064e7220d9a07aa.png
[SouthEast 8]: /images/20220602/c0bdae1d4b424d3ba408f13f13ad84d6.png
[https_github.com_MSOpenTech_redis_releases]: https://github.com/MSOpenTech/redis/releases
[SouthEast 9]: /images/20220602/70a5853163cf444681e07dcb50022582.png
[https_redisdesktop.com_download]: https://redisdesktop.com/download
[SouthEast 10]: /images/20220602/caa33c4015f94272825b2e58c9e3305c.png
[SouthEast 11]: /images/20220602/452d481fd44643849a64d6bc87c21290.png
[SouthEast 12]: /images/20220602/8a5ce6c924954efe9272973490632e27.png
[SouthEast 13]: /images/20220602/e76b7b0f66494c35a339bd2cbe8ce5c9.png
[SouthEast 14]: /images/20220602/e9678c6fe45449d7889780b296370151.png
[SouthEast 15]: /images/20220602/85e4c9cf312b47febe755a0c9b99099e.png
[SouthEast 16]: /images/20220602/f88863acba5b4daeb79eb471e94fabda.png
[SouthEast 17]: /images/20220602/ca6ec911aec148f79d077153d1ed2cf3.png
[http_www.apache.org_dyn_closer.cgi_zookeeper]: http://www.apache.org/dyn/closer.cgi/zookeeper/
[SouthEast 18]: /images/20220602/c179e3528274477f8c9c62b2985b78c1.png
[SouthEast 19]: /images/20220602/044d58b5621b42f198860973746a570a.png
[SouthEast 20]: /images/20220602/fc04dfc68a744124a526eb3f97cd27cf.png
[http_nginx.org]: http://nginx.org/
[SouthEast 21]: /images/20220602/2c459c862f104119ae7abe920ab94f7e.png
[SouthEast 22]: /images/20220602/b5dcbfa1c03340949f7aa09bd3f10be0.png
[SouthEast 23]: /images/20220602/ff43447663504c13a986f844ce4ccdb0.png
[SouthEast 24]: /images/20220602/d35691d1636b4209a25f7621dd2c6997.png
[SouthEast 25]: /images/20220602/d4130ea2013044b0903d100807dd3678.png
[SouthEast 26]: /images/20220602/934bc3f2072842abbea52ef0eb5302a5.png
[SouthEast 27]: /images/20220602/657314d1e39440309c3cc7391bacb321.png
[SouthEast 28]: /images/20220602/c75761f35f15479698c0f630a71ce3b4.png
[SouthEast 29]: /images/20220602/281c7ffb32a2463b819757cec5e38d6a.png
[SouthEast 30]: /images/20220602/ce4f1240fc33409694506b845b1b2662.png
[SouthEast 31]: /images/20220602/b158d9edc5534fe788fbb2d454712e47.png
[SouthEast 32]: /images/20220602/1c9c477791204bed8bc0fab9cc3ae172.png
[SouthEast 33]: /images/20220602/80f3387c1efe460d9976dd7231bc443e.png
[SouthEast 34]: /images/20220602/6e00c085867e4dcaabc42af19f1c8a16.png
[SouthEast 35]: /images/20220602/6990ce87e53845aaba6fc52b58d917b2.png
[20180110105111734]: /images/20220602/84bc9e0b86024db98aca51d13e4059d7.png
[SouthEast 36]: /images/20220602/51e1add6c0f54c5d9f4b8f08a7e63238.png
[SouthEast 37]: /images/20220602/aec5ffd44aa94e318d5e6e54d0fcf467.png
[SouthEast 38]: /images/20220602/d839310793794623ab90311dfa962636.png
[SouthEast 39]: /images/20220602/ec7b0274629b4a0bbd07fd8994cf742e.png
[SouthEast 40]: /images/20220602/b638d0402fe243a1ab47780b300a177f.png
[SouthEast 41]: /images/20220602/bddae1ae03794d168383bae6cd78fd07.png
[SouthEast 42]: /images/20220602/a1d48d749377428eb63755b323074985.png
[SouthEast 43]: /images/20220602/e44d796bdab641db96150b3611cc7404.png
[20180110105600058]: /images/20220602/6dcc735bd2fa4c5996bbb5b90d2824a1.png
[SouthEast 44]: /images/20220602/f967b4e51d8a4d9eacbd7ee46b47be85.png
[20180110121314562]: /images/20220602/32f06e4bc9534647b1eb341e2a6b60be.png
[http_download.csdn.net_download_u011781521_10197867]: http://download.csdn.net/download/u011781521/10197867
[20180110103736258]: /images/20220602/379c63b593734c7cad2e14d73b27a5d7.png
[20180110104843534]: /images/20220602/6e81bb0de1c24d2ea8278de60171d86a.png
[20180110105026636]: /images/20220602/e1d91dd690e14e24abddc5bb20728a21.png
[SouthEast 45]: /images/20220602/02124621c0d347038f09fa83d5af196c.png
[SouthEast 46]: /images/20220602/fd218b28d82e455688eb854fd3655605.png
[SouthEast 47]: /images/20220602/5a71386e46a84b388427c303c42ab7a2.png
[20180110105831967]: /images/20220602/69e5d3a07ebd4b4299205bba61cc0c01.png
[http_upms.zhangshuzheng.cn_1111]: http://upms.zhangshuzheng.cn:1111/
[SouthEast 48]: /images/20220602/f101adb57dfa459b912468052b4d9129.png
[SouthEast 49]: /images/20220602/e493566a26ea48c0845c6553401fcbef.png
[20180110115736721]: /images/20220602/0af80a2bb49f4799b5637c9140026836.png
[20180110115938155]: /images/20220602/190ba57caaa04fdaa7b729aabf8a66a4.png
[http_upms.zhangshuzheng.cn_1111 1]: http://upms.zhangshuzheng.cn:1111
[20180110120839709]: /images/20220602/43971082e25b412891bae7e297a148b8.png
[20180110120921404]: /images/20220602/72a803031b0d46efa24a886337538bb6.png
[http_cms.zhangshuzheng.cn_2224]: http://cms.zhangshuzheng.cn:2224/
[20180110121001025]: /images/20220602/43dc51ce9a0a462d9031acf31d56d628.png