seowatcher Instalar com Docker
Instale com Docker no Mac, no Linux e no Windows. Um comando basta e não é preciso criar um arquivo .env. Seus dados ficam no volume de dados do Docker.
Ao fim desta página, o aplicativo estará rodando no Docker (um
programa que executa aplicativos em contêineres isolados) e aberto em
http://localhost:3001. Se você usa Windows, o instalador
de arquivo único é bem mais fácil. Esta página é para Mac, Linux e
para quem já usa Docker. A primeira inicialização leva alguns minutos,
porque o aplicativo é construído dentro do contêiner. As
inicializações seguintes levam segundos.
O que você precisa
- No Windows, o Docker Desktop exige o WSL 2 e a virtualização ativada na BIOS/UEFI.
- Docker Desktop (Mac, Windows) ou Docker Engine com Docker Compose (Linux).
- Git. Se você não tiver, Code → Download ZIP na página do GitHub também serve.
- Cerca de 2 GB de espaço livre em disco e 2 GB de memória livre durante a primeira construção.
Passos
- Baixe o repositório (os arquivos do projeto) e entre na pasta dele:
git clone https://github.com/ucsahinn/seotracker.git
cd seotracker- Inicie o aplicativo:
docker compose up -d
É só isso. Não é preciso um arquivo .env. A chave de
criptografia e a senha do assistente são criadas automaticamente na
primeira inicialização e guardadas no volume de dados do Docker.
- Se quiser acompanhar o progresso, execute isto:
docker compose logs -f-
Aguarde. No registro, a linha "Building client + server" é
a primeira construção. Espere até que
docker compose psmostre o estado healthy e depois abrahttp://localhost:3001no navegador.
O próximo passo é o guia da conexão com o Google. No Docker, os dois endereços de redirecionamento que você informa ao Google são:
http://localhost:3001/api/gsc/oauth/callbackhttp://localhost:3001/api/ga4/oauth/callback
Atualização
Execute estes dois comandos:
git pull
docker compose up -d --build
Ayarlar → Hakkında (Configurações → Sobre) avisa da
versão nova e mostra esses dois comandos. Seus dados ficam no volume
de dados chamado seotracker_data, então a atualização não
os apaga.
Parar e remover
- Para parar:
docker compose stop - Para iniciar de novo:
docker compose up -d -
Para remover o contêiner e manter os dados:
docker compose down -
Para apagar também os dados:
docker compose down -v. Este comando apaga de forma permanente o banco de dados, as conexões com o Google e os relatórios.
Backup
Seus dados estão no volume seotracker_data, no caminho
/app/.wrangler dentro do contêiner. Para fazer um backup,
execute estes três comandos, nesta ordem:
docker compose stop
docker run --rm -v seotracker_data:/data -v "$PWD":/backup alpine tar czf /backup/seotracker-yedek.tgz -C /data .
docker compose up -d
Para restaurar, use tar xzf no lugar de
tar czf no mesmo comando. O arquivo
instance-secret, no volume de dados, é a chave que
criptografa as conexões com o Google. Sem ele, o backup é restaurado
sem as conexões com o Google.
Configurações (opcional)
Nenhuma configuração é obrigatória. Se quiser mudar algo, coloque um
arquivo .env na pasta do projeto. Depois execute
docker compose up -d --force-recreate seotracker.
| Nome da configuração | O que faz |
|---|---|
| PORT | O número da porta, 3001 por padrão. Quando ele muda, os endereços de redirecionamento do Google também mudam |
| ALLOWED_HOST | O nome pelo qual o aplicativo é acessado de fora, se houver outro servidor na frente. Se estiver vazio, só localhost |
| AUTH_MODE |
local_noauth (padrão) ou
cloudflare_access
|
| BETTER_AUTH_SECRET | A chave de criptografia. Deixe vazia e o aplicativo cria uma. Se você a definir à mão, use pelo menos 32 caracteres e depois não a altere |
| GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET | Uma alternativa a informá-los na tela Ayarlar (Configurações). O valor informado na tela tem prioridade |
| PAGESPEED_API_KEY | Uma alternativa a informá-la na tela Ayarlar (Configurações) |
| MCP_TOKEN |
Se estiver vazio, é criado na primeira inicialização. Se você
escrever off, nenhuma senha é pedida. Qualquer
outro valor é usado como está
|
Verificação
-
Na saída de
docker compose ps, o estado deve ser healthy. Na primeira inicialização, pode levar até cinco minutos para chegar a ele. -
A saída de
curl.exe http://127.0.0.1:3001/api/healthdeve começar com "status":"ok". Você também pode abrirhttp://127.0.0.1:3001/api/healthno navegador. -
http://localhost:3001deve abrir no navegador. O cartão de estado da tela Yardım (Ajuda) deve dizer "Her şey yolunda." (Está tudo certo.) Antes de conectar o Google, a linha "Google girişi" (Login do Google) pede atenção. Isso é normal.
Perguntas frequentes
Por que a primeira inicialização demora? O aplicativo é construído dentro do contêiner. Nas inicializações seguintes, a construção é pulada.
Onde está o arquivo .env.example? Não há
nenhum. Esse arquivo, herdado do projeto de origem, descrevia coisas
que não existem nesta versão. A lista completa está na tabela acima e
no arquivo docs/ENVIRONMENT.md.
Posso abri-lo para a internet? O aplicativo não
pergunta quem você é. Não o abra sem colocar sua própria autenticação
na frente. Se você definir ALLOWED_HOST, o aplicativo
avisa na verificação de saúde.
Onde pego a senha do meu assistente? A tela
Ajan kurulumu (Configuração do agente) do aplicativo
mostra o comando:
docker compose exec -T seotracker cat
/app/.wrangler/mcp-token. Se você usa o Git Bash, coloque MSYS_NO_PATHCONV=1 na
frente.
Se algo der errado
-
Aparece "Bind for 127.0.0.1:3001 failed".
O número da porta está em uso. Coloque na pasta do projeto um
arquivo
.envcom a linhaPORT=3002e recrie o contêiner. No Windows, o Bloco de Notas pode salvar o arquivo como.env.txt. No PowerShell,Set-Content -Encoding ascii .env 'PORT=3002'é seguro. -
O estado é "unhealthy".
docker compose logs --tail 50mostra as últimas linhas. Se a memória acabou durante a construção, dê mais memória ao Docker Desktop. -
A conexão com o Google diz "yapılandırılmamış" (não
configurada).
Se
BETTER_AUTH_SECRETtiver menos de 32 caracteres, o Google fica desligado. Se você a definiu à mão, deixe-a mais longa. Se não definiu, o arquivoinstance-secretno volume de dados pode estar danificado. -
A conexão com o Google caiu depois de uma atualização.
BETTER_AUTH_SECRETmudou ou o volume de dados foi recriado. Escolha Yeniden bağlan (Reconectar) nas configurações do projeto.