Como Adicionar um Site no ISPConfig 3.2

ISPConfig é um painel de controle de hospedagem para servidores Linux. O ISPConfig fornece funções para gerenciar sites, bancos de dados, usuários FTP e shell, contas de email e DNS. Neste guia, mostraremos passo a passo como adicionar um site, banco de dados MySQL/MariaDB, usuário FTP e usuário SSH no ISPConfig. As configurações que escolhemos neste tutorial correspondem aos requisitos para CMS típicos baseados em PHP, como WordPress, Joomla, Contao, Typo3, etc.

Pré-requisitos

Os seguintes pré-requisitos devem ser atendidos para seguir este guia:

• Servidor com o painel de controle de hospedagem ISPConfig instalado.
  Se você ainda não instalou o ISPConfig, siga o guia de instalação do ISPConfig.
• Um login de administrador, revendedor ou cliente do ISPConfig. Logins de revendedores ou clientes devem ter permissão para adicionar sites habilitada dentro de seus limites de cliente.
• Um nome de domínio para o site que aponte para o servidor com um registro DNS A já configurado.
• Este tutorial é compatível com servidores Apache e Nginx.

Para fins de demonstração, o domínio ‘example.com’ é usado. Substitua example.com pelo seu próprio nome de domínio sempre que ocorrer abaixo.

Vídeo

Este tutorial também está disponível como um vídeo no YouTube. Clique aqui: https://www.youtube.com/watch?v=v8cKGK-YPLU para abrir o vídeo no YouTube.

Adicionando um Site no ISPConfig

Faça login na interface web do ISPConfig, em seguida, vá para o módulo “Sites” clicando em Sites no menu superior.

Agora clique no botão verde “Adicionar novo site”. Se você não vê esse botão, clique na palavra “Site” no menu à esquerda.

O formulário de configurações do site aparecerá. Ele permite que você configure os detalhes do site. Vou explicar as configurações obrigatórias e recomendadas abaixo.

Configurações do site. Se você deseja obter explicações detalhadas de todos os campos, consulte o Manual do ISPConfig. Vou apenas cobrir o que é recomendado ser configurado para um site típico baseado em PHP aqui. Uma observação importante, não é recomendado habilitar recursos que não são necessários.

• Cliente: Este campo aparece apenas quando você está logado como administrador ou revendedor. O campo pode ser deixado em branco. Se você deseja gerenciar clientes, crie um cliente primeiro antes de criar o site.
• Endereço IPv4: Escolha aqui. O que é importante é que todos os sites do servidor que apontam para o mesmo IP usem ou o endereço IP, mas não misturem e IP. Portanto, recomendo sempre usar , o que significa que você obtém um host virtual baseado em nome.
• Domínio: Insira o nome do domínio aqui.
• Suexec (apenas servidores Apache): A caixa de seleção suexec deve estar sempre ativada, pois garante que os scripts PHP sejam executados sob o usuário da web do site, permitindo assim que o PHP escreva arquivos (arquivos de mídia e atualizações) conforme exigido por qualquer CMS moderno.
• Subdomínio automático: Se o seu site deve ser acessível por www.example.com também, e não apenas example.com, então defina o subdomínio automático para www, caso contrário, defina como nenhum.
• SSL: Ative esta caixa de seleção para permitir o acesso ao site por SSL (HTTPS). É altamente recomendado habilitá-la.
• SSL Let’s Encrypt: O SSL requer um chamado certificado SSL para funcionar. Você pode ter um certificado SSL autoassinado (que mostrará um erro de insegurança quando você acessar o site em um navegador da web), ou pode comprar um certificado SSL de uma autoridade SSL, ou pode obter um certificado SSL gratuito de, por exemplo, Let’s Encrypt. E é para isso que esta caixa de seleção foi criada. Ao habilitar esta caixa de seleção, o ISPConfig tenta obter um certificado SSL gratuito do Let’s Encrypt para o site. Importante: Você receberá um certificado SSL Let’s Encrypt apenas quando o nome de domínio do site já apontar para o endereço IP deste servidor web. Se você tiver problemas para obter um certificado SSL Let’s Encrypt (a caixa de seleção do Let’s Encrypt é desmarcada cerca de um minuto após você criar o site), consulte o FAQ de Erros do Let’s Encrypt para uma lista de verificação para depurar o problema.
• PHP: O modo PHP recomendado é PHP-FPM. Se você estiver usando um servidor web Nginx, então este campo não aparecerá, servidores ISPConfig Nginx usam sempre PHP-FPM.
• Versão PHP: Este campo aparece apenas se você tiver várias versões do PHP instaladas. Recomendo sempre usar a versão mais alta que é suportada pelo CMS ou aplicativo web que você planeja instalar neste site. Consulte os requisitos do sistema para o CMS para escolher a versão correta.
• Ativo: Para ativar o site.

