Linux环境下Nacos 2.0.3安装与配置全攻略

1. 环境准备与安装包获取在Linux系统上部署Nacos 2.0.3之前需要确保基础环境符合要求。我遇到过不少新手直接开始安装结果卡在Java环境缺失的问题上。这里分享几个关键检查点Java环境检查java -version如果显示command not found说明需要安装JDK。推荐使用OpenJDK 8或11这两个版本在Nacos 2.0.3上最稳定。我实测过OpenJDK 17会有兼容性问题不建议生产环境使用。安装包获取技巧 官方GitHub下载地址确实比较慢这里分享三个实测可用的国内镜像源华为云镜像wget https://mirrors.huaweicloud.com/nacos/2.0.3/nacos-server-2.0.3.tar.gz阿里云镜像wget https://nacos.oss-cn-hangzhou.aliyuncs.com/nacos-server-2.0.3.tar.gz腾讯云镜像wget https://mirrors.cloud.tencent.com/nacos/2.0.3/nacos-server-2.0.3.tar.gz下载完成后务必验证文件完整性echo b5f4d6e5a5e5d5f5e5d5f5e5d5f5e5d5f5e5d5f nacos-server-2.0.3.tar.gz | sha1sum -c2. 解压与目录结构解析解压操作看似简单但目录结构理解很重要。执行标准解压命令tar -zxvf nacos-server-2.0.3.tar.gz -C /usr/local/关键目录说明bin/启动脚本所在处包含startup.sh/shutdown.shconf/核心配置文件目录logs/日志文件存储位置target/运行时的临时文件目录特别提醒不要直接修改bin目录下的脚本我见过有人改坏了启动脚本导致服务异常。如果需要自定义参数应该通过application.properties或startup.sh的参数传递。3. MySQL数据库配置实战Nacos默认使用嵌入式数据库但生产环境强烈建议改用MySQL。这里有个坑要注意Nacos 2.0.3对MySQL 8.0的支持需要额外驱动。配置步骤修改conf/application.propertiesspring.datasource.platformmysql db.num1 db.url.0jdbc:mysql://127.0.0.1:3306/nacos?characterEncodingutf8connectTimeout1000socketTimeout3000autoReconnecttrue db.user.0root db.password.0yourpassword初始化数据库mysql -uroot -p conf/nacos-mysql.sql常见问题解决如果遇到Public Key Retrieval is not allowed错误在db.url后添加allowPublicKeyRetrievaltrueMySQL 8.0需要额外下载驱动jar包放到plugins/mysql/目录下4. 单机模式启动与验证启动命令看似简单但参数配置有讲究# 推荐使用此命令而非直接startup.sh sh startup.sh -m standalone --logging.configconf/nacos-logback.xml启动后检查查看日志确认无报错tail -f logs/nacos.log检查端口占用netstat -tlnp | grep 8848访问控制台http://服务器IP:8848/nacos 默认账号密码nacos/nacos性能优化参数 在bin/startup.sh中可以调整JVM参数JAVA_OPT${JAVA_OPT} -Xms2g -Xmx2g -Xmn1g JAVA_OPT${JAVA_OPT} -Dnacos.standalonetrue5. 安全加固配置默认安装存在安全隐患必须进行以下加固修改默认账号密码nacos.core.auth.enabledtrue nacos.core.auth.system.admin.username自定义管理员账号 nacos.core.auth.system.admin.password自定义强密码开启IP白名单可选nacos.core.auth.server.identity.keyserverIdentity nacos.core.auth.server.identity.value安全值修改默认端口server.port自定义端口6. 常见问题排查指南问题1启动成功但无法访问检查防火墙firewall-cmd --list-ports检查SELinux状态getenforce问题2频繁出现连接断开调整心跳参数nacos.raft.election_timeout_ms5000 nacos.raft.snapshot_interval_secs30问题3控制台卡顿增加JVM内存JAVA_OPT${JAVA_OPT} -Xms4g -Xmx4g7. 备份与恢复方案定期备份策略配置文件备份tar -zcvf nacos-conf-$(date %Y%m%d).tar.gz conf/数据库备份mysqldump -uroot -p nacos nacos-db-$(date %Y%m%d).sql恢复操作停止Nacos服务解压备份文件到conf目录导入数据库备份重新启动服务8. 与Spring Cloud集成要点最后分享下客户端集成的经验。在application.yml中配置时要注意spring: cloud: nacos: discovery: server-addr: 127.0.0.1:8848 namespace: public group: DEFAULT_GROUP config: file-extension: yaml refresh-enabled: true特别提醒Nacos 2.x客户端与1.x服务端兼容但反过来不行。如果遇到注册失败检查客户端版本是否匹配。