Nacos单机部署全指南：从环境准备到生产优化

一、Nacos单机部署的适用场景与核心价值

Nacos作为阿里巴巴开源的动态服务发现、配置和服务管理平台，其单机部署模式主要适用于开发测试环境、小型项目或资源受限的场景。相比集群模式，单机部署具有部署简单、资源占用低、维护成本低的特点，但牺牲了高可用性和水平扩展能力。对于初期验证、本地开发或非关键业务场景，单机部署是高效且经济的选择。

二、环境准备：基础要求与依赖检查

1. 硬件与操作系统要求

• CPU/内存：建议至少2核4G（开发环境可放宽至1核2G）。
• 操作系统：支持Linux（推荐CentOS/Ubuntu）、Windows（需注意路径分隔符差异）。
• 磁盘空间：预留至少5GB（日志和快照可能占用较大空间）。

2. Java环境配置

Nacos基于Java开发，需提前安装JDK 8或11（推荐OpenJDK）：

# Linux示例（安装OpenJDK 11）
sudo apt update
sudo apt install openjdk-11-jdk
java -version  # 验证版本

关键点：避免使用JDK 17+（可能存在兼容性问题），并通过JAVA_HOME环境变量指定路径。

3. 网络与端口规划

Nacos默认使用8848端口（HTTP API和UI），需确保该端口未被占用：

# Linux检查端口占用
netstat -tulnp | grep 8848
# 或使用ss命令
ss -tulnp | grep 8848

若端口冲突，可通过修改conf/application.properties中的server.port调整。

三、Nacos单机部署详细步骤

1. 下载与解压

从Nacos GitHub Release页面下载稳定版本（如2.3.2）：

wget https://github.com/alibaba/nacos/releases/download/2.3.2/nacos-server-2.3.2.tar.gz
tar -xzvf nacos-server-2.3.2.tar.gz -C /opt  # 解压到指定目录

版本选择建议：生产环境避免使用Beta或RC版本，优先选择LTS（长期支持）版本。

2. 启动模式配置

单机模式需修改conf/application.properties：

# 关闭集群模式
nacos.standalone=true
# 可选：调整JVM内存参数（根据机器配置）
# 在bin/startup.sh中修改JAVA_OPT
JAVA_OPT="${JAVA_OPT} -Xms512m -Xmx512m -Xmn256m"

内存优化：开发环境可降低至-Xms256m -Xmx256m，生产环境建议根据负载调整。

3. 启动与验证

# Linux启动（前台运行）
sh /opt/nacos/bin/startup.sh -m standalone
# Windows启动（CMD）
cd /opt/nacos/bin
startup.cmd -m standalone

验证方式：

• 访问http://localhost:8848/nacos，使用默认账号nacos/nacos登录。
• 检查日志文件/opt/nacos/logs/start.out是否有错误。

四、生产环境优化建议

1. 数据持久化配置

默认使用嵌入式数据库Derby，生产环境建议替换为MySQL：

1. 创建MySQL数据库并执行conf/nacos-mysql.sql初始化表结构。
2. 修改conf/application.properties：

   spring.datasource.platform=mysql
   db.num=1
   db.url.0=jdbc//127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
   db.user=root
   db.password=your_password

2. 安全加固

• 修改默认密码：通过UI的“权限管理”修改初始账号密码。
• 启用认证：在conf/application.properties中设置：

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

3. 日志与监控

• 日志轮转：配置logback.xml中的maxHistory和maxFileSize。
• 集成Prometheus：通过Nacos的Metrics接口暴露指标，接入Grafana监控。

五、常见问题与解决方案

1. 启动失败：端口冲突或权限不足

• 现象：日志中报Address already in use或Permission denied。
• 解决：
  • 修改端口或终止占用进程。
  • Linux下使用chmod +x bin/*.sh赋予执行权限。

2. 服务注册失败：网络不可达

• 检查点：
  • 客户端与Nacos服务器的网络连通性（ping和telnet测试）。
  • 防火墙规则是否放行8848端口。

3. 配置未生效：Namespace或Data ID错误

• 验证步骤：
  1. 确认配置的Namespace和Group是否存在。
  2. 检查客户端配置的serverAddr和contextPath是否正确。

六、总结与扩展建议

Nacos单机部署的核心优势在于快速上手和低资源消耗，但需明确其局限性。对于关键业务系统，建议后续迁移至集群模式（至少3节点）以保障高可用性。此外，可结合Spring Cloud Alibaba或Dubbo实现服务治理的完整闭环。

进阶方向：

• 探索Nacos与Kubernetes的集成（通过CRD管理配置）。
• 研究Nacos的扩展点（如自定义命名空间、鉴权插件）。

通过本文的指导，读者可高效完成Nacos单机部署，并根据实际需求逐步优化和扩展。