💡 Visão Geral da Arquitetura¶

Bem-vindo à seção de Visão Geral da Arquitetura! Após a implementação detalhada no Manual de Implementação, esta seção tem como objetivo fornecer um entendimento conceitual de como os diversos componentes do seu servidor doméstico se integram e operam em conjunto.

Objetivo¶

Aqui, exploraremos a lógica por trás das escolhas de design, o fluxo de dados e interações entre as principais tecnologias utilizadas:

• Fluxo de Rede e Acesso Externo Seguro: Como seus serviços são expostos à internet de forma segura.
• Virtualização com Proxmox VE: A base para hospedar seus serviços em máquinas virtuais isoladas.
• Estratégia de Armazenamento com ZFS e NFS: Como os dados são armazenados de forma resiliente e compartilhados.
• Automação da Infraestrutura com Ansible: O poder da Infraestrutura como Código para gerenciamento e repetibilidade.
• Gerenciamento de Containers com Docker e Portainer: Como as aplicações são empacotadas e executadas.
• Princípios de Segurança Aplicados: As camadas de segurança implementadas em toda a stack.
• Estratégia de APIs de LLM: Como combinar Ollama local, LiteLLM e provedores externos de forma coerente.
• Catálogo de Aplicações: Os fatos de cada aplicação (stack, exposição, dados, métricas) que guiam as integrações.
• Índice de Integrações: As integrações entre aplicações, com regras verificáveis e os passos para adicionar ou remover.

Esta seção é ideal para quem deseja entender o "porquê" das escolhas de arquitetura e como os diferentes sistemas colaboram, sem necessariamente se aprofundar nos comandos exatos de implementação (que já foram cobertos no manual).

Componentes Chave e Suas Interações¶

A arquitetura do nosso servidor doméstico é composta por várias camadas e tecnologias que trabalham em harmonia:

graph LR
    subgraph "Camada de Acesso Externo"
        Internet[Internet / Usuário] --> CF[Cloudflare]
        CF --> CFT[Cloudflare Tunnel]
    end

    subgraph "Camada de Rede e Segurança Interna"
        CFT --> Traefik[Traefik Proxy Reverso]
        Traefik --> Authelia[Authelia 2FA]
        Authelia --> Traefik
    end

    subgraph "Camada de Aplicações (Docker na core-services-vm)"
        Traefik --> AppDocker[Serviços Docker: Nextcloud, Jellyfin, etc.]
        AppDocker -- Dados Persistentes --> NFS_Mount_VM[Montagem NFS na VM]
    end

    subgraph "Camada de Virtualização e Host"
        Proxmox[Host Proxmox VE] --> CoreVM[VM: core-services-vm]
        Proxmox --> AiVM[VM: ai-desktop-vm (Opcional)]
        NFS_Server_Host[Servidor NFS no Host Proxmox] --> NFS_Mount_VM
        ZFS[Pool ZFS /data nos HDDs] --> NFS_Server_Host
    end

    subgraph "Camada de Gerenciamento e Automação"
        Ansible[Máquina de Controle Ansible] -.-> Proxmox
        Ansible -.-> CoreVM
        Ansible -.-> AiVM
        Portainer[Portainer na core-services-vm] -- Gerencia --> DockerHost[Docker Engine na VM]
        DockerHost -- Executa --> AppDocker
    end

    style Internet fill:#cde,stroke:#333
    style CF fill:#f90,stroke:#333
    style Proxmox fill:#e96900,stroke:#333,color:#fff
    style Ansible fill:#ee0000,stroke:#333,color:#fff
    style AppDocker fill:#2496ed,stroke:#333,color:#fff

Navegue pelas subseções para um mergulho mais profundo em cada um desses aspectos da arquitetura.