Windows 跑起一个 SpringBoot 项目需要准备的基本环境

359 阅读10分钟

本项目是在 Windows 10 下进行开发,因此下面的安装都是基 Windows。

安装 JDK 8

下载 JDK

双击安装完成后,在 环境变量 > 系统变量 中,新增系统变量 JAVA_HOME 其值为 JDK 的安装目录,并为 Path 系统变量新增 %JAVA_HOME%\bin 和 %JAVA_HOME%\jre\bin 两项。

保存后,打开一个新的控制台(CMD)并输入 java -version,看到 java 的版本信息后则说明安装成功。

安装 Redis 3

下载 Redis

可以下载绿色解压即可用的版本,也可以下载双击安装版本。

安装完成后,在 环境变量 > 系统变量 中,新增系统变量 REDIS_HOME 其值为 Redis 的安装目录,并为 Path 系统变量新增 %REDIS_HOME%。

接下来将 Redis 注册为服务并实现开机自启动。基于 Redis 的安装目录打开一个新的命令行控制台(CMD)并输入命令 redis-server --service-install redis.windows.conf 并执行,即可在 Windows 系统中成功注册服务。接着在 计算机管理 > 服务和应用程序 > 服务 中找到 Redis 服务并打开,启动类型选为自动。

要启动 Redis 服务,可在命令行控制台中输入并执行 redis-server --service-start。

要测试 Redis 服务是否启动成功,可在另一个命令行控制台输入 redis-cli 并回车,进入 Redis 命令行后,输入 ping,回车后如果返回 PONG,则说明 Redis 服务已成功启动。

安装 Maven 3

下载 Maven

我下载的版本是 3.5.0,只需要把压缩包解压到目标目录中即可。

安装完成后,在 环境变量 > 系统变量 中,新增系统变量 MAVEN_HOME 其值为 Maven 的安装目录,并为 Path 系统变量新增 %MAVEN_HOME%\bin。

保存后,打开一个新的控制台(CMD)并输入 mvn -version,看到 Maven 的版本信息后则说明安装成功。

接下来,把 Maven 的安装目录下的 conf/settings.xml 配置文件进行修改:

在 Maven 的安装目录中新增一个 repository 目录,用于存放未来需要下载的依赖包,并把该 repository 的绝对地址添加到配置(约在第 55 行)中。

<localRepository>这里是 repository 的绝对路径</localRepository>

接着在 Mirrors 内新增一个 mirror 配置,使得依赖包的下载地址重定向到阿里云。

<mirror>
  <id>alimaven</id>
  <mirrorOf>central</mirrorOf>
  <name>aliyun maven</name>
  <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

到了这里,如果您还安装了 IDEA 作为 Java 的开发工具,则还可以将 IDEA 的默认 Moven 配置为当前安装的 Maven。步骤如下:

  1. 在没打开任何项目的情况下,选中 File > Settings > Build, Execution, Deployment > Build Tools > Maven,打开 IDEA 的 Maven 配置。
  2. 把 Maven home directory 改选为当前已安装的 Maven 安装目录。
  3. 把 User settings file 改选为我们已经修改了的 settings.xml 文件,并勾选 Override。
  4. 先点击 Apply 按钮,再点击 OK 按钮。再次打开 IDEA 后,我们便能使用当前已安装的 Maven 了。

安装 MySQL 5.7

下载 MySQL

我下载的版本是 5.7.24,只需要把压缩包解压到程序目录中即可。

安装完成后,在 环境变量 > 系统变量 中,新增系统变量 MYSQL_HOME 其值为 MySQL 的安装目录,并为 Path 系统变量新增 %MYSQL_HOME%\bin。

保存后,打开一个新的控制台(CMD)并输入 mysql --version,看到 MySQL 的版本信息后则说明安装成功。

接下来在 MySQL 安装目录中新建一个 my.ini 的配置文件,并输入以下内容(注意根据中文提示替换成相应的内容):

[client]
port=3306
default-character-set=utf8
[mysqld]
port=3306
character-set-server=utf8
default-storage-engine=INNODB
# 自己的 MySQL 安装目录
basedir=你的 MySQL 安装目录
# 自己的 MySQL 的数据库存放目录
datadir=你的 MySQL 安装目录再加上一个 data 子目录
# 跳过安全检查
skip-grant-tables

