astrina

Pulsar — Guia de configuração

Conecte um dispositivo em minutos — escolha a forma que se adapta, de um telefone a um servidor reserva.

Extensão do navegadorAgente CLIAgente CLI em um servidor (VPS ou dedicado)Aplicativo móvel (iOS / Android)
  1. 1 Código de aparelhamento
  2. 2 Dispositivo online
  3. 3 Primeiro resultado

01Passo 1 — obtenha um código de emparelhamento

Faça login e abra sua página de dispositivos, então crie um código de emparelhamento. Ele dura 15 minutos e funciona para todos os tipos de agentes; uma conta pode ter até 5 dispositivos.

02Passo 2 — conecte um dispositivo

Extensão do navegador

Funciona silenciosamente enquanto seu navegador está aberto. Instale-o, cole o código de emparelhamento — pronto.

Chrome / Edge: chrome://extensions → Modo desenvolvedor → Carregar descompactado (descompacte primeiro).

Firefox: about:debugging → Este Firefox → Carregar Complemento Temporário (descompacte primeiro, escolha manifest.json).

Baixar para Chrome / Edge Baixar para Firefox

Agente CLI no seu computador

Um arquivo PHP para servidores e desktops. Necessita php-cli 8+ com curl. Baixe o agente, então em um terminal:

shell
php pulsar-agent.php pair <CODE> --accept-terms --label=my-pc
php pulsar-agent.php run

Prefere um ícone na bandeja a um terminal? O wrapper de desktop é um pequeno aplicativo Electron em torno deste mesmo agente — fontes e instruções de construção, você constrói por conta própria. Baixar as fontes de desktop

Baixar agente

Checksum do agente (SHA-256): 69b3aa1d28eeea225dcda6692ad10f7d7c8823954ebbd3e6726d46b89ed0da9d
Verifique após o download: echo "69b3aa1d28eeea225dcda6692ad10f7d7c8823954ebbd3e6726d46b89ed0da9d pulsar-agent.php" | sha256sum -c · Todos os checksums

Agente CLI em um servidor (VPS ou dedicado)

Um nó de servidor funciona 24/7, constrói confiança mais rápido e ganha de forma mais consistente. Requisitos: qualquer Linux com php-cli 8+ e a extensão curl — nada mais, sem necessidade de root.

Mais rápido: uma linha (verifica o download antes de instalar)

shell
curl -fsSL "https://astrina.io/pulsar/setup?install" | sh -s <CODE>

O script se recusa a instalar qualquer coisa cujo SHA-256 não corresponda ao digest que publicamos em SHA256SUMS — leia primeiro com curl -fsSL "https://astrina.io/pulsar/setup?install" | less se preferir, nós faríamos.

Ou faça isso manualmente — baixe o agente diretamente para o servidor:

shell
mkdir -p ~/pulsar && cd ~/pulsar
wget -O pulsar-agent.php "https://astrina.io/pulsar/setup?dl=agent"

Emparelhe-o (a bandeira confirma os termos de participação):

shell
php pulsar-agent.php pair <CODE> --accept-terms --label=my-server

Mantenha-o em execução — seja como um serviço systemd (recomendado):

/etc/systemd/system/pulsar-node.service
[Unit]
Description=Pulsar node agent (astrina.io)
After=network-online.target
Wants=network-online.target

[Service]
User=youruser
ExecStart=/usr/bin/php /home/youruser/pulsar/pulsar-agent.php run
Restart=always
RestartSec=30
# optional resource ceiling
CPUQuota=40%
MemoryMax=512M

[Install]
WantedBy=multi-user.target
shell
systemctl daemon-reload
systemctl enable --now pulsar-node
journalctl -u pulsar-node -f

…ou simplesmente em segundo plano:

shell
nohup php pulsar-agent.php run >/dev/null 2>&1 &

Os limites de CPU e memória na unidade são um teto opcional — o agente em si é um processo PHP usando alguns megabytes.

Windows (como um serviço)

Instale o PHP para Windows, depois use o NSSM (nssm.cc) para executar o agente como um serviço:

cmd
php pulsar-agent.php pair <CODE> --accept-terms --label=my-pc
nssm install PulsarNode "C:\php\php.exe" "C:\pulsar\pulsar-agent.php" run
nssm start PulsarNode
Muitas máquinas ao mesmo tempo