Clique no botão ‘Salvar’ para criar o site. O site recém-adicionado aparecerá na lista de sites.

A criação do site pode levar até um minuto. Está concluído quando o ponto vermelho desaparece no menu superior. O número no ponto é o número de alterações de configuração pendentes.

Agora temos um site totalmente funcional, mas a maioria dos sistemas CMS também requer um banco de dados MySQL ou MariaDB para armazenar seu conteúdo. No próximo passo, criaremos um banco de dados e um usuário de banco de dados.

Adicionar Banco de Dados MySQL e Usuário de Banco de Dados no ISPConfig

Neste passo, adicionaremos um novo usuário MySQL e banco de dados a serem usados pelo sistema CMS desse site. O primeiro passo é adicionar o usuário MySQL.

Clique em “ Usuários de Banco de Dados “ no menu à esquerda:

E então clique no botão verde “ Adicionar novo usuário “ que aparece na seção do meio da página.

O formulário com os detalhes do usuário do banco de dados aparece.

Os campos de entrada do usuário do banco de dados são explicados em detalhes abaixo:

• Cliente: É opcional escolher um cliente aqui. Mas se você escolheu atribuir o site a um cliente ao criar o site, então é importante que você escolha o mesmo cliente (ou, no caso deste exemplo - nenhum cliente) aqui.
• Usuário do banco de dados: Insira o nome que o novo usuário do banco de dados deve ter aqui. Um prefixo será adicionado ao nome, então neste exemplo, o nome resultante do usuário do banco de dados será c0mywebsite. Veremos isso mais tarde na lista de usuários do banco de dados também. Veja o capítulo no final do guia sobre prefixos.
• Senha do banco de dados e Repetir senha: Insira uma senha segura para o novo usuário do banco de dados aqui duas vezes. Ou use o botão “Gerar senha” para gerar uma. Tome cuidado para anotar a senha, pois você precisará dela mais tarde ao instalar o CMS no site.

Agora pressione salvar para criar o usuário do banco de dados, você será redirecionado para a lista de usuários do banco de dados. Observe que o usuário é criado no MySQL no momento em que o atribuirmos a um banco de dados no próximo passo.

Como você pode ver na lista agora, o nome do usuário do banco de dados é “c0mywebsite” e esse é o nome que você terá que usar ao inserir os detalhes do banco de dados ao instalar o CMS no site.

Agora, criaremos um banco de dados MySQL. Para fazer isso, clique em “ Bancos de Dados “ no menu à esquerda.

A lista (vazia) de bancos de dados aparecerá. Lá você clica no botão verde “ Adicionar novo banco de dados “.

Preencha os detalhes do banco de dados conforme mostrado abaixo:

As configurações do banco de dados em detalhes:

• Site: aqui você deve escolher o site ao qual o banco de dados deve pertencer. No nosso caso, o site “example.com”. Escolher o site correto é importante, pois essa configuração, por exemplo, define em qual backup o banco de dados acabará e quais permissões são definidas para o acesso ao banco de dados.
• Nome do banco de dados: aqui você insere o nome que o novo banco de dados deve ter. Usarei o nome “mywebsite” aqui. Semelhante ao usuário MySQL, um prefixo é adicionado ao nome do banco de dados, então o nome resultante do banco de dados será “c0mywebsite”. Veja o capítulo no final do guia sobre prefixos.
• Usuário do banco de dados: Aqui você seleciona o nome do usuário do banco de dados que criamos anteriormente.
• Ativo: Deve ser habilitado para ativar o banco de dados.

Agora pressione o botão salvar. Isso criará o banco de dados e também o usuário do banco de dados no MySQL. Você será retornado à lista de bancos de dados e nosso novo banco de dados aparecerá lá.

Você pode acessar o site agora, por exemplo, através do phpmyadmin clicando no botão phpMyAdmin na lista:

Nota: Caso você receba um erro de que o phpMyAdmin não foi encontrado, então a URL para o phpMyAdmin ainda não foi configurada após a instalação do ISPConfig em sistema > Interface > Configuração Principal. A URL é tipicamente https://server1.example.com/phpmyadmin em sistemas Apache e https://server1.example.com:8081/phpmyadmin em sistemas Nginx, onde server1.example.com é o nome do host do servidor de hospedagem.