然后使用管理员身份打开命令行控制台(CMD),并切换到 MySQL 安装目录的 bin 子目录下,执行以下命令把 MySQL 注册为一个 Windows 服务:

mysqld -install

成功后可在 计算机管理 > 服务和应用程序 > 服务 中找到 MySQL 服务并打开,启动类型选为自动,此后每次开机 MySQL 服务均能自动启动了。

接着我们可以执行以下命令进行数据库的初始化(执行成功后会在 MySQL 安装目录中生成 data 目录):

mysqld --initialize-insecure --user=mysql

使用以下命令启动 MySQL (如果已经启动控制台也会打印相关信息):

net start mysql

使用以下命令进入 MySQL 管理控制台(不要输入密码,直接回车即可):

mysql -u root -p

在 MySQL 控制台中,我们作为 root 用户可以直接输入 SQL 语句修改 root 用户的密码为 123456:

# 先把 root 的密码设置为 123456
ALTER USER 'root'@'localhost' IDENTIFIED BY '123456';

# 接着刷新权限
flush privileges;

# 然后退出 MySQL 控制台即可
exit;

回到 Windows 的控制台后,我们把 my.ini 的配置项 skip-grant-tables 删掉或变成注释。

# 跳过安全检查
# skip-grant-tables

然后重启 MySQL

# 停止 MySQL 服务
net stop mysql

# 启动 MySQL 服务
net start mysql

这时我们再使用 root 用户身份进入 MySQL 控制台时,就需要输入密码了。

安装 Tomcat 8

下载 Tomcat

使用 JavaEE 开发规范之一 Servlet 时,我们是无法避开 Tomcat 这个 Web 服务器的。另外,Tomcat 依赖于环境变量 JAVA_HOME,请确保您的 JAVA_HOME 存在并正确!

由于我们安装的 Tomcat 8 的绿色版本,因此只需要把解压后的内容放置到目标目录中(作为安装目录)即可。

安装完成后,在 环境变量 > 系统变量 中,新增系统变量 TOMCAT_HOME 其值为 Tomcat 的安装目录,并为 Path 系统变量新增 %TOMCAT_HOME%\bin。

保存后,打开一个新的控制台(CMD)并输入 tomcat8 version,看到 Tomcat 的版本信息后则说明安装成功。

接下来在安装目录中找到并双击 bin\startup.bat 可启动 Tomcat 服务器,在浏览器地址栏输入 localhost:8080 可以看到 Tomcat 的默认访问页面则说明启动成功。

接着在安装目录中打开 conf/logging.properties 文件把控制台的输入编码格式从 UTF-8 改为 GBK,这样就可以避免控制台中 Tomcat 打印乱码了:

java.util.logging.ConsoleHandler.encoding=GBK

当然,我们不一定希望服务器的端口号就是 8080!因此我们可以在 conf/server.xml 中修改 Connector 标签的 port 属性为我们希望使用的端口号(例如 2020):

<Connector port="2020" protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="8443" />

这样我们在浏览器中要访问 Tomcat 服务器的话,就需要输入 localhost:2020 了。

安装 Nginx 1.18

下载 Nginx

我下载的版本是 1.18.0,只需要把压缩包解压到目标目录中即可。

安装完成后,在 环境变量 > 系统变量 中,新增系统变量 NGINX_HOME 其值为 Nginx 的安装目录,并为 Path 系统变量新增 %NGINX_HOME%。

在 Nginx 安装目录中双击启动 nginx.exe,或在有管理员权限的命令行中执行 start nginx 即可启动 Nginx 服务器。如果 80 端口被其他服务占用了,可以到 conf/nginx.conf 文件中修改端口配置(例如 3333),重启 Nginx 服务器,在浏览器中访问 localhost:3333 能看到 Nginx 的默认页面则说明启动成功。

如果要实现 Nginx 开机自启,可以到 WinSW 中下载一个服务包装器来把 nginx.exe 注册为 Windows 服务。

本人下载了 WinSW v2.12.0 的 x64 版本,然后把它放置在 nginx.exe (即 Nginx 安装目录)的同级目录下,并把该包装器重命名为 nginx-service.exe。

