From cf24856bb09e4749f96af975da60d84c1d9baacc Mon Sep 17 00:00:00 2001
From: Victor <vhiago26@gmail.com>
Date: Sun, 7 Jun 2026 18:20:37 -0300
Subject: [PATCH] Documenta estrutura inicial do Victor Hub

---
 README.md                      | 21 +++++++++++++++++++++
 docs/01-visao-geral.md         | 26 ++++++++++++++++++++++++++
 docs/02-arquitetura.md         | 24 ++++++++++++++++++++++++
 docs/03-dns-cloudflare.md      | 26 ++++++++++++++++++++++++++
 docs/04-nginx-proxy-manager.md | 19 +++++++++++++++++++
 docs/05-portainer.md           | 13 +++++++++++++
 docs/06-n8n.md                 | 17 +++++++++++++++++
 docs/07-filebrowser.md         | 17 +++++++++++++++++
 docs/08-gitea.md               | 17 +++++++++++++++++
 docs/09-uptime-kuma.md         | 18 ++++++++++++++++++
 docs/10-tailscale.md           | 15 +++++++++++++++
 docs/11-backup.md              | 20 ++++++++++++++++++++
 docs/12-seguranca.md           | 17 +++++++++++++++++
 docs/13-recuperacao.md         | 22 ++++++++++++++++++++++
 14 files changed, 272 insertions(+)
 create mode 100644 README.md
 create mode 100644 docs/01-visao-geral.md
 create mode 100644 docs/02-arquitetura.md
 create mode 100644 docs/03-dns-cloudflare.md
 create mode 100644 docs/04-nginx-proxy-manager.md
 create mode 100644 docs/05-portainer.md
 create mode 100644 docs/06-n8n.md
 create mode 100644 docs/07-filebrowser.md
 create mode 100644 docs/08-gitea.md
 create mode 100644 docs/09-uptime-kuma.md
 create mode 100644 docs/10-tailscale.md
 create mode 100644 docs/11-backup.md
 create mode 100644 docs/12-seguranca.md
 create mode 100644 docs/13-recuperacao.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..706e814
--- /dev/null
+++ b/README.md
@@ -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.
diff --git a/docs/01-visao-geral.md b/docs/01-visao-geral.md
new file mode 100644
index 0000000..0985545
--- /dev/null
+++ b/docs/01-visao-geral.md
@@ -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.
diff --git a/docs/02-arquitetura.md b/docs/02-arquitetura.md
new file mode 100644
index 0000000..36c6fca
--- /dev/null
+++ b/docs/02-arquitetura.md
@@ -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.
diff --git a/docs/03-dns-cloudflare.md b/docs/03-dns-cloudflare.md
new file mode 100644
index 0000000..3a69702
--- /dev/null
+++ b/docs/03-dns-cloudflare.md
@@ -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.
diff --git a/docs/04-nginx-proxy-manager.md b/docs/04-nginx-proxy-manager.md
new file mode 100644
index 0000000..dfb8829
--- /dev/null
+++ b/docs/04-nginx-proxy-manager.md
@@ -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
diff --git a/docs/05-portainer.md b/docs/05-portainer.md
new file mode 100644
index 0000000..7d16b38
--- /dev/null
+++ b/docs/05-portainer.md
@@ -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.
diff --git a/docs/06-n8n.md b/docs/06-n8n.md
new file mode 100644
index 0000000..5cfaa2e
--- /dev/null
+++ b/docs/06-n8n.md
@@ -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
diff --git a/docs/07-filebrowser.md b/docs/07-filebrowser.md
new file mode 100644
index 0000000..d3bda12
--- /dev/null
+++ b/docs/07-filebrowser.md
@@ -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.
diff --git a/docs/08-gitea.md b/docs/08-gitea.md
new file mode 100644
index 0000000..7620e21
--- /dev/null
+++ b/docs/08-gitea.md
@@ -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.
diff --git a/docs/09-uptime-kuma.md b/docs/09-uptime-kuma.md
new file mode 100644
index 0000000..d39b957
--- /dev/null
+++ b/docs/09-uptime-kuma.md
@@ -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
diff --git a/docs/10-tailscale.md b/docs/10-tailscale.md
new file mode 100644
index 0000000..ad0fbe0
--- /dev/null
+++ b/docs/10-tailscale.md
@@ -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.
diff --git a/docs/11-backup.md b/docs/11-backup.md
new file mode 100644
index 0000000..adffdc6
--- /dev/null
+++ b/docs/11-backup.md
@@ -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.
diff --git a/docs/12-seguranca.md b/docs/12-seguranca.md
new file mode 100644
index 0000000..d9626c0
--- /dev/null
+++ b/docs/12-seguranca.md
@@ -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
diff --git a/docs/13-recuperacao.md b/docs/13-recuperacao.md
new file mode 100644
index 0000000..094c825
--- /dev/null
+++ b/docs/13-recuperacao.md
@@ -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