Acessando os arquivos do site

Já criamos um site e um banco de dados MySQL, mas para instalar um sistema CMS, você deve ser capaz de acessar a pasta do site por FTP ou SSH. Neste capítulo, mostrarei como conceder acesso FTP (FTPS) e SSH (SFTP) ao site.

Adicionar Usuário FTP no ISPConfig

Clique em Acesso Web > Contas FTP no menu à esquerda para ir à lista de usuários FTP.

Na página que aparece, clique no botão verde “ Adicionar novo Usuário FTP “.

O formulário de detalhes do usuário FTP aparece:

Os detalhes sobre o que inserir em quais campos são:

• Site: Selecione o site ao qual o usuário FTP deve pertencer aqui. No nosso exemplo, o site é chamado “example.com”.
• Nome de usuário: Insira um nome de usuário para o usuário FTP aqui. Um prefixo será adicionado automaticamente ao nome de usuário.
• Senha e Repetir senha: Insira uma senha segura aqui duas vezes, ou use o botão “Gerar Senha”.
• Ativo: Esta caixa de seleção deve ser marcada para ativar o acesso FTP.

Agora pressione “ Salvar “ para criar o usuário FTP. Você será redirecionado para a lista de usuários FTP, que também mostra o nome de usuário FTP, incluindo o prefixo.

Criamos com sucesso um usuário FTP no ISPConfig. Isso nos permite acessar o site através de qualquer cliente FTP. Os protocolos suportados são FTP e FTPS (FTP sobre TLS). Observe que SFTP (mesmo que o nome seja semelhante) é acesso a arquivos SSH e não FTP, portanto, requer um usuário SSH para usar esse protocolo (que criaremos no próximo capítulo).

Então, quais detalhes devem ser usados em um cliente FTP agora?

• Servidor: O nome do servidor FTP é o nome do host do servidor, pois esse é o nome para o qual o certificado SSL do servidor FTP geralmente é emitido. Meu servidor tem o nome do host “server1.example.com”, então vou inserir ‘server1.example.com’ quando o cliente FTP perguntar o nome do servidor FTP.
• Nome de usuário FTP: O nome de usuário FTP é o nome de usuário completo, incluindo o prefixo. Portanto, no caso deste exemplo, o prefixo é “default” e o nome de usuário é “mywebsite”, então o nome de usuário FTP resultante a ser inserido no cliente FTP é “defaultmywebsite”. A propósito, se você não gosta dos prefixos, veja o capítulo no final do guia sobre por que os prefixos são necessários na maioria dos sistemas e onde desativá-los e alterá-los (se você for o administrador do servidor).
• Senha FTP: a senha que você definiu para esse usuário FTP no formulário de usuário FTP acima.

Então, onde fazer upload de arquivos agora? A raiz do site é a pasta com o nome “ web “, para a qual você faz upload dos arquivos do seu CMS. A pasta “web” é aquela que você acessa pelo navegador da web quando insere o nome do domínio do site na barra de endereços do navegador. Se você quiser armazenar arquivos no site que não devem ser acessíveis por um navegador da web, então você pode enviá-los para a pasta com o nome “ private “.

Adicionar usuário SSH / SFTP / Shell no ISPConfig

Adicionar um usuário Shell, que fornece acesso por SSH e SFTP ao site, é muito semelhante a adicionar um usuário FTP. O primeiro passo é clicar em Linha de Comando > Usuário Shell no menu à esquerda.

A página com os usuários shell aparece na seção do meio. Lá você clica no botão verde “ Adicionar novo Usuário Shell “.

O formulário com os detalhes do usuário shell aparece.

Os seguintes campos precisam ser preenchidos.

• Site: aqui você seleciona o site ao qual este usuário SSH deve conceder acesso. No nosso exemplo, o site é chamado example.com.
• Nome de usuário: Insira o nome de usuário desejado aqui. Um prefixo será aplicado, assim como descrito para o usuário FTP.
• Senha e Repetir Senha: Insira uma senha segura para o novo usuário SSH aqui.
• Shell Chroot: Se você escolher jailkit aqui, então o usuário SSH será preso na raiz do site. Isso é recomendado e adiciona uma camada adicional de segurança, mas o usuário só pode acessar programas e arquivos que estão instalados em sua prisão. Este campo é visível apenas para administradores, para clientes e revendedores, o valor para este campo pode ser pré-definido pelos limites do cliente.
• Chave Pública SSH-RSA: Se você deseja usar autenticação por chave pública para acesso SSH em vez ou além de uma senha, então você pode inserir sua chave pública aqui.