然后在此目录中在创建一个 nginx-service.xml 配置文件,配置如下(其中下面各项的 D:\path-to-nginx\nginx 请替换成您的 Nginx 安装目录):

<service>
    <id>nginx</id>
    <name>nginx</name>
    <description>nginx</description>
    <logpath>D:\path-to-nginx</logpath>
    <logmode>roll</logmode>
    <depend></depend>
    <executable>D:\path-to-nginx\nginx.exe</executable>
    <stopexecutable>D:\path-to-nginx\nginx.exe -s stop</stopexecutable>
</service>

保存该配置文件后,使用管理员身份打开命令行控制台(CMD)并进入到 Nginx 的安装目录中执行以下命令:

nginx-service.exe install

成功后可在 计算机管理 > 服务和应用程序 > 服务 中找到 nginx 服务并打开,启动类型选为自动,此后每次开机 nginx 服务就可以自动启动了。

安装 RabbitMQ 3.12

您必须先下载安装 Erlang,再下载安装 RabbitMQ。

而本人安装的是 RabbitMQ 3.12.6,依赖于 Erlang 26.1.2。

安装完成 Erlang 后,在 环境变量 > 系统变量 中,新增系统变量 ERLANG_HOME 其值为 Erlang 的安装目录,并为 Path 系统变量新增 %ERLANG_HOME%\bin。

保存后,打开一个新的控制台(CMD)并输入 erl -version,看到 Erlang 的版本信息后则说明安装成功。

接着安装 RabbitMQ,完成后,在 环境变量 > 系统变量 中,新增系统变量 RABBITMQ_HOME 其值为 RabbitMQ 的安装目录,并为 Path 系统变量新增 %RABBITMQ_HOME%\sbin。

保存后,打开一个新的控制台(CMD)并执行以下命令,若成功打印 RabbitMQ 的相关信息,说明安装成功:

rabbitmqctl status

接下来执行命令启动 RabbitMQ:

net start rabbitmq

命令行不便于我们对 RabbitMQ 的管理,所以我们可以执行以下命令安装可视化插件:

rabbitmq-plugins enable rabbitmq_management

然后我们再用 rabbitmqctl 命令为 rabbitmq 新增用户 newuser ,密码为 123456

rabbitmqctl add_user newuser 123456

再为用户 newuser 授予管理员角色

rabbitmqctl set_user_tags newuser administrator

最后为用户 newuser 添加全部权限

rabbitmqctl set_permissions -p / newuser ".*" ".*" ".*"

安装可视化插件完成后可打开 http://localhost:15672/ 使用新创建的用户密码登录查看 RabbitMQ。

为了让 RabbitMQ 能开机自启,我们使用管理员身份打开命令行控制台(CMD)并进入到 RabbitMQ 的安装目录中,再进入子目录 sbin 中,然后执行以下命令把 RabbitMQ 注册为 Windows 服务:

rabbitmq-service.bat install

成功后可在 计算机管理 > 服务和应用程序 > 服务 中找到 RabbitMQ 服务并打开,启动类型选为自动,此后每次开机 RabbitMQ 服务就可以自动启动了。

安装 Node

下载 nvm

为何不直接下载 Node?这是因为我们可能面临多个项目需要不同的 Node 版本的情况。而 nvm 就是用来管理多个版本的 NodeJS 运行时的。

我下载的版本是 1.1.11。找到 nvm-setup.exe 文件链接,点击后即可下载。

安装完成后,记得在 nvm 的安装目录中找到并修改 settings.txt 配置文件,添加下面各项:

# 这个 path 指定的路径只是一个例子,您可以修改成任意你希望 nvm 下载 nodejs 放置的位置,不过这个路径必须是已存在的
path: C:\node
arch: 64
proxy: none
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

如果你通过 nvm install X.X.X 命令安装好某个版本的 node 后,使用命令 nvm use X.X.X 却在控制台中看到 "exit status 1:" 这样的报错信息,那大概就是您安装的 nvm 版本过低。请重新安装最新版本的 nvm。

当安装并使用了某个版本的 node 和 npm 后,除了修改 settings.txt 配置,我们也可以在命令行直接把 npm 的镜像源指向淘宝官方,从而加快 npm 依赖的安装速度:

npm config set registry https://registry.npmmirror.com/

到此,我们就可以开开心心地开发 Java 的前端部分了。