Nova documentação da Zima: da configuração do ZimaOS às aplicações, hardware, ferramentas para programadores e comunidade

Um servidor doméstico raramente permanece como era no primeiro dia. Começa por colocar o sistema online, depois adiciona armazenamento, transfere os seus ficheiros, instala algumas aplicações, experimenta o acesso remoto e, eventualmente, dá por si a comparar níveis de RAID, a executar o Jellyfin, a fazer cópias de segurança de fotografias, a testar IA local ou a ler sobre ZFS tarde numa noite de domingo.

Foi por isso que reconstruímos a documentação da ZimaSpace em torno daquilo que as pessoas realmente tentam fazer. Em vez de tratar a documentação como um manual longo, a nova estrutura oferece cinco percursos de aprendizagem claros: ZimaOS, App Store, Hardware, Programador e Centro de Ajuda. E, quando o percurso documentado não é suficiente, a Comunidade ZimaSpace oferece outro espaço para comparar configurações, fazer perguntas, partilhar soluções e ver o que outros utilizadores estão a construir.

Para a maioria dos utilizadores novos, o percurso começa naturalmente com o ZimaOS, passa para as aplicações quando o básico já funciona e ramifica-se para o hardware ou para as ferramentas de desenvolvimento à medida que a configuração se torna mais ambiciosa. Mas não existe uma ordem obrigatória: se está aqui por causa do Jellyfin, avance diretamente para a App Store; se precisa de ZFS ou SSH, vá diretamente para Programador; se algo já deixou de funcionar, comece pelo Centro de Ajuda; e, se a sua configuração não corresponder exatamente a um guia formal, a Comunidade é muitas vezes o próximo lugar a consultar.

1. ZimaOS: Comece pela base

A documentação do ZimaOS é o melhor ponto de partida se a sua principal questão for pôr o sistema operativo, o armazenamento, os dados, as cópias de segurança e o acesso diário a funcionar corretamente.

Esta parte da documentação segue o ciclo de vida natural de um servidor doméstico, em vez de tratar cada funcionalidade como um tutorial isolado: pôr o sistema a funcionar, organizar o armazenamento, trazer os seus dados, tornar esses dados acessíveis e, em seguida, aprender a manter o servidor.

Visão geral

A Visão geral do ZimaOS funciona como porta de entrada para toda a secção. Se ainda não tiver a certeza de qual é o guia de que precisa, comece aqui. Liga a configuração, o armazenamento, as cópias de segurança, a partilha de ficheiros, a instalação e a gestão do sistema, para que possa avançar rapidamente para o problema que está realmente a tentar resolver.

Para um sistema completamente novo, o guia Começar a utilizar o ZimaOS é o caminho mais direto. Explica a primeira ligação, o ZimaClient, a criação da conta e o ambiente básico que irá utilizar posteriormente.

Configuração e Armazenamento

Se o servidor for novo, dedique algum tempo a esta parte antes de instalar dez aplicações só porque parecem interessantes.

A Configuração e Armazenamento abrangem as decisões que se tornam mais difíceis de alterar posteriormente: compreender a interface do ZimaOS, escolher unidades, criar armazenamento, comparar opções de RAID e decidir onde devem ficar os dados das aplicações.

O guia de configuração do armazenamento do ZimaOS é particularmente útil se estiver a decidir entre um sistema simples com um único disco, armazenamento redundante para ficheiros importantes, uma biblioteca multimédia maior ou armazenamento para um servidor doméstico sempre ligado.

Definir corretamente a disposição do armazenamento desde o início torna quase tudo o que vem depois mais fácil.

Sincronização e Cópias de Segurança

Assim que o servidor estiver a funcionar, a pergunta seguinte normalmente não é sobre o próprio servidor. É sobre os seus dados: como é que ponho realmente tudo o que tenho lá?

A Sincronização e as Cópias de Segurança reúnem esses caminhos de migração. Esta parte da documentação aborda cópias de segurança do telemóvel, cópias de segurança do computador, ligações a unidades na nuvem, migração de dados de outro NAS, transferência de ficheiros entre unidades, o Time Machine e fluxos de trabalho de cópia de segurança mais abrangentes.

