jerry6290/nacos-server

docker-nacos-server 镜像文档

镜像概述和主要用途

docker-nacos-server是一个优化的Nacos服务端镜像，旨在解决官方Nacos镜像体积过大、资源占用高及特定版本（v1.1.4）升级失败的问题。该镜像基于轻量级的Alpine JRE基础镜像构建，显著减小了镜像体积，同时保持Nacos的核心服务能力，适用于对资源占用敏感的部署场景。

核心功能和特性

1. 轻量级基础镜像

• 采用 adoptopenjdk/openjdk8:x86_64-alpine-jre8u232-b09 作为基础镜像，仅包含JRE运行环境，基础镜像大小仅45M。

2. 极致体积优化

• 打包后镜像总大小约93M，相比官方Nacos镜像（约700M）减少80%以上，大幅降低存储和传输成本。

3. 版本兼容性修复

• 解决官方v1.1.4版本因构建问题导致的升级失败问题，确保服务稳定运行。

4. 低内存占用

• 基于Alpine系统和精简JRE，运行时内存占用显著低于官方镜像，适合资源受限环境。

使用场景和适用范围

• 资源受限环境：边缘计算设备、嵌入式系统或低配置服务器部署Nacos服务。
• 轻量级部署：开发测试环境、CI/CD流水线或小型项目的服务注册与配置中心需求。
• 对镜像体积敏感的场景：需要快速拉取镜像、节省存储空间的容器化部署环境。
• Nacos v1.1.4版本用户：需解决官方版本升级失败问题的用户。

使用方法和配置说明

基本运行命令

bash
docker run -d -p 8848:8848 --name nacos-server your-registry/docker-nacos-server:latest

环境变量配置

Nacos支持通过环境变量进行配置，常用参数如下：

单机模式示例

bash
docker run -d \
  -p 8848:8848 \
  -e MODE=standalone \
  --name nacos-server \
  your-registry/docker-nacos-server:latest

Docker Compose配置示例

yaml
version: '3'
services:
  nacos:
    image: your-registry/docker-nacos-server:latest
    container_name: nacos-server
    ports:
      - "8848:8848"
    environment:
      - MODE=standalone
    restart: always

集群模式示例（需MySQL支持）

bash
docker run -d \
  -p 8848:8848 \
  -e MODE=cluster \
  -e SPRING_DATASOURCE_PLATFORM=mysql \
  -e MYSQL_SERVICE_HOST=mysql-host \
  -e MYSQL_SERVICE_PORT=3306 \
  -e MYSQL_SERVICE_DB_NAME=nacos_config \
  -e MYSQL_SERVICE_USER=root \
  -e MYSQL_SERVICE_PASSWORD=123456 \
  --name nacos-server \
  your-registry/docker-nacos-server:latest

访问验证

服务启动后，通过 http://<容器IP>:8848/nacos 访问Nacos控制台，默认用户名/密码为 nacos/nacos。