中间件 - Wizard Doc

最后修改人	孙荣利
最后修改时间	2026-09-19 18:02:04
创建人	孙荣利
创建时间	2026-09-19 18:02:04

该文档由孙荣利创建于 2026-09-19 18:02:04 ，孙荣利在 2026-09-19 18:02:04 修改了该文档。

[TOCM]

## 一、简介

```text
Nacos 是一个开源的、用于构建云原生应用的动态服务发现、配置管理和服务管理平台。它由阿里巴巴开源，旨在解决微服务架构中服务实例动态变化和配置分散管理的核心难题。
```

## 二、安装部署

### 1. 服务说明

| 项目 | 说明 |
|------|------|
| 镜像 | repo.358369.xyz/nacos/nacos-server:v2.3.2 |
| 容器名 | nacos-server |
| 网络模式 | host（端口 8848/9848） |
| 数据目录 | /data/nacos（nacos/data、nacos/logs） |
| 存储模式 | MySQL（SPRING_DATASOURCE_PLATFORM: mysql） |
| 鉴权 | 已开启 NACOS_AUTH_ENABLE |

---

### 2. 前置条件

> nacos 一定要先初始化数据库

```shell
# 连接 mysql 数据库，建立 nacos 库与用户
# CentOS 正式服：nacos 库 / nacos / nacos
# Ubuntu 正式服：nacos 库 / nacos / nacos
```

---

### 3. 目录准备

```shell
mkdir /data/nacos -p
cd /data/nacos
# 创建数据目录和日志目录
touch docker-compose.yml
```

---

### 4. 配置文件（docker-compose.yml）

#### 4.1 配置存储于文件中，无用户名、密码

```yaml
services:
  nacos-server:
    container_name: nacos-server
    image: repo.hivery.cn/nacos/nacos-server:v2.3.2
    network_mode: host
    restart: always
    environment:
      TZ: Asia/Shanghai
      MODE: standalone
      JVM_XMS: 512m
      JVM_XMX: 512m
      JVM_XMN: 128m
      JVM_MMS: 300m
      # 用于监控
      JAVA_OPT: "-Dmanagement.endpoints.web.exposure.include=*"
    volumes:
      # 挂载数据目录到宿主机
      - ./nacos/data:/home/nacos/data
      - ./nacos/logs:/home/nacos/logs
```

#### 4.2 配置存储数数据库中，无用户名、密码

```yaml
services:
  nacos-server:
    container_name: nacos-server
    image: repo.hivery.cn/nacos/nacos-server:v2.3.2
    network_mode: host
    restart: always
    environment:
      TZ: Asia/Shanghai
      MODE: standalone
      PREFER_HOST_MODE: ip
      SPRING_DATASOURCE_PLATFORM: mysql
      # 数据库配置按需调整
      MYSQL_SERVICE_HOST: 192.168.51.23
      MYSQL_SERVICE_PORT: 3306
      MYSQL_SERVICE_DB_NAME: nacos
      MYSQL_SERVICE_USER: nacos
      MYSQL_SERVICE_PASSWORD: '此处设置密码'
      MYSQL_SERVICE_DB_PARAM: characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false&allowPublicKeyRetrieval=true
      JVM_XMS: 512m
      JVM_XMX: 512m
      JVM_XMN: 128m
      JVM_MMS: 300m
      # 用于监控
      JAVA_OPT: "-Dmanagement.endpoints.web.exposure.include=*"
```

#### 4.3 配置存储数数据库中，有用户名、密码，初始用户名密码 nacos / nacos

```shell
cat > docker-compose.yml <<'EOF'
services:
  nacos-server:
    container_name: nacos-server
    image: repo.358369.xyz/nacos/nacos-server:v2.3.2
    network_mode: host
    restart: always
    environment:
      TZ: Asia/Shanghai
      MODE: standalone
      PREFER_HOST_MODE: ip
      SPRING_DATASOURCE_PLATFORM: mysql
      # 数据库配置按需调整
      MYSQL_SERVICE_HOST: '192.168.0.1'
      MYSQL_SERVICE_PORT: 3306
      MYSQL_SERVICE_DB_NAME: nacos
      MYSQL_SERVICE_USER: nacos
      MYSQL_SERVICE_PASSWORD: 'nacos'
      MYSQL_SERVICE_DB_PARAM: characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false&allowPublicKeyRetrieval=true
      JVM_XMS: 512m
      JVM_XMX: 512m
      JVM_XMN: 128m
      JVM_MMS: 300m
      # 加上这行：开启 Nacos 登录鉴权（核心）
      NACOS_AUTH_ENABLE: true
      NACOS_AUTH_TOKEN: SaaSSecretKey012345678901234567890123456789012345678901234567890123456789
      # token 过期时间，默认18000秒（5小时）
      NACOS_AUTH_TOKEN_EXPIRE_SECONDS: 18000
      # 服务身份标识的key和value，用于服务端识别
      NACOS_AUTH_IDENTITY_KEY: SaaSserverIdentity
      NACOS_AUTH_IDENTITY_VALUE: SaaSsecurity
      # 用于监控
      JAVA_OPT: "-Dmanagement.endpoints.web.exposure.include=*"
EOF
```

---

### 5. 启动服务

```shell
docker compose up -d
```

---

### 6. 验证

```shell
docker ps | grep nacos-server
# 控制台：http://<服务器IP>:8848/nacos 
```