1. Nacos单机模式启动概述Nacos作为阿里巴巴开源的服务发现和配置管理平台单机模式(standalone)是其最简单的运行方式。通过startup.cmd -m standalone命令启动时Nacos会以独立进程运行不与其他实例组成集群适合开发测试环境快速搭建。重要提示生产环境强烈建议使用集群模式单机模式存在单点故障风险2. 环境准备与安装2.1 系统要求JDK 1.8推荐OpenJDK 8内存至少2GB可用磁盘空间至少1GB操作系统Windows/Linux/macOS2.2 下载与解压从Nacos官网下载对应版本当前稳定版为2.2.3wget 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 cd nacos3. 单机模式启动详解3.1 启动命令解析startup.cmd -m standalonestartup.cmdWindows下的启动脚本-m standalone指定单机模式运行Linux系统对应使用sh startup.sh -m standalone3.2 启动过程分析加载bin/startup.sh脚本检查JAVA_HOME环境变量解析启动参数设置JVM参数默认-Xms1g -Xmx1g启动SpringBoot应用默认端口88483.3 验证启动成功检查日志输出tail -f logs/start.out看到以下输出表示启动成功Nacos started successfully in standalone mode4. 关键配置解析4.1 配置文件位置conf/application.properties是核心配置文件主要参数包括参数默认值说明server.port8848控制台端口nacos.core.auth.enabledfalse是否开启鉴权spring.datasource.platformderby内置数据库类型4.2 数据库配置可选如需使用MySQL替代内置Derby创建数据库建议名nacos_config执行conf/nacos-mysql.sql初始化表结构修改application.propertiesspring.datasource.platformmysql db.num1 db.url.0jdbc:mysql://127.0.0.1:3306/nacos_config?characterEncodingutf8 db.userroot db.passwordyour_password5. 常见问题排查5.1 端口冲突错误现象Address already in use: bind解决方案修改application.properties中的server.port或终止占用端口的进程5.2 内存不足错误现象java.lang.OutOfMemoryError解决方案 修改bin/startup.sh中的JVM参数JAVA_OPT${JAVA_OPT} -Xms512m -Xmx512m5.3 控制台无法访问检查步骤确认防火墙已放行8848端口检查启动日志是否有异常尝试访问http://localhost:8848/nacos6. 生产环境建议虽然本文介绍单机模式但生产环境建议使用集群模式至少3节点开启鉴权nacos.core.auth.enabledtrue使用外部数据库MySQL/Oracle配置定期备份机制7. 进阶配置技巧7.1 自定义上下文路径修改application.propertiesserver.servlet.contextPath/nacos7.2 开启Prometheus监控添加依赖dependency groupIdio.micrometer/groupId artifactIdmicrometer-registry-prometheus/artifactId /dependency配置端点暴露management.endpoints.web.exposure.include*7.3 日志配置日志配置文件conf/logback.xml支持按天归档日志级别调整日志文件大小限制8. 版本升级注意事项从1.x升级到2.x需注意新增gRPC通信端口9848客户端需要同步升级配置数据需要迁移鉴权机制有变化建议升级路径1.x → 2.0.3 → 2.2.39. 安全加固建议修改默认账号密码nacos/nacos开启HTTPS访问配置IP白名单定期审计用户权限修改密码步骤访问http://localhost:8848/nacos进入权限控制→用户列表修改nacos用户密码同步修改客户端配置10. 性能调优参数关键JVM参数建议JAVA_OPT${JAVA_OPT} -server JAVA_OPT${JAVA_OPT} -Xmn1g JAVA_OPT${JAVA_OPT} -XX:MetaspaceSize128m JAVA_OPT${JAVA_OPT} -XX:MaxMetaspaceSize320m JAVA_OPT${JAVA_OPT} -XX:UseG1GC数据库连接池配置db.pool.config.connectionTimeout30000 db.pool.config.validationTimeout10000 db.pool.config.maximumPoolSize2011. 监控与告警推荐监控指标服务实例数配置项数量JVM内存使用率数据库连接数API请求成功率集成Prometheus的监控配置示例scrape_configs: - job_name: nacos metrics_path: /nacos/actuator/prometheus static_configs: - targets: [localhost:8848]12. 备份与恢复12.1 配置备份导出配置控制台操作备份数据库定期dump备份conf/目录12.2 恢复流程停止Nacos服务恢复数据库恢复配置文件重新启动服务13. 客户端接入指南Spring Cloud Alibaba接入示例spring: cloud: nacos: discovery: server-addr: localhost:8848 config: server-addr: localhost:8848 file-extension: yaml14. 常见使用误区单机模式用于生产环境使用默认账号密码不配置数据库持久化忽略日志文件清理客户端与服务端版本不匹配15. 资源清理停止服务后建议清理logs/目录如使用Derby清理data/目录检查无残留进程停止服务命令sh shutdown.sh