Perguntas frequentes e resolução de problemas
Perguntas gerais
Que servidores é que o gyokuro suporta?
Gitea e Forgejo — autoalojados, com quantas instâncias quiseres em simultâneo.
O gyokuro também funciona com certificados autoassinados ou atrás de um proxy?
Sim. O gyokuro suporta certificados autoassinados, mTLS, proxies HTTP/SOCKS, cabeçalhos HTTP próprios e Basic Auth — pensado exatamente para este tipo de configurações de homelab.
Como é que recebo notificações push?
Através da tua própria instância de ntfy ou Gotify — self-hosted até ao fim. Além disso há notificações locais e um relatório semanal opcional.
Os meus dados de acesso são carregados para algum lado?
Não. Tokens e dados de acesso ficam exclusivamente no porta-chaves do iOS, no teu dispositivo. Sem cloud, sem monitorização por terceiros.
Resolução de problemas
A autenticação falha
O registo em direto durante a autenticação mostra cada passo da verificação da ligação — aí vês logo se o problema está no URL, no certificado ou no token. Verifica também se o token tem as permissões necessárias.
O meu servidor exige autenticação para a API
Servidores que só permitem acesso à API com autenticação são suportados desde a versão 2.1 — atualiza a app.
As execuções ou os logs das Actions não aparecem
As Gitea Actions têm de estar ativadas no servidor (na configuração do servidor e no respetivo repositório). Sem as Actions ativadas, a secção fica vazia.
O push por ntfy/Gotify não chega
Verifica o URL e o topic da tua própria instância nas definições e dá uma vista de olhos aos filtros de notificações — podem ser restringidos por repositório e por tipo.
Erros de certificado ao ligar
Com certificados autoassinados tens de permitir o certificado explicitamente nas definições do servidor da app, ou configurar mTLS/cabeçalhos próprios em conformidade.