免服务器生成永久微信群二维码

综合介绍

serverless-qrcode-hub 是一个开源工具，专为解决微信群聊二维码频繁失效的问题而设计。它基于 Cloudflare Workers 和 D1 数据库，无需传统服务器即可运行。用户可以生成永久有效的微信群二维码，方便群聊管理，同时支持将任意长链接转为短链接。项目提供管理后台，用户可随时更新二维码或短链接内容，并支持自定义样式和密码保护。部署简单，免费配额足够日常使用，适合个人、团队或开发者。代码在 GitHub 上公开，社区可自由优化和扩展。

功能列表

• 生成永久有效的微信群聊二维码，解决失效问题。
• 将长链接转为短链接，方便分享和传播。
• 支持自定义二维码样式，包括颜色、边框和 Logo。
• 提供管理后台，随时更新二维码或短链接内容。
• 支持密码保护，限制未经授权的访问。
• 基于 Cloudflare Workers 和 D1 数据库，无需服务器。
• 开源代码，支持用户修改和扩展功能。
• 自动清理过期数据，保持系统高效。

使用帮助

安装与部署

serverless-qrcode-hub 使用 Cloudflare Workers 平台运行，无需传统服务器。以下是详细部署步骤：

1. 注册 Cloudflare 账户
   访问 Cloudflare 官网，注册免费账户。已有账户可直接登录。
2. 创建 D1 数据库
   登录 Cloudflare 仪表板，进入“Workers and Pages” > “D1” > “创建数据库”。
   • 为数据库命名，例如 qrcode-db。
   • 创建后复制数据库 ID，稍后使用。
3. Fork GitHub 仓库
   访问 项目仓库，点击右上角“Fork”按钮，将仓库复制到你的 GitHub 账户。
4. 编辑 wrangler.toml
   在你的 Fork 仓库中，打开 wrangler.toml 文件，点击编辑按钮。找到 [d1_databases] 部分，将 database_id 替换为第 2 步复制的 D1 数据库 ID。示例：

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

   保存并提交更改。

5. 创建 Cloudflare Worker
   返回 Cloudflare 仪表板，选择“Workers and Pages” > “创建 Worker”。
   • 命名 Worker，例如 qrcode-hub。
   • 点击“配置” > “Git 集成”，选择你 Fork 的 GitHub 仓库。
   • 点击“保存并部署”。
6. 绑定自定义域名（可选）
   部署成功后，Cloudflare 提供默认的 *.workers.dev 域名。如果需要更快的访问速度或品牌化：
   • 进入“Workers” > “触发器” > “添加自定义域名”。
   • 输入在 Cloudflare 托管的子域名（例如 qr.example.com）。
   • 按提示完成 DNS 配置。
7. 设置访问密码
   在 Cloudflare 仪表板中，进入 Worker 设置，找到环境变量部分。添加变量 PASSWORD，值为自定义密码（建议使用字母和数字组合，例如两段 UUID 字符串，如 a1b2c3d4-e5f6g7h8）。保存后，访问管理后台需输入此密码。
8. 验证部署
   部署完成后，访问分配的 *.workers.dev 域名或自定义域名。如果看到登录页面，说明部署成功。

升级说明

旧版项目（基于 Cloudflare KV，版本号 ≤ v1.2.0）因免费配额限制已不推荐使用。新版基于 D1 数据库，支持 500 万次读取，性能更稳定。

• 迁移指南：参考 MIGRATE.md。
• 旧版文档：查看 README.v1.md。

使用主要功能

部署完成后，用户可通过浏览器访问工具。以下是详细操作流程：

生成永久微信群二维码

1. 访问管理后台
   打开 Workers 域名（例如 https://qrcode-hub.<你的账户>.workers.dev）或自定义域名。输入设置的密码登录。
2. 添加微信群链接
   在管理后台，点击“添加微信二维码”。
   • 输入微信群聊的原始链接（通常是临时二维码链接）。
   • 可选择上传 Logo（建议 PNG/JPG 格式，像素小于 100x100）。
   • 调整二维码颜色或边框（默认黑色前景、白色背景）。
   • 点击“生成”。
