Documentação

Instalação do Agente

O agente CS Command é um serviço leve desenvolvido em Go que roda como serviço do sistema operacional. Suporta Windows, Linux e macOS.

Pré-requisitos

  • Conexão à internet (HTTPS porta 443)
  • Windows 10/Server 2016+ | Ubuntu 20.04+ | macOS 12+
  • Permissões de administrador/root
  • Token de instalação gerado no painel

Gerando o token de instalação

No painel CS Command, acesse Dispositivos → Instalar agente e clique em Gerar token. O token tem validade de 24 horas e pode ser usado em múltiplos dispositivos.

Windows

Instalação via PowerShell (recomendado)

# Execute como Administrador $token = "csi_SEU_TOKEN_AQUI" $url = "https://api.cs-command.com/api/v1/installer/script?platform=windows&token=$token" Invoke-WebRequest -Uri $url -OutFile install.ps1 Set-ExecutionPolicy Bypass -Scope Process -Force .\install.ps1

O script instala o agente como serviço Windows (cs-agent), configura o arquivo YAML em %ProgramData%\CS Command\config.yamle inicia automaticamente.

Instalação manual (MSI)

Baixe o instalador MSI em Dispositivos → Baixar instaladore execute com as seguintes propriedades:

msiexec /i cs-agent.msi INSTALL_TOKEN=csi_SEU_TOKEN SERVER_URL=https://api.cs-command.com /qn

Linux

Ubuntu / Debian

# Execute como root curl -fsSL https://api.cs-command.com/api/v1/installer/script?platform=linux&token=csi_SEU_TOKEN | bash

O agente é instalado em /usr/local/bin/cs-agent com unidade systemd (cs-agent.service).

RHEL / CentOS / Fedora

curl -fsSL https://api.cs-command.com/api/v1/installer/script?platform=linux&token=csi_SEU_TOKEN | bash

Verificar status

systemctl status cs-agent journalctl -u cs-agent -f # logs em tempo real

macOS

# Execute como administrador curl -fsSL https://api.cs-command.com/api/v1/installer/script?platform=macos&token=csi_SEU_TOKEN | bash

O agente é instalado como LaunchDaemon em/Library/LaunchDaemons/com.cs-command.agent.plist.

Configuração manual

O arquivo de configuração YAML aceita as seguintes opções:

# /etc/cs-command/config.yaml (Linux/macOS) # %ProgramData%\CS Command\config.yaml (Windows) server_url: https://api.cs-command.com agent_key: csa_SUA_CHAVE_AQUI heartbeat_interval: 60s inventory_interval: 12h log_level: info

Desinstalação

Windows

sc stop cs-agent sc delete cs-agent Remove-Item "C:\ProgramData\CS Command" -Recurse

Linux

systemctl stop cs-agent && systemctl disable cs-agent rm /usr/local/bin/cs-agent /etc/systemd/system/cs-agent.service rm -rf /etc/cs-command