As fotografias são frequentemente um dos primeiros grandes conjuntos de dados pessoais que as pessoas transferem para um servidor doméstico. Se quiser criar uma biblioteca privada de fotografias, o guia de cópia de segurança de fotografias do Immich oferece uma forma prática de começar a fazer cópias de segurança e a gerir fotografias no ZimaOS.

Quer esteja a transferir algumas centenas de fotografias do telemóvel ou a substituir gradualmente um NAS antigo ou um fluxo de trabalho baseado no armazenamento na nuvem, não precisa de migrar tudo num único fim de semana. Mova uma fonte de cada vez e crie o sistema de cópias de segurança em torno dos dados de que realmente se importa.

Acesso e partilha

Um NAS ao qual só é possível aceder quando está sentado ao lado dele não é propriamente entusiasmante.

A secção Acesso e partilha é onde o ZimaOS começa a ligar o servidor ao resto dos seus dispositivos. A secção abrange o ZimaClient, o acesso remoto, a partilha de ficheiros SMB, as ligações de partilha e as configurações Samba multiutilizador.

Se estiver a ligar um computador ou telemóvel pela primeira vez, o guia de instalação do ZimaClient é um bom ponto de partida.

A partir daí, pense no acesso com base na situação: partilha local de ficheiros para computadores em casa, acesso remoto quando está fora de casa ou ferramentas de partilha quando outra pessoa só precisa de ficheiros ou pastas específicos.

Métodos de instalação

O ZimaOS não está limitado a um único método de instalação.

Se estiver a instalar o sistema por sua conta, o guia Como instalar o ZimaOS explica como criar o suporte de instalação, iniciar o dispositivo, instalar o sistema operativo e aceder ao sistema posteriormente.

Esta secção é especialmente útil para quem cria servidores domésticos DIY com hardware x86-64 compatível, bem como para utilizadores que experimentam o Proxmox, migram do CasaOS ou tratam de outras tarefas relacionadas com a instalação e as contas.

Sistema

Provavelmente, não abrirá a secção Sistema todos os dias. E isso é bom.

Quando um servidor passa a fazer parte do seu fluxo de trabalho diário, a fiabilidade torna-se mais importante do que a configuração. A secção Sistema aborda o lado menos glamoroso, mas importante, da utilização do ZimaOS, incluindo proteção contra falhas de energia, recuperação, instalação offline, reposições de rede, pesquisa e outras tarefas de manutenção.

Estes não são necessariamente os primeiros guias que irá ler, mas poderá ficar contente por saber que existem antes do dia em que realmente precisar deles.

2. App Store: decida o que quer que o seu servidor faça

Colocar o armazenamento online é satisfatório. Instalar a primeira aplicação útil é normalmente quando um servidor doméstico começa a parecer o seu servidor doméstico.

A documentação da loja de aplicações do ZimaOS está organizada em torno de cargas de trabalho, e não dos mecanismos de instalação.

Em vez de começar pela pergunta “Como configuro o Docker?”, esta parte do mapa de aprendizagem começa num ponto mais útil: O que quer que o seu servidor faça?

Servidor Multimédia

Este é um dos pontos mais fáceis para começar com o autoalojamento. Um servidor doméstico pode tornar-se uma biblioteca privada de filmes, televisão, música, fotografias e outros conteúdos multimédia que permanecem sob o seu controlo.

A secção Servidor Multimédia reúne Jellyfin, Plex, Emby, Immich, serviços DLNA, servidores de câmaras, migração de fotografias e cargas de trabalho multimédia assistidas por GPU.

Se o Jellyfin for o seu primeiro projeto de servidor, o guia de configuração de um servidor multimédia Jellyfin proporciona um caminho direto para criar uma biblioteca de streaming privada.

Se a sua primeira ideia para um servidor doméstico se parece mais com “Quero ter o meu próprio Netflix” ou “Quero tirar as minhas fotografias de uma subscrição na nuvem”, esta é a primeira parte da documentação que deve explorar.

Aplicações Autoalojadas

Depois do servidor multimédia vem a parte perigosa: perceber que pode alojar quase tudo por si próprio.

Esta secção abrange ferramentas para sincronização de ficheiros, bloqueio de anúncios em toda a rede, gestão de documentos, automatização de transferências, monitorização, gestão de multimédia e outros serviços que normalmente estariam algures na nuvem.

