Geração sem servidor de código QR permanente da Microsoft

Introdução geral

O serverless-qrcode-hub é uma ferramenta de código aberto projetada para resolver o problema da falha frequente dos códigos QR nos bate-papos em grupo do WeChat. Ela se baseia no Cloudflare Workers e no banco de dados D1, sem a necessidade de execução de servidores tradicionais. Os usuários podem gerar um código QR de grupo WeChat permanentemente válido para facilitar o gerenciamento do bate-papo em grupo e, ao mesmo tempo, oferecer suporte a qualquer link longo para um link curto. O projeto oferece um backend de gerenciamento que permite aos usuários atualizar o código QR ou o conteúdo do link curto a qualquer momento, além de oferecer suporte a estilos personalizados e proteção por senha. A implantação é simples, a cota gratuita é suficiente para o uso diário, adequada para indivíduos, equipes ou desenvolvedores. O código está disponível publicamente no GitHub, e a comunidade é livre para otimizá-lo e ampliá-lo.

Lista de funções

• Gere um código QR permanentemente válido para o bate-papo em grupo do WeChat para resolver o problema de falha.
• Converta links longos em links curtos para facilitar o compartilhamento e a distribuição.
• Suporte para estilos de código QR personalizados, incluindo cores, bordas e logotipos.
• Fornece back-end de gerenciamento para atualizar o conteúdo do código QR ou do link curto a qualquer momento.
• Oferece suporte à proteção por senha para restringir o acesso não autorizado.
• Com base no Cloudflare Workers e no banco de dados D1, não são necessários servidores.
• Código-fonte aberto com suporte para modificações e extensões do usuário.
• Limpa automaticamente os dados expirados para manter seu sistema eficiente.

Usando a Ajuda

Instalação e implementação

O serverless-qrcode-hub é executado usando a plataforma Cloudflare Workers e não requer um servidor tradicional. Aqui estão as etapas detalhadas da implantação:

1. Registre-se em uma conta da Cloudflare
   Visite o site da Cloudflare para se registrar em uma conta gratuita. As contas existentes podem ser conectadas diretamente.
2. Criação de um banco de dados D1
   Faça login no painel de controle da Cloudflare e acesse Workers and Pages > D1 > Create Database.
   • Nomeie o banco de dados, por exemplo. qrcode-db.
   • Copie o ID do banco de dados após a criação e use-o posteriormente.
3. Bifurcar o repositório do GitHub
   entrevistas Armazém de projetosEm seguida, clique no botão "Fork" no canto superior direito para copiar o repositório para sua conta do GitHub.
4. compilador wrangler.toml
   Em seu repositório Fork, abra o arquivo wrangler.toml clique no botão Editar. Localize a seção [d1_databases] Em parte, ele irá database_id Substitua pelo ID do banco de dados D1 copiado na etapa 2. Exemplo:

   [[d1_databases]]
   binding = "DB"
   database_name = "qrcode-db"
   database_id = "<你的数据库ID>"
   

   Salve e confirme as alterações.

5. Criação de um Cloudflare Worker
   Volte ao painel do Cloudflare e selecione Workers and Pages > Create Worker.
   • Nome do trabalhador, por exemplo qrcode-hub.
   • Clique em Configuration > Git Integration e selecione o repositório do GitHub com o qual está trabalhando.
   • Clique em "Save and Deploy" (Salvar e implantar).
6. Vincular nomes de domínio personalizados (opcional)
   Após uma implantação bem-sucedida, a Cloudflare fornece o padrão *.workers.dev Nome de domínio. Se for necessário um acesso mais rápido ou uma marca:
   • Vá para "Workers" > "Triggers" > "Add Custom Domain" (Adicionar domínio personalizado).
   • Insira um subdomínio hospedado na Cloudflare (por exemplo qr.example.com).
   • Siga os prompts para concluir a configuração do DNS.
