Nacos Server 3.0.x安装教程
前言
注：
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)
解决办法
配置密钥，将密钥从nacos改为红框中的值，或者注释下面那行，开启上面一行即可。
nacos.core.auth.plugin.nacos.token.secret.key=VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=
