Documentação
Adicionar entrada "hosts" no seu PC local
Contexto e Visão Geral
Note que estas instruções são relevantes para qualquer dispositivo conectado à rede com um IP válido - não apenas servidores TurnKey.
Alguns servidores TurnKey Linux exigem que um domínio seja definido. Quando isso é o caso, a aplicação principal (por exemplo, WordPress, Mediawiki, etc) esperará que o domínio resolva o endereço IP do seu servidor. No entanto, às vezes você não pode ou não quer usar um domínio resolvível publicamente - ou seja, um disco DNS.
Adicionar uma entrada de arquivos hosts é uma maneira de acessar um servidor através de um nome de domínio sem precisar configurar registros DNS. Quando o seu PC tenta ligar- se a um domínio, ele lê primeiro o ficheiro das máquinas. Se o domínio desejado for encontrado no ficheiro das máquinas, o IP indicado será usado.
Limitações
Existem várias limitações usando uma entrada de hosts para acessar seu servidor por domínio:
- Cada PC que você quiser ser capaz de acessar seu servidor TurnKey de terá que ter uma entrada hosts adicionada.
- O acesso do administrador ao seu PC local é necessário para editar o arquivo hosts.
- O IP estático do servidor é altamente desejável - sem um IP estático, o arquivo hosts precisará ser atualizado cada vez que o IP do servidor mudar.
Também vale a pena anotar explicitamente se um domínio corresponder a uma entrada de hosts, uma solicitação DNS não será feita. Então, a menos que você queira explicitamente bloquear/sobrepor um domínio, use apenas domínios específicos do site - não "reais". Caso contrário, se você esquecer que você fez uma entrada hosts, solucionar problemas de conexão na pista pode ser um mundo inteiro de dor! Por exemplo. um bom domínio específico do site pode ser 'mediawiki.home.lan'; um domínio ruim seria 'mediawiki.turnkeylinux.org' (não existe, mas talvez possa no futuro).
Definir IP estático para servidor
Usar um IP estático para o seu servidor não é necessário, mas como mencionado acima, é altamente desejável. Se você ainda não tiver definido e desejar, como você faz isso dependerá da plataforma em que você está executando o TurnKey:
Servidor Cloud AWS - lançado a partir do TurnKey Hub ou Mercado AWS
Adicione um "IP elástico" ao seu servidor através do console AWS. Não definir um IP estático dentro do próprio servidor - os servidores AWS devem sempre obter o seu IP de AWS DHCP!
Recipiente LXC - por exemplo em Proxmox
Recomenda- se que o IP do servidor estático seja definido na máquina Proxmox - não dentro do próprio servidor. Isto porque por padrão o Proxmox gerencia a configuração de rede do servidor LXC.
VM e metal nu
Confconsole (>> Avançado >> Rede), Webmin (https na porta 12321) ou manualmente via CLI.
Localização do ficheiro das máquinas
Janelas
C:\Windows\System32\drivers\etc\hosts
Linux e MacOSX
/etc/hosts
Abrir o ficheiro das máquinas para edição
Primeiro abra o arquivo de máquinas no seu editor de texto preferido. Observe que deve ser um editor de texto simples. Um editor que formate texto - por exemplo, um processador de texto - irá quebrar o seu ficheiro de máquinas! Para editar o ficheiro, você deve ser um Administrador.
Janelas
Windows Notepad é uma opção comum e sã para editar arquivos de texto simples.
Clique com o botão direito do mouse em sua aplicação de editor de texto (por exemplo: Notepad) e selecione "Execute como administrador." Então, ou copie/passe "C:\Windows\System32\drivers\etc\hosts" na barra de endereços - ou procure por esse local através dos editores de texto Caixa de diálogo "Abrir".
Linux & MacOSX
Em sistemas 'nix (Linux, OSX, etc) é frequentemente mais fácil usar o seu editor de texto CLI preferido dentro de um terminal. Editores CLI comuns são nano, Vim ou emacs.
Lançar o seu editor de texto num terminal como utilizador de sudo (ou como root). Por exemplo, usando o nano:
sudo nano /etc/hosts
Adicionar nova linha ao ficheiro de máquinas
Uma vez que você tenha aberto o arquivo hosts para edição, adicione uma nova linha com um formato como este:
<IP_ADDRESS> <DOMAIN_NAME>
Por exemplo, para apontar 'mediawiki.home.lan' para o endereço IP '192.168.1.100' - adicione uma nova linha com isto:
192.168.1.100 mediawiki.home.lan
Finalmente, salve o arquivo de hosts atualizados e saia do editor de texto.
Teste seu domínio
Depois de adicionar a entrada de seus hosts, a resolução do seu domínio ao IP especificado deve "apenas funcionar". Mas, para ter certeza, vale a pena verificar duas vezes através de um terminal. Então, abra um terminal (por exemplo. cmd.exe no Windows) e usar ping. Por exemplo:
ping mediawiki.home.lan
Se você obter resultados observando o domínio e o endereço IP do seu servidor, então você está pronto para ir. Se ele dá o IP errado, então verifique novamente o arquivo de suas máquinas. Se ele der uma mensagem de erro, então verifique se você pode se conectar ao IP, pingando-o. Por exemplo:
ping 192.168.1.100
Se isso não funcionar, então verifique se você tem o IP do servidor correto. Outra coisa a verificar é que a rede (do seu PC e/ou servidor) está configurada corretamente.
Palavra final
Se você está feliz com seu domínio, adicionou-o ao seu arquivo de hosts e pode se conectar ao seu servidor, então é isso. Tudo o que resta é desfrutar do seu servidor TurnKey! :)
Atualizar domínio no servidor TurnKey
Se você já tivesse definido o domínio no seu servidor TurnKey antes de ler isso e gostaria de alterá-lo, você pode fazer isso reinicializando o servidor. Obviamente, o domínio no arquivo de seus hosts precisará corresponder ao novo domínio.
Se você já começou a adicionar conteúdo/dados ao seu servidor antes de reiniciar, faça um backup primeiro (por exemplo, faça um backup). TKLBAM) - apenas no caso. Tentamos garantir que nossos scripts de inicialização são idempotent (ou seja, pode ser executado com segurança) mas pode haver um caso de borda que não consideramos. Por favor, relate quaisquer erros ou comportamento inesperado através do nosso fóruns ou o nosso consolidado localizador de emissão.
Reinicialização
Você pode usar o comando 'turnkey-init' para fazer uma reiniciação completa. Isso incluirá a redefinição do domínio, bem como de todas as outras configurações do servidor. Você precisará responder todas as perguntas de inicialização novamente, embora seja bom usar o mesmo que você fez na primeira vez (esperar domínio obviamente):
turnkey-init
Se você preferir apenas reiniciar o aplicativo principal para atualizar o domínio, você pode executar o script de inicialização específico do aplicativo diretamente. Os scripts individuais são escritos em python com uma extensão de arquivo .py e localizados em /usr/lib/inithooks/bin. Como regra geral, o nome do script init específico da aplicação irá corresponder ao aplicativo, então, geralmente pode ser adivinhado. Se você gostaria de verificar explicitamente o nome, listar todos os arquivos no diretório relevante:
ls -l /usr/lib/inithooks/bin/*.py
Em seguida, execute o script usando o caminho completo. Por exemplo, WordPress:
/usr/lib/inithooks/bin/wordpress.py