Agora clique em salvar e o usuário SSH será criado. Isso pode levar até um minuto, você pode ver o indicador vermelho piscando na barra de navegação superior até que as alterações tenham sido gravadas no disco.

Com este usuário SSH, você pode acessar o site com um cliente SFTP (Transferência de Arquivos SSH) ou pode usar o comando ssh ou um cliente SSH como o Putty para obter acesso ao terminal. Os detalhes a serem usados em um cliente SSH ou SFTP são:

• Servidor: Use o nome do host do servidor aqui. No meu caso, o nome do host é server1.example.com.
• Nome de usuário SSH: O nome de usuário SSH é o nome de usuário completo, incluindo o prefixo. Portanto, no caso deste exemplo, o prefixo é “default” e o nome de usuário é “mywebsite”, então o nome de usuário resultante é “defaultmywebsite”.
• Senha SSH: A senha que você inseriu acima ou você pode usar a chave SSH, caso tenha usado isso.

Como navegar até a pasta do site como usuário SSH?

O comando para mudar para uma pasta diferente no shell Linux é “cd”. Ao fazer login no site como usuário SSH, você aterrissa na pasta inicial do seu usuário SSH (que está vazia quando você começa a usá-la). Para ir para a pasta web (que contém os arquivos do site), você usa o comando cd assim:

cd ../../web/

O comando acima funciona para usuários SSH presos e não presos. Para usuários presos, você pode usar a alternativa:

cd /web

como a pasta raiz de um usuário SSH preso é a raiz do site e a raiz http ou httpdocs, como é chamada às vezes (a pasta que contém os arquivos do site) é a pasta chamada ‘web’.

Prefixos de nome de usuário no ISPConfig

Por que os prefixos de nome de usuário são usados? A maioria dos serviços no Linux que usam nomes de usuário e senhas para autenticação requer que o nome de usuário seja exclusivo nesse servidor. O ISPConfig é um painel de controle de hospedagem que pode ser usado por vários Clientes, onde cada cliente vê apenas seus próprios usuários, é claro. Agora, o seguinte problema pode surgir: O Cliente A cria um usuário FTP/SSH/Banco de Dados chamado “tom”. Agora o Cliente B faz login no ISPConfig e tenta criar um novo usuário FTP, chamado “tom” também. Ele não pode ver que já existe um usuário com o nome tom, pois esse usuário pertence ao cliente A. Ele então receberia um erro de que o usuário tom já existe, mas como não pode ver esse usuário, provavelmente pensaria que deve haver uma falha no software e chamaria o suporte de seu ISP. Aqui entram os prefixos de nome de usuário, o ISPConfig os configura por padrão, por exemplo, um “c + ID do cliente” é adicionado na frente de um banco de dados ou usuário de banco de dados ou o nome de usuário do cliente (no caso de nenhum cliente, a palavra padrão) é adicionado na frente de um usuário SSH ou FTP. Isso permite que cada cliente tenha um usuário ‘tom’, com a desvantagem de que o prefixo faz parte do nome de usuário para torná-lo exclusivo. Mas nem todos os servidores ISPConfig são usados como sistemas de hospedagem, você pode, por exemplo, usar o ISPConfig como um painel para seu servidor doméstico ou servidor interno da empresa, então você não requer prefixos de nome de usuário e acha irritante que o ISPConfig os adicione. Mas isso pode ser resolvido facilmente, pois os prefixos de nome de usuário são livremente configuráveis no ISPConfig. Para removê-los, vá para Sistema > Interface > Configuração Principal (enquanto estiver logado como usuário administrador):

Limpe todos os campos de prefixo e pressione o botão salvar:

Agora os prefixos de nome de usuário e nome de banco de dados estão desativados. Observe que a alteração se aplica apenas a usuários recém-criados, o prefixo de usuários existentes não será removido, portanto, nomes de usuário existentes não serão alterados e seu login não será interrompido quando você alterar essas configurações.

Links

Aqui estão alguns links para leitura adicional e para obter ajuda se você tiver problemas.

• Página inicial do ISPConfig
• Uma descrição detalhada das opções no ISPConfig
• Instruções de instalação do ISPConfig para todos os sistemas operacionais suportados
• Obtenha ajuda se algo não estiver funcionando pela Comunidade ISPConfig
• Obtenha suporte comercial por e-mail ou login remoto