Sign inSign up

kouleen/nacos

By kouleen

•Updated 6 months ago

Nacos service image

Image
Integration & delivery
API management
Web servers
0

116

kouleen/nacos repository overview

⁠🚀 kouleen/nacos - 轻量级 Nacos 服务注册/配置中心镜像

⁠镜像简介

kouleen/nacos 是基于 Alpine Linux 构建的轻量化、稳定、生产可用的 Nacos 镜像。 兼容官方 Nacos 功能，支持单机 / 集群部署，开箱即用，适合微服务架构、Spring Cloud、Dubbo 环境。

⁠核心特性

✅ 超小体积：Alpine 精简构建，比官方镜像小 50%+

✅ 稳定兼容：完全兼容官方 Nacos API、配置、注册中心

✅ 一键启动：支持单机快速启动，无需复杂配置

✅ 数据持久化：支持 MySQL / 内置数据库

✅ 安全鉴权：支持开启 Nacos 安全认证

✅ 端口完整：8080 / 8848 / 9848 / 9849 全暴露

✅ 自动重启：服务崩溃自动恢复，稳定不中断

✅ 持续维护：定期更新版本，安全补丁同步

⁠默认端口

  • 8080: HTTP Web 页面访问
  • 8848：HTTP 主端口（核心访问端口）
  • 9848：gRPC 客户端通信端口
  • 9849：gRPC 同步端口

⁠快速使用（3 种模式）

⁠模式 1：单机模式（测试/开发）
docker run -d \
  --name nacos \
  --restart always \
  -e MODE=standalone \
  -p 8080:8080 \
  -p 8848:8848 \
  -p 9848:9848 \
  -p 9849:9849 \
  kouleen/nacos:latest
⁠模式 2：单机 + 数据持久化（生产推荐）
docker run -d \
  --name nacos \
  --restart always \
  -e MODE=standalone \
  -v ./nacos-data:/home/nacos/data \
  -p 8080:8080 \
  -p 8848:8848 \
  -p 9848:9848 \
  -p 9849:9849 \
  kouleen/nacos:latest
⁠模式 3：单机 + 外接 MySQL（生产高可用推荐）
docker run -d \
  --privileged=true \
  --name nacos \
  --restart always \
  -e MODE=standalone \
  -e TIME_ZONE=Asia/Shanghai \
  -e SPRING_DATASOURCE_PLATFORM=mysql \
  -e MYSQL_SERVICE_HOST=数据库地址 \
  -e MYSQL_SERVICE_PORT=数据库端口 \
  -e MYSQL_SERVICE_USER=用户名 \
  -e MYSQL_SERVICE_PASSWORD=密码 \
  -e MYSQL_SERVICE_DB_NAME=数据库名 \
  -e NACOS_AUTH_ENABLE=true \
  -e NACOS_AUTH_TOKEN=自定义令牌 \
  -e NACOS_AUTH_IDENTITY_KEY=自定义key \
  -e NACOS_AUTH_IDENTITY_VALUE=自定义值 \
  -e NACOS_CONFIG_MIGRATE_SKIP=true \
  -v /usr/local/nacos/data:/home/nacos/data \
  -v /usr/local/nacos/logs:/home/nacos/logs \
  -p 8080:8080 \
  -p 8848:8848 \
  -p 9848:9848 \
  -p 9849:9849 \
  kouleen/nacos:latest

⁠访问控制台

http://服务器IP:8080
默认账号：nacos
默认密码：nacos

⁠📘 完整环境变量说明（已补全你新增的所有变量）

变量名作用默认值
MODE运行模式：standalone / clusterstandalone
TIME_ZONE时区设置Asia/Shanghai
JVM_XMS初始堆内存512m
JVM_XMX最大堆内存1g
SPRING_DATASOURCE_PLATFORM数据库类型（mysql 则启用外接库）空
MYSQL_SERVICE_HOSTMySQL 地址空
MYSQL_SERVICE_PORTMySQL 端口3306
MYSQL_SERVICE_USERMySQL 用户名空
MYSQL_SERVICE_PASSWORDMySQL 密码空
MYSQL_SERVICE_DB_NAMEMySQL 数据库名空
NACOS_AUTH_ENABLE是否开启安全认证false
NACOS_AUTH_TOKEN授权令牌（开启认证必填）空
NACOS_AUTH_IDENTITY_KEY认证身份 KEY空
NACOS_AUTH_IDENTITY_VALUE认证身份值空
NACOS_CONFIG_MIGRATE_SKIP是否跳过配置迁移false

⁠数据持久化目录

/home/nacos/data  # 数据目录
/home/nacos/logs  # 日志目录

⁠常用管理命令

# 查看状态
docker ps | grep nacos

# 查看日志
docker logs -f nacos

# 重启/停止/删除
docker restart nacos
docker stop nacos
docker rm -f nacos

# 拉取最新版
docker pull kouleen/nacos:latest

⁠适用场景

  • Spring Cloud / Spring Boot 微服务架构
  • 服务注册发现、配置中心、动态配置管理
  • 分布式系统、微服务网关、生产环境
  • 开发/测试/生产环境通用

⁠常见问题

⁠Q1：是否兼容官方 Nacos？

完全兼容，数据结构、API、控制台 1:1 官方一致。

⁠Q2：支持集群模式吗？

支持，设置 MODE=cluster 即可。

⁠Q3：数据会丢失吗？

挂载 /home/nacos/data 即可永久保存。

⁠Q4：可以用于公网生产环境？

可以，开启鉴权后更安全。

⁠作者信息

🐳 Docker Hub: kouleen⁠ 📦 镜像地址: kouleen/nacos⁠

⁠💡 觉得好用？欢迎点个 ⭐ Star 支持一下！

Tag summary

Content type

Image

Digest

sha256:604d8d382…

Size

269.6 MB

Last updated

6 months ago

docker pull kouleen/nacos:3.1.1