当前位置：首页 > article >正文

在 WSL Ubuntu-24.04 上安装 Nacos 2.5.1 并使用 MySQL 数据库

article 2025/5/31 20:31:54

在微服务架构中，Nacos 是一个非常重要的服务发现和配置管理工具。本文将详细介绍如何在 WSL（Windows Subsystem for Linux）中的 Ubuntu-24.04 系统上安装 Nacos 2.5.1，并将其配置为使用 MySQL 数据库进行数据存储。我们将使用 root 作为数据库账号，并设置密码为 12345678。

一、环境准备

在开始安装 Nacos 之前，我们需要确保 WSL 环境已经安装并运行正常。同时，还需要安装以下依赖项：

1. 安装 Java 环境

Nacos 基于 Java 开发，因此需要安装 JDK。建议安装 JDK 1.8 或更高版本。

sudo apt update
sudo apt install openjdk-11-jdk -y
java -version

如果安装成功，你会看到类似以下的输出：

openjdk version "11.0.20.1" 2024-09-17
OpenJDK Runtime Environment (build 11.0.20.1+1-Ubuntu-0ubuntu1.24.04)
OpenJDK 64-Bit Server VM (build 11.0.20.1+1-Ubuntu-0ubuntu1.24.04, mixed mode)

2. 安装 MySQL 数据库

我们需要安装 MySQL 并创建一个数据库供 Nacos 使用。

sudo apt install mysql-server -y
sudo mysql_secure_installation

在安装过程中，系统会提示你设置 root 用户的密码。请按照提示输入 12345678。

接下来，登录到 MySQL 数据库并创建一个名为 nacos 的数据库：

mysql -u root -p

输入密码后，执行以下 SQL 命令：

CREATE DATABASE nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON nacos.* TO 'root'@'%' IDENTIFIED BY '12345678';
FLUSH PRIVILEGES;
EXIT;

3. 准备 Nacos 安装包

在 Windows 系统中，你已经下载了 Nacos 2.5.1 的安装包，路径为 C:\Users\yjtzf\Downloads\nacos-server-2.5.1.tar.gz。我们需要将该文件复制到 WSL 的 /opt 目录中。

方法一：使用 WSL 命令行复制文件

打开 WSL 终端，执行以下命令将文件从 Windows 文件系统复制到 WSL 文件系统中：

mkdir -p /mnt/c/Users/yjtzf/Downloads
cp /mnt/c/Users/yjtzf/Downloads/nacos-server-2.5.1.tar.gz /opt/

方法二：使用 Windows 文件资源管理器

你也可以通过 Windows 文件资源管理器直接将文件拖动到 WSL 的挂载目录中。在 Windows 文件资源管理器中，访问 \\wsl$\Ubuntu-24.04\opt，然后将 nacos-server-2.5.1.tar.gz 文件拖动到该目录中。

二、安装 Nacos

1. 解压安装包

进入 /opt 目录并解压安装包：

cd /opt
tar -zxvf nacos-server-2.5.1.tar.gz

解压完成后，你会看到一个名为 nacos 的文件夹。

2. 配置 Nacos 使用 MySQL 数据库

进入 conf 目录，编辑 application.properties 文件，添加以下内容以配置 MySQL 数据源：

cd /opt/nacos/conf
nano application.properties

在文件中添加以下内容：

# 指定使用 MySQL 数据库
spring.datasource.url=jdbc:mysql://localhost:3306/nacos?characterEncoding=utf-8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
spring.datasource.username=root
spring.datasource.password=12345678

保存并退出编辑器。

3. 初始化 MySQL 数据库

运行 Nacos 提供的 SQL 脚本，初始化数据库结构。在 /opt/nacos/conf 目录下执行以下命令：

mysql -u root -p nacos < mysql-schema.sql

输入密码 12345678 后，脚本会自动执行，完成数据库初始化。

4. 启动 Nacos

进入 Nacos 的 bin 目录，并以单机模式启动 Nacos：

cd /opt/nacos/bin
sh startup.sh -m standalone

启动完成后，你可以通过查看日志文件来确认 Nacos 是否正常运行：

cat /opt/nacos/logs/start.out

如果看到类似以下的输出，说明 Nacos 已经成功启动：

Nacos is starting, you can check the /opt/nacos/logs/start.out

三、访问 Nacos 控制台

Nacos 默认运行在 8848 端口上。在浏览器中输入以下地址访问 Nacos 控制台：

http://localhost:8848/nacos

如果没有开启鉴权，页面会直接显示 Nacos 控制台。如果开启了鉴权，需要使用默认账号 nacos 和密码 nacos 登录。

四、关闭 Nacos

如果需要关闭 Nacos，可以在 bin 目录下执行以下命令：

sh shutdown.sh

五、总结

通过以上步骤，我们成功在 WSL Ubuntu-24.04 系统上安装了 Nacos 2.5.1，并将其配置为使用 MySQL 数据库进行数据存储。你可以根据实际需求进一步配置 Nacos 的其他功能，例如服务发现、配置管理等。

如果你在安装过程中遇到任何问题，可以参考 Nacos 官方文档或 CSDN 博客获取更多帮助。