📝 Update README
This commit is contained in:
parent
85b0cc0c91
commit
4dc2729024
65
README.md
65
README.md
@ -10,7 +10,8 @@ A blazing fast reverse proxy with a lot of shining features.
|
||||
4. Integrate with CI/CD
|
||||
5. Webhook integration
|
||||
6. ~~Web management panel~~
|
||||
7. **Blazing fast ⚡**
|
||||
7. One-liner CLI
|
||||
8. **Blazing fast ⚡**
|
||||
|
||||
> Deleted item means under construction, check out our roadmap!
|
||||
|
||||
@ -27,6 +28,66 @@ Here's the result:
|
||||
|
||||
As result, roadsign undoubtedly is the fastest one.
|
||||
|
||||
It can be found that the prefork feature makes RoadSign more stable in concurrency. We can see this from the **Slowest Time**. At the same time, the **Fastest Time** is affected because reusing ports requires some extra steps to handle load balancing. Enable this feature at your own discretion depending on your use case.
|
||||
It can be found that the prefork feature makes RoadSign more stable in concurrency. We can see this from the **Slowest
|
||||
Time**. At the same time, the **Fastest Time** is affected because reusing ports requires some extra steps to handle
|
||||
load balancing. Enable this feature at your own discretion depending on your use case.
|
||||
|
||||
More details can be found at benchmark's [README.md](./test/README.md)
|
||||
|
||||
## Installation
|
||||
|
||||
We strongly recommend you install RoadSign via docker compose.
|
||||
|
||||
```yaml
|
||||
version: "3"
|
||||
services:
|
||||
roadsign:
|
||||
image: code.smartsheep.studio/goatworks/roadsign:nightly
|
||||
restart: always
|
||||
volumes:
|
||||
- "./certs:/certs" # Optional, use for storage certificates
|
||||
- "./config:/config"
|
||||
- "./wwwroot:/wwwroot" # Optional, use for storage web apps
|
||||
- "./settings.yml:/settings.yml"
|
||||
ports:
|
||||
- "80:80"
|
||||
- "443:443"
|
||||
- "81:81"
|
||||
```
|
||||
|
||||
After that, you can manage your roadsign instance with RoadSign CLI aka. RDS CLI.
|
||||
To install it, run this command. (Make sure you have golang toolchain on your computer)
|
||||
|
||||
```shell
|
||||
go install code.smartsheep.studio/goatworks/roadsign/pkg/cmd/rds@latest
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
To use roadsign, you need to add a configuration for it. Create a file locally.
|
||||
Name whatever you like. And follow our [documentation](https://wiki.smartsheep.studio/roadsign/02-configuration.html) to
|
||||
write it.
|
||||
|
||||
After configure, you need sync your config to remote server. Before that, add a connection between roadsign server and
|
||||
rds cli with this command.
|
||||
|
||||
```shell
|
||||
rds connect <id> <url> <password>
|
||||
# ID will allow you find this server in after commands.
|
||||
# URL is to your roadsign server administration api.
|
||||
# Password is your roadsign server credential.
|
||||
# ======================================================================
|
||||
# !WARNING! All these things will storage in your $HOME/.roadsignrc.yaml
|
||||
# ======================================================================
|
||||
```
|
||||
|
||||
Then, sync your local config to remote.
|
||||
|
||||
```shell
|
||||
rds sync <server id> <site id> <config file>
|
||||
# Server ID is your server added by last command.
|
||||
# Site ID is your new site id or old site id if you need update it.
|
||||
# Config File is your local config file path.
|
||||
```
|
||||
|
||||
After a few seconds, your website is ready!
|
Loading…
Reference in New Issue
Block a user