Ethica/Termix

0 Fork 0

mirror of https://github.com/Termix-SSH/Termix.git synced 2026-10-28 06:05:24 +00:00

Files

T

LukeGus 6217b91ae2 feat: move telemetry out of core into a usage statistics plugin

2026-09-30 23:54:38 -05:00

21 KiB

Raw Blame History

Termix

Gestão de servidores auto-hospedada, do SSH e do desktop remoto às automações

English · 中文 · 日本語 · 한국어 · Français · Deutsch · Español · Português · Русский · العربية · हिन्दी · Türkçe · Tiếng Việt · Italiano

O Termix é gratuito e de código aberto. Se ele te ajuda, considera doar para ajudar a cobrir os custos de servidor e o tempo de desenvolvimento.

_{Conquistado em 1 de setembro de 2025}

Visão geral

O Termix é uma plataforma gratuita, de código aberto e auto-hospedada para gerenciar os teus servidores. Ele junta num só lugar terminais SSH, desktops remotos (RDP, VNC, Telnet), transferência de arquivos, túneis, Docker, métricas e automações, na web, no desktop e no celular. É uma alternativa auto-hospedada ao Termius que continua gratuita para sempre.

Funcionalidades

Terminal SSH: Um terminal completo com abas como as do navegador e tela dividida, até 6 painéis ao mesmo tempo. Escolhe o teu tema, a fonte e as cores. Acima de cada sessão há uma barra com CPU, memória e disco ao vivo, além de atalhos para os arquivos, o Docker, os túneis e as métricas daquele host.	Desktop remoto: RDP, VNC e Telnet no navegador, em abas e tela dividida como qualquer outra sessão. Inclui um navegador de arquivos para as unidades RDP e envio arrastando e soltando. No desktop Windows também dá para abrir um host no cliente RDP nativo.
Túneis SSH: Encaminhamento local, remoto e SOCKS dinâmico, com reconexão automática e verificação de estado. Os túneis de cliente para servidor do aplicativo de desktop ficam naquela máquina, e dá para salvar predefinições no servidor para levar uma configuração para outro computador.	Gerenciador de arquivos: Navega, edita, envia, baixa, renomeia, move e apaga arquivos por SFTP, com suporte a sudo. Vê e edita código, imagens, áudio e vídeo. Copia arquivos direto de um servidor para outro, com o caminho mais rápido escolhido para ti e a integridade das transferências verificada.
Docker e Podman: Inicia, para, pausa e remove containers, acompanha as estatísticas e abre um shell dentro de um deles. Funciona tanto com Docker quanto com Podman. Não é para substituir o Portainer ou o Dockge, só para gerenciar os containers que já tens.	Gerenciador de hosts: Salva e organiza hosts com etiquetas e pastas aninhadas que podes nomear e colorir. Reaproveita credenciais salvas entre hosts, distribui chaves SSH automaticamente, agrupa hosts sob um host pai, edita e exporta em lote, e usa a conexão rápida para conexões pontuais que não queres guardar.
Métricas de host: CPU, memória, disco, rede, temperatura, tempo ligado, processos, portas, logins e informações do sistema na maioria dos servidores Linux, com gráficos de histórico. Os cartões de gerenciamento deixam cuidar de serviços, tarefas cron, pacotes, usuários, regras de firewall, WireGuard, Tailscale, certificados SSL, logs e verificações de saúde sem sair do Termix.	Automações: Escolhe um gatilho e depois diz o que deve acontecer. Os gatilhos incluem uma métrica passando de um limite, um host caindo ou voltando, uma verificação de saúde mudando, um agendamento, um evento de container ou um webhook recebido. Os passos podem rodar comandos e trechos, controlar containers e túneis, acordar um host, chamar uma URL, esperar, seguir por uma condição, rodar outra automação e te avisar por ntfy, Discord ou webhook. As execuções de teste deixam experimentar com segurança primeiro.
Frotas: Junta hosts numa frota escolhendo um a um ou com regras de etiquetas, para que os novos entrem sozinhos. Roda um comando em todos os hosts de uma vez, envia e busca arquivos em todos eles, instala pacotes e reúne um inventário do sistema, do kernel, da arquitetura e do tempo ligado.	Assistente de IA: É opcional e fica desligado até tu ligares. Conecta OpenAI, Anthropic, Gemini, Ollama ou qualquer endpoint compatível com OpenAI e pergunta sobre a tua instalação. Ele lê hosts, frotas, trechos e alertas, e propõe mudanças para tu aprovares em vez de fazer sozinho. Nunca consegue mexer em credenciais, usuários ou configurações. Os administradores podem deixar desligado para toda a instância, e dá para escondê-lo já na configuração inicial.
Login e usuários: Contas locais além de login por OIDC, LDAP, GitHub e Google, com dois fatores (TOTP), chaves de acesso (WebAuthn) e dispositivos confiáveis. Os administradores podem gerenciar usuários, ligar grupos do OIDC a papéis, ver todas as sessões ativas em qualquer plataforma e encerrá-las. Liga a tua conta local com a do OIDC e consulta o registro de auditoria do que cada um fez.	Papéis e compartilhamento: Cria papéis e compartilha hosts com usuários ou papéis em quatro níveis: conectar, ver, editar e gerenciar. Funciona com todos os tipos de autenticação e todos os protocolos, e dá para trocar as credenciais usadas num host compartilhado.
Alertas: Define regras em métricas de host como CPU, memória e disco, e recebe aviso por ntfy, Discord ou webhook quando elas disparam. Vê os alertas ativos e resolvidos num histórico e dispensa os que não te interessam.	Página inicial: Uma grade de widgets que tu mesmo montas arrastando e soltando. Tem widget para status de host, ping, links de serviços, favoritos, busca, relógios, calendários, contagens regressivas, notas, RSS, previsão do tempo, imagens, iframes, Docker, túneis, gráficos de métricas, APIs próprias e até um terminal ao vivo.
Trechos e ferramentas: Salva os comandos que usas sempre e dispara com um clique, com variáveis para o host e para o que tu digitares. Roda um mesmo comando em todos os terminais abertos e pesquisa o teu histórico com preenchimento automático.	Compartilhar sessão: Compartilha ao vivo uma sessão de terminal, RDP, VNC ou Telnet. Manda um link que qualquer um entra sem conta, ou compartilha com um usuário específico do Termix, em somente leitura ou com escrita. Os compartilhamentos podem expirar sozinhos ou ser revogados, e dá para desligar tudo de uma vez ou por host.
Gravação e registros de sessão: Grava sessões de terminal, RDP e VNC e reproduz depois. Baixa registros de texto de uma sessão e olha o registro de conexão para ver exatamente o que aconteceu durante ela.	Conexões seriais: Fala com dispositivos seriais como roteadores, switches e microcontroladores pelo navegador ou pelo aplicativo de desktop. Define taxa de transmissão, bits de dados, bits de parada e paridade. Usa a API Web Serial nos navegadores compatíveis, ou um backend nativo no aplicativo de desktop.
Tailscale: Traz dispositivos da tua tailnet para adicionar como hosts em poucos cliques, e conecta com Tailscale SSH para que as ACLs da tailnet cuidem do acesso sem guardar credenciais. Headscale e endpoints personalizados também funcionam.	Proxmox: Importa hosts direto de uma instância Proxmox e acompanha as estatísticas de nós e convidados, incluindo CPU, memória e armazenamento, numa aba própria.
Áreas de trabalho e abas: Salva um conjunto de abas com a divisão da tela e reabre tudo com um clique. O Termix também lembra da tua última sessão, então as abas voltam depois de recarregar e em outros dispositivos.	Linha de comando: Um CLI `termix` para o teu shell e os teus scripts. Abre terminais, roda um comando num host ou numa frota inteira, move arquivos por SFTP e gerencia hosts, trechos e credenciais. Instala com `npm install -g @termix-cli/cli` ou pega um binário independente. Vê a documentação do CLI.
Segurança: Senhas, chaves e outros segredos são criptografados por usuário, e os próprios arquivos do banco de dados podem ser criptografados em disco. Vê a documentação para entender como funciona.	Idiomas: Cerca de 30 idiomas incluídos, gerenciados pelo Crowdin.

