Ir para o conteúdo

Documentação

Webmin e Virtualmin

O Webmin é a integração de painel de controlo para servidores que executam o Virtualmin. Cria e gere contas de alojamento web numa máquina que já está em funcionamento. Não há sistema operativo para instalar nem máquina para arrancar: cria-se uma conta, atribui-se-lhe um plano e, mais tarde, suspende-se, muda-se de plano ou remove-se.

O Webmin é o painel; o Virtualmin faz o alojamento

O produto é conhecido como Webmin, e é assim que esta página se chama. O que o Provibr comanda na realidade é o Virtualmin: o módulo que conhece domínios, planos e quotas. O Webmin isolado administra uma máquina Linux e desconhece por completo o conceito de conta de alojamento.

Num servidor sem esse módulo a API remota simplesmente não existe: responde exatamente como um módulo inexistente. O Provibr não pode, portanto, recorrer ao Webmin isolado, e também não finge que pode: a ligação é recusada com um motivo em vez de ficar meio criada.

O que é preciso

A API remota do Webmin fala HTTP Basic, pelo que o segredo aqui é uma palavra-passe e não um token. É uma característica do Webmin e não uma decisão nossa, e é a razão pela qual as duas regras abaixo são mais rigorosas do que nos restantes painéis de controlo.

  • Anfitrião: o endereço do painel. Tem de ser https, e a porta 10000 é acrescentada se for omitida.
  • Utilizador do Webmin: o root funciona, mas é melhor um utilizador que tenha apenas o módulo Virtualmin.
  • Palavra-passe: a desse utilizador. Não há nada a restringir, por isso convém escolher o utilizador com cuidado.
  • Impressão digital TLS: obrigatória, porque o instalador do Webmin deixa um certificado autoassinado.
Atribua o módulo Virtualmin a um utilizador do Webmin criado para o efeito. Pode fazer tudo o que o Virtualmin faz, o que já é muito, mas não tudo o que o Webmin faz.

https e impressão digital são ambos obrigatórios

As outras integrações de painel de controlo aceitam um endereço http sem cifra e avisam do que isso custa. Esta não, e a diferença está no segredo: uma chave de acesso do DirectAdmin pode ser limitada a um punhado de comandos; uma palavra-passe do Webmin não pode ser limitada de todo.

Enviar essa palavra-passe sem cifra, ou para um certificado que ninguém verificou, não é uma decisão que tomemos em nome do cliente. Por isso o http é recusado e o campo da impressão digital não pode ficar vazio.

A impressão digital lê-se a partir de qualquer máquina que alcance o painel e cola-se tal como veio, com ou sem dois pontos, e o prefixo que a ferramenta imprime pode ficar.

shell
openssl s_client -connect <host>:10000 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Os comandos e a saída do terminal estão em inglês em todo o lado, no painel e nestas páginas. Um só texto, uma só verdade: o que aqui se lê é literalmente o que o seu host vai devolver.

A API remota

O Provibr não usa a interface web do Webmin. Chama a API remota do módulo Virtualmin, que devolve respostas legíveis por máquina em vez de páginas. Em algumas instalações esse caminho está desativado; volta a ligar-se em Webmin, Webmin Configuration, Advanced Options.

Quando o painel responde com uma página de início de sessão em vez da API, o agente di-lo com todas as letras. Normalmente significa que o endereço aponta para uma página e não para o painel, ou que a API remota está desligada.

Definições

Não há nenhuma. Um servidor Webmin decide por si onde vive uma conta e que endereço recebe, pelo que não sobra nada para escolher. O separador de definições continua a existir, porque é também aí que se reenviam as credenciais.

Planos

Um plano do Virtualmin é a descrição que o próprio painel tem de uma conta: quota de disco, tráfego mensal, quantos domínios e caixas de correio, que funcionalidades estão ativas. Não é um plano do Provibr nem um sistema operativo. É um nome a que nos referimos, e o seu conteúdo pode mudar no servidor do cliente sem que demos por isso.

A página da integração consegue ler a lista de planos com o que cada um inclui, para se ver o que se está a escolher em vez de escrever um nome de cor.

Um plano web fixa um plano do Virtualmin numa integração e dá-lhe um nome próprio. Encomendar com um plano prevalece sobre escolher um plano solto, e essa escolha solta continua disponível para os casos que um plano não cobre.

Como é uma conta no Provibr

Uma conta de alojamento é uma linha de servidor comum, do tipo servidor web. O seu identificador é o número interno que o Virtualmin dá ao domínio, e o domínio, o utilizador, o plano e as funcionalidades chegam em cada leitura.

  • Criar uma conta exige um domínio, um endereço de e-mail, um plano e uma palavra-passe.
  • O utilizador unix é derivado do domínio, por isso os hífenes são normais aqui, ao contrário do DirectAdmin, que tem uma regra de nomes própria.
  • A palavra-passe não fica registada em lado nenhum. Fica apenas o facto de ter sido fornecida uma; o valor viaja em separado.
  • Depois é possível suspender, retomar, mudar de plano e eliminar. Não há consola: uma conta de alojamento não a tem.
O identificador é o número e não o nome, porque o Virtualmin consegue mudar o nome de um domínio. Uma chave baseada no nome soltar-se-ia da sua linha na primeira vez que alguém o fizesse.

Quotas e utilização

A quota de disco e o tráfego seguem na leitura habitual, pelo que uma conta ganha um gráfico de utilização sem ser preciso ligar mais nada, desde que o servidor os consiga medir.

O Virtualmin só reporta quota e consumo quando as quotas do sistema de ficheiros estão ligadas, e uma instalação acabada de fazer tem-nas desligadas. Enquanto ninguém as ligar, esses campos simplesmente não existem. O Provibr não mostra nada em vez de um zero: não medir e não consumir não são a mesma coisa.

Adotar contas que já existem

O separador de importação lista as contas do painel e permite trazer para o Provibr as que se quiser. As contas já conhecidas aparecem, mas não podem voltar a ser selecionadas, para se ver o quadro completo e não um quadro filtrado.

As contas importadas contam para a capacidade exatamente como as encomendadas. Importar mais do que cabe abre um excedente, com o período de tolerância habitual.