3. 获取二维码和短链接
   系统返回二维码图片和短链接（例如 https://qr.example.com/abc123）。扫描二维码可直接加入群聊，短链接可分享到微信或其他平台。
4. 更新群聊链接
   如果原始群聊链接失效，进入管理后台，找到对应二维码记录，更新为新的群聊链接。更新后，二维码和短链接保持不变，用户无需重新分享。

URL 缩短服务

1. 添加长链接
   在管理后台，点击“添加普通短链”。
   • 粘贴任意长链接（例如文章、文件下载地址）。
   • 可选择自定义短链接后缀（例如 abc123）。
   • 点击“生成”。
2. 获取短链接
   系统返回短链接，点击测试是否跳转到原始页面。短链接可用于社交媒体、邮件等场景。
3. 管理短链接
   在管理后台查看所有短链接，支持编辑、删除或查看跳转记录。

自定义二维码样式

1. 调整外观
   在添加二维码时，点击“高级选项”。
   • 上传 Logo（增强品牌效果）。
   • 选择前景色和背景色（确保对比度高，便于扫描）。
   • 设置边框宽度或圆角效果。
2. 预览和保存
   点击“预览”查看效果，确认后生成最终二维码。

密码保护管理

• 每次访问管理后台需输入部署时设置的密码。
• 如需更改密码，在 Cloudflare 仪表板中更新 PASSWORD 环境变量，重新部署 Worker。

注意事项

• 配额：Cloudflare Workers 免费账户提供每天 10 万次请求，D1 数据库支持 500 万次读取，足够个人使用。高流量场景可升级付费计划。
• 备份：D1 数据库存储所有二维码和短链接数据，建议定期导出备份（通过 Cloudflare 仪表板操作）。
• 域名速度：默认 *.workers.dev 域名在部分地区访问较慢，建议绑定自定义域名。
• 安全：密码需足够复杂，避免泄露。短链接和二维码内容需合法合规。

示例操作

• 创建短链接：输入 https://example.com/long-url，生成 https://qr.example.com/xyz789，点击测试跳转。
• 创建微信二维码：输入群聊链接，上传 Logo，生成二维码后保存图片，分享到微信群或朋友圈。
• 更新记录：在管理后台找到二维码记录，替换失效链接，确认后用户可继续使用原二维码。

通过以上步骤，用户可以快速部署 serverless-qrcode-hub，生成永久二维码或短链接。管理后台操作直观，无需编程经验即可上手。

应用场景

1. 微信群管理
   群管理员需要长期分享群聊二维码。serverless-qrcode-hub 生成的永久二维码避免了频繁更换的麻烦，成员随时扫码加入。
2. 营销活动
   商家将活动报名链接转为短链接和二维码，印在传单或发布到社交媒体。自定义 Logo 增强品牌效果，管理后台支持随时更新链接。
3. 内容分享
   博主或创作者将文章、视频链接缩短，生成二维码，嵌入名片或海报，方便粉丝访问。
4. 教育培训
   培训机构将课程链接转为二维码，印刷在教材或广告中。学生扫码即可报名，链接更新不影响二维码使用。
5. 开源项目推广
   开发者将 GitHub 仓库链接转为短链接，生成二维码，分享到社区或文档，便于用户访问。

QA

1. 生成的二维码会失效吗？
   只要 Cloudflare Workers 和 D1 数据库正常运行，二维码永久有效。即使原始群聊链接失效，可通过管理后台更新，二维码无需更换。
2. 部署需要编程经验吗？
   不需要。部署只需按步骤操作，管理后台界面友好，适合零基础用户。
3. 免费账户够用吗？
   Cloudflare 免费配额（10 万次请求/天，500 万次数据库读取）足够个人或小型团队使用。高流量场景可考虑付费计划。
4. 如何保证数据安全？
   数据存储在 D1 数据库，密码保护管理后台。建议定期备份数据库，设置复杂密码。
5. 支持哪些链接？
   支持任意合法 URL，包括微信群链接、网页、文件下载等。生成前建议测试链接有效性。
6. 旧版用户如何升级？
   参考 MIGRATE.md，将 KV 数据迁移到 D1 数据库，重新部署新版代码。