Instalação
Instale o agente InfraFence no Linux com o install.sh - requisitos, todas as opções do instalador, onde ficam os arquivos e como reinstalar ou mover um servidor.
Última atualização:
O agente roda como um serviço no servidor: systemd, upstart ou sysvinit. Para containers, veja Docker e Kubernetes.
Requisitos
- Linux em x86-64 (
x86_64) ou ARM64 (aarch64). Qualquer outra arquitetura interrompe o instalador comUnsupported architecture. - Acesso root.
- systemd, upstart ou sysvinit.
apt-get,dnfouyum, para instalar o que estiver faltando:curl,iptableseca-certificates. Oipsettambém é instalado quando a verificação somente leitura diz que é seguro fazê-lo.- HTTPS de saída para
infrafence.com,github.comerelease-assets.githubusercontent.com: o agente é baixado só das releases no GitHub.
A página distribuições suportadas lista as 15 distribuições em que cada versão é testada.
Instalar
Crie um token de instalação no painel (Servidores › Adicionar servidor), depois, no servidor:
curl -fsSL https://github.com/infrafence/infrafence-agent/releases/latest/download/install.sh | sudo bash -s -- --token <YOUR_TOKEN>O instalador nunca faz perguntas, então também funciona em scripts de provisionamento.
Opções do instalador
| Opção | Efeito |
|---|---|
--token <TOKEN> |
O token de instalação de uso único do painel. Necessário para um novo registro. |
--dry-run |
Baixa o agente, executa a verificação somente leitura e mostra o que uma execução real faria. Nada é instalado nem alterado, e não precisa de token. |
--no-ipset |
Nunca instala o ipset. Os banimentos continuam funcionando, com uma regra de firewall por endereço (até 500); o bloqueio por país e o bloqueio das listas de threat intelligence passam a apenas detectar. |
--install-only |
Instala o binário e o serviço sem registrar. O serviço fica habilitado, mas não é iniciado; o instalador mostra o comando infrafence-agent register para executar depois. |
--force-register |
Registra de novo mesmo que /etc/infrafence/config.json exista, com um novo token. |
--skip-checksum |
Instala mesmo quando o checksum da release não pode ser baixado. Inseguro: o binário não é verificado. Sem essa opção, um checksum ausente ou errado interrompe o instalador e nada é instalado. |
--uninstall |
Remove o agente e o que ele adicionou. Veja Desinstalar. |
O instalador também lê estas variáveis de ambiente:
| Variável | Padrão | Efeito |
|---|---|---|
INFRAFENCE_AGENT_NAME |
o hostname curto | O nome que o servidor recebe no painel. |
INFRAFENCE_SERVER_URL |
https://infrafence.com |
O painel em que o agente se registra. |
Passe-as pelo sudo, por exemplo:
curl -fsSL https://github.com/infrafence/infrafence-agent/releases/latest/download/install.sh | sudo INFRAFENCE_AGENT_NAME=web-01 bash -s -- --token <YOUR_TOKEN>Onde ficam as coisas
| Caminho | O quê |
|---|---|
/usr/local/bin/infrafence-agent |
O binário do agente. A versão anterior é mantida como infrafence-agent.bak depois de uma atualização. |
/etc/infrafence/config.json |
Endereço do painel e o token do próprio agente (modo 0600, diretório 0750). |
/var/lib/infrafence/ |
Estado: banimentos, whitelist, bloqueios por país, portas fechadas, arquivos em quarentena. |
/etc/systemd/system/infrafence-agent.service |
A unidade systemd (upstart: /etc/init/infrafence-agent.conf; sysvinit: /etc/init.d/infrafence-agent). |
/usr/local/bin/infrafence-agent-recover.sh |
Roda antes de cada início no systemd: se o binário estiver quebrado, restaura o backup ou baixa a versão de novo, verificando o checksum e a assinatura. |
O agente registra os logs no journal com o systemd (journalctl -u infrafence-agent) e no syslog com upstart ou sysvinit.
Executar de novo
Executar o instalador de novo sem --token em um servidor já registrado atualiza o binário e o serviço e mantém o registro:
curl -fsSL https://github.com/infrafence/infrafence-agent/releases/latest/download/install.sh | sudo bashEle mostra Existing config found at /etc/infrafence/config.json — keeping current registration. Para conectar o servidor a outra organização, ou como um novo servidor, use --force-register com um novo token.
Se algo falhar
O instalador explica cada falha em um quadro com o próximo passo: uma dependência faltando, um download que falhou ou um registro que falhou (Invalid or expired install token, Server URL is unreachable, Server limit reached for your plan). Veja Solução de problemas.