Não precisa de ter vinte contentores logo no primeiro dia. Escolha um problema que queira que o seu servidor resolva, faça esse fluxo de trabalho funcionar e, depois, adicione o serviço seguinte.

IA e Aprendizagem Automática

A IA local tornou-se rapidamente mais uma razão para manter um servidor capaz a funcionar em casa.

A secção IA e Aprendizagem Automática centra-se em cargas de trabalho nas quais modelos, documentos, fotografias ou agentes podem funcionar perto dos seus próprios dados. O percurso de aprendizagem inclui a implementação de modelos locais, pesquisa com IA, modelos offline, inteligência aplicada a fotografias e agentes de IA sempre ativos.

Se tem interesse em IA privada, LLMs locais ou agentes que precisam de acesso contínuo aos ficheiros armazenados no seu servidor, esta é a área que deve seguir.

Construções Criativas

Nem todos os projetos de servidores domésticos têm de melhorar a produtividade. Por vezes, só quer construir algo porque pode.

Creative Builds reúne projetos mais experimentais, como servidores de jogos, jogos retro, configurações relacionadas com RV, experiências de virtualização, lojas de aplicações da comunidade e outros projetos que ficam algures entre um homelab e um passatempo de fim de semana.

Para os utilizadores de homelab, é muitas vezes aqui que um projeto se transforma discretamente em mais três.

Recursos para programadores

Mais cedo ou mais tarde, alguns utilizadores deparam-se com o mesmo problema: a aplicação que procuram ainda não existe na loja.

Os Recursos para programadores constituem o passo seguinte para quem quer criar e publicar aplicações por conta própria, estabelecendo uma ponte natural entre a utilização da App Store e a contribuição para o ecossistema que está por detrás dela.

3. Hardware: compreender a máquina por baixo do software

Os guias de software respondem a muitas perguntas até que a questão passe a ser: “Qual é essa porta?” ou “Esta máquina pode receber outra unidade, placa de rede, GPU ou sistema operativo?”

É aí que entra a documentação de Hardware.

Visão geral

A visão geral do hardware reúne as principais famílias de dispositivos Zima e permite perceber rapidamente qual o percurso da documentação que corresponde ao hardware que tem à sua frente.

A ZimaCube foi concebida para cargas de trabalho maiores e orientadas para NAS, armazenamento, multimédia e expansão. A ZimaBoard adapta-se a servidores domésticos compactos, redes, autoalojamento e experimentação de hardware. A ZimaBlade oferece um ponto de entrada mais pequeno para projetos DIY de NAS e servidores.

Assim que souber com que família está a trabalhar, o resto da secção Hardware torna-se muito mais fácil de consultar.

ZimaCube

O percurso da ZimaCube destina-se a utilizadores que trabalham com um NAS maior e um sistema orientado para a expansão.

Os guias vão além da configuração inicial e abrangem interfaces de hardware, armazenamento adicional, expansão por GPU, expansão por SSD, configuração da BIOS, redes, Thunderbolt, refrigeração, Wake-on-LAN e outras funcionalidades específicas do dispositivo.

Utilize esta secção quando a pergunta já não for simplesmente “Como utilizo o ZimaOS?”, mas sim “O que pode fazer esta configuração de hardware específica?”

ZimaBoard 2

A ZimaBoard 2 é o ramo compacto e orientado para a expansão do mapa de hardware. Foi concebida para utilizadores que gostam de experimentar com servidores domésticos, redes, autoalojamento, armazenamento e configurações de hardware personalizadas.

Se acabou de retirar a placa da caixa, comece pelo guia de introdução à ZimaBoard 2. Este guia proporciona um ponto de partida claro para a configuração do hardware antes de avançar para o armazenamento, as redes, as aplicações, a refrigeração ou a expansão PCIe.

A partir daí, a documentação da ZimaBoard aborda as interfaces de hardware, os passos para ligar o dispositivo, a expansão, a refrigeração, a configuração de ventoinhas PWM e os detalhes práticos para integrar a placa num projeto de homelab maior.

Isso torna a mesma placa adequada para utilizações muito diferentes: um NAS compacto, um servidor multimédia, um anfitrião Docker, um dispositivo de rede, um nó de virtualização ou outro serviço autoalojado sempre ligado.

ZimaBlade

O ZimaBlade mantém o percurso de hardware mais simples e proporciona um ponto de entrada acessível para servidores DIY.

A respetiva documentação centra-se sobretudo em pôr o hardware a funcionar, compreender a configuração básica e preparar o sistema antes de começar a adicionar aplicações e serviços.

Compatibilidade

Os servidores domésticos raramente existem isoladamente. Unidades, UPS, adaptadores de rede, módulos Wi-Fi, placas de expansão e outros acessórios tornam-se gradualmente parte do sistema.

A secção Compatibilidade responde à questão prática de saber o que foi testado e como deve ser configurado um determinado hardware.

Tem uma função muito simples: ajudar a responder à pergunta «Isto funciona com a minha configuração?» antes de passar uma tarde a tentar perceber porque não funciona.

Sistemas de terceiros

O hardware Zima não está bloqueado a um único sistema operativo.

Se o seu projeto exigir Unraid, TrueNAS, OpenWrt, OpenMediaVault, Ubuntu Server, Arch Linux ou outro ambiente, a secção Sistemas de terceiros fornece um caminho para implementações alternativas.

Isto significa que a documentação do hardware continua a ser útil mesmo quando o seu projeto acaba por crescer para além do próprio ZimaOS.

4. Programador: aprofunde os conhecimentos quando as predefinições já não forem suficientes

A maioria das pessoas não precisa de começar aqui — e esse é precisamente o objetivo.

A documentação para programadores destina-se ao momento em que as predefinições convenientes deixam de ser suficientes e pretende ter mais controlo sobre o sistema subjacente.

Visão geral

A Visão geral para programadores é o ramo avançado do mapa de aprendizagem para utilizadores avançados, criadores de homelabs, programadores e qualquer pessoa que queira ir além da interface padrão do ZimaOS.

Se já sabe o que procura — ZFS, SSH, APIs, aplicações personalizadas ou redes mais avançadas — não precisa de começar pelos guias para principiantes. Comece aqui.

Armazenamento e Sistema de Ficheiros

Esta secção vai além da configuração quotidiana dos discos e aborda tecnologias como ZFS, configurações RAID avançadas, NFS, iSCSI, armazenamento encriptado, rsync, processos de recuperação e ligações a outros sistemas NAS.

Se Configuração e Armazenamento, na secção do ZimaOS, responde a «Como devo configurar as minhas unidades?», a secção Armazenamento para programadores começa a responder a uma pergunta diferente: «Como funciona a pilha de armazenamento e até que ponto posso controlá-la?»

Rede e Protocolos

À medida que um homelab cresce, a rede passa a fazer parte do projeto, em vez de ser algo que simplesmente acontece em segundo plano.

Rede e Protocolos abrange a configuração de rede, o acesso por SSH, as definições avançadas de SSH, o desempenho das transferências e os protocolos utilizados para ligar o ZimaOS a outras máquinas.

Esta é a próxima paragem natural quando começa a trabalhar com vários servidores, redes mais rápidas, shells remotas ou configurações de rede mais avançadas.

Desenvolvimento

Este ramo destina-se a criar soluções sobre o próprio sistema.

Para os utilizadores que querem automatizar o seu servidor ou contribuir para o ecossistema, a secção de Desenvolvimento abrange ambientes de scripting, fluxos de trabalho de contribuição e desenvolvimento orientado pela comunidade.

Mesmo que não esteja a criar uma aplicação completa, um pequeno script pode tornar-se surpreendentemente útil quando o poupa de repetir a mesma tarefa administrativa todas as semanas.

Desenvolvimento da App Store

Executar aplicações e criar aplicações são duas etapas diferentes da mesma jornada.

O Desenvolvimento da App Store destina-se a pessoas que querem empacotar aplicações Docker, publicá-las para os utilizadores do ZimaOS, criar catálogos de aplicações, trabalhar com metadados do Docker Compose, gerir recursos e localizações ou automatizar fluxos de trabalho de publicação de aplicações.

Se a secção da App Store é o recreio, esta é a oficina por detrás dela.

API do ZimaOS

