dnsblock/README.md
2025-12-05 13:38:08 -03:00

96 lines
1.8 KiB
Markdown

# DNSBlock
Agente do DNSBlock para Linux.
## Instalação e Configuração
```bash
curl -sS https://install.dnsblock.app | bash
```
## Instalação Manual
O agente deve ser instalado como um serviço do sistema (Systemd) para garantir execução contínua e reinício automático.
### 1. Instalação dos Arquivos
Você pode clonar o repositório oficial diretamente no diretório de destino:
```bash
# Acessar diretório de programas opcionais
cd /opt
# Clonar o repositório (criará a pasta /opt/dnsblock)
sudo git clone https://git.ipv0.com.br/0/dnsblock.git
# Entrar no diretório
cd dnsblock
# Configurar permissão de execução
sudo chmod +x dnsblock-agent
```
### 2. Configuração
Renomeie o arquivo de exemplo e edite com seus dados:
```bash
# Criar arquivo de configuração a partir do exemplo
sudo cp config.json.example config.json
# Editar
sudo nano config.json
```
Insira sua **Serial Key** fornecida no painel de administração.
### 3. Criar Serviço Systemd
Crie o arquivo de serviço para o gerenciador do sistema:
```bash
sudo nano /etc/systemd/system/dnsblock-agent.service
```
Cole o seguinte conteúdo:
```ini
[Unit]
Description=DNSBlock Agent Service
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=/opt/dnsblock
ExecStart=/opt/dnsblock/dnsblock-agent
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
```
### 4. Ativar e Iniciar
Habilite o serviço para iniciar com o sistema e rode-o agora:
```bash
# Recarregar daemon do systemd
sudo systemctl daemon-reload
# Habilitar inicialização automática
sudo systemctl enable dnsblock-agent
# Iniciar o serviço
sudo systemctl start dnsblock-agent
```
### 5. Verificar Status
Para confirmar se o agente está rodando corretamente:
```bash
sudo systemctl status dnsblock-agent
```