Генерация постоянного QR-кода microsoft без использования сервера

Практические уроки по искусственному интеллектуОбновлено 5 месяцев назад Круг обмена ИИ

9.4K 00

Общее введение

serverless-qrcode-hub - это инструмент с открытым исходным кодом, предназначенный для решения проблемы частых сбоев QR-кодов в групповых чатах WeChat. Он основан на Cloudflare Workers и базе данных D1, без необходимости запуска традиционных серверов. Пользователи могут генерировать постоянно действующий QR-код группы WeChat, чтобы облегчить управление групповым чатом, поддерживая при этом любую длинную ссылку на короткую. Проект предоставляет бэкэнд управления, который позволяет пользователям обновлять содержимое QR-кода или короткой ссылки в любое время, а также поддерживает настраиваемые стили и защиту паролем. Развертывание простое, бесплатной квоты достаточно для ежедневного использования, подходит для отдельных пользователей, команд или разработчиков. Код находится в открытом доступе на GitHub, и сообщество может свободно оптимизировать и расширять его.

Список функций

Сгенерируйте постоянно действующий QR-код для группового чата WeChat, чтобы решить проблему сбоев.
Преобразуйте длинные ссылки в короткие для удобства обмена и распространения.
Поддержка пользовательских стилей QR-кодов, включая цвета, границы и логотипы.
Предоставьте бэкэнд управления для обновления содержимого QR-кода или короткой ссылки в любое время.
Поддерживает защиту паролем для ограничения несанкционированного доступа.
Работает на базе Cloudflare Workers и базы данных D1, серверы не требуются.
Открытый исходный код с поддержкой пользовательских модификаций и расширений.
Автоматически очищает данные с истекшим сроком хранения, обеспечивая эффективность работы системы.

Использование помощи

Установка и развертывание

serverless-qrcode-hub работает на платформе Cloudflare Workers и не требует традиционного сервера. Ниже приведены подробные шаги по развертыванию:

Зарегистрируйте учетную запись Cloudflare
Посетите веб-сайт Cloudflare, чтобы зарегистрировать бесплатную учетную запись. Существующие учетные записи можно регистрировать напрямую.
Создание базы данных D1
Войдите в приборную панель Cloudflare и перейдите в раздел Workers and Pages > D1 > Create Database.
- Назовите базу данных, например. qrcode-db.
- Скопируйте идентификатор базы данных после создания и используйте его в дальнейшем.
Форк репозитория GitHub
интервью Проект "СкладЗатем нажмите кнопку "Fork" в правом верхнем углу, чтобы скопировать репозиторий в свой аккаунт GitHub.
компилятор wrangler.toml
В вашем репозитории Fork откройте wrangler.toml файла, нажмите кнопку Изменить. Найдите [d1_databases] В частности, это будет database_id Замените на идентификатор базы данных D1, скопированный в шаге 2. например:
```
[[d1_databases]]
binding = "DB"
database_name = "qrcode-db"
database_id = "<你的数据库ID>"
```
Сохраните и зафиксируйте изменения.
Создание рабочего Cloudflare
Вернитесь на приборную панель Cloudflare и выберите Workers and Pages > Create Worker.
- Назовите имя работника, например. qrcode-hub.
- Нажмите Configuration > Git Integration и выберите репозиторий GitHub, с которым вы работаете.
- Нажмите "Сохранить и развернуть".
Привязка пользовательских доменных имен (необязательно)
После успешного развертывания Cloudflare по умолчанию предоставляет *.workers.dev Доменное имя. Если требуется более быстрый доступ или брендинг:
- Перейдите в раздел "Рабочие" > "Триггеры" > "Добавить пользовательский домен".
- Введите поддомен, размещенный на Cloudflare (например. qr.example.com).
- Следуйте подсказкам, чтобы завершить настройку DNS.
Установка пароля доступа
В панели Cloudflare перейдите в раздел Worker Settings и найдите раздел Environment Variables. Добавьте переменную PASSWORD, значение - пользовательский пароль (рекомендуется комбинация букв и цифр, например, две строки UUID, такие как a1b2c3d4-e5f6g7h8). После сохранения этот пароль необходим для доступа к бэкэнду администрирования.
Проверка развертывания
После завершения развертывания доступ к назначенному *.workers.dev домен или пользовательский домен. Если вы видите страницу входа в систему, значит, развертывание прошло успешно.

