1. 项目概述为什么要在Ubuntu上部署Nacos如果你正在搭建微服务架构或者准备学习Spring Cloud Alibaba那么Nacos这个名字你肯定不陌生。作为一个集服务发现、配置管理于一体的核心组件Nacos已经成为了很多团队技术栈中的标配。但很多教程都集中在Windows或Docker环境对于生产环境更常见的Linux服务器特别是Ubuntu这类发行版详细的、一步一坑的部署指南反而没那么好找。我自己在从开发转向兼顾运维部署的过程中就曾在Ubuntu上安装Nacos时踩过不少坑。比如照着某篇教程装好了一启动就闪退日志也看不出个所以然又比如配置了集群节点之间死活无法通信。这些经历让我意识到一个看似简单的“安装配置”过程背后其实藏着很多环境依赖、路径规划和参数调优的门道。今天我就结合这些实战经验为你梳理一份在Ubuntu 22.04 LTS上从零开始安装、配置并启动Nacos的完整指南。这份指南不仅会告诉你每一步怎么做更会重点解释“为什么这么做”以及那些容易忽略但至关重要的细节。我们的目标很明确在Ubuntu 22.04系统上部署一个可以稳定运行的单机版Nacos并完成基础的服务发现与配置管理功能验证。整个过程会涉及JDK环境准备、MySQL数据库初始化、Nacos服务包部署、系统服务集成以及基础功能测试。无论你是要在本地虚拟机搭建测试环境还是在云服务器上部署生产应用这篇内容都能给你提供直接的参考。2. 环境准备构建稳固的基石在下载Nacos安装包之前我们必须先把它的“家”给安顿好。Nacos的运行依赖于两个核心环境Java运行时和持久化数据库。这一步没做对后面所有的操作都是空中楼阁。2.1 安装与配置Java环境Nacos 2.x版本要求JDK 1.8或更高版本但为了更好的性能和兼容性我强烈推荐使用JDK 11或JDK 17。Ubuntu 22.04的默认仓库里提供了OpenJDK这是最方便、最稳妥的选择。首先更新系统包列表并安装OpenJDK 11sudo apt update sudo apt install openjdk-11-jdk -y安装完成后验证一下安装是否成功java -version你应该能看到类似openjdk version 11.0.22的输出。这里有个关键点仅仅安装JDK还不够我们需要确保JAVA_HOME环境变量被正确设置。很多后续的脚本包括Nacos自己的启动脚本都会依赖这个变量来定位Java的安装路径。查找Java的安装路径sudo update-alternatives --config java记下输出结果中的路径例如/usr/lib/jvm/java-11-openjdk-amd64。然后编辑用户的环境变量配置文件如果你希望对所有用户生效可以编辑/etc/environmentnano ~/.bashrc在文件末尾添加以下两行export JAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64 export PATH$JAVA_HOME/bin:$PATH保存退出后执行source ~/.bashrc使配置立即生效并再次验证echo $JAVA_HOME这个步骤千万不能省。我见过太多“Nacos闪退”的问题最后追查下来都是因为JAVA_HOME没有正确设置导致启动脚本找不到Java命令或者找到了错误版本的Java。2.2 初始化MySQL数据库Nacos默认使用内嵌的Apache Derby数据库但这仅适用于单机测试。任何有持久化需求或未来可能扩展的场景都必须使用外置数据库MySQL是最常见的选择。Ubuntu 22.04安装MySQL 8.0非常方便sudo apt install mysql-server -y安装完成后运行安全初始化脚本设置root密码并移除一些不安全配置sudo mysql_secure_installation接下来我们需要为Nacos创建一个专用的数据库和用户。以root身份登录MySQLsudo mysql在MySQL命令行中依次执行以下SQL语句-- 创建一个名为nacos的数据库使用utf8mb4字符集和更通用的排序规则 CREATE DATABASE IF NOT EXISTS nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 创建一个名为nacos的用户并设置一个强密码这里示例为Nacos123456 CREATE USER nacos% IDENTIFIED BY Nacos123456; -- 授予nacos用户对nacos数据库的所有权限 GRANT ALL PRIVILEGES ON nacos.* TO nacos%; -- 刷新权限使更改生效 FLUSH PRIVILEGES; -- 退出MySQL EXIT;这里有两个经验性的细节需要注意。第一关于用户主机%在生产环境中为了安全你可能会限制为localhost或特定IP。但在初次安装测试时使用%允许任何主机连接可以避免因网络问题导致的连接失败待一切调通后再收紧安全策略。第二密码强度务必使用包含大小写字母、数字和特殊字符的强密码不要使用123456这类简单密码。数据库创建好后需要将Nacos的表结构导入。首先我们需要下载Nacos的安装包。3. 部署与配置Nacos服务环境就绪后我们就可以开始部署Nacos本体了。这个过程包括获取软件包、初始化数据库表结构、修改核心配置文件以及最重要的——将Nacos配置为系统服务。3.1 下载Nacos并初始化数据库访问Nacos的GitHub Release页面找到最新稳定版的压缩包。我们通常选择以.tar.gz结尾的压缩包。在服务器上我们使用wget命令直接下载请将链接替换为当时最新的稳定版链接cd /opt sudo wget https://github.com/alibaba/nacos/releases/download/2.3.0/nacos-server-2.3.0.tar.gz下载完成后解压sudo tar -zxvf nacos-server-2.3.0.tar.gz sudo mv nacos /usr/local/现在Nacos的主目录就在/usr/local/nacos了。接下来找到数据库初始化脚本。它位于/usr/local/nacos/conf目录下文件名是nacos-mysql.sql。我们将其导入到之前创建的数据库中mysql -u nacos -p nacos /usr/local/nacos/conf/nacos-mysql.sql系统会提示你输入密码即之前设置的Nacos123456。执行成功后可以登录MySQL验证表是否创建成功mysql -u nacos -p USE nacos; SHOW TABLES;你应该能看到config_info,users等一堆表。这一步如果出错最常见的原因是数据库连接信息用户名、密码、主机权限不对请回头检查2.2节的步骤。3.2 配置Nacos连接外部数据库Nacos的配置文件集中在/usr/local/nacos/conf目录。我们需要修改application.properties文件将数据库连接从内嵌的Derby切换到我们刚配置好的MySQL。sudo nano /usr/local/nacos/conf/application.properties找到文件中关于数据库配置的部分通常被注释掉了修改为以下内容# 启用数据库存储 spring.datasource.platformmysql # 数据库实例数量单机部署为1 db.num1 # 第一个数据库的连接信息 db.url.0jdbc:mysql://127.0.0.1:3306/nacos?characterEncodingutf8connectTimeout1000socketTimeout3000autoReconnecttrueuseUnicodetrueuseSSLfalseserverTimezoneUTC db.user.0nacos db.password.0Nacos123456这里有三个关键的配置项需要你根据实际情况调整db.url.0中的127.0.0.1:3306如果你的MySQL安装在另一台服务器需要改为对应的IP和端口。useSSLfalse在内部网络或测试环境可以禁用SSL以简化连接。在生产环境并跨公网访问时务必设置为true并配置正确的证书。serverTimezoneUTC这里设置数据库连接的时区为UTC确保时间戳处理一致。你也可以设置为Asia/Shanghai等但要保证MySQL服务器和Nacos服务器的时区设置一致否则在管理配置时可能会遇到时间显示问题。3.3 创建系统服务实现开机自启直接通过脚本启动Nacos不是长久之计我们需要将其注册为systemd服务实现开机自启、方便地启停和日志集中管理。首先创建一个systemd服务单元文件sudo nano /etc/systemd/system/nacos.service将以下内容粘贴进去[Unit] DescriptionNacos Server Afternetwork.target mysql.service Wantsnetwork.target mysql.service [Service] Typeforking # 设置环境变量确保JAVA_HOME被识别 EnvironmentJAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64 # 启动脚本路径 ExecStart/usr/local/nacos/bin/startup.sh -m standalone ExecStop/usr/local/nacos/bin/shutdown.sh # 如果服务失败在10秒后重启 Restarton-failure RestartSec10 # 重要指定运行用户和组不要用root Usernobody Groupnogroup # 安全限制防止服务占用过多资源 LimitNOFILE65535 LimitNPROC65535 [Install] WantedBymulti-user.target这个配置文件有几个设计点需要解释Aftermysql.service这确保了Nacos服务会在MySQL服务完全启动之后才启动避免了因数据库未就绪而导致的启动失败。Typeforking因为Nacos的启动脚本(startup.sh)会启动一个后台进程然后自己退出所以服务类型需要设为forking。Usernobody和Groupnogroup这是出于安全考虑让Nacos以一个非特权用户运行。但这里有个大坑nobody用户默认可能没有对Nacos日志目录(/usr/local/nacos/logs)的写入权限会导致启动失败。你有两个选择1) 将目录权限授予nobody(sudo chown -R nobody:nogroup /usr/local/nacos/logs)2) 创建一个专用的系统用户来运行例如sudo useradd -r -s /bin/false nacosuser然后在配置文件中使用Usernacosuser。我推荐第二种更清晰安全。LimitNOFILE提高进程可打开的文件描述符数量对于高并发的服务发现场景很重要。保存文件后重新加载systemd配置启动Nacos服务并设置开机自启sudo systemctl daemon-reload sudo systemctl start nacos.service sudo systemctl enable nacos.service检查服务状态和日志确认启动成功sudo systemctl status nacos.service sudo tail -f /usr/local/nacos/logs/start.out如果状态显示active (running)并且日志中没有明显的错误信息最后出现Nacos started successfully in stand alone mode那么恭喜你Nacos服务已经成功运行了默认情况下它监听在8848端口。你可以在服务器本机通过curl localhost:8848/nacos/测试或者在浏览器访问http://你的服务器IP:8848/nacos。4. 基础功能验证与安全加固服务跑起来只是第一步我们还需要验证其核心功能是否正常并对默认的安全设置进行加固为后续的使用扫清障碍。4.1 访问控制台与基础功能测试在浏览器中输入http://你的服务器IP:8848/nacos你应该能看到Nacos的登录页面。默认的用户名和密码都是nacos。这是一个非常重要的安全风险点我们稍后就必须修改它。登录后你可以进行以下快速测试确保服务发现和配置管理两大核心功能正常服务注册与发现测试进入“服务管理” - “服务列表”。点击“注册服务”。你可以模拟注册一个服务例如服务名填test-service分组填DEFAULT_GROUP临时实例的IP和端口可以随意填一个如127.0.0.1:8080。点击注册。在服务列表中你应该能看到刚注册的test-service并且健康状态为“健康”虽然是我们模拟的。这证明服务注册功能正常。配置管理测试进入“配置管理” - “配置列表”。点击“”创建配置。Data ID 填test.properties分组填DEFAULT_GROUP配置格式选Properties。在配置内容里随便写点东西比如server.port8080。点击“发布”。发布成功后在配置列表中找到它可以点击“详情”查看或“编辑”修改。这证明配置的发布、存储和读取功能正常。4.2 修改默认密码与增强安全现在我们必须立刻处理那个广为人知的默认密码。在Nacos控制台点击右上角用户名进入“权限控制” - “用户管理”。找到nacos用户点击“修改”。输入一个复杂的新密码并保存。但是仅仅修改控制台密码还不够。Nacos提供了一个服务端认证的插件机制。对于生产环境我强烈建议开启服务端鉴权这样客户端连接时也需要提供身份凭证。编辑Nacos的配置文件sudo nano /usr/local/nacos/conf/application.properties找到并修改以下配置# 开启鉴权 nacos.core.auth.enabledtrue # 设置用于生成JWT Token的密钥务必修改为一个复杂的随机字符串 nacos.core.auth.server.identity.keyyour-custom-secret-key-here nacos.core.auth.server.identity.valueyour-custom-secret-value-here # 设置Token过期时间单位秒默认180005小时 nacos.core.auth.plugin.nacos.token.expire.seconds18000 # 可选允许携带认证信息的用户列表用于内部系统调用按需配置 nacos.core.auth.enable.userAgentAuthWhitefalse修改完成后重启Nacos服务使配置生效sudo systemctl restart nacos.service重启后客户端如Spring Cloud应用在连接Nacos时就需要在配置文件中增加用户名和密码了spring.cloud.nacos.discovery.usernamenacos spring.cloud.nacos.discovery.password你的新密码 spring.cloud.nacos.config.usernamenacos spring.cloud.nacos.config.password你的新密码这个步骤能有效防止未经授权的服务随意注册或拉取敏感配置是生产部署的必备操作。4.3 防火墙与网络访问控制Ubuntu 22.04默认使用ufw作为防火墙管理工具。我们需要开放Nacos的访问端口默认8848同时限制访问来源以增强安全。# 启用UFW如果尚未启用 sudo ufw enable # 允许SSH端口确保你不会把自己关在外面 sudo ufw allow 22/tcp # 允许特定IP段访问Nacos端口例如只允许办公室IP 192.168.1.0/24 sudo ufw allow from 192.168.1.0/24 to any port 8848 # 或者在测试阶段可以先允许所有IP访问生产环境不推荐 # sudo ufw allow 8848/tcp # 查看规则 sudo ufw status numbered通过限制访问来源IP可以将Nacos控制台的暴露面降到最低。此外如果Nacos部署在云服务器上别忘了检查云服务商的安全组规则也需要做相应的端口开放和IP限制。5. 生产环境考量与常见故障排查将Nacos用于开发测试和用于生产环境关注点完全不同。单机模式无法保证高可用任何故障都会导致整个微服务体系瘫痪。因此生产部署必须考虑集群模式。5.1 从单机迈向集群部署Nacos集群部署的核心思想是让多个Nacos节点组成一个集群共同对外提供服务实现负载均衡和高可用。集群部署需要解决两个问题数据一致性和节点间状态同步。Nacos使用Raft协议来选举Leader处理写请求确保数据一致性。部署一个最小化的三节点集群你需要准备至少三台服务器或虚拟机每台都重复上述单机安装的步骤确保JDK、MySQL环境一致。使用同一个MySQL数据库所有Nacos节点应该连接至同一个MySQL数据库实例或主从复制的集群这样配置数据才能集中存储。切记不要每个节点用独立的数据库。配置集群节点信息在每个节点的/usr/local/nacos/conf目录下有一个cluster.conf.example文件。复制它并命名为cluster.confcp cluster.conf.example cluster.conf nano cluster.conf在文件中列出所有集群节点的IP和端口端口默认是8848但集群通信端口是偏移量后的7848这里写应用端口即可192.168.1.101:8848 192.168.1.102:8848 192.168.1.103:8848每个节点的这个文件内容必须完全一致。修改启动模式将每个节点systemd服务文件(nacos.service)中的启动命令从-m standalone改为-m cluster。配置负载均衡在客户端应用和Nacos集群之间需要部署一个负载均衡器如Nginx。客户端的配置文件中spring.cloud.nacos.config.server-addr和spring.cloud.nacos.discovery.server-addr应指向这个负载均衡器的地址例如lb.example.com:8848。集群部署的复杂度和维护成本远高于单机但它带来的高可用性是生产系统不可或缺的。5.2 实战中遇到的典型问题与解决方案即便按照教程一步步操作你也可能会遇到一些“坑”。下面是我总结的几个常见问题及其排查思路问题一Nacos启动后立刻闪退start.out日志文件为空或很小。排查思路检查JAVA_HOME这是最常见的原因。运行echo $JAVA_HOME确保输出正确的路径并且该路径下存在bin/java可执行文件。务必在systemd服务文件中也通过Environment指令显式设置JAVA_HOME。检查启动脚本权限确保/usr/local/nacos/bin目录下的.sh脚本有执行权限 (chmod x *.sh)。查看更详细的日志除了start.out重点检查/usr/local/nacos/logs/nacos.log。闪退的根因通常记录在这里。检查数据库连接确认application.properties中的数据库连接信息URL、用户名、密码百分百正确并且MySQL服务已启动nacos用户有远程连接权限如果IP不是127.0.0.1。问题二客户端服务无法注册到Nacos报连接超时或拒绝连接。排查思路网络连通性在客户端服务器上使用telnet nacos服务器IP 8848测试端口是否通畅。如果不通检查Nacos服务器防火墙(ufw)、云安全组规则。Nacos服务状态在Nacos服务器上用sudo systemctl status nacos和netstat -tlnp | grep 8848确认服务确实在运行并监听在正确端口。客户端配置检查客户端配置文件中的spring.cloud.nacos.discovery.server-addr的IP和端口是否正确。如果是集群是否指向了负载均衡器地址。鉴权问题如果你开启了服务端鉴权 (nacos.core.auth.enabledtrue)客户端配置中必须提供正确的username和password。问题三Nacos控制台可以登录但页面加载缓慢或经常出错。排查思路资源不足检查服务器内存和CPU使用情况。Nacos单机至少需要1-2GB的堆内存。可以通过修改/usr/local/nacos/bin/startup.sh中的JVM参数来调整例如将-Xms和-Xmx从默认的1g改为2g。数据库性能如果配置项非常多MySQL可能成为瓶颈。检查MySQL的慢查询日志考虑对config_info等核心表进行索引优化。前端资源加载检查浏览器控制台(F12)是否有JS或CSS文件加载失败。可能是网络问题也可能是Nacos版本的前端资源存在bug尝试清除浏览器缓存或使用无痕模式。问题四修改配置后客户端无法实时接收到配置更新配置热更新失效。排查思路客户端长连接Nacos配置热更新依赖于客户端与服务器保持的长轮询连接。检查客户端日志看是否有关于“long-polling”的错误。客户端配置确保在Spring Boot客户端中使用了RefreshScope注解并且依赖了spring-cloud-starter-alibaba-nacos-config。网络策略某些严格的网络策略或代理可能会中断长连接。检查客户端与Nacos服务器之间的网络环境。Nacos服务器日志查看Nacos服务器的nacos.log确认配置发布事件是否被正常记录和推送。把Nacos在Ubuntu上跑起来只是起点让它稳定、高效、安全地支撑起你的微服务体系才是真正的目标。这份指南里的每一个步骤和提醒都来自实际运维中的经验教训。特别是环境变量、服务用户权限、默认密码修改和防火墙规则这几处看似简单却往往是拦路虎。建议你在完成基础部署后花点时间按照“生产环境考量”部分的内容至少把安全加固做完并为未来的集群化留好扩展思路。 1. 项目概述为什么要在Ubuntu上部署Nacos如果你正在搭建微服务架构或者准备学习Spring Cloud Alibaba那么Nacos这个名字你肯定不陌生。作为一个集服务发现、配置管理于一体的核心组件Nacos已经成为了很多团队技术栈中的标配。但很多教程都集中在Windows或Docker环境对于生产环境更常见的Linux服务器特别是Ubuntu这类发行版详细的、一步一坑的部署指南反而没那么好找。我自己在从开发转向兼顾运维部署的过程中就曾在Ubuntu上安装Nacos时踩过不少坑。比如照着某篇教程装好了一启动就闪退日志也看不出个所以然又比如配置了集群节点之间死活无法通信。这些经历让我意识到一个看似简单的“安装配置”过程背后其实藏着很多环境依赖、路径规划和参数调优的门道。今天我就结合这些实战经验为你梳理一份在Ubuntu 22.04 LTS上从零开始安装、配置并启动Nacos的完整指南。这份指南不仅会告诉你每一步怎么做更会重点解释“为什么这么做”以及那些容易忽略但至关重要的细节。我们的目标很明确在Ubuntu 22.04系统上部署一个可以稳定运行的单机版Nacos并完成基础的服务发现与配置管理功能验证。整个过程会涉及JDK环境准备、MySQL数据库初始化、Nacos服务包部署、系统服务集成以及基础功能测试。无论你是要在本地虚拟机搭建测试环境还是在云服务器上部署生产应用这篇内容都能给你提供直接的参考。2. 环境准备构建稳固的基石在下载Nacos安装包之前我们必须先把它的“家”给安顿好。Nacos的运行依赖于两个核心环境Java运行时和持久化数据库。这一步没做对后面所有的操作都是空中楼阁。2.1 安装与配置Java环境Nacos 2.x版本要求JDK 1.8或更高版本但为了更好的性能和兼容性我强烈推荐使用JDK 11或JDK 17。Ubuntu 22.04的默认仓库里提供了OpenJDK这是最方便、最稳妥的选择。首先更新系统包列表并安装OpenJDK 11sudo apt update sudo apt install openjdk-11-jdk -y安装完成后验证一下安装是否成功java -version你应该能看到类似openjdk version 11.0.22的输出。这里有个关键点仅仅安装JDK还不够我们需要确保JAVA_HOME环境变量被正确设置。很多后续的脚本包括Nacos自己的启动脚本都会依赖这个变量来定位Java的安装路径。查找Java的安装路径sudo update-alternatives --config java记下输出结果中的路径例如/usr/lib/jvm/java-11-openjdk-amd64。然后编辑用户的环境变量配置文件如果你希望对所有用户生效可以编辑/etc/environmentnano ~/.bashrc在文件末尾添加以下两行export JAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64 export PATH$JAVA_HOME/bin:$PATH保存退出后执行source ~/.bashrc使配置立即生效并再次验证echo $JAVA_HOME这个步骤千万不能省。我见过太多“Nacos闪退”的问题最后追查下来都是因为JAVA_HOME没有正确设置导致启动脚本找不到Java命令或者找到了错误版本的Java。2.2 初始化MySQL数据库Nacos默认使用内嵌的Apache Derby数据库但这仅适用于单机测试。任何有持久化需求或未来可能扩展的场景都必须使用外置数据库MySQL是最常见的选择。Ubuntu 22.04安装MySQL 8.0非常方便sudo apt install mysql-server -y安装完成后运行安全初始化脚本设置root密码并移除一些不安全配置sudo mysql_secure_installation接下来我们需要为Nacos创建一个专用的数据库和用户。以root身份登录MySQLsudo mysql在MySQL命令行中依次执行以下SQL语句-- 创建一个名为nacos的数据库使用utf8mb4字符集和更通用的排序规则 CREATE DATABASE IF NOT EXISTS nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 创建一个名为nacos的用户并设置一个强密码这里示例为Nacos123456 CREATE USER nacos% IDENTIFIED BY Nacos123456; -- 授予nacos用户对nacos数据库的所有权限 GRANT ALL PRIVILEGES ON nacos.* TO nacos%; -- 刷新权限使更改生效 FLUSH PRIVILEGES; -- 退出MySQL EXIT;这里有两个经验性的细节需要注意。第一关于用户主机%在生产环境中为了安全你可能会限制为localhost或特定IP。但在初次安装测试时使用%允许任何主机连接可以避免因网络问题导致的连接失败待一切调通后再收紧安全策略。第二密码强度务必使用包含大小写字母、数字和特殊字符的强密码不要使用123456这类简单密码。数据库创建好后需要将Nacos的表结构导入。首先我们需要下载Nacos的安装包。3. 部署与配置Nacos服务环境就绪后我们就可以开始部署Nacos本体了。这个过程包括获取软件包、初始化数据库表结构、修改核心配置文件以及最重要的——将Nacos配置为系统服务。3.1 下载Nacos并初始化数据库访问Nacos的GitHub Release页面找到最新稳定版的压缩包。我们通常选择以.tar.gz结尾的压缩包。在服务器上我们使用wget命令直接下载请将链接替换为当时最新的稳定版链接cd /opt sudo wget https://github.com/alibaba/nacos/releases/download/2.3.0/nacos-server-2.3.0.tar.gz下载完成后解压sudo tar -zxvf nacos-server-2.3.0.tar.gz sudo mv nacos /usr/local/现在Nacos的主目录就在/usr/local/nacos了。接下来找到数据库初始化脚本。它位于/usr/local/nacos/conf目录下文件名是nacos-mysql.sql。我们将其导入到之前创建的数据库中mysql -u nacos -p nacos /usr/local/nacos/conf/nacos-mysql.sql系统会提示你输入密码即之前设置的Nacos123456。执行成功后可以登录MySQL验证表是否创建成功mysql -u nacos -p USE nacos; SHOW TABLES;你应该能看到config_info,users等一堆表。这一步如果出错最常见的原因是数据库连接信息用户名、密码、主机权限不对请回头检查2.2节的步骤。3.2 配置Nacos连接外部数据库Nacos的配置文件集中在/usr/local/nacos/conf目录。我们需要修改application.properties文件将数据库连接从内嵌的Derby切换到我们刚配置好的MySQL。sudo nano /usr/local/nacos/conf/application.properties找到文件中关于数据库配置的部分通常被注释掉了修改为以下内容# 启用数据库存储 spring.datasource.platformmysql # 数据库实例数量单机部署为1 db.num1 # 第一个数据库的连接信息 db.url.0jdbc:mysql://127.0.0.1:3306/nacos?characterEncodingutf8connectTimeout1000socketTimeout3000autoReconnecttrueuseUnicodetrueuseSSLfalseserverTimezoneUTC db.user.0nacos db.password.0Nacos123456这里有三个关键的配置项需要你根据实际情况调整db.url.0中的127.0.0.1:3306如果你的MySQL安装在另一台服务器需要改为对应的IP和端口。useSSLfalse在内部网络或测试环境可以禁用SSL以简化连接。在生产环境并跨公网访问时务必设置为true并配置正确的证书。serverTimezoneUTC这里设置数据库连接的时区为UTC确保时间戳处理一致。你也可以设置为Asia/Shanghai等但要保证MySQL服务器和Nacos服务器的时区设置一致否则在管理配置时可能会遇到时间显示问题。3.3 创建系统服务实现开机自启直接通过脚本启动Nacos不是长久之计我们需要将其注册为systemd服务实现开机自启、方便地启停和日志集中管理。首先创建一个systemd服务单元文件sudo nano /etc/systemd/system/nacos.service将以下内容粘贴进去[Unit] DescriptionNacos Server Afternetwork.target mysql.service Wantsnetwork.target mysql.service [Service] Typeforking # 设置环境变量确保JAVA_HOME被识别 EnvironmentJAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64 # 启动脚本路径 ExecStart/usr/local/nacos/bin/startup.sh -m standalone ExecStop/usr/local/nacos/bin/shutdown.sh # 如果服务失败在10秒后重启 Restarton-failure RestartSec10 # 重要指定运行用户和组不要用root Usernobody Groupnogroup # 安全限制防止服务占用过多资源 LimitNOFILE65535 LimitNPROC65535 [Install] WantedBymulti-user.target这个配置文件有几个设计点需要解释Aftermysql.service这确保了Nacos服务会在MySQL服务完全启动之后才启动避免了因数据库未就绪而导致的启动失败。Typeforking因为Nacos的启动脚本(startup.sh)会启动一个后台进程然后自己退出所以服务类型需要设为forking。Usernobody和Groupnogroup这是出于安全考虑让Nacos以一个非特权用户运行。但这里有个大坑nobody用户默认可能没有对Nacos日志目录(/usr/local/nacos/logs)的写入权限会导致启动失败。你有两个选择1) 将目录权限授予nobody(sudo chown -R nobody:nogroup /usr/local/nacos/logs)2) 创建一个专用的系统用户来运行例如sudo useradd -r -s /bin/false nacosuser然后在配置文件中使用Usernacosuser。我推荐第二种更清晰安全。LimitNOFILE提高进程可打开的文件描述符数量对于高并发的服务发现场景很重要。保存文件后重新加载systemd配置启动Nacos服务并设置开机自启sudo systemctl daemon-reload sudo systemctl start nacos.service sudo systemctl enable nacos.service检查服务状态和日志确认启动成功sudo systemctl status nacos.service sudo tail -f /usr/local/nacos/logs/start.out如果状态显示active (running)并且日志中没有明显的错误信息最后出现Nacos started successfully in stand alone mode那么恭喜你Nacos服务已经成功运行了默认情况下它监听在8848端口。你可以在服务器本机通过curl localhost:8848/nacos/测试或者在浏览器访问http://你的服务器IP:8848/nacos。4. 基础功能验证与安全加固服务跑起来只是第一步我们还需要验证其核心功能是否正常并对默认的安全设置进行加固为后续的使用扫清障碍。4.1 访问控制台与基础功能测试在浏览器中输入http://你的服务器IP:8848/nacos你应该能看到Nacos的登录页面。默认的用户名和密码都是nacos。这是一个非常重要的安全风险点我们稍后就必须修改它。登录后你可以进行以下快速测试确保服务发现和配置管理两大核心功能正常服务注册与发现测试进入“服务管理” - “服务列表”。点击“注册服务”。你可以模拟注册一个服务例如服务名填test-service分组填DEFAULT_GROUP临时实例的IP和端口可以随意填一个如127.0.0.1:8080。点击注册。在服务列表中你应该能看到刚注册的test-service并且健康状态为“健康”虽然是我们模拟的。这证明服务注册功能正常。配置管理测试进入“配置管理” - “配置列表”。点击“”创建配置。Data ID 填test.properties分组填DEFAULT_GROUP配置格式选Properties。在配置内容里随便写点东西比如server.port8080。点击“发布”。发布成功后在配置列表中找到它可以点击“详情”查看或“编辑”修改。这证明配置的发布、存储和读取功能正常。4.2 修改默认密码与增强安全现在我们必须立刻处理那个广为人知的默认密码。在Nacos控制台点击右上角用户名进入“权限控制” - “用户管理”。找到nacos用户点击“修改”。输入一个复杂的新密码并保存。但是仅仅修改控制台密码还不够。Nacos提供了一个服务端认证的插件机制。对于生产环境我强烈建议开启服务端鉴权这样客户端连接时也需要提供身份凭证。编辑Nacos的配置文件sudo nano /usr/local/nacos/conf/application.properties找到并修改以下配置# 开启鉴权 nacos.core.auth.enabledtrue # 设置用于生成JWT Token的密钥务必修改为一个复杂的随机字符串 nacos.core.auth.server.identity.keyyour-custom-secret-key-here nacos.core.auth.server.identity.valueyour-custom-secret-value-here # 设置Token过期时间单位秒默认180005小时 nacos.core.auth.plugin.nacos.token.expire.seconds18000 # 可选允许携带认证信息的用户列表用于内部系统调用按需配置 nacos.core.auth.enable.userAgentAuthWhitefalse修改完成后重启Nacos服务使配置生效sudo systemctl restart nacos.service重启后客户端如Spring Cloud应用在连接Nacos时就需要在配置文件中增加用户名和密码了spring.cloud.nacos.discovery.usernamenacos spring.cloud.nacos.discovery.password你的新密码 spring.cloud.nacos.config.usernamenacos spring.cloud.nacos.config.password你的新密码这个步骤能有效防止未经授权的服务随意注册或拉取敏感配置是生产部署的必备操作。4.3 防火墙与网络访问控制Ubuntu 22.04默认使用ufw作为防火墙管理工具。我们需要开放Nacos的访问端口默认8848同时限制访问来源以增强安全。# 启用UFW如果尚未启用 sudo ufw enable # 允许SSH端口确保你不会把自己关在外面 sudo ufw allow 22/tcp # 允许特定IP段访问Nacos端口例如只允许办公室IP 192.168.1.0/24 sudo ufw allow from 192.168.1.0/24 to any port 8848 # 或者在测试阶段可以先允许所有IP访问生产环境不推荐 # sudo ufw allow 8848/tcp # 查看规则 sudo ufw status numbered通过限制访问来源IP可以将Nacos控制台的暴露面降到最低。此外如果Nacos部署在云服务器上别忘了检查云服务商的安全组规则也需要做相应的端口开放和IP限制。5. 生产环境考量与常见故障排查将Nacos用于开发测试和用于生产环境关注点完全不同。单机模式无法保证高可用任何故障都会导致整个微服务体系瘫痪。因此生产部署必须考虑集群模式。5.1 从单机迈向集群部署Nacos集群部署的核心思想是让多个Nacos节点组成一个集群共同对外提供服务实现负载均衡和高可用。集群部署需要解决两个问题数据一致性和节点间状态同步。Nacos使用Raft协议来选举Leader处理写请求确保数据一致性。部署一个最小化的三节点集群你需要准备至少三台服务器或虚拟机每台都重复上述单机安装的步骤确保JDK、MySQL环境一致。使用同一个MySQL数据库所有Nacos节点应该连接至同一个MySQL数据库实例或主从复制的集群这样配置数据才能集中存储。切记不要每个节点用独立的数据库。配置集群节点信息在每个节点的/usr/local/nacos/conf目录下有一个cluster.conf.example文件。复制它并命名为cluster.confcp cluster.conf.example cluster.conf nano cluster.conf在文件中列出所有集群节点的IP和端口端口默认是8848但集群通信端口是偏移量后的7848这里写应用端口即可192.168.1.101:8848 192.168.1.102:8848 192.168.1.103:8848每个节点的这个文件内容必须完全一致。修改启动模式将每个节点systemd服务文件(nacos.service)中的启动命令从-m standalone改为-m cluster。配置负载均衡在客户端应用和Nacos集群之间需要部署一个负载均衡器如Nginx。客户端的配置文件中spring.cloud.nacos.config.server-addr和spring.cloud.nacos.discovery.server-addr应指向这个负载均衡器的地址例如lb.example.com:8848。集群部署的复杂度和维护成本远高于单机但它带来的高可用性是生产系统不可或缺的。5.2 实战中遇到的典型问题与解决方案即便按照教程一步步操作你也可能会遇到一些“坑”。下面是我总结的几个常见问题及其排查思路问题一Nacos启动后立刻闪退start.out日志文件为空或很小。排查思路检查JAVA_HOME这是最常见的原因。运行echo $JAVA_HOME确保输出正确的路径并且该路径下存在bin/java可执行文件。务必在systemd服务文件中也通过Environment指令显式设置JAVA_HOME。检查启动脚本权限确保/usr/local/nacos/bin目录下的.sh脚本有执行权限 (chmod x *.sh)。查看更详细的日志除了start.out重点检查/usr/local/nacos/logs/nacos.log。闪退的根因通常记录在这里。检查数据库连接确认application.properties中的数据库连接信息URL、用户名、密码百分百正确并且MySQL服务已启动nacos用户有远程连接权限如果IP不是127.0.0.1。问题二客户端服务无法注册到Nacos报连接超时或拒绝连接。排查思路网络连通性在客户端服务器上使用telnet nacos服务器IP 8848测试端口是否通畅。如果不通检查Nacos服务器防火墙(ufw)、云安全组规则。Nacos服务状态在Nacos服务器上用sudo systemctl status nacos和netstat -tlnp | grep 8848确认服务确实在运行并监听在正确端口。客户端配置检查客户端配置文件中的spring.cloud.nacos.discovery.server-addr的IP和端口是否正确。如果是集群是否指向了负载均衡器地址。鉴权问题如果你开启了服务端鉴权 (nacos.core.auth.enabledtrue)客户端配置中必须提供正确的username和password。问题三Nacos控制台可以登录但页面加载缓慢或经常出错。排查思路资源不足检查服务器内存和CPU使用情况。Nacos单机至少需要1-2GB的堆内存。可以通过修改/usr/local/nacos/bin/startup.sh中的JVM参数来调整例如将-Xms和-Xmx从默认的1g改为2g。数据库性能如果配置项非常多MySQL可能成为瓶颈。检查MySQL的慢查询日志考虑对config_info等核心表进行索引优化。前端资源加载检查浏览器控制台(F12)是否有JS或CSS文件加载失败。可能是网络问题也可能是Nacos版本的前端资源存在bug尝试清除浏览器缓存或使用无痕模式。问题四修改配置后客户端无法实时接收到配置更新配置热更新失效。排查思路客户端长连接Nacos配置热更新依赖于客户端与服务器保持的长轮询连接。检查客户端日志看是否有关于“long-polling”的错误。客户端配置确保在Spring Boot客户端中使用了RefreshScope注解并且依赖了spring-cloud-starter-alibaba-nacos-config。网络策略某些严格的网络策略或代理可能会中断长连接。检查客户端与Nacos服务器之间的网络环境。Nacos服务器日志查看Nacos服务器的nacos.log确认配置发布事件是否被正常记录和推送。把Nacos在Ubuntu上跑起来只是起点让它稳定、高效、安全地支撑起你的微服务体系才是真正的目标。这份指南里的每一个步骤和提醒都来自实际运维中的经验教训。特别是环境变量、服务用户权限、默认密码修改和防火墙规则这几处看似简单却往往是拦路虎。建议你在完成基础部署后花点时间按照“生产环境考量”部分的内容至少把安全加固做完并为未来的集群化留好扩展思路。 
