前言

注：
1.Nacos Server 3.0.x 要求 JDK版本不低于17。
2.Nacos 2.2.0 及以上版本需要 Java 11 或更高版本。
3.Java 8，需要下载 Nacos 2.1.x 及以下版本

JDK17安装

JDK官方下载地址：Oracle官网JDK下载地址
JDK17：JDK17下载地址

下载后，点击安装即可。配置好Java_Home环境变量。

验证是否成功

打开cmd,输入

java -version

出现对应的版本信息即为安装成功.

java version "17.0.15" 2025-04-15 LTS
Java(TM) SE Runtime Environment (build 17.0.15+9-LTS-241)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.15+9-LTS-241, mixed mode, sharing)

Nacos-Server 3.0.x下载安装

下载

方式一 githup

githup下载地址：githup下载地址

方式二 Nacos-Server 官网

Nacos-Server 官网：Nacos官网下载地址
不推荐，很慢，本人没成功。自测！！！！！

安装

将下载好的压缩包解压。

配置Nacos

修改默认启动端口

因本地有其它版本的nacos，需要修改端口，若无其它版本nacos，可忽略，也可根据自己需要修改端口。

在解压文件夹下找到 application.properties 文件。一般位于 conf 文件夹下。

编辑配置文件。例如我这里改称18085端口。

nacos.server.main.port=18085

开启认证及设置默认密码

修改默认管理页端口

可根据自己需要修改

nacos.console.port=8050

开启认证并设置账号、密码、密钥

nacos.core.auth.console.enabled=true
nacos.core.auth.server.identity.key=nacos
nacos.core.auth.server.identity.value=nacos
nacos.core.auth.plugin.nacos.token.cache.enable=false
nacos.core.auth.plugin.nacos.token.expire.seconds=18000
nacos.core.auth.plugin.nacos.token.secret.key=VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=

设置单机启动

在 bin目录下找到startup.cmd文件，用记事本或其它工具打开。
找到启动模式配置,修改为单机启动，如是集群配置，需要添加集群IP，因我是作为本地开发测试用，单机启动即可。

set MODE="standalone"

启动nacos

在 bin目录下找到 startup.cmd ，双击启动。

例如：我这里管理地址为：

http://localhost:8050/index.html

第一次进入要求设置密码，设置好自行保存。

配置MySQL数据库存储配置文件(可选)

添加或修改配置文件：

db.url=jdbc:mysql://ip:port/database?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=Asia/Shanghai
db.user=username
db.password=password

常见错误及解决办法

JDK版本低于17

报错信息

Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.UnsupportedClassVersionError: org/springframework/boot/loader/launch/PropertiesLauncher has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0

解决办法

升级JDK版本到17及以上。

未开启认证及设置账号密码

报错信息

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'defaultAuthenticationManager' defined in class path resource [com/alibaba/nacos/plugin/auth/impl/configuration/core/NacosAuthPluginCoreConfig.class]: Unsatisfied dependency expressed through method 'defaultAuthenticationManager' parameter 1: Error creating bean with name 'tokenManagerDelegate' defined in class path resource [com/alibaba/nacos/plugin/auth/impl/configuration/core/NacosAuthPluginCoreConfig.class]: Unsatisfied dependency expressed through method 'tokenManagerDelegate' parameter 0: Error creating bean with name 'tokenManager' defined in class path resource [com/alibaba/nacos/plugin/auth/impl/configuration/core/NacosAuthPluginCoreConfig.class]: Failed to instantiate [com.alibaba.nacos.plugin.auth.impl.token.TokenManager]: Factory method 'tokenManager' threw exception with message: the length of secret key must great than or equal 32 bytes; And the secret key  must be encoded by base64.Please see https://nacos.io/docs/latest/manual/admin/auth/at org.springframework.beans.factory.support.ConstructorResolver.createArgumentArray(ConstructorResolver.java:804)at org.springframework.beans.factory.support.ConstructorResolver.instantiateUsingFactoryMethod(ConstructorResolver.java:546)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.instantiateUsingFactoryMethod(AbstractAutowireCapableBeanFactory.java:1361)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1191)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:563)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:523)at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:339)at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:347)

Nacos-Server 3.x默认为false，但启动时报错。要求必须开启认证，否则启动失败。

nacos.core.auth.enabled=false  

解决办法

修改配置文件，开启认证。

nacos.core.auth.enabled=true
nacos.core.auth.server.identity.key=nacos
nacos.core.auth.server.identity.value=nacos

未设置或没有正确配置符合要求的密钥（secret key）

Factory method ‘tokenManager’ threw exception with message: the length of secret key must great than or equal 32 bytes; And the secret key must be encoded by base64.
要求设置密码为base64编码且为32字节。

报错信息

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'defaultAuthenticationManager' defined in class path resource [com/alibaba/nacos/plugin/auth/impl/configuration/core/NacosAuthPluginCoreConfig.class]: Unsatisfied dependency expressed through method 'defaultAuthenticationManager' parameter 1: Error creating bean with name 'tokenManagerDelegate' defined in class path resource [com/alibaba/nacos/plugin/auth/impl/configuration/core/NacosAuthPluginCoreConfig.class]: Unsatisfied dependency expressed through method 'tokenManagerDelegate' parameter 0: Error creating bean with name 'tokenManager' defined in class path resource [com/alibaba/nacos/plugin/auth/impl/configuration/core/NacosAuthPluginCoreConfig.class]: Failed to instantiate [com.alibaba.nacos.plugin.auth.impl.token.TokenManager]: Factory method 'tokenManager' threw exception with message: the length of secret key must great than or equal 32 bytes; And the secret key  must be encoded by base64.Please see https://nacos.io/docs/latest/manual/admin/auth/at org.springframework.beans.factory.support.ConstructorResolver.createArgumentArray(ConstructorResolver.java:804)at org.springframework.beans.factory.support.ConstructorResolver.instantiateUsingFactoryMethod(ConstructorResolver.java:546)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.instantiateUsingFactoryMethod(AbstractAutowireCapableBeanFactory.java:1361)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1191)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:563)at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:523)

   ![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/ea73b24c669d441493feb6d090dc9907.png)

解决办法

配置密钥，将密钥从nacos改为红框中的值，或者注释下面那行，开启上面一行即可。

nacos.core.auth.plugin.nacos.token.secret.key=VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=