QuickShare Cloudflare

在 AI 辅助编程日益普及的今天，我们经常生成各种 HTML Demo、Markdown 文档、SVG 图标或 Mermaid 流程图。然而，将这些内容分享给他人往往面临尴尬：发文件太繁琐，贴代码刷屏又不美观，使用第三方平台又担心隐私泄露或链接失效。

QuickShare Cloudflare 是一个基于 Cloudflare 生态构建的轻量级分享工具，它能将 AI 生成的各类内容瞬间转化为一个干净、可访问的永久链接，且完全由你掌控数据和部署。

核心亮点：为何选择 QuickShare？

1. 专为 AI 内容设计，自动识别渲染

• 多格式支持：直接粘贴 HTML、Markdown、SVG 或 Mermaid 代码。
• 智能渲染：系统自动识别内容类型，HTML 直接预览效果，Markdown 渲染为可读页面，SVG 和 Mermaid 生成可视化图表。
• 极致便捷：无需下载文件，无需登录第三方平台，对方点开链接即可查看。

2. 私有部署，数据主权在手

• Cloudflare 全家桶：利用 Cloudflare Workers 运行逻辑，R2 存储大段内容正文，D1 管理元数据（ID、时间、权限等）。
• 零成本托管：依托 Cloudflare 的免费额度，个人使用几乎零成本。
• 完全可控：代码开源，可 Fork 修改，部署在自己的 Cloudflare 账号下，数据不经过第三方服务器。

3. 无账号体系，隐私与安全兼顾

• Cookie 身份识别：每个浏览器自动获得 owner cookie，无需注册即可管理自己创建的内容。
• 可选密码保护：支持设置 5 位数字访问密码，适合临时分享给客户、朋友或测试用户，防止误传播。
• 正文分离存储：大段内容存入 R2，D1 仅存元数据，提升数据库性能并降低耦合。

4. 简易管理后台

• 内容管理：查看列表、编辑正文、复制链接、预览效果、删除过期内容。
• 灵活控制：可随时切换内容的公开/保护状态。

适用场景

一键部署指南

QuickShare 提供了极简的部署流程，只需几步即可拥有自己的分享服务。

1. 前置准备

• 拥有 Cloudflare 账号。
• 安装 Node.js 20+。

2. 部署步骤

方式一：Deploy Button（推荐）
点击项目仓库顶部的 Deploy to Cloudflare 按钮，Cloudflare 将自动读取 wrangler.jsonc 并绑定所需资源（D1, R2, Workers）。

方式二：手动部署

# 1. 克隆项目并安装依赖
git clone <repo-url>
cd quickshare-cloudflare
npm install

# 2. 登录 Cloudflare
npx wrangler login

# 3. 创建 D1 数据库和 R2 存储桶
npx wrangler d1 create quickshare-db
npx wrangler r2 bucket create quickshare-content

# 4. 更新 wrangler.jsonc 中的 database_id
# 5. 执行迁移并部署
npm run db:migrate:remote
wrangler deploy

3. 安全配置

部署完成后，务必在 Cloudflare 控制台的环境变量中设置以下参数以保护你的实例：

AUTH_ENABLED=true
AUTH_PASSWORD=<your-strong-password>
COOKIE_SECRET=<openssl rand -hex 32>

• AUTH_ENABLED=true：保护首页和创建接口，防止被滥用。
• AUTH_PASSWORD：设置管理员密码。
• COOKIE_SECRET：用于加密会话 Cookie。

本地开发

# 1. 安装依赖
npm install

# 2. 本地数据库迁移
npm run db:migrate:local

# 3. 启动开发服务
npm run dev
# 默认地址：http://127.0.0.1:8787

# 4. 验证配置
npm run check

QuickShare Cloudflare 是 AI 时代的高效协作利器。它解决了“最后一公里”的分享难题，让 AI 生成的代码、文档和图表能够以最美观、最便捷的方式呈现给受众。

通过私有化部署，你不仅获得了极致的控制权，还避免了第三方平台的不稳定性与隐私风险。无论是个人开发者、技术团队还是 AI 爱好者，QuickShare 都值得成为你工具箱中的常驻成员。