Quando clicar manualmente nos botões já não é suficiente, a API torna-se a camada seguinte.

A secção da API do ZimaOS proporciona acesso ao controlo programático, à autenticação, às integrações, aos endpoints disponíveis e a ferramentas para explorar como outras aplicações podem comunicar com o ZimaOS.

Isso abre caminho a scripts personalizados, painéis, ferramentas de gestão e integrações criados para o seu próprio ambiente de servidor doméstico.

Registo de versões

A área de Desenvolvimento também mantém o histórico de versões do ZimaOS junto da documentação técnica.

Isso torna-se útil quando o comportamento muda entre versões, quando quer saber quando uma funcionalidade foi introduzida ou quando um guia depende de funcionalidades introduzidas numa versão mais recente do ZimaOS.

5. Centro de Ajuda: comece pelo sintoma

Por vezes, não quer aprender um novo protocolo de armazenamento. Só quer que a máquina volte a arrancar.

O Centro de Ajuda da ZimaSpace é deliberadamente o caminho mais curto do mapa. Em vez de exigir que compreenda primeiro a causa principal, permite-lhe começar pelo problema que consegue realmente observar.

Visão geral

Se chegou aqui, é bastante provável que algo já não esteja a funcionar como esperava.

O Centro de Ajuda orienta os utilizadores para material de resolução de problemas e de referência, em vez de os obrigar a pesquisar todos os guias de configuração para decidir se o problema diz respeito a software, armazenamento, rede ou hardware.

Resolução de problemas

Se o dispositivo não arrancar, a criação de RAID falhar, uma ligação de rede desaparecer, for necessário testar a memória, a BIOS precisar de atenção ou uma ligação de hardware não funcionar, comece aqui.

O percurso de resolução de problemas foi concebido para encurtar a distância entre:

“Há algo de errado” → “Isto parece ser o meu problema” → “Eis o que deve verificar.”

Normalmente, isso é mais útil do que esperar que alguém saiba se um problema pertence ao sistema operativo, à camada de armazenamento, à pilha de rede ou ao hardware antes de começar a procurar ajuda.

Referência

Nem todas as páginas úteis precisam de ser um guia passo a passo.

A área de Referência reúne informações de apoio e material técnico que os utilizadores podem precisar de consultar ocasionalmente, sem seguir um tutorial completo.

Comunidade: quando a documentação é apenas o início

A documentação funciona melhor quando o problema já tem uma resposta clara. Os servidores domésticos nem sempre colaboram.

Talvez a sua configuração combine uma placa de rede, um controlador de armazenamento, uma stack Docker e uma versão do sistema operativo para os quais não foi criado nenhum guia específico. Talvez queira saber como outro utilizador resolveu o mesmo problema de armazenamento do Immich. Ou talvez tenha criado algo suficientemente útil para que outras pessoas devam saber da sua existência.

É aí que a Comunidade ZimaSpace se torna a próxima camada do mapa de aprendizagem.

A Comunidade reúne vários tipos de conhecimento que são difíceis de captar numa documentação estática:

• Resolução de problemas reais: veja como outros utilizadores diagnosticam problemas invulgares do ZimaOS, de aplicações, de armazenamento, de rede e de hardware.
• Tutoriais da comunidade: descubra fluxos de trabalho e configurações criados por pessoas que utilizam o ZimaOS nos seus próprios ambientes.
• Experiências com hardware: compare placas de expansão, configurações de rede, configurações de armazenamento, projetos de virtualização e outras montagens de homelab.
• Feedback e ideias: sugira funcionalidades, comunique problemas e discuta como o ZimaOS e o hardware Zima podem melhorar.
• Anúncios: acompanhe os lançamentos do ZimaOS, as atualizações de produtos, os projetos da comunidade e outras alterações em todo o ecossistema.

Uma regra simples é útil: use a Documentação quando precisar do caminho estabelecido; use a Comunidade quando quiser ver como outras pessoas o estão a percorrer na prática.

Se não conseguir encontrar imediatamente a resposta, volte à página inicial da documentação do ZimaSpace ou continue a conversa na Comunidade ZimaSpace.

Perguntas frequentes: como encontrar o seu caminho na nova documentação do ZimaSpace