7. Definição de uma senha de acesso
   No painel da Cloudflare, vá para Worker Settings (Configurações do trabalhador) e encontre a seção Environment Variables (Variáveis de ambiente). Adicione a variável PASSWORDo valor é uma senha personalizada (recomenda-se uma combinação de letras e números, por exemplo, duas cadeias de caracteres UUID, como a1b2c3d4-e5f6g7h8). Depois de salva, essa senha é necessária para acessar o backend de administração.
8. Validação da implantação
   Após a conclusão da implantação, o acesso à *.workers.dev ou um domínio personalizado. Se você vir a página de login, a implementação foi bem-sucedida.

Instruções de upgrade

A versão antiga do projeto (baseada no Cloudflare KV, versão ≤ v1.2.0) não é mais recomendada devido às restrições de cota gratuita. A nova versão é baseada no banco de dados D1 e suporta 5 milhões de leituras para um desempenho mais estável.

• Guia de migração: Referência MIGRAR.md.
• Versão antiga do documento: Ver README.v1.md.

Uso das funções principais

Após a conclusão da implantação, os usuários podem acessar a ferramenta pelo navegador. Veja a seguir o procedimento detalhado de operação:

Gerar código QR permanente da Microsoft

1. Acesso ao histórico de gerenciamento
   Abra o domínio Workers (por exemplo https://qrcode-hub.<你的账户>.workers.dev) ou um nome de domínio personalizado. Digite a senha definida para fazer login.
2. Adicionar link do WeChat
   No plano de fundo da administração, clique em "Add WeChat QR Code" (Adicionar código QR do WeChat).
   • Digite o link original do bate-papo em grupo do WeChat (geralmente um link de código QR temporário).
   • Opcionalmente, você pode carregar um logotipo (recomenda-se o formato PNG/JPG, com menos de 100x100 pixels).
   • Ajuste a cor ou a borda do código QR (primeiro plano preto padrão, fundo branco).
   • Clique em "Generate" (Gerar).
3. Obter código QR e link curto
   O sistema retorna imagens de código QR e links curtos (por exemplo https://qr.example.com/abc123) Digitalize o código QR para entrar diretamente no bate-papo em grupo, e o link curto pode ser compartilhado no WeChat ou em outras plataformas.
4. Atualizar o link do chat de grupo
   Se o link original do bate-papo em grupo não estiver funcionando, vá para o plano de fundo da administração, localize o registro do código QR correspondente e atualize-o para um novo link de bate-papo em grupo. Após a atualização, o código QR e o link curto permanecerão inalterados, de modo que os usuários não precisarão compartilhá-los novamente.

Serviço de encurtamento de URL

1. Adicionar link longo
   No painel de administração, clique em "Add Common Shortlink".
   • Cole qualquer link longo (por exemplo, artigo, endereço de download de arquivo).
   • Sufixos de links curtos opcionalmente personalizáveis (por exemplo abc123).
   • Clique em "Generate" (Gerar).
2. Obter link curto
   O sistema retorna um link curto no qual é possível clicar para testar se ele salta para a página original. Os links curtos podem ser usados em mídias sociais, e-mails e outros cenários.
3. Gerenciamento de links curtos
   Visualize todos os links curtos no backend do administrador, suporte à edição, exclusão ou visualização de registros de saltos.

Estilos de código QR personalizados

1. Ajuste da aparência
   Ao adicionar um código QR, clique em "Advanced Options" (Opções avançadas).
   • Carregar logotipo (para aprimorar a marca)
   • Selecione as cores do primeiro plano e do plano de fundo (para garantir alto contraste e facilidade de digitalização).
   • Defina a largura da borda ou o efeito de canto arredondado.
2. Visualizar e salvar
   Clique em "Preview" (Visualizar) para ver o efeito e confirme para gerar o código QR final.

Gerenciamento de proteção por senha

• Sempre que acessar o backend de administração, será necessário inserir a senha que você configurou no momento da implementação.
• Para alterar sua senha, atualize-a no painel de controle da Cloudflare PASSWORD e reimplantar o trabalhador.

advertência

• raçãoAs contas gratuitas do Cloudflare Workers oferecem 100.000 solicitações por dia e o banco de dados D1 suporta 5 milhões de leituras, o suficiente para uso pessoal. Para cenários de alto tráfego, você pode fazer upgrade para um plano pago.
• backupO banco de dados D1 armazena todos os dados de códigos QR e links curtos, e é recomendável exportar backups regularmente (por meio das ações do painel do Cloudflare).
• Velocidade do domínio: Padrão *.workers.dev O nome de domínio em algumas áreas de acesso é lento, por isso é recomendável vincular um nome de domínio personalizado.
• garantiaAs senhas precisam ser complexas o suficiente para evitar vazamentos. O conteúdo de links curtos e códigos QR deve ser legal e estar em conformidade.

operação de amostra

• Criação de links curtos: Entrada https://example.com/long-urlGerar https://qr.example.com/xyz789clique no botão de teste.
• Criar um código QR para o WeChatDigite o link do bate-papo em grupo, carregue o logotipo, gere o código QR e salve a imagem para compartilhá-la com o grupo ou círculo de amigos do WeChat.
• atualizar um registroLocalize o registro do código QR no plano de fundo do gerenciamento, substitua o link inválido e confirme se o usuário pode continuar a usar o código QR original.

Com essas etapas, os usuários podem implementar rapidamente o serverless-qrcode-hub para gerar códigos QR permanentes ou links curtos. O back-end de gerenciamento é intuitivo e não requer experiência em programação para começar.

cenário do aplicativo

1. Gerenciamento de grupos do WeChat
   Os administradores de grupo precisam compartilhar o código QR do bate-papo em grupo por um longo período. O serverless-qrcode-hub gera um código QR permanente que evita o problema de alterações frequentes, e os membros podem escanear o código para participar a qualquer momento.
2. Atividades de marketing
   Os comerciantes podem transformar os links de registro de eventos em links curtos e códigos QR, imprimi-los em folhetos ou publicá-los nas mídias sociais. Os logotipos personalizados aprimoram a marca e o painel de administração permite atualizações de links a qualquer momento.
3. Compartilhamento de conteúdo
   Blogueiros ou criadores de conteúdo encurtam links para artigos e vídeos, geram códigos QR e os incorporam em cartões de visita ou pôsteres para facilitar o acesso dos fãs.
4. Educação e treinamento
   As organizações de treinamento transformam os links dos cursos em códigos QR e os imprimem em livros didáticos ou anúncios. Os alunos podem escanear o código para se inscrever, e as atualizações de links não afetam o uso do código QR.
5. Promoção de projetos de código aberto
   Os desenvolvedores transformam os links do repositório do GitHub em links curtos, geram códigos QR e os compartilham com comunidades ou documentos para facilitar o acesso.

QA

1. O código QR gerado será invalidado?
   Desde que o Cloudflare Workers e o banco de dados D1 estejam funcionando corretamente, o código QR é válido para sempre. Mesmo que o link original do chat em grupo não funcione, ele pode ser atualizado por meio do backend do administrador e o código QR não precisa ser substituído.
2. Preciso de experiência em programação para implantar?
   Não há necessidade. A implementação é feita apenas passo a passo, e a interface de back-end de gerenciamento é amigável e adequada para usuários não básicos.
3. Uma conta gratuita é suficiente?
   A cota gratuita da Cloudflare (100.000 solicitações/dia, 5 milhões de leituras de banco de dados) é suficiente para um indivíduo ou uma equipe pequena. Cenários de alto tráfego podem considerar um plano pago.
4. Como você mantém seus dados seguros?
   Os dados são armazenados no banco de dados D1 e a senha protege o backend de administração. Recomenda-se fazer backup do banco de dados regularmente e definir senhas complexas.
5. Quais são os links suportados?
   É compatível com qualquer URL legal, inclusive links do WeChat, páginas da Web, downloads de arquivos etc. Recomenda-se testar a validade do link antes de gerá-lo.
6. Como faço para atualizar os usuários mais antigos?
   consulta MIGRAR.mdA nova versão do código foi reimplantada com a migração dos dados KV para o banco de dados D1.