From 2fca458bd05847e07fcca54ee4d91fc893f386f1 Mon Sep 17 00:00:00 2001 From: PassiveLemon Date: Mon, 16 Dec 2024 18:14:02 -0500 Subject: [PATCH] Image building instructions and README touch-ups --- .gitignore | 2 +- README.md | 7 ++++--- docker/README.md | 13 ++++++++++--- 3 files changed, 15 insertions(+), 7 deletions(-) diff --git a/.gitignore b/.gitignore index 6e386d5..5e9c044 100644 --- a/.gitignore +++ b/.gitignore @@ -30,7 +30,7 @@ src/certs/* src/rules/* src/README.md docker/ContainerTester.sh -docker/ImagePublisher.sh +docker/docker-compose.yaml src/mod/acme/test/stackoverflow.pem /tools/dns_challenge_update/code-gen/acmedns /tools/dns_challenge_update/code-gen/lego diff --git a/README.md b/README.md index 5d02072..b9f3140 100644 --- a/README.md +++ b/README.md @@ -137,7 +137,8 @@ If you already have an upstream reverse proxy server in place with permission ma ./zoraxy -noauth=true ``` -*Note: For security reasons, you should only enable no-auth if you are running Zoraxy in a trusted environment or with another authentication management proxy in front.* +> [!WARNING] +> For security reasons, you should only enable no-auth if you are running Zoraxy in a trusted environment or with another authentication management proxy in front.* ## Screenshots @@ -157,7 +158,7 @@ This project also compatible with [ZeroTier](https://www.zerotier.com/). However To use Zoraxy with ZeroTier, assuming you already have a valid license, install ZeroTier on your host and then run Zoraxy in sudo mode (or Run As Administrator if you are on Windows). The program will automatically grab the authtoken in the correct location on your host. -If you prefer not to run Zoraxy in sudo mode or you have some weird installation profile, you can also pass in the ZeroTier auth token using the following flags:: +If you prefer not to run Zoraxy in sudo mode or you have some weird installation profile, you can also pass in the ZeroTier auth token using the following flags: ```bash ./zoraxy -ztauth="your_zerotier_authtoken" -ztport=9993 @@ -178,7 +179,7 @@ Web SSH currently only supports Linux based OSes. The following platforms are su ### Loopback Connection -Loopback web SSH connection, by default, is disabled. This means that if you are trying to connect to an address like 127.0.0.1 or localhost, the system will reject your connection for security reasons. To enable loopback for testing or development purpose, use the following flags to override the loopback checking: +Loopback web SSH connections, by default, are disabled. This means that if you are trying to connect to an address like 127.0.0.1 or localhost, the system will reject your connection for security reasons. To enable loopback for testing or development purpose, use the following flags to override the loopback checking: ```bash ./zoraxy -sshlb=true diff --git a/docker/README.md b/docker/README.md index 583c701..96e27d2 100644 --- a/docker/README.md +++ b/docker/README.md @@ -9,7 +9,7 @@ If you are attempting to access your service from outside your network, make sure to forward ports 80 and 443 to the Zoraxy host to allow web traffic. If you know how to do this, great! If not, find the manufacturer of your router and search on how to do that. There are too many to be listed here. Read more about it from [whatismyip](https://www.whatismyip.com/port-forwarding/). -In the examples below, make sure to update `/path/to/zoraxy/config/` with your actual path. If a path is not provided, a Docker volume will be created at the location but it is recommended to store the data at a defined host location. +In the examples below, make sure to update `/path/to/zoraxy/config/`. If a path is not provided, a Docker volume will be created at the location but it is recommended to store the data at a defined host location or a named Docker volume. Once setup, access the webui at `http://:8000` to configure Zoraxy. Change the port in the URL if you changed the management port. @@ -26,7 +26,6 @@ docker run -d \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /etc/localtime:/etc/localtime \ -e FASTGEOIP="true" \ - -e ZEROTIER="true" \ zoraxydocker/zoraxy:latest ``` @@ -48,7 +47,6 @@ services: - /etc/localtime:/etc/localtime environment: FASTGEOIP: "true" - ZEROTIER: "true" ``` ### Ports @@ -93,3 +91,12 @@ Variables are the same as those in [Start Parameters](https://github.com/tobychu > [!IMPORTANT] > Contrary to the Zoraxy README, Docker usage of the port flag should NOT include the colon. Ex: `-e PORT="8000"` for Docker run and `PORT: "8000"` for Docker compose. +### Building + +To build the Docker image: + - Check out the repository/branch. + - Copy the Zoraxy `src/` directory into the `docker/` (here) directory. + - Run the build command with `docker build -t zoraxy_build .` + - You can now use the image `zoraxy_build` + - If you wish to change the image name, then modify`zoraxy_build` in the previous step and then build again. +