Por onde deve começar um novo utilizador do ZimaOS?

Comece pelo guia Começar a utilizar o ZimaOS. A partir daí, o percurso natural passa normalmente por Configuração e armazenamento, Sincronização e cópia de segurança e Acesso e partilha, antes de começar a adicionar mais aplicações.

Preciso de ler as cinco secções da documentação pela ordem?

Não. A documentação funciona melhor como um mapa do que como um livro. Um novo utilizador pode começar pelo ZimaOS, enquanto um utilizador experiente de homelab que procura ZFS ou SSH pode aceder diretamente à documentação para desenvolvedores. Se algo já estiver avariado, comece pelo Centro de Ajuda.

Onde posso encontrar guias sobre armazenamento e RAID do ZimaOS?

Para o planeamento normal do armazenamento, comece pelo guia de configuração do armazenamento do ZimaOS. Para temas mais avançados, como ZFS, RAID avançado, NFS ou iSCSI, continue em Desenvolvedor → Armazenamento e sistema de ficheiros.

Onde devo procurar o Jellyfin, o Plex, o Immich ou outras aplicações autoalojadas?

Comece pela documentação da App Store. A secção Servidor multimédia abrange serviços como Jellyfin, Plex, Emby, Immich, DLNA e fluxos de trabalho multimédia relacionados, enquanto Aplicações autoalojadas abrange uma gama mais vasta de serviços.

Onde estão os guias de IA local?

Abra a documentação da App Store e consulte a secção IA e aprendizagem automática. Esta reúne modelos locais, pesquisa com IA, funcionalidades inteligentes para fotografias, fluxos de trabalho de IA offline e projetos de agentes.

Por onde devo começar com o ZimaBoard 2?

Comece pelo guia de iniciação do ZimaBoard 2. A partir daí, pode avançar para armazenamento, redes, expansão, refrigeração, ZimaOS ou sistemas de terceiros, consoante o que pretende construir.

Posso instalar o ZimaOS no meu próprio hardware x86?

Sim. O guia Como instalar o ZimaOS explica o processo de instalação para hardware x86-64 compatível, sendo útil tanto para projetos DIY de NAS e servidores domésticos como para hardware Zima.

Posso instalar outro sistema operativo no hardware Zima?

Sim. A documentação de hardware inclui uma secção sobre sistemas de terceiros para utilizadores que experimentam sistemas operativos alternativos para NAS, Linux ou redes.

Onde encontro documentação sobre API, SSH, ZFS ou redes avançadas?

Aceda diretamente à documentação para programadores. É o ramo avançado para armazenamento, redes, desenvolvimento, desenvolvimento da App Store e a API do ZimaOS.

Quando devo utilizar a Comunidade ZimaSpace em vez da documentação?

Utilize a documentação quando precisar de um procedimento estabelecido de configuração, instalação ou resolução de problemas. Utilize a Comunidade ZimaSpace quando a sua configuração for invulgar, quiser comparar experiências reais, precisar de ajuda de outros utilizadores, quiser partilhar a sua própria solução ou tiver feedback que possa ajudar a melhorar o ecossistema.

O que devo fazer se não souber em que secção se encontra o meu problema?

Se algo deixou de funcionar, comece pelo Centro de Ajuda e procure o sintoma que corresponde ao seu problema. Se está a tentar criar ou configurar algo novo, volte à página inicial da documentação da ZimaSpace e escolha o percurso mais próximo do seu objetivo. Se a sua situação estiver fora do percurso documentado, coloque a pergunta na Comunidade ZimaSpace.

Um servidor doméstico não tem propriamente um nível final. Há sempre outra unidade para adicionar, outra aplicação para experimentar, outro backup para melhorar ou outro projeto estranho de fim de semana à espera de acontecer.

A nova documentação foi criada para esse tipo de percurso. Comece onde está, siga o ramo que corresponde ao que está a construir e aprofunde-se tanto quanto o seu projeto exigir. E, quando o percurso documentado terminar, é provável que alguém na comunidade já tenha tentado ir um pouco mais longe.

Explore a nova documentação da ZimaSpace →

Tem uma pergunta, uma solução alternativa ou uma configuração que valha a pena partilhar? Junte-se à Comunidade ZimaSpace →