From 2064ff1ae7044075280a5d8d6b8b345d0843e79b Mon Sep 17 00:00:00 2001 From: VPS 4 Deploy Agent Date: Tue, 16 Jun 2026 03:39:15 +0200 Subject: [PATCH] docs: renomeia terminologia "staging" -> "dev" (ambiente nunca foi isolado) Co-Authored-By: Claude Opus 4.8 --- VPS-0.1/wg0.conf | 2 +- VPS-0.4/README.md | 6 +++--- VPS-0.4/hub_peer_vps4.conf | 2 +- VPS-0.4/wg0.conf | 2 +- arquitetura.md | 14 +++++++------- instrucoes/arquitetura.md | 14 +++++++------- newwhats.clube67.com/newwhats.local/arquitetura.md | 14 +++++++------- vpn-setup.md | 2 +- 8 files changed, 28 insertions(+), 28 deletions(-) diff --git a/VPS-0.1/wg0.conf b/VPS-0.1/wg0.conf index c0881d6..fa3a199 100644 --- a/VPS-0.1/wg0.conf +++ b/VPS-0.1/wg0.conf @@ -25,7 +25,7 @@ AllowedIPs = 10.99.0.10/32 PublicKey = S40JqovA4F8oH8aieWsDvNEv1yw5Juwu1wb4zHjQ8Ww= AllowedIPs = 10.99.0.3/32 -# Peer 3: VPS 4 (Desenvolvimento / Staging) +# Peer 3: VPS 4 (Desenvolvimento / Dev) [Peer] PublicKey = ln7phEfm4w//jZJqqlkGAjsXKWQnOw2kYc64ni5PXX0= AllowedIPs = 10.99.0.4/32 diff --git a/VPS-0.4/README.md b/VPS-0.4/README.md index 819e362..f43a630 100644 --- a/VPS-0.4/README.md +++ b/VPS-0.4/README.md @@ -1,4 +1,4 @@ -# 🧪 Configuração de Rede Segura (VPN WireGuard) - VPS 4 (Desenvolvimento / Staging) +# 🧪 Configuração de Rede Segura (VPN WireGuard) - VPS 4 (Desenvolvimento / Dev) Este diretório contém os arquivos de configuração necessários para que a **VPS 4** (`10.99.0.4`) entre na rede privada criptografada do **Clube67** de forma totalmente segura. @@ -7,7 +7,7 @@ Este diretório contém os arquivos de configuração necessários para que a ** ## 🗺️ Visão de Conexão da VPS 4 ```mermaid graph LR - VPS4["🧪 VPS 4 (Staging)
IP: 10.99.0.4"] + VPS4["🧪 VPS 4 (Dev)
IP: 10.99.0.4"] VPS1["🖥️ VPS 1 (Hub Central)
IP: 10.99.0.1"] VPS3["🗄️ VPS 3 (Banco de Dados)
IP: 10.99.0.3"] @@ -37,7 +37,7 @@ Antes de ativar a conexão na VPS 4, o servidor central (**VPS 1**) precisa auto 3. Adicione o seguinte bloco de peer ao final do arquivo: ```ini [Peer] - # VPS 4 (Desenvolvimento / Staging) + # VPS 4 (Desenvolvimento / Dev) PublicKey = ln7phEfm4w//jZJqqlkGAjsXKWQnOw2kYc64ni5PXX0= AllowedIPs = 10.99.0.4/32 PersistentKeepalive = 25 diff --git a/VPS-0.4/hub_peer_vps4.conf b/VPS-0.4/hub_peer_vps4.conf index 278f853..46f95d1 100644 --- a/VPS-0.4/hub_peer_vps4.conf +++ b/VPS-0.4/hub_peer_vps4.conf @@ -2,7 +2,7 @@ # Adicione este bloco ao final do arquivo para autorizar a conexão da VPS 4 [Peer] -# VPS 4 (Desenvolvimento / Staging) +# VPS 4 (Desenvolvimento / Dev) PublicKey = ln7phEfm4w//jZJqqlkGAjsXKWQnOw2kYc64ni5PXX0= AllowedIPs = 10.99.0.4/32 PersistentKeepalive = 25 diff --git a/VPS-0.4/wg0.conf b/VPS-0.4/wg0.conf index 75ab51c..c1ad6cb 100644 --- a/VPS-0.4/wg0.conf +++ b/VPS-0.4/wg0.conf @@ -1,4 +1,4 @@ -# /etc/wireguard/wg0.conf - VPS 4 (Desenvolvimento / Staging) +# /etc/wireguard/wg0.conf - VPS 4 (Desenvolvimento / Dev) # Configuração de Cliente VPN WireGuard # IP Atribuído: 10.99.0.4 diff --git a/arquitetura.md b/arquitetura.md index 4a69e49..3d03e1c 100644 --- a/arquitetura.md +++ b/arquitetura.md @@ -18,7 +18,7 @@ graph TD subgraph "Rede Privada VPN (10.99.0.0/24)" VPS1["🖥️ VPS 1 (Produção)
IP: 10.99.0.1
(Traefik / Apps)"] VPS3["🗄️ VPS 3 (Banco de Dados)
IP: 10.99.0.3
(PostgreSQL Dedicado)"] - VPS4["🧪 VPS 4 (Desenvolvimento)
IP: 10.99.0.4
(Staging / Builds)"] + VPS4["🧪 VPS 4 (Desenvolvimento)
IP: 10.99.0.4
(Dev / Builds)"] VPS5["💬 VPS 5 (CRM WhatsApp)
IP: 10.99.0.5
(Bots / APIs)"] end @@ -77,15 +77,15 @@ graph TD --- -### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Staging) -* **Função Principal**: Testar novos recursos, hospedar containers de staging e realizar builds de desenvolvimento. +### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Dev) +* **Função Principal**: Testar novos recursos, hospedar containers de dev e realizar builds de desenvolvimento. * **IP Privado VPN**: `10.99.0.4` * **Políticas do Firewall (UFW)**: * **Porta 22 (SSH)**: **Bloqueada publicamente**. Apenas acessível via VPN. * **Portas de teste (ex: 3002, 8080)**: **Bloqueadas publicamente** ou atreladas apenas ao IP privado da VPN para acesso exclusivo dos desenvolvedores autorizados. * **Tecnologias**: Docker, Docker Compose, PostgreSQL 18 (Standby Replica em Container). * **Vantagens de Segurança & Performance**: - * **Replicação Streaming Real-Time (Staging)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal. + * **Replicação Streaming Real-Time (Dev)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal. * **Isolamento de Riscos**: Compilações de código (`npm run build`, `docker build`) e testes pesados de carga rodam aqui e consomem CPU sem comprometer os servidores de produção e banco de dados. * **Ambiente Espelho**: Homologação idêntica à produção para validações precisas antes de aplicar modificações em produção. @@ -205,15 +205,15 @@ graph TD A rede VPN WireGuard (`10.99.0.0/24`) deixa de ser tratada como uma zona de confiança irrestrita. Implementa-se uma política de privilégio mínimo na comunicação entre os servidores da VPN. * **O Problema de Movimentação Lateral**: - Se a máquina de desenvolvimento/staging (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados. + Se a máquina de desenvolvimento/dev (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados. * **Regras de Isolamento Lateral (Exemplo no Firewall da VPS 3)**: ```text # Bloquear por padrão toda conexão vinda da VPN exceto as estritamente autorizadas: - Permitir VPS 1 (Produção) -> Porta 5432 (PostgreSQL) [ACEITAR] - Permitir VPS 5 (CRM) -> Porta 5432 (PostgreSQL) [ACEITAR] - - Permitir VPS 4 (Staging) -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR] - - Permitir VPS 4 (Staging) -> VPS 3 (Produção - Outras portas / serviços) [BLOQUEAR] + - Permitir VPS 4 (Dev) -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR] + - Permitir VPS 4 (Dev) -> VPS 3 (Produção - Outras portas / serviços) [BLOQUEAR] ``` * **🌐 DNS e Acesso Seguro à Internet no WireGuard**: diff --git a/instrucoes/arquitetura.md b/instrucoes/arquitetura.md index c2114ba..739dc84 100644 --- a/instrucoes/arquitetura.md +++ b/instrucoes/arquitetura.md @@ -18,7 +18,7 @@ graph TD subgraph "Rede Privada VPN (10.99.0.0/24)" VPS1["🖥️ VPS 1 (Produção)
IP: 10.99.0.1
(Traefik / Apps)"] VPS3["🗄️ VPS 3 (Banco de Dados)
IP: 10.99.0.3
(PostgreSQL Dedicado)"] - VPS4["🧪 VPS 4 (Desenvolvimento)
IP: 10.99.0.4
(Staging / Builds)"] + VPS4["🧪 VPS 4 (Desenvolvimento)
IP: 10.99.0.4
(Dev / Builds)"] VPS5["💬 VPS 5 (CRM WhatsApp)
IP: 10.99.0.5
(Bots / APIs)"] end @@ -77,15 +77,15 @@ graph TD --- -### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Staging) -* **Função Principal**: Testar novos recursos, hospedar containers de staging e realizar builds de desenvolvimento. +### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Dev) +* **Função Principal**: Testar novos recursos, hospedar containers de dev e realizar builds de desenvolvimento. * **IP Privado VPN**: `10.99.0.4` * **Políticas do Firewall (UFW)**: * **Porta 22 (SSH)**: **Bloqueada publicamente**. Apenas acessível via VPN. * **Portas de teste (ex: 3002, 8080)**: **Bloqueadas publicamente** ou atreladas apenas ao IP privado da VPN para acesso exclusivo dos desenvolvedores autorizados. * **Tecnologias**: Docker, Docker Compose, PostgreSQL 18 (Standby Replica em Container). * **Vantagens de Segurança & Performance**: - * **Replicação Streaming Real-Time (Staging)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal. + * **Replicação Streaming Real-Time (Dev)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal. * **Isolamento de Riscos**: Compilações de código (`npm run build`, `docker build`) e testes pesados de carga rodam aqui e consomem CPU sem comprometer os servidores de produção e banco de dados. * **Ambiente Espelho**: Homologação idêntica à produção para validações precisas antes de aplicar modificações em produção. @@ -205,15 +205,15 @@ graph TD A rede VPN WireGuard (`10.99.0.0/24`) deixa de ser tratada como uma zona de confiança irrestrita. Implementa-se uma política de privilégio mínimo na comunicação entre os servidores da VPN. * **O Problema de Movimentação Lateral**: - Se a máquina de desenvolvimento/staging (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados. + Se a máquina de desenvolvimento/dev (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados. * **Regras de Isolamento Lateral (Exemplo no Firewall da VPS 3)**: ```text # Bloquear por padrão toda conexão vinda da VPN exceto as estritamente autorizadas: - Permitir VPS 1 (Produção) -> Porta 5432 (PostgreSQL) [ACEITAR] - Permitir VPS 5 (CRM) -> Porta 5432 (PostgreSQL) [ACEITAR] - - Permitir VPS 4 (Staging) -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR] - - Permitir VPS 4 (Staging) -> VPS 3 (Produção - Outras portas / serviços) [BLOQUEAR] + - Permitir VPS 4 (Dev) -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR] + - Permitir VPS 4 (Dev) -> VPS 3 (Produção - Outras portas / serviços) [BLOQUEAR] ``` --- diff --git a/newwhats.clube67.com/newwhats.local/arquitetura.md b/newwhats.clube67.com/newwhats.local/arquitetura.md index c2114ba..739dc84 100644 --- a/newwhats.clube67.com/newwhats.local/arquitetura.md +++ b/newwhats.clube67.com/newwhats.local/arquitetura.md @@ -18,7 +18,7 @@ graph TD subgraph "Rede Privada VPN (10.99.0.0/24)" VPS1["🖥️ VPS 1 (Produção)
IP: 10.99.0.1
(Traefik / Apps)"] VPS3["🗄️ VPS 3 (Banco de Dados)
IP: 10.99.0.3
(PostgreSQL Dedicado)"] - VPS4["🧪 VPS 4 (Desenvolvimento)
IP: 10.99.0.4
(Staging / Builds)"] + VPS4["🧪 VPS 4 (Desenvolvimento)
IP: 10.99.0.4
(Dev / Builds)"] VPS5["💬 VPS 5 (CRM WhatsApp)
IP: 10.99.0.5
(Bots / APIs)"] end @@ -77,15 +77,15 @@ graph TD --- -### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Staging) -* **Função Principal**: Testar novos recursos, hospedar containers de staging e realizar builds de desenvolvimento. +### 🧪 3. VPS 4: Servidor de Desenvolvimento e Homologação (Dev) +* **Função Principal**: Testar novos recursos, hospedar containers de dev e realizar builds de desenvolvimento. * **IP Privado VPN**: `10.99.0.4` * **Políticas do Firewall (UFW)**: * **Porta 22 (SSH)**: **Bloqueada publicamente**. Apenas acessível via VPN. * **Portas de teste (ex: 3002, 8080)**: **Bloqueadas publicamente** ou atreladas apenas ao IP privado da VPN para acesso exclusivo dos desenvolvedores autorizados. * **Tecnologias**: Docker, Docker Compose, PostgreSQL 18 (Standby Replica em Container). * **Vantagens de Segurança & Performance**: - * **Replicação Streaming Real-Time (Staging)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal. + * **Replicação Streaming Real-Time (Dev)**: Hospeda um container PostgreSQL 18 configurado como réplica de leitura (Standby) do banco de dados nativo de produção da VPS 3. Isso permite testar queries pesadas e validar migrações com dados reais em tempo de desenvolvimento de forma 100% segura e com zero impacto no banco principal. * **Isolamento de Riscos**: Compilações de código (`npm run build`, `docker build`) e testes pesados de carga rodam aqui e consomem CPU sem comprometer os servidores de produção e banco de dados. * **Ambiente Espelho**: Homologação idêntica à produção para validações precisas antes de aplicar modificações em produção. @@ -205,15 +205,15 @@ graph TD A rede VPN WireGuard (`10.99.0.0/24`) deixa de ser tratada como uma zona de confiança irrestrita. Implementa-se uma política de privilégio mínimo na comunicação entre os servidores da VPN. * **O Problema de Movimentação Lateral**: - Se a máquina de desenvolvimento/staging (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados. + Se a máquina de desenvolvimento/dev (VPS 4) for comprometida por um script malicioso, o atacante não pode ter permissão para escaneá-la ou conectar-se ao banco de dados de produção (VPS 3), exceto para o fluxo estritamente necessário de replicação de dados. * **Regras de Isolamento Lateral (Exemplo no Firewall da VPS 3)**: ```text # Bloquear por padrão toda conexão vinda da VPN exceto as estritamente autorizadas: - Permitir VPS 1 (Produção) -> Porta 5432 (PostgreSQL) [ACEITAR] - Permitir VPS 5 (CRM) -> Porta 5432 (PostgreSQL) [ACEITAR] - - Permitir VPS 4 (Staging) -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR] - - Permitir VPS 4 (Staging) -> VPS 3 (Produção - Outras portas / serviços) [BLOQUEAR] + - Permitir VPS 4 (Dev) -> Porta 5432 (PostgreSQL - Apenas 'replicator') [ACEITAR] + - Permitir VPS 4 (Dev) -> VPS 3 (Produção - Outras portas / serviços) [BLOQUEAR] ``` --- diff --git a/vpn-setup.md b/vpn-setup.md index 2a66f98..6c7f9bf 100644 --- a/vpn-setup.md +++ b/vpn-setup.md @@ -145,7 +145,7 @@ Definimos o **`MTU = 1360`** (ou `1280` para máxima resiliência) em todos os a ``` *Reinicie o serviço:* `sudo systemctl restart wg-quick@wg0` -3. **Nas VPSs 4 e 5 (Staging e CRM - REQUER APLICAR):** +3. **Nas VPSs 4 e 5 (Dev e CRM - REQUER APLICAR):** Repita o mesmo procedimento adicionando `MTU = 1360` sob `[Interface]` em seus respectivos `/etc/wireguard/wg0.conf` e reinicie a interface. > [!TIP]