Deploy a Nacos Cluster with Docker#

Pull the Image#

1
docker pull nacos/nacos-server:v2.2.0

Avoid pulling the latest tag — always pin a specific version for production.

Database Setup#

Nacos cluster requires MySQL to store configuration data. MySQL 5.7 is recommended.

Create a database named nacos_config and run the official initialization script (located in the Nacos source at distribution/conf/nacos-mysql.sql, which creates config_info, config_info_aggr, users, roles, and other core tables).

Create Nacos Containers#

Create three Nacos instances to form the cluster. Replace IP addresses in the commands below with your server’s IP.

Node 1 (Port 8848)#

1
docker run -d \
2
  -e PREFER_HOST_MODE=hostname \
3
  -e MODE=cluster \
4
  -e NACOS_APPLICATION_PORT=8848 \
5
  -e NACOS_SERVERS="your-server-ip:8848 your-server-ip:8858 your-server-ip:8868" \
6
  -e SPRING_DATASOURCE_PLATFORM=mysql \
7
  -e MYSQL_SERVICE_HOST=your-server-ip \
8
  -e MYSQL_SERVICE_PORT=3306 \
9
  -e MYSQL_SERVICE_USER=root \
10
  -e MYSQL_SERVICE_PASSWORD=your-password \
11
  -e MYSQL_SERVICE_DB_NAME=nacos_config \
12
  -e NACOS_SERVER_IP=your-server-ip \
13
  -p 8848:8848 -p 9848:9848 -p 9849:9849 \
14
  --name my-nacos1 \
15
  nacos/nacos-server:v2.2.0

Node 2 (Port 8858)#

1
docker run -d \
2
  -e PREFER_HOST_MODE=hostname \
3
  -e MODE=cluster \
4
  -e NACOS_APPLICATION_PORT=8858 \
5
  -e NACOS_SERVERS="your-server-ip:8848 your-server-ip:8858 your-server-ip:8868" \
6
  -e SPRING_DATASOURCE_PLATFORM=mysql \
7
  -e MYSQL_SERVICE_HOST=your-server-ip \
8
  -e MYSQL_SERVICE_PORT=3306 \
9
  -e MYSQL_SERVICE_USER=root \
10
  -e MYSQL_SERVICE_PASSWORD=your-password \
11
  -e MYSQL_SERVICE_DB_NAME=nacos_config \
12
  -e NACOS_SERVER_IP=your-server-ip \
13
  -p 8858:8858 -p 9858:9858 -p 9859:9859 \
14
  --name my-nacos2 \
15
  nacos/nacos-server:v2.2.0

Node 3 (Port 8868)#

1
docker run -d \
2
  -e PREFER_HOST_MODE=hostname \
3
  -e MODE=cluster \
4
  -e NACOS_APPLICATION_PORT=8868 \
5
  -e NACOS_SERVERS="your-server-ip:8848 your-server-ip:8858 your-server-ip:8868" \
6
  -e SPRING_DATASOURCE_PLATFORM=mysql \
7
  -e MYSQL_SERVICE_HOST=your-server-ip \
8
  -e MYSQL_SERVICE_PORT=3306 \
9
  -e MYSQL_SERVICE_USER=root \
10
  -e MYSQL_SERVICE_PASSWORD=your-password \
11
  -e MYSQL_SERVICE_DB_NAME=nacos_config \
12
  -e NACOS_SERVER_IP=your-server-ip \
13
  -p 8868:8868 -p 9868:9868 -p 9869:9869 \
14
  --name my-nacos3 \
15
  nacos/nacos-server:v2.2.0

Verify the Cluster#

Visit http://ip:port/nacos on any node. The default credentials are nacos/nacos. You should see all three nodes listed in the Cluster Management page.

Nginx Load Balancing#

Configure the Upstream#

Create a custom configuration in your Nginx Proxy Manager installation directory:

1
upstream nacos {
2
    server your-server-ip:8848;
3
    server your-server-ip:8858;
4
    server your-server-ip:8868;
5
}

Configure the Reverse Proxy#

Add a proxy in NPM’s web interface:

1
Domain: nacos.your-domain.com
2
Forward Hostname: 127.0.0.1
3
Forward Port: 80

Then add this in the Advanced tab:

1
location / {
2
    proxy_pass http://nacos;
3
}

After configuring an SSL certificate, you can access the Nacos console at https://nacos.your-domain.com/nacos.

Note: When using Nginx Proxy Manager, create http.conf under the nginx/custom/ directory in the container mount. NPM will automatically include this file in the global configuration.

Music