Docker Image

Pull official docker image

docker pull shardingsphere/sharding-proxy

Manual build docker image(Optional)

git clone
mvn clean install
cd sharding-sphere/sharding-proxy
mvn clean package docker:build

Configure Sharding-Proxy

Create /${your_work_dir}/conf/config.yaml file to configure sharding rule. More details please reference Configuration Manual.

Run docker

docker run -d -v /${your_work_dir}/conf:/opt/sharding-proxy/conf --env PORT=3308 -p13308:3308 shardingsphere/sharding-proxy:latest

The port 3308 and 13308 could be customized, 3308 represents port of docker container, 13308 represents port of host machine.

docker run -d -v /${your_work_dir}/conf:/opt/sharding-proxy/conf --env JVM_OPTS="-Djava.awt.headless=true" --env PORT=3308 -p13308:3308 shardingsphere/sharding-proxy:latest

Set JVM relative parameters into JVM_OPTS.

Access Sharding-Proxy

Same as access MySQL.

mysql -u${your_user_name} -p${your_password} -h${your_host} -P13308


Q1: I/O exception ( caught when processing request to {}->unix://localhost:80: Connection refused?

A: Please make sure docker is running before you build or run.

Q2:Can’t connect to database when starting the container?

A:Please make sure /${your_work_dir}/conf/sharding-config.yaml’s mysql database ip can be accessed by docker container.