Mais funcionalidades

Painel - Os teus servidores num relance, com cartões que tu mesmo organizas
Gráfico de rede - O teu homelab desenhado a partir dos teus hosts, com status ao vivo
Monitor tmux - Percorre sessões, janelas e painéis do tmux, com prévia e busca
Chaves de API - Chaves por usuário com data de validade para scripts e CI
Exportar e importar - Leva e traz hosts, credenciais e dados do gerenciador de arquivos
SSL automático - Certificados gerados e renovados para ti, com redirecionamento para HTTPS, ou usa os teus
Bancos de dados - SQLite por padrão, com PostgreSQL e MySQL também suportados
Interface moderna - Interface React limpa que funciona no desktop e no celular, com temas como claro, escuro e Dracula. Qualquer conexão abre em tela cheia por uma URL
Paleta de comandos - Toca duas vezes no Shift esquerdo para ir a um host pelo teclado
Atalhos de teclado - Trocar de aba, fechar abas e mais, tudo remapeável
Wake-on-LAN - Liga uma máquina pelo Termix ou por um passo de automação
Autenticação por proxy confiável - Deixa um proxy reverso cuidar do login e repassar o usuário
Marca própria - Os administradores podem rebatizar a instância com nome, logo e cores próprios
Endpoints web - Abre a interface web do próprio host, como a página de administração de um roteador, embutida no Termix em vez de numa aba separada
Salas de colaboração - Salas persistentes onde um grupo pode passar de uma sessão para outra junto, com um palco de apresentação e convites
SSH bem completo - Hosts de salto, Warpgate, pedidos de TOTP, SOCKS5, verificação de chave de host, preenchimento automático de senha, OPKSSH, tmux, port knocking, registro do terminal, encaminhamento de agente, agente SSH do Bitwarden, assinatura SSH com HashiCorp Vault, Step CA, 1Password Connect e mais
Termix ID - Uma versão embutida do sshid.io. Registra um identificador, publica as tuas chaves públicas numa URL de resolução e emite certificados SSH pela CA embutida
Sugestões automáticas de histórico de comandos - Sugestões dentro do terminal enquanto tu digitas, baseadas no teu histórico de comandos
Desktop independente e sincronização - O aplicativo de desktop roda sozinho, com backend e banco de dados locais, e pode opcionalmente sincronizar com um servidor Termix

