服务器Nacos教程:Linux 单机部署与生产避坑

把 Nacos 装到服务器上,最省事的做法是先用单机模式跑通,再考虑集群。
Nacos 是阿里开源的注册中心和配置中心,微服务之间靠它互相发现、动态拉取配置。
下面按 Linux 服务器(CentOS 7/8 或 Ubuntu 20.04 以上均可)走一遍完整流程,命令可直接复制。

先确认环境是否够用

Nacos 基于 Java 运行,需要 JDK 8 或 11。
先检查:

java -version

如果提示 command not found,安装 OpenJDK 8:

# CentOS / RHEL
yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel

# Ubuntu / Debian
apt update && apt install -y openjdk-8-jdk

再确认内存。
单机模式最低建议 1GB 可用内存,但生产用至少要 2GB 以上,因为默认 JVM 参数会占用约 512MB 堆内存。
用 free -h 查看剩余内存。

还需要 MySQL 5.7 或 8.0。
Nacos 默认用内嵌 Derby 数据库,不适合生产,所以本文直接用 MySQL 持久化。

下载与解压

从 GitHub Releases 获取稳定版本,例如当前常用的 2.x 系列:

cd /opt
wget https://github.com/alibaba/nacos/releases/download/2.2.3/nacos-server-2.2.3.tar.gz
tar -zxvf nacos-server-2.2.3.tar.gz
mv nacos /usr/local/nacos

版本号请以官方发布页为准,不要照抄本示例里的数字。
解压后目录结构里 conf 放配置,bin 放启动脚本。

配置 MySQL 持久化

先在 MySQL 里建库:

CREATE DATABASE nacos_config DEFAULT CHARACTER SET utf8mb4;
CREATE USER 'nacos'@'%' IDENTIFIED BY '你的强密码';
GRANT ALL PRIVILEGES ON nacos_config.* TO 'nacos'@'%';
FLUSH PRIVILEGES;

接着导入 Nacos 自带的建表脚本,脚本在 conf/mysql-schema.sql:

mysql -u nacos -p nacos_config < /usr/local/nacos/conf/mysql-schema.sql

然后编辑 conf/application.properties,把数据库连接改成自己的:

spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false&serverTimezone=Asia/Shanghai
db.user.0=nacos
db.password.0=你的强密码

注意:如果 MySQL 是 8.0,useSSL=false 和 serverTimezone 建议保留,否则容易报时区或 SSL 连接错误。

启动与验证

单机模式启动命令:

cd /usr/local/nacos/bin
sh startup.sh -m standalone

查看日志确认是否成功:

tail -f /usr/local/nacos/logs/start.out

看到 Nacos started successfully in stand alone mode 即表示启动成功。
然后在浏览器访问 http://服务器IP:8848/nacos,默认账号密码都是 nacos。
如果打不开,先在服务器本地用 curl http://127.0.0.1:8848/nacos 测试,本地能通说明是防火墙问题。

放行端口:

# firewalld
firewall-cmd --zone=public --add-port=8848/tcp --permanent
firewall-cmd --reload

# 或 ufw
ufw allow 8848/tcp

如果用的是云服务器,还要在安全组里放行 8848。

上线前必须开启鉴权

单机跑通不代表能直接对外。
默认关闭鉴权,任何人知道地址都能改配置。
在 application.properties 中开启:

nacos.core.auth.enabled=true
nacos.core.auth.server.identity.key=自定义key
nacos.core.auth.server.identity.value=自定义value
nacos.core.auth.plugin.nacos.token.secret.key=至少32位Base64编码字符串

改完重启 Nacos。
如果不需要对外网暴露,更稳妥的做法是只监听内网,通过 Nginx 或内网负载均衡转发。

常见启动失败怎么查

最常见的是内存不足导致进程被 kill。
编辑 bin/startup.sh,把 JAVA_OPT 里的 -Xms512m -Xmx512m 调小,例如 -Xms256m -Xmx256m,再重启。

另一种是数据库连不上。
检查 logs/start.out 是否出现 Communications link failure,这时确认 MySQL 是否启动、账号权限是否允许远程连接、防火墙是否放行 3306。

如果启动后日志停在 Nacos is starting... 长时间不动,通常是 Derby 或 MySQL 初始化慢,等 30 秒再看;
仍无进展就检查磁盘空间 df -h。

验证部署是否真的可用

打开 Nacos 控制台,进入“配置管理”,新建一条测试配置,Data ID 填 test.properties,内容随便写一行。
保存后在“服务管理”里能看到服务列表功能正常。
最后用 ps -ef | grep nacos 确认进程存在,用 netstat -tlnp | grep 8848 确认端口在监听。

做到这一步,单机 Nacos 已经可以支撑测试和小规模生产。
集群部署还需要额外配 cluster.conf 和外部数据库高可用,建议先把这个单机版本用稳再扩展。

分享到:
上一篇
服务器etcd教程:零基础单节点部署与日常维护实操
下一篇
服务器Eureka教程:从零搭建到可用注册中心
1
系统公告

泽御云中秋国庆双节活动上线:新购8折,拼团3.99元起

尊敬的用户:
泽御云“月满中秋·礼贺国庆”双节活动现已开启,活动时间为2026年9月23日至10月10日。 活动期间可享以下福利:
1. 常规云服务器新购使用优惠码“泽御中秋国庆同乐”,符合条件的订单享8折优惠。
2. 香港精品云服务器5人拼团低至3.99元,部分4核4G套餐3人拼团年付388元,续费同价。
3. 新用户购买年付云服务器,符合活动规则可赠送2个月使用时长。
4. 老用户续费季度赠15天,续费年度赠2个月;活动期间升级配置免收配置迁移手续费。
5. 推荐好友成功下单,符合条件的推荐人可获赠7天服务器使用时长。
6. 活动期间享宕机补偿标准翻倍、简单网站迁移协助及技术工单优先处理权益。
温馨提示:优惠码不适用于拼团套餐、活动轻量产品、年付订单及续费订单;拼团套餐为独立特价活动,不与赠时类福利叠加。赠送时长不可折现、退款或跨账户转移,具体规则以活动页面说明为准。
服务中心
客服
在线客服
24小时为您服务
咨询
联系我们
联系我们,为您的业务提供专属服务。
24/7 技术支持
如果您遇到寻求进一步的帮助,请过工单与我们进行联系。
24/7 即时支持
泽御云
售前客服
泽御云
泽御云
售后客服
泽御云
技术支持
评价
您对当前页面的整体感受是否满意?
😞
非常不满意
😕
不满意
😐
一般
🙂
满意
😊
非常满意