一、为什么选择Docker Compose部署单机Nacos？

Nacos作为阿里巴巴开源的动态服务发现、配置和服务管理平台，在微服务架构中承担着核心角色。单机版Nacos适用于开发测试环境或小型项目，具有部署简单、资源占用低的特点。而Docker Compose通过YAML文件定义多容器应用，能够快速构建标准化环境，避免手动安装的繁琐步骤和版本冲突问题。

相比传统虚拟机部署，Docker Compose的优势体现在：

环境一致性：通过镜像固化依赖，确保开发、测试、生产环境完全一致
快速启停：单条命令即可完成服务启动/停止，支持一键回滚
资源隔离：每个容器独立运行，避免服务间资源竞争
可扩展性：后续可无缝升级为集群模式，仅需修改配置文件

二、环境准备与前置条件

2.1 系统要求

操作系统：Linux/macOS/Windows（WSL2推荐）
硬件配置：最低2核4G内存（生产环境建议4核8G）
磁盘空间：至少预留5GB可用空间

2.2 软件依赖

Docker引擎：建议使用最新稳定版（20.10+）

# Linux安装示例（Ubuntu）
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Docker Compose：V2.0+版本（已集成在Docker Desktop中）
```
# 验证安装
docker compose version
```
网络配置：确保主机8848（Nacos默认端口）未被占用
```
sudo netstat -tulnp | grep 8848
```

三、Docker Compose配置详解

3.1 基础配置文件（docker-compose.yml）

version: '3.8'
services:
  nacos:
    image: nacos/nacos-server:v2.3.2
    container_name: nacos-standalone
    environment:
      - MODE=standalone
      - PREFER_HOST_MODE=hostname
      - JVM_XMS=512m
      - JVM_XMX=512m
      - JVM_XMN=256m
    ports:
      - "8848:8848"
    volumes:
      - ./nacos-data:/home/nacos/data
      - ./nacos-logs:/home/nacos/logs
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8848/nacos/health"]
      interval: 30s
      timeout: 10s
      retries: 3

关键参数说明：

MODE=standalone：强制单机模式运行
JVM_XMS/XMX：根据服务器内存调整，建议不超过物理内存的50%
volumes：持久化数据和日志，防止容器重启后数据丢失
healthcheck：服务健康监测，集成到容器编排系统中

3.2 高级配置优化

3.2.1 内存调优

对于4G内存主机，推荐配置：

environment:
  - JVM_XMS=256m
  - JVM_XMX=1g
  - JVM_XMN=512m
  - JVM_OPTS="-Dnacos.standalone=true -Dnacos.member.list="

3.2.2 自定义配置文件

若需修改application.properties，可挂载自定义配置：

volumes:
  - ./custom-config:/home/nacos/conf

3.2.3 多环境支持

通过.env文件实现环境切换：

# .env.prod
MODE=cluster
JVM_XMX=2g

# docker-compose.yml
services:
  nacos:
    env_file: .env.${ENV:-dev}

四、部署流程与验证

4.1 完整部署步骤

创建工作目录

mkdir nacos-standalone && cd nacos-standalone

下载配置文件

curl -o docker-compose.yml https://raw.githubusercontent.com/nacos-group/nacos-docker/master/example/standalone-mysql.yml
# 修改为前文的基础配置

启动服务
```
docker compose up -d
```

验证服务状态

docker compose ps
docker logs nacos-standalone

4.2 访问控制台

浏览器访问：http://localhost:8848/nacos
默认账号：nacos/nacos
关键验证点：
- 控制台可正常登录
- 服务列表页面能加载
- 配置管理功能可用

4.3 常见问题处理

端口冲突：

# 修改ports映射
ports:
  - "18848:8848"

内存不足：
- 调整JVM参数或升级主机配置
- 监控命令：docker stats nacos-standalone
数据持久化失败：
- 检查volumes目录权限：chmod -R 777 nacos-data

五、生产环境建议

5.1 安全加固

修改默认密码：

# 通过MySQL客户端执行（若使用外部数据库）
UPDATE users SET password='$2a$10$EuWPZHzz32dJN7jexM34MOeYirDdFAZm2kuWj7VEOJhhZkDrxfVUi' WHERE username='nacos';

启用HTTPS：

ports:
  - "8848:8848"
  - "9848:9848"  # HTTPS端口
environment:
  - NACOS_SECURE=true

5.2 监控集成

Prometheus监控：

services:
  nacos:
    expose:
      - "9555"  # Prometheus metrics端口

日志收集：

volumes:
  - ./logs:/var/log/nacos
logging:
  driver: "json-file"
  options:
    max-size: "10m"
    max-file: "3"

5.3 备份策略

定期备份：

# 每日备份脚本示例
docker exec nacos-standalone sh -c "tar -czf /tmp/nacos-backup.tar.gz /home/nacos/data"
docker cp nacos-standalone:/tmp/nacos-backup.tar.gz ./backups/

异地备份：
- 结合rsync或云存储服务实现

六、升级与维护

6.1 版本升级流程

备份当前数据：

docker compose exec nacos tar -czf /tmp/nacos-data-backup.tar.gz /home/nacos/data

修改镜像版本：
```
image: nacos/nacos-server:v2.4.0
```
重建容器：
```
docker compose down
docker compose up -d
```

6.2 日常维护命令

命令	用途
`docker compose restart`	重启服务
`docker compose top`	查看进程
`docker compose exec nacos bash`	进入容器
`docker compose down -v`	彻底清理（包括卷）

七、扩展应用场景

7.1 结合Spring Cloud使用

添加依赖：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2022.0.0.0</version>
</dependency>

配置示例：

spring:
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
      config:
        server-addr: localhost:8848
        file-extension: yaml

7.2 与Kubernetes集成

虽然本文聚焦Docker Compose，但单机部署可作为K8s环境的测试基准。实际生产中，可通过Helm Chart实现：

helm repo add nacos https://nacos-io.github.io/k8s/
helm install nacos nacos/nacos --set mode=standalone

八、总结与最佳实践

资源分配原则：
- 开发环境：1核2G + 512M JVM
- 生产环境：4核8G + 2G JVM
配置管理建议：
- 将环境变量抽离到.env文件
- 使用ConfigMap管理自定义配置
监控告警体系：
- 集成Prometheus+Grafana
- 设置内存使用率>80%告警
备份恢复测试：
- 每季度进行一次恢复演练
- 验证备份文件的完整性

通过Docker Compose部署单机Nacos，开发者可以在10分钟内完成从环境搭建到服务验证的全流程。这种部署方式不仅简化了操作复杂度，更通过容器化技术保障了环境的一致性，为后续的集群扩展奠定了坚实基础。建议将此部署方案纳入CI/CD流水线，实现服务的自动化交付。

dockercompose部署单机Nacos：从环境配置到服务启动全流程指南