Инструкции по обновлению

Старая версия проекта (на базе Cloudflare KV, версия ≤ v1.2.0) больше не рекомендуется из-за ограничений по свободным квотам. Новая версия основана на базе данных D1 и поддерживает 5 миллионов чтений для более стабильной работы.

Руководство по миграции: Справочник MIGRATE.md.
Старая версия документа: Смотреть README.v1.md.

Использование основных функций

После завершения развертывания пользователи могут получить доступ к инструменту через браузер. Ниже приводится подробная процедура работы:

Генерировать постоянный QR-код microsoft

Доступ к управленческому фону
Откройте рабочий домен (например. https://qrcode-hub.<你的账户>.workers.dev) или пользовательское доменное имя. Введите установленный пароль для входа в систему.
Добавьте ссылку WeChat
На административном фоне нажмите "Добавить QR-код WeChat".
- Введите оригинальную ссылку на групповой чат WeChat (обычно это временная ссылка с QR-кодом).
- По желанию вы можете загрузить логотип (рекомендуется формат PNG/JPG, не более 100x100 пикселей).
- Настройте цвет или границы QR-кода (по умолчанию черный передний план, белый фон).
- Нажмите "Сгенерировать".
Получите QR-код и короткую ссылку
Система возвращает изображения QR-кодов и короткие ссылки (например. https://qr.example.com/abc123) Отсканируйте QR-код, чтобы присоединиться к групповому чату напрямую, а короткой ссылкой можно поделиться в WeChat или на других платформах.
Обновить ссылку на групповой чат
Если оригинальная ссылка на групповой чат не работает, перейдите в административный фон, найдите соответствующую запись QR-кода и обновите ее на новую ссылку на групповой чат. После обновления QR-код и короткая ссылка остаются неизменными, поэтому пользователям не нужно повторно их публиковать.

Сервис сокращения URL-адресов

Добавить длинную ссылку
В панели администратора нажмите "Добавить общую ссылку".
- Вставьте любую длинную ссылку (например, статью, адрес загрузки файла).
- Настраиваемые по желанию суффиксы коротких ссылок (например. abc123).
- Нажмите "Сгенерировать".
Получить короткую ссылку
Система возвращает короткую ссылку, чтобы проверить, переходит ли она на исходную страницу. Короткие ссылки можно использовать в социальных сетях, электронной почте и других сценариях.
Управление короткими ссылками
Просмотр всех коротких ссылок в бэкенде администратора, поддержка редактирования, удаления или просмотра записей о переходах.

Индивидуальные стили QR-кодов

Корректировка внешнего вида
При добавлении QR-кода нажмите "Дополнительные параметры".
- Загрузите логотип (для улучшения брендинга)
- Выберите цвета переднего и заднего плана (для обеспечения высокой контрастности и удобства сканирования).
- Установите ширину границы или эффект закругленных углов.
Предварительный просмотр и сохранение
Нажмите "Предварительный просмотр", чтобы увидеть эффект, и подтвердите, чтобы сгенерировать окончательный QR-код.

Управление защитой паролем

Каждый раз при входе в бэкэнд администрирования необходимо вводить пароль, заданный во время развертывания.
Чтобы изменить пароль, обновите его на панели управления Cloudflare PASSWORD переменную окружения и переразверните рабочий.

предостережение

рационCloudflare Workers: бесплатные аккаунты предлагают 100 000 запросов в день, а база данных D1 поддерживает 5 миллионов чтений, что вполне достаточно для личного использования. Для сценариев с высоким трафиком вы можете перейти на платный тарифный план.
резервное копирование: В базе данных D1 хранятся все данные о QR-кодах и коротких ссылках, поэтому рекомендуется регулярно экспортировать резервные копии (управляется через панель Cloudflare).
Скорость домена: По умолчанию *.workers.dev Доменное имя в некоторых зонах доступа медленное, рекомендуется привязать пользовательское доменное имя.
поручительство: Пароли должны быть достаточно сложными, чтобы избежать утечки. Содержание коротких ссылок и QR-кодов должно быть законным и соответствующим требованиям.

пробная операция

Создание коротких ссылок: Вход https://example.com/long-urlСоздать https://qr.example.com/xyz789Нажмите на тестовый переход.
Создание QR-кода для WeChat: Введите ссылку группового чата, загрузите логотип, сгенерируйте QR-код, а затем сохраните изображение, чтобы поделиться им с группой WeChat или кругом друзей.
обновление записи: Найдите запись QR-кода в фоновом режиме управления, замените недействительную ссылку и подтвердите, что пользователь может продолжать использовать оригинальный QR-код.

С помощью этих шагов пользователи могут быстро развернуть serverless-qrcode-hub для генерации постоянных QR-кодов или коротких ссылок. Бэкэнд управления интуитивно понятен и не требует опыта программирования для начала работы.

сценарий применения

Управление группами WeChat
Администраторам групп необходимо долгое время сообщать QR-код группового чата. serverless-qrcode-hub генерирует постоянный QR-код, который не требует частой смены, а участники могут отсканировать его, чтобы присоединиться в любой момент.
Маркетинговая деятельность
Торговцы могут превращать ссылки на регистрацию в короткие ссылки и QR-коды, печатать их на листовках или размещать в социальных сетях. Настраиваемые логотипы улучшают брендинг, а панель администратора поддерживает обновление ссылок в любое время.
Совместное использование контента
Блоггеры или авторы сокращают ссылки на статьи и видео, генерируют QR-коды и вставляют их в визитки или плакаты, чтобы поклонники могли легко получить к ним доступ.
Образование и обучение
Учебные организации превращают ссылки на курсы в QR-коды и печатают их в учебниках или рекламных объявлениях. Студенты могут отсканировать код, чтобы записаться на курс, а обновление ссылок не влияет на использование QR-кода.
Продвижение проектов с открытым исходным кодом
Разработчики превращают ссылки на репозитории GitHub в короткие ссылки, генерируют QR-коды и делятся ими с сообществами или документами для легкого доступа.

QA

Будет ли сгенерированный QR-код считаться недействительным?
Пока Cloudflare Workers и база данных D1 работают правильно, QR-код будет действителен всегда. Даже если оригинальная ссылка на групповой чат не работает, ее можно обновить через бэкенд администратора, и QR-код не нужно будет заменять.
Нужен ли мне опыт программирования для развертывания?
Нет необходимости. Развертывание - это всего лишь пошаговая операция, а интерфейс бэкэнда управления дружелюбен и подходит для пользователей с нулевым уровнем подготовки.
Достаточно ли бесплатного аккаунта?
Бесплатной квоты Cloudflare (100 000 запросов в день, 5 миллионов чтений базы данных) достаточно для отдельного человека или небольшой команды. В сценариях с высоким трафиком можно рассмотреть платный тарифный план.
Как вы обеспечиваете безопасность своих данных?
Данные хранятся в базе данных D1, а бэкэнд администрирования защищен паролем. Рекомендуется регулярно создавать резервные копии базы данных и устанавливать сложные пароли.
Какие ссылки поддерживаются?
Поддерживает любые легальные URL, включая ссылки WeChat, веб-страницы, файлы для скачивания и т.д. Перед генерацией рекомендуется проверить валидность ссылки.
Как обновить версию для старых пользователей?
консультация MIGRATE.mdНовая версия кода была развернута путем переноса данных KV в базу данных D1.