https://github.com/diennea/carapaceproxy
A Distributed Java Reverse Proxy
https://github.com/diennea/carapaceproxy
http-proxy java load-balancer netty proxy
Last synced: 7 months ago
JSON representation
A Distributed Java Reverse Proxy
- Host: GitHub
- URL: https://github.com/diennea/carapaceproxy
- Owner: diennea
- License: apache-2.0
- Created: 2019-01-18T13:43:03.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-05-28T15:13:18.000Z (7 months ago)
- Last Synced: 2025-06-03T23:16:43.583Z (7 months ago)
- Topics: http-proxy, java, load-balancer, netty, proxy
- Language: Java
- Size: 7.63 MB
- Stars: 25
- Watchers: 6
- Forks: 9
- Open Issues: 67
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - Carapaceproxy
README
# Carapaceproxy
A Distributed Java Reverse Proxy
## For Developers
Start Carapace by running `./run.sh` script. This just launch the server, the ui and load a ready to use dynamic configuration.
Server will start at `http://localhost:8001/ui/#/` and `https://localhost:4001/ui/#/` with no authentication required.
To launch/update the ui only, run `./carapace-ui/deploy.sh`
To bundle the project into a .zip archive for a standalone installation run `mvn clean install -DskipTests -Pproduction`. You'll find the generated zip in `carapace-server/target/carapace-server-X.Y.Z-SNAPSHOT.zip`
## For Admins
To install Carapace, just unzip the carapace.zip archive and then run `./bin/service server start [custom-server.properties]` (default server.properties is loaded).
The server will start at `hostname:port` as defined in the server.properties file loaded.
## Docker
You can build carapace docker image by running:
```
mvn clean install -DskipTests -Pproduction
docker/build.sh
```
Then you can run the container and the admin interface will be listening on 0.0.0.0:8001
```
docker run -p 8001:8001 carapace/carapace-server:latest
```
You can also pass system properties using docker option `-e` with the prefix `CARAPACE`:
```
docker run -p 8001:8001 -e CARAPACE_mode=cluster -e CARAPACE_zkAddress=localhost:2181 carapace/carapace-server:latest
```
### Docker start a simple cluster with 1 node
You can run a simple 1-node cluster using the docker-compose.yml file.
This starts a Carapace node (with embedded bookkeeper and herddb) and Zookeeper.
The replication factor of bookkeeper in this case will be set to 1.
```
docker compose up -d
```