mirror of
https://github.com/eduardogsilva/wireguard_webadmin.git
synced 2026-01-01 06:16:16 +00:00
streamline deploy instructions for NGINX/non-NGINX options and simplify upgrade steps
This commit is contained in:
32
README.md
32
README.md
@@ -81,7 +81,7 @@ Follow these steps to deploy the WireGuard WebAdmin:
|
|||||||
|
|
||||||
Depending on your deployment scenario, choose one of the following commands to download the appropriate `docker-compose.yml` file directly into your working directory. This approach ensures you're using the latest version of the deployment configuration.
|
Depending on your deployment scenario, choose one of the following commands to download the appropriate `docker-compose.yml` file directly into your working directory. This approach ensures you're using the latest version of the deployment configuration.
|
||||||
|
|
||||||
### With NGINX (Recommended)
|
### Option 1: With NGINX (Recommended)
|
||||||
|
|
||||||
For a production-ready deployment with NGINX as a reverse proxy (recommended for most users), use:
|
For a production-ready deployment with NGINX as a reverse proxy (recommended for most users), use:
|
||||||
|
|
||||||
@@ -89,14 +89,18 @@ Follow these steps to deploy the WireGuard WebAdmin:
|
|||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose.yml
|
||||||
```
|
```
|
||||||
This mode is recommended for running the web admin interface. The container deployment will automatically generate a self-signed certificate for you. If you want to update your certificates, simply navigate to the `certificates` volume and replace `nginx.pem` and `nginx.key` with your own certificates.
|
This mode is recommended for running the web admin interface. The container deployment will automatically generate a self-signed certificate for you. If you want to update your certificates, simply navigate to the `certificates` volume and replace `nginx.pem` and `nginx.key` with your own certificates.
|
||||||
### Without NGINX (Debug Mode and Testing Only)
|
|
||||||
|
|
||||||
For a debug environment without NGINX, suitable only for testing (not recommended for production), use:
|
### Option 2: Without NGINX
|
||||||
|
|
||||||
|
If you prefer to use your own reverse proxy or run without one, use:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> Running the system without HTTPS (NGINX) is not recommended due to security risks. If you choose this option, ensure you are using a secure connection (e.g., through your own reverse proxy with SSL).
|
||||||
|
|
||||||
3.**Create the `.env` File:**
|
3.**Create the `.env` File:**
|
||||||
|
|
||||||
Create a `.env` file in the same directory as your `docker-compose.yml` with the following content, adjusting `my_server_address` to your server's DNS name or IP address. This step is crucial for ensuring the application functions correctly.
|
Create a `.env` file in the same directory as your `docker-compose.yml` with the following content, adjusting `my_server_address` to your server's DNS name or IP address. This step is crucial for ensuring the application functions correctly.
|
||||||
@@ -121,24 +125,12 @@ This mode is recommended for running the web admin interface. The container depl
|
|||||||
|
|
||||||
Execute the Docker Compose command to start your deployment.
|
Execute the Docker Compose command to start your deployment.
|
||||||
|
|
||||||
### With NGINX (Recommended)
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
```
|
```
|
||||||
|
|
||||||
Access the web interface using `https://yourserver.example.com`. If you are using a self-signed certificate, you must accept the certificate exception that your browser will present.
|
Access the web interface using `https://yourserver.example.com`. If you are using a self-signed certificate, you must accept the certificate exception that your browser will present.
|
||||||
|
|
||||||
### Without NGINX (Debug Mode and Testing Only)
|
|
||||||
|
|
||||||
If you opted for the non-NGINX setup, simply run the previously fetched `docker-compose-no-nginx.yml` with:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker compose -f docker-compose-no-nginx.yml up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
Access the web interface using `http://127.0.0.1:8000`.
|
|
||||||
|
|
||||||
After completing these steps, your WireGuard WebAdmin should be up and running. Begin the configuration by accessing your server's web interface.
|
After completing these steps, your WireGuard WebAdmin should be up and running. Begin the configuration by accessing your server's web interface.
|
||||||
|
|
||||||
Certainly, let's refine the upgrade instructions with the inclusion of a backup step for the database and a more appropriate suggestion for transitioning users from a git clone workflow.
|
Certainly, let's refine the upgrade instructions with the inclusion of a backup step for the database and a more appropriate suggestion for transitioning users from a git clone workflow.
|
||||||
@@ -150,15 +142,11 @@ Upgrading your WireGuard WebAdmin installation ensures you have access to the la
|
|||||||
|
|
||||||
### Preparing for Upgrade:
|
### Preparing for Upgrade:
|
||||||
|
|
||||||
1.**Transitioning from a Git Clone Workflow:**
|
1.**Navigate to the Project Directory:**
|
||||||
|
|
||||||
Begin by navigating to your wireguard_webadmin directory:
|
Navigate to your `wireguard_webadmin` directory:
|
||||||
```bash
|
```bash
|
||||||
cd path/to/wireguard_webadmin
|
cd wireguard_webadmin
|
||||||
```
|
|
||||||
If you're upgrading from an existing git clone installation, navigate to your current project directory.
|
|
||||||
```bash
|
|
||||||
cd /path/to/wireguard_webadmin_git_clone
|
|
||||||
```
|
```
|
||||||
|
|
||||||
2.**Shutdown Services:**
|
2.**Shutdown Services:**
|
||||||
|
|||||||
@@ -73,6 +73,12 @@ Auf Basis deiner Anforderungen wurden die folgenden Deploy‑Anweisungen erstell
|
|||||||
|
|
||||||
Folge diesen Schritten, um WireGuard WebAdmin bereitzustellen:
|
Folge diesen Schritten, um WireGuard WebAdmin bereitzustellen:
|
||||||
|
|
||||||
|
1. **Umgebung vorbereiten**
|
||||||
|
|
||||||
|
Erstelle zunächst ein Verzeichnis für WireGuard WebAdmin und wechsle hinein:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkdir wireguard_webadmin && cd wireguard_webadmin
|
||||||
1. **Umgebung vorbereiten**
|
1. **Umgebung vorbereiten**
|
||||||
|
|
||||||
Erstelle zunächst ein Verzeichnis für WireGuard WebAdmin und wechsle hinein:
|
Erstelle zunächst ein Verzeichnis für WireGuard WebAdmin und wechsle hinein:
|
||||||
@@ -85,7 +91,7 @@ Folge diesen Schritten, um WireGuard WebAdmin bereitzustellen:
|
|||||||
|
|
||||||
Wähle je nach Szenario einen der folgenden Befehle, um die passende `docker-compose.yml` herunterzuladen. So nutzt du stets die aktuelle Version der Deployment‑Datei.
|
Wähle je nach Szenario einen der folgenden Befehle, um die passende `docker-compose.yml` herunterzuladen. So nutzt du stets die aktuelle Version der Deployment‑Datei.
|
||||||
|
|
||||||
### Mit NGINX (empfohlen)
|
### Option 1: Mit NGINX (empfohlen)
|
||||||
|
|
||||||
Für eine produktionsreife Bereitstellung mit NGINX als Reverse‑Proxy (empfohlen):
|
Für eine produktionsreife Bereitstellung mit NGINX als Reverse‑Proxy (empfohlen):
|
||||||
|
|
||||||
@@ -95,14 +101,17 @@ Folge diesen Schritten, um WireGuard WebAdmin bereitzustellen:
|
|||||||
|
|
||||||
Im Standard generiert der Container ein selbstsigniertes Zertifikat. Eigene Zertifikate können durch Ersetzen von `nginx.pem` und `nginx.key` im Volume `certificates` hinterlegt werden.
|
Im Standard generiert der Container ein selbstsigniertes Zertifikat. Eigene Zertifikate können durch Ersetzen von `nginx.pem` und `nginx.key` im Volume `certificates` hinterlegt werden.
|
||||||
|
|
||||||
### Ohne NGINX (nur Debug/Test)
|
### Option 2: Ohne NGINX
|
||||||
|
|
||||||
Für eine reine Testumgebung ohne NGINX (nicht für Produktion empfohlen):
|
Wenn Sie Ihren eigenen Reverse-Proxy verwenden oder das System ohne einen solchen betreiben möchten, nutzen Sie:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> Es wird nicht empfohlen, das System ohne HTTPS (NGINX) zu betreiben, da dies Sicherheitsrisiken birgt. Wenn Sie diese Option wählen, stellen Sie sicher, dass Sie eine sichere Verbindung verwenden (z. B. über Ihren eigenen Reverse-Proxy mit SSL).
|
||||||
|
|
||||||
3. **`.env`‑Datei erstellen**
|
3. **`.env`‑Datei erstellen**
|
||||||
|
|
||||||
Erstelle eine `.env`‑Datei im selben Verzeichnis wie deine `docker-compose.yml` und passe `my_server_address` an die DNS‑Adresse oder IP deines Servers an:
|
Erstelle eine `.env`‑Datei im selben Verzeichnis wie deine `docker-compose.yml` und passe `my_server_address` an die DNS‑Adresse oder IP deines Servers an:
|
||||||
@@ -116,7 +125,7 @@ Folge diesen Schritten, um WireGuard WebAdmin bereitzustellen:
|
|||||||
|
|
||||||
4. **Docker Compose ausführen**
|
4. **Docker Compose ausführen**
|
||||||
|
|
||||||
### Mit NGINX (empfohlen)
|
Führen Sie den Docker Compose-Befehl aus, um Ihr Deployment zu starten:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
@@ -124,14 +133,6 @@ Folge diesen Schritten, um WireGuard WebAdmin bereitzustellen:
|
|||||||
|
|
||||||
Web‑Interface unter `https://yourserver.example.com` öffnen. Bei selbstsigniertem Zertifikat muss die Ausnahme akzeptiert werden.
|
Web‑Interface unter `https://yourserver.example.com` öffnen. Bei selbstsigniertem Zertifikat muss die Ausnahme akzeptiert werden.
|
||||||
|
|
||||||
### Ohne NGINX (nur Debug/Test)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker compose -f docker-compose-no-nginx.yml up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
Web‑Interface unter `http://127.0.0.1:8000` öffnen.
|
|
||||||
|
|
||||||
Nach diesen Schritten sollte WireGuard WebAdmin laufen. Konfiguriere anschließend deine Instanzen über das Web‑Interface.
|
Nach diesen Schritten sollte WireGuard WebAdmin laufen. Konfiguriere anschließend deine Instanzen über das Web‑Interface.
|
||||||
|
|
||||||
## Upgrade‑Anleitung
|
## Upgrade‑Anleitung
|
||||||
@@ -140,14 +141,10 @@ Regelmäßige Upgrades stellen sicher, dass du die neuesten Funktionen, Sicherhe
|
|||||||
|
|
||||||
### Vorbereitung
|
### Vorbereitung
|
||||||
|
|
||||||
1. **Vom Git‑Clone‑Workflow umsteigen**
|
1. **In das Projektverzeichnis wechseln**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd /pfad/zu/wireguard_webadmin
|
cd wireguard_webadmin
|
||||||
```
|
|
||||||
Befindet sich deine Installation in einem Git‑Clone‑Verzeichnis, wechsle dorthin:
|
|
||||||
```bash
|
|
||||||
cd /pfad/zu/wireguard_webadmin_git_clone
|
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Dienste stoppen**
|
2. **Dienste stoppen**
|
||||||
|
|||||||
@@ -81,7 +81,7 @@ Siga estos pasos para desplegar WireGuard WebAdmin:
|
|||||||
|
|
||||||
Según su escenario de despliegue, elija uno de los siguientes comandos para descargar el archivo `docker-compose.yml` correspondiente directamente en su directorio de trabajo. Este método garantiza que utilice la versión más reciente de la configuración.
|
Según su escenario de despliegue, elija uno de los siguientes comandos para descargar el archivo `docker-compose.yml` correspondiente directamente en su directorio de trabajo. Este método garantiza que utilice la versión más reciente de la configuración.
|
||||||
|
|
||||||
### Con NGINX (Recomendado)
|
### Opción 1: Con NGINX (Recomendado)
|
||||||
|
|
||||||
Para un despliegue de producción con NGINX como *reverse proxy* (recomendado para la mayoría), use:
|
Para un despliegue de producción con NGINX como *reverse proxy* (recomendado para la mayoría), use:
|
||||||
|
|
||||||
@@ -89,16 +89,19 @@ Siga estos pasos para desplegar WireGuard WebAdmin:
|
|||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
Este modo es el recomendado para ejecutar la interfaz web de administración. El despliegue del contenedor generará automáticamente un certificado autofirmado. Si desea actualizar sus certificados, acceda al volumen `certificates` y sustituya `nginx.pem` y `nginx.key` por sus propios certificados.
|
Este modo es el recomendado para ejecutar la interfaz web de administración. El despliegue del contenedor generará automáticamente un certificado autofirmado para usted. Si desea actualizar sus certificados, acceda al volumen `certificates` y sustituya `nginx.pem` y `nginx.key` por sus propios certificados.
|
||||||
|
|
||||||
### Sin NGINX (Solo para Depuración y Pruebas)
|
### Opción 2: Sin NGINX
|
||||||
|
|
||||||
Para un entorno de depuración sin NGINX (no recomendado en producción), use:
|
Si prefiere usar su propio proxy inverso o ejecutar el sistema sin uno, use:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> No se recomienda servir el sistema sin HTTPS (NGINX) debido a riesgos de seguridad. Si elige esta opción, asegúrese de utilizar una conexión segura (por ejemplo, a través de su propio proxy inverso con SSL).
|
||||||
|
|
||||||
3. **Cree el Archivo `.env`:**
|
3. **Cree el Archivo `.env`:**
|
||||||
|
|
||||||
Cree un archivo `.env` en el mismo directorio que su `docker-compose.yml` con el siguiente contenido, ajustando `my_server_address` al nombre DNS o IP de su servidor.
|
Cree un archivo `.env` en el mismo directorio que su `docker-compose.yml` con el siguiente contenido, ajustando `my_server_address` al nombre DNS o IP de su servidor.
|
||||||
@@ -114,7 +117,7 @@ Siga estos pasos para desplegar WireGuard WebAdmin:
|
|||||||
|
|
||||||
4. **Ejecute Docker Compose:**
|
4. **Ejecute Docker Compose:**
|
||||||
|
|
||||||
### Con NGINX (Recomendado)
|
Ejecute el comando Docker Compose para iniciar su despliegue.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
@@ -122,16 +125,6 @@ Siga estos pasos para desplegar WireGuard WebAdmin:
|
|||||||
|
|
||||||
Acceda a la interfaz web en `https://suserver.ejemplo.com`. Si utiliza un certificado autofirmado, acepte la excepción de seguridad en su navegador.
|
Acceda a la interfaz web en `https://suserver.ejemplo.com`. Si utiliza un certificado autofirmado, acepte la excepción de seguridad en su navegador.
|
||||||
|
|
||||||
### Sin NGINX (Solo para Depuración y Pruebas)
|
|
||||||
|
|
||||||
Si eligió la configuración sin NGINX, ejecute el archivo descargado `docker-compose-no-nginx.yml`:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker compose -f docker-compose-no-nginx.yml up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
Acceda a la interfaz en `http://127.0.0.1:8000`.
|
|
||||||
|
|
||||||
Tras completar estos pasos, WireGuard WebAdmin estará en funcionamiento. Comience la configuración accediendo a la interfaz web de su servidor.
|
Tras completar estos pasos, WireGuard WebAdmin estará en funcionamiento. Comience la configuración accediendo a la interfaz web de su servidor.
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -142,18 +135,12 @@ Actualizar su instalación de WireGuard WebAdmin garantiza acceso a nuevas funci
|
|||||||
|
|
||||||
### Preparación para la Actualización:
|
### Preparación para la Actualización:
|
||||||
|
|
||||||
1. **Transición desde un flujo de trabajo *git clone*:**
|
1. **Vaya al Directorio del Proyecto:**
|
||||||
|
|
||||||
Acceda al directorio `wireguard_webadmin`:
|
Acceda al directorio `wireguard_webadmin`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd path/to/wireguard_webadmin
|
cd wireguard_webadmin
|
||||||
```
|
|
||||||
|
|
||||||
Si actualiza desde una instalación realizada con *git clone*, vaya al directorio del proyecto:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd /path/to/wireguard_webadmin_git_clone
|
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Detenga los Servicios:**
|
2. **Detenga los Servicios:**
|
||||||
|
|||||||
@@ -79,7 +79,7 @@ Suivez ces étapes pour déployer WireGuard WebAdmin:
|
|||||||
|
|
||||||
Choisissez l’une des commandes suivantes pour récupérer la dernière version du `docker-compose.yml` directement depuis le dépôt GitHub.
|
Choisissez l’une des commandes suivantes pour récupérer la dernière version du `docker-compose.yml` directement depuis le dépôt GitHub.
|
||||||
|
|
||||||
### Avec NGINX (recommandé)
|
### Option 1 : Avec NGINX (recommandé)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose.yml
|
||||||
@@ -87,12 +87,17 @@ Suivez ces étapes pour déployer WireGuard WebAdmin:
|
|||||||
|
|
||||||
Ce mode est recommandé pour exécuter l’interface web. Le déploiement générera automatiquement un certificat auto‑signé. Pour utiliser vos propres certificats, remplacez `nginx.pem` et `nginx.key` dans le volume `certificates`.
|
Ce mode est recommandé pour exécuter l’interface web. Le déploiement générera automatiquement un certificat auto‑signé. Pour utiliser vos propres certificats, remplacez `nginx.pem` et `nginx.key` dans le volume `certificates`.
|
||||||
|
|
||||||
### Sans NGINX (mode debug/test uniquement)
|
### Option 2 : Sans NGINX
|
||||||
|
|
||||||
|
Si vous préférez utiliser votre propre proxy inverse ou exécuter le système sans proxy, utilisez :
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> Il n'est pas recommandé de servir le système sans HTTPS (NGINX) en raison de risques de sécurité. Si vous choisissez cette option, assurez-vous d'utiliser une connexion sécurisée (par exemple, via votre propre proxy inverse avec SSL).
|
||||||
|
|
||||||
3. **Créer le fichier `.env`**
|
3. **Créer le fichier `.env`**
|
||||||
|
|
||||||
Dans le même répertoire que `docker-compose.yml`, créez un fichier `.env`:
|
Dans le même répertoire que `docker-compose.yml`, créez un fichier `.env`:
|
||||||
@@ -106,9 +111,9 @@ Suivez ces étapes pour déployer WireGuard WebAdmin:
|
|||||||
|
|
||||||
Remplacez `my_server_address` par l’adresse réelle de votre serveur.
|
Remplacez `my_server_address` par l’adresse réelle de votre serveur.
|
||||||
|
|
||||||
4. **Lancer Docker Compose**
|
4. **Lancer Docker Compose**
|
||||||
|
|
||||||
#### Avec NGINX (recommandé)
|
Exécutez la commande Docker Compose pour démarrer votre déploiement.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
@@ -116,24 +121,16 @@ Suivez ces étapes pour déployer WireGuard WebAdmin:
|
|||||||
|
|
||||||
Accédez à l’interface via `https://votreserveur.exemple.com`. Avec un certificat auto‑signé, votre navigateur demandera une exception.
|
Accédez à l’interface via `https://votreserveur.exemple.com`. Avec un certificat auto‑signé, votre navigateur demandera une exception.
|
||||||
|
|
||||||
#### Sans NGINX (mode debug/test)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker compose -f docker-compose-no-nginx.yml up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
Accédez à l’interface via `http://127.0.0.1:8000`.
|
|
||||||
|
|
||||||
Après ces étapes, WireGuard WebAdmin sera opérationnel.
|
Après ces étapes, WireGuard WebAdmin sera opérationnel.
|
||||||
|
|
||||||
## Instructions de mise à jour
|
## Instructions de mise à jour
|
||||||
|
|
||||||
Pour profiter des dernières fonctionnalités et correctifs:
|
Pour profiter des dernières fonctionnalités et correctifs:
|
||||||
|
|
||||||
1. **Si vous utilisiez un clone Git**
|
1. **Allez dans le répertoire du projet**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd /chemin/vers/wireguard_webadmin_git_clone
|
cd wireguard_webadmin
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Arrêter les services**
|
2. **Arrêter les services**
|
||||||
|
|||||||
@@ -81,7 +81,7 @@ Siga estes passos para implantar o WireGuard WebAdmin:
|
|||||||
|
|
||||||
Dependendo do seu cenário de implantação, escolha um dos comandos a seguir para baixar o arquivo `docker-compose.yml` apropriado diretamente no seu diretório de trabalho. Esse método garante que você está usando a versão mais recente da configuração de implantação.
|
Dependendo do seu cenário de implantação, escolha um dos comandos a seguir para baixar o arquivo `docker-compose.yml` apropriado diretamente no seu diretório de trabalho. Esse método garante que você está usando a versão mais recente da configuração de implantação.
|
||||||
|
|
||||||
### Com NGINX (Recomendado)
|
### Opção 1: Com NGINX (Recomendado)
|
||||||
|
|
||||||
Para uma implantação pronta para produção com NGINX como *reverse proxy* (recomendado para a maioria dos usuários), use:
|
Para uma implantação pronta para produção com NGINX como *reverse proxy* (recomendado para a maioria dos usuários), use:
|
||||||
|
|
||||||
@@ -91,14 +91,17 @@ Siga estes passos para implantar o WireGuard WebAdmin:
|
|||||||
|
|
||||||
Este modo é recomendado para executar a interface web de administração. O *deployment* do contêiner gerará automaticamente um certificado autoassinado para você. Se desejar atualizar seus certificados, basta acessar o volume `certificates` e substituir `nginx.pem` e `nginx.key` pelos seus próprios certificados.
|
Este modo é recomendado para executar a interface web de administração. O *deployment* do contêiner gerará automaticamente um certificado autoassinado para você. Se desejar atualizar seus certificados, basta acessar o volume `certificates` e substituir `nginx.pem` e `nginx.key` pelos seus próprios certificados.
|
||||||
|
|
||||||
### Sem NGINX (Somente para Debug e Testes)
|
### Opção 2: Sem NGINX
|
||||||
|
|
||||||
Para um ambiente de depuração sem NGINX, adequado apenas para testes (não recomendado em produção), use:
|
Se você preferir usar seu próprio proxy reverso ou rodar sem um, use:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> Não é recomendado servir o sistema sem HTTPS (NGINX) devido a riscos de segurança. Se optar por esta opção, certifique-se de estar utilizando uma conexão segura (ex: através de seu próprio proxy reverso com SSL).
|
||||||
|
|
||||||
3. **Crie o Arquivo `.env`:**
|
3. **Crie o Arquivo `.env`:**
|
||||||
|
|
||||||
Crie um arquivo `.env` no mesmo diretório do seu `docker-compose.yml` com o conteúdo abaixo, ajustando `my_server_address` para o DNS ou endereço IP do seu servidor. Este passo é crucial para garantir o funcionamento correto da aplicação.
|
Crie um arquivo `.env` no mesmo diretório do seu `docker-compose.yml` com o conteúdo abaixo, ajustando `my_server_address` para o DNS ou endereço IP do seu servidor. Este passo é crucial para garantir o funcionamento correto da aplicação.
|
||||||
@@ -114,7 +117,7 @@ Siga estes passos para implantar o WireGuard WebAdmin:
|
|||||||
|
|
||||||
4. **Execute o Docker Compose:**
|
4. **Execute o Docker Compose:**
|
||||||
|
|
||||||
### Com NGINX (Recomendado)
|
Execute o comando Docker Compose para iniciar sua implantação.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
@@ -122,16 +125,6 @@ Siga estes passos para implantar o WireGuard WebAdmin:
|
|||||||
|
|
||||||
Acesse a interface web em `https://seuservidor.exemplo.com`. Se estiver usando um certificado autoassinado, será necessário aceitar a exceção de certificado apresentada pelo navegador.
|
Acesse a interface web em `https://seuservidor.exemplo.com`. Se estiver usando um certificado autoassinado, será necessário aceitar a exceção de certificado apresentada pelo navegador.
|
||||||
|
|
||||||
### Sem NGINX (Somente para Debug e Testes)
|
|
||||||
|
|
||||||
Caso tenha optado pela configuração sem NGINX, simplesmente execute o arquivo `docker-compose-no-nginx.yml` obtido anteriormente:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker compose -f docker-compose-no-nginx.yml up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
Acesse a interface web em `http://127.0.0.1:8000`.
|
|
||||||
|
|
||||||
Após concluir esses passos, o WireGuard WebAdmin deverá estar em execução. Inicie a configuração acessando a interface web do seu servidor.
|
Após concluir esses passos, o WireGuard WebAdmin deverá estar em execução. Inicie a configuração acessando a interface web do seu servidor.
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -142,18 +135,12 @@ Manter sua instalação do WireGuard WebAdmin atualizada garante acesso aos recu
|
|||||||
|
|
||||||
### Preparação para o Upgrade:
|
### Preparação para o Upgrade:
|
||||||
|
|
||||||
1. **Transição de um Workflow *git clone*:**
|
1. **Navegue até o Diretório do Projeto:**
|
||||||
|
|
||||||
Navegue até o diretório `wireguard_webadmin`:
|
Navegue até o diretório `wireguard_webadmin`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd path/to/wireguard_webadmin
|
cd wireguard_webadmin
|
||||||
```
|
|
||||||
|
|
||||||
Se estiver atualizando a partir de uma instalação existente via *git clone*, navegue até o diretório do projeto atual.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd /path/to/wireguard_webadmin_git_clone
|
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Desligue os Serviços:**
|
2. **Desligue os Serviços:**
|
||||||
|
|||||||
Reference in New Issue
Block a user