Configure uma máquina da maneira que você deseja, depois leve suas configurações para as demais. A exportação deliberadamente omite a identidade, para que cada máquina ainda se emparelhe como seu próprio dispositivo — copiar uma identidade para uma frota faria com que todas relatassem como um único dispositivo.

shell
php pulsar-agent.php export-config > pulsar-fleet.json
# on every other machine:
php pulsar-agent.php import-config pulsar-fleet.json
php pulsar-agent.php pair <CODE> --accept-terms --label=$(hostname)

Mover um dispositivo para novo hardware é o caso oposto — lá você realmente quer a identidade, e a bandeira diz isso:

shell
php pulsar-agent.php export-config --with-identity > device.json   # contains a secret
php pulsar-agent.php import-config device.json --with-identity
Verifique se o agente não foi alterado

O instalador verifica o download; isso re-verifica o arquivo no disco depois, e o agente em execução repete isso uma vez por dia. Ele distingue uma versão desatualizada de uma alterada. É um alarme de fumaça, não uma fechadura: qualquer um que possa editar o arquivo também poderia remover a verificação.

shell
php pulsar-agent.php verify
Docker
shell
wget -O Dockerfile "https://astrina.io/pulsar/setup?dl=dockerfile"
docker build -t astrina/pulsar-node .
docker run --rm -v pulsar:/data astrina/pulsar-node pair <CODE> --accept-terms --config=/data/agent.json
docker run -d --restart=unless-stopped --cpus=0.5 --memory=256m -v pulsar:/data astrina/pulsar-node

Prefere Docker Compose? Baixe os três arquivos e execute em um único comando:

shell
wget -O pulsar-agent.php   "https://astrina.io/pulsar/setup?dl=agent"
wget -O Dockerfile         "https://astrina.io/pulsar/setup?dl=dockerfile"
wget -O docker-compose.yml "https://astrina.io/pulsar/setup?dl=compose"
docker compose run --rm pulsar pair <CODE> --accept-terms --config=/data/agent.json
docker compose up -d

Aplicativo móvel (iOS / Android)

Abra a tela de Nós no aplicativo Astrina e insira o código de emparelhamento — seu telefone se junta como um ponto de vista enquanto o aplicativo está aberto. O mesmo código de emparelhamento funciona para todos os tipos de agente.

Mini App do Telegram

Responda a pequenas perguntas de rotulagem de IA em momentos livres — sem instalação. Seu julgamento se torna dados de treinamento, verificados por acordo. Abra o Mini App no Telegram — rotulando tarefas, saldo e seus dispositivos, direto no telefone.

03Passo 3 — verifique se funciona

Dentro de um minuto, o dispositivo se torna “ativo” na sua página de dispositivos e “última vez visto” começa a atualizar. As primeiras tarefas são verificações de controle ocultas; as tarefas do cliente são abertas uma vez que a rede tenha três ou mais dispositivos ativos.

Pausar ou remover um dispositivo a qualquer momento da sua página de dispositivos — o agente obedece imediatamente. Um dispositivo offline por mais de um dia aciona uma notificação para você.

Um único dispositivo sempre ligado ganha alguns AP por dia, não um salário. AP não tem taxa em relação ao dinheiro; quanto o pool contém depende de quanto trabalho pago a rede tem.

Se algo der errado

  • O código de emparelhamento expirou — os códigos duram 15 minutos; basta criar um novo.
  • Perdeu o segredo do dispositivo (~/.pulsar-agent.json) — remova o dispositivo na sua página de dispositivos e emparelhe novamente.
  • “Agente muito antigo” — baixe o arquivo do agente atualizado e reinicie-o.

Perguntas? Veja como o Pulsar funciona ou abra seu painel. Leia os Termos de Participação

O que esta página responde

  • como conectar um nó Pulsar
  • extensão de navegador para Pulsar
  • nó em um servidor via systemd
  • nó em um telefone
  • configurando o Pulsar CLI
  • o que é um nó Pulsar
  • como um nó Pulsar funciona
  • um nó Pulsar explicado
  • guia de um nó Pulsar
  • como começar com um nó Pulsar
  • avaliações de um nó Pulsar
  • vale a pena um nó Pulsar
  • preços de um nó Pulsar
  • um nó Pulsar alternativas
  • um nó Pulsar para iniciantes
  • por que um nó Pulsar
  • um nó Pulsar — o que você recebe