Documenta estrutura inicial do Victor Hub

2026-06-07 18:20:37 -03:00
commit cf24856bb0
14 changed files with 272 additions and 0 deletions
@@ -0,0 +1,21 @@
+# Victor Hub
+
+Documentacao oficial da VPS pessoal hubvictor.com.br.
+
+## Objetivo
+
+O Victor Hub e uma infraestrutura pessoal hospedada em uma VPS Oracle Ubuntu, organizada com Docker, Nginx Proxy Manager, Cloudflare, Tailscale, Gitea, n8n, FileBrowser, Uptime Kuma, Portainer e Homepage.
+
+## Servicos principais
+
+- Homepage: https://painel.hubvictor.com.br
+- Nginx Proxy Manager: https://proxy.hubvictor.com.br
+- Portainer: https://portainer.hubvictor.com.br
+- Uptime Kuma: https://status.hubvictor.com.br
+- n8n: https://n8n.hubvictor.com.br
+- FileBrowser: https://arquivos.hubvictor.com.br
+- Gitea: https://git.hubvictor.com.br
+
+## Observacao sobre a Wiki
+
+O BookStack foi desativado. A documentacao passou a ser mantida neste repositorio Gitea.
@@ -0,0 +1,26 @@
+# 01 - Visao Geral
+
+O Victor Hub e uma central pessoal de servicos em VPS.
+
+## Stack base
+
+- Ubuntu Server
+- Docker
+- Docker Compose
+- Nginx Proxy Manager
+- Cloudflare DNS
+- Registro.br
+- Tailscale
+
+## Servicos ativos
+
+- Homepage
+- Portainer
+- Uptime Kuma
+- n8n
+- FileBrowser
+- Gitea
+
+## Servico desativado
+
+- BookStack, substituido pela documentacao em Markdown no Gitea.
@@ -0,0 +1,24 @@
+# 02 - Arquitetura
+
+## Estrutura geral
+
+Internet -> Cloudflare DNS -> VPS Oracle -> Nginx Proxy Manager -> Containers Docker.
+
+## Diretorio principal
+
+/opt/victor-hub
+
+Subpastas principais:
+
+- stacks
+- data
+- backups
+- scripts
+- secrets
+- docs
+
+## Rede Docker principal
+
+Rede: proxy
+
+Servicos publicados por subdominio devem estar conectados a rede proxy.
@@ -0,0 +1,26 @@
+# 03 - DNS e Cloudflare
+
+## Dominio
+
+hubvictor.com.br
+
+## Nameservers no Registro.br
+
+- ara.ns.cloudflare.com
+- charles.ns.cloudflare.com
+
+## IP publico da VPS
+
+147.15.33.41
+
+## Subdominios ativos
+
+- painel.hubvictor.com.br
+- proxy.hubvictor.com.br
+- portainer.hubvictor.com.br
+- status.hubvictor.com.br
+- arquivos.hubvictor.com.br
+- n8n.hubvictor.com.br
+- git.hubvictor.com.br
+
+O subdominio wiki.hubvictor.com.br foi usado para BookStack, mas sera desativado ou redirecionado futuramente.
@@ -0,0 +1,19 @@
+# 04 - Nginx Proxy Manager
+
+## URL
+
+https://proxy.hubvictor.com.br
+
+## Funcao
+
+Gerenciar proxy reverso, certificados Let's Encrypt, subdominios e encaminhamento para containers.
+
+## Proxy Hosts ativos
+
+- painel.hubvictor.com.br -> homepage:3000
+- status.hubvictor.com.br -> uptime-kuma:3001
+- n8n.hubvictor.com.br -> n8n:5678
+- arquivos.hubvictor.com.br -> filebrowser:80
+- git.hubvictor.com.br -> gitea:3000
+- portainer.hubvictor.com.br -> portainer:9000
+- proxy.hubvictor.com.br -> nginx-proxy-manager:81
@@ -0,0 +1,13 @@
+# 05 - Portainer
+
+## URL
+
+https://portainer.hubvictor.com.br
+
+## Funcao
+
+Gerenciar containers, volumes, redes e stacks Docker pela interface visual.
+
+## Atencao
+
+Servico sensivel. Deve ter senha forte e protecao adicional.
@@ -0,0 +1,17 @@
+# 06 - n8n
+
+## URL
+
+https://n8n.hubvictor.com.br
+
+## Funcao
+
+Central de automacoes.
+
+## Banco
+
+Usa PostgreSQL proprio no container n8n-postgres.
+
+## Volume de dados
+
+/opt/victor-hub/stacks/06-n8n/n8n_data
@@ -0,0 +1,17 @@
+# 07 - FileBrowser
+
+## URL
+
+https://arquivos.hubvictor.com.br
+
+## Funcao
+
+Gerenciador web dos arquivos da VPS.
+
+## Diretorio exposto
+
+/opt/victor-hub/data
+
+## Atencao
+
+Servico sensivel. Nao armazenar documentos criticos sem politica de seguranca e backup.
@@ -0,0 +1,17 @@
+# 08 - Gitea
+
+## URL
+
+https://git.hubvictor.com.br
+
+## Funcao
+
+Git privado e documentacao oficial do Victor Hub.
+
+## Repositorio principal
+
+vhiago26/victor-hub-infra
+
+## Regra
+
+Nunca subir senhas, tokens, chaves SSH privadas ou arquivos .env com credenciais reais.
@@ -0,0 +1,18 @@
+# 09 - Uptime Kuma
+
+## URL
+
+https://status.hubvictor.com.br
+
+## Funcao
+
+Monitorar disponibilidade dos servicos.
+
+## Monitores recomendados
+
+- painel.hubvictor.com.br
+- proxy.hubvictor.com.br
+- portainer.hubvictor.com.br
+- n8n.hubvictor.com.br
+- arquivos.hubvictor.com.br
+- git.hubvictor.com.br
@@ -0,0 +1,15 @@
+# 10 - Tailscale
+
+## Funcao
+
+Rede privada para acesso seguro a VPS.
+
+## Consultar IP privado
+
+Comando:
+
+tailscale ip -4
+
+## Uso recomendado
+
+Futuramente, servicos administrativos podem ser restritos para acesso apenas via Tailscale.
@@ -0,0 +1,20 @@
+# 11 - Backup
+
+## Itens criticos
+
+- docker-compose.yml das stacks
+- .env.global
+- volumes do Gitea
+- banco do Gitea
+- dados do n8n
+- banco do n8n
+- dados do FileBrowser
+- configuracoes do Nginx Proxy Manager
+
+## Diretorio local de backups
+
+/opt/victor-hub/backups
+
+## Pendencia
+
+Criar rotina definitiva de backup com dumps de banco e copia externa.
@@ -0,0 +1,17 @@
+# 12 - Seguranca
+
+## Pontos sensiveis
+
+- proxy.hubvictor.com.br
+- portainer.hubvictor.com.br
+- n8n.hubvictor.com.br
+- arquivos.hubvictor.com.br
+- git.hubvictor.com.br
+
+## Pendencias
+
+- fechar portas diretas 81 e 9000
+- revisar regras da Oracle Cloud
+- aplicar Access List no Nginx Proxy Manager
+- revisar cadastros publicos
+- manter senhas fortes
@@ -0,0 +1,22 @@
+# 13 - Recuperacao
+
+## Ver containers
+
+docker ps -a
+
+## Ver logs
+
+docker logs nome-do-container --tail=100
+
+## Reiniciar uma stack
+
+cd /opt/victor-hub/stacks/NOME-DA-STACK
+docker compose restart
+
+## Subir uma stack
+
+docker compose up -d
+
+## Parar uma stack
+
+docker compose down