Plataformas suportadas

Plataforma	Distribuição
Web	Qualquer navegador moderno (Chrome, Safari, Firefox) · Suporte a PWA
Windows _x64/ia32	Portátil · Instalador MSI · Chocolatey
Linux _x64/ia32	Portátil · AUR · AppImage · Deb · Flatpak
macOS _{x64/ia32, v12.0+}	Apple App Store · DMG · Homebrew
iOS/iPadOS _v15.1+	Apple App Store · IPA
Android _v7.0+	Google Play Store · APK

Instalação

Vê a documentação do Termix para as instruções completas de instalação em todas as plataformas.

Exemplo de arquivo Docker Compose (dá para tirar o guacd e a rede se não pretendes usar o desktop remoto):

services:
  termix:
    image: ghcr.io/lukegus/termix:latest
    container_name: termix
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - termix-data:/app/data
    environment:
      PORT: "8080"
    depends_on:
      - guacd
    networks:
      - termix-net

  guacd:
    image: guacamole/guacd:1.6.0
    container_name: guacd
    restart: unless-stopped
    ports:
      - "4822:4822"
    networks:
      - termix-net

volumes:
  termix-data:
    driver: local

networks:
  termix-net:
    driver: bridge

Linha de comando

O Termix também tem um CLI, para gerenciares os teus servidores pelo terminal e usares o Termix nos teus próprios scripts.

npm install -g @termix-cli/cli
termix login --url https://termix.example.com
termix ssh 1

Ele abre terminais, roda um comando num host ou numa frota inteira, move arquivos por SFTP e gerencia hosts, trechos e credenciais. A documentação completa está em docs.termix.site/cli.

Hospedagem na nuvem

Dá para rodar o servidor do Termix num VPS em vez de dentro da tua própria rede. Se o Termix roda na rede que ele gerencia, uma queda leva ele junto, bem na hora em que precisas dele para resolver. Rodando fora ele continua acessível, te dá um IP fixo e dá para entrar de qualquer lugar sem VPN nem abrir portas.

A GINERNET patrocina o Termix, e a documentação tem um guia passo a passo para publicar na plataforma de VPS deles.

Telemetria

O Termix envia uma vez por dia um pequeno relatório anónimo, para eu ver quantas instâncias estão a correr e que funcionalidades são usadas. Contém um ID de instância aleatório, a versão da app e quantos utilizadores e hosts tens. Também pode incluir a tua plataforma (sistema operativo, arquitetura, versão do Node.js, tipo de base de dados e se usas Docker, a app de desktop ou um servidor normal), quantas vezes cada tipo de separador foi aberto e quantos logins SSH houve, e que funcionalidades integradas estão ativas. Nunca contém nomes de utilizador, nomes de host, endereços IP, credenciais ou qualquer outra coisa que te identifique a ti ou aos teus servidores.

Vem ligado por padrão. Podes desligar ou escolher o que inclui nas configurações de administração, em Usage Statistics, onde também podes ver o relatório exato antes de ser enviado. Cada utilizador pode excluir o seu próprio uso de funcionalidades no perfil. Definir ENABLE_TELEMETRY=false desliga-o e bloqueia o interruptor.

Doar

O Termix é gratuito e de código aberto, sem assinaturas nem planos pagos. Se ele te ajuda, considera doar para ajudar com servidores, domínios e tempo de desenvolvimento. As doações também custeiam o tempo de pesquisar e aprender o necessário para funcionalidades como SAML, Kubernetes e suporte a agentes. Acompanha o progresso e doa abaixo.

Doar

Patrocinadores

Tens interesse num espaço pago para apoiar o desenvolvimento? Escreve para mail@termix.site.

Suporte

Precisas de ajuda ou queres pedir uma funcionalidade? Abre uma nova issue com o máximo de detalhes possível, em inglês se der. Também podes perguntar no canal de suporte do Discord, embora as respostas por lá possam demorar mais.