Update 'README.md'
This commit is contained in:
parent
be25f9beac
commit
b6fd2df88f
23
README.md
23
README.md
|
@ -4,24 +4,27 @@ Clean, dockerized v2ray(Websocket + TLS) + Nginx + Let's Encrypt with official a
|
|||
## Supports:
|
||||
- v2ray with websocket + TLS protocol using the [official v2ray docker image](https://hub.docker.com/r/v2ray/official/).
|
||||
- Nginx frontend and **auto-renewing** Let's Encrypt certificate using the popular [linuxserver/swag](https://hub.docker.com/r/linuxserver/swag/).
|
||||
- This project basically generates UUID, random paths and uses python to process the templates.
|
||||
- watchtower for automatic docker image updates (can be disabled) from [containrrr/watchtower](https://hub.docker.com/r/containrrr/watchtower)
|
||||
- Easy multiuser configuration and user conf file generation.
|
||||
## Usage:
|
||||
### Required packages
|
||||
- python 3
|
||||
- docker-ce.
|
||||
- docker-compose.
|
||||
- python-jinja2. A popular python template processor. Just search for jinja2 with your distro's package manager.
|
||||
|
||||
### Building
|
||||
- Clone this repo with your user instead of root.
|
||||
- Make sure you run setup.py with your user instead of root otherwise Nginx will not start.
|
||||
- Run `python setup.py -h` for directions.
|
||||
- For example, if your full domain name is `aaa.bb.c` and your email is `d@e.f` then run `python setup.py -d bb.c -s aaa -e d@e.f`
|
||||
- To start over, run `git reset --hard`. Don't run this with a running build or you will lose your existing config!
|
||||
- Clone this repo.
|
||||
- Modify `config.yml` to your liking. Please see the comments in the file for documentation.
|
||||
- Run `configure.py` with python 3.
|
||||
- Generated files are located in the `build` directory. Run `docker-compose up -d` within that directory to start the stack.
|
||||
- To start over or to update the existing configuration. Simply change `config.yml`, rerun `configure.py` and restart the stack.
|
||||
|
||||
### Connecting
|
||||
After spinning up all the containers, you can use client.conf to connect. If you are setting it up on your phone, connect to subdomain.domain.tld:443 and use websocket obfuscation.
|
||||
### Client conf files
|
||||
Client conf files are generated
|
||||
|
||||
### Troubleshooting
|
||||
- Make sure your subdomain.domain.tld points to the server.
|
||||
- Use `docker logs nginx` to check for nginx init errors. Detailed nginx logs and be found in `nginx/logs/nginx`
|
||||
- Use `docker logs v2ray` to check for v2ray init errors.
|
||||
- Use `docker logs v2ray_nginx` to check for nginx init errors. Detailed nginx logs and be found in `nginx/logs/nginx`
|
||||
- Use `docker logs v2ray_v2ray` to check for v2ray init errors.
|
||||
- Use `docker logs v2ray_watchtower` to check for watchtower errors.
|
Loading…
Reference in New Issue