Usar um Token de Acesso Pessoal (PAT) do GitHub é a maneira mais confiável de contornar os limites de taxa (rate limits) da API do GitHub. Embora o atualizador suporte proxies públicos, um token fornece um limite privado e significativamente maior (5.000 requisições por hora).Documentation Index
Fetch the complete documentation index at: https://docs.fau.fpt.icu/llms.txt
Use this file to discover all available pages before exploring further.
Por que usar um token?
- Confiabilidade: Você não compartilha o limite com outros usuários de um proxy público.
- Velocidade: Sem saltos extras através de servidores de proxy.
- Privacidade: Suas verificações de atualização são realizadas diretamente entre sua máquina e o GitHub.
Criando um token
- Vá para as suas Configurações de Token do GitHub.
- Clique em Generate new token (classic).
- Dê um nome descritivo como
fp-appimage-updater. - Nenhum escopo é necessário. Para repositórios públicos, o token só precisa do acesso padrão “public access” para ler metadados de release. Não marque nenhuma caixa, a menos que esteja atualizando de repositórios privados.
- Clique em Generate token e copie-o imediatamente.
Métodos de configuração
1. Variável de Ambiente (Mais Privado)
A variável de ambienteGITHUB_TOKEN é a forma mais segura porque nunca toca o seu disco em texto simples se gerenciada corretamente (ex: via um gerenciador de segredos ou perfil de shell criptografado).
2. Arquivo de Segredos (Recomendado para Dotfiles)
Crie um arquivosecrets.yml. Isso permite manter suas credenciais separadas do seu config.yml, facilitando a exclusão do Git ou a criptografia usando ferramentas como sops, age ou git-crypt.
Arquivo: ~/.config/fp-appimage-updater/secrets.yml
3. Configuração Global
Você pode adicioná-lo aoconfig.yml, mas isso é desencorajado se você compartilha seus dotfiles publicamente.
Melhores Práticas
Use un token dedicado
Não reutilize seu token principal de desenvolvimento. Crie um token “classic” ou “fine-grained” especificamente para esta ferramenta com permissões mínimas.Isolamento de segurança
O fp-appimage-updater foi projetado com a segurança em mente:- Sem vazamento para Proxy: O token nunca é enviado para as URLs configuradas em
github_proxy_prefix. Ele é enviado apenas paraapi.github.com. - Apenas em Memória: Quando carregado do
config.ymlousecrets.yml, o token é armazenado em memória e nunca é escrito de volta no disco pelo aplicativo.
Criptografia de Dotfiles
Se você armazena sua configuração em um repositório público, use osecrets.yml e adicione-o ao seu .gitignore, ou use uma ferramenta de criptografia:
- sops: Criptografe o
secrets.ymle descriptografe-o apenas quando necessário. - Variáveis de ambiente: Use a CLI de um gerenciador de senhas (como
bw,opoulpass) para injetar o token: