QBin 使用指南

January 26, 2026 · View on GitHub

QBin 提供便捷的内容编辑&分享服务，让您轻松存储和分享各种文字、代码和文件。

🚀 快速开始

  1. 访问你部署好的地址, 示例 [QBin Demo]
  2. 选择适合您需求的编辑器：
    • 📒 Markdown编辑器：支持实时预览，方便文档编写
    • 📝 代码编辑器：提供语法高亮，适合各类编程代码
    • 📦 通用编辑器：快速上传和分享各种文件类型
  3. 默认管理员账号密码:

💾 内容保存

  1. 在编辑器中输入或上传您的内容
  2. 您可以设置自定义过期时间，控制内容的保存期限
  3. 您可以自定义访问路径和密码，方便记忆和分享
  4. 点击 预览图标 图标进入预览&管理界面
  5. 系统会根据您的设置生成：
    • 访问路径：内容的唯一标识符（2-32字符）
    • 密码：可选的额外保护措施（0-32字符）

📤 分享方式

QBin 提供两种链接格式，满足不同分享需求：

  • 预览模式：http://localhost:8000/p/访问路径/密码

    • 带有完整管理界面，方便浏览和操作
    • 例如：http://localhost:8000/p/document

  • 直链模式：http://localhost:8000/r/访问路径/密码

    • 仅显示纯内容，无界面元素
    • 例如：http://localhost:8000/r/document

📱 内容管理

在预览界面（p/链接）中，您可以：

  • 复制内容：单击 Copy 按钮
  • 复制分享链接：双击 Copy 按钮
  • 生成二维码：点击 QR 按钮，方便移动设备扫描访问
  • 查看直链内容：点击 Raw 按钮，切换到纯内容模式
  • 创建新内容：点击 New 按钮，开始新的创作
  • 删除内容：点击 Del 按钮，永久删除内容

在个人中心界面, 你可以:

  • 选择(通用 / 代码 / Markdown)编辑器
  • 存储管理(List/Grid)视图
  • 设置 浅色 / 深色 / 跟随系统主题
  • 生成第三方接入Token
  • 设置默认编辑器

💡 使用技巧

  • HTML渲染：在代码编辑器中选择 HTML 语言，通过直链模式链接（r/）可直接渲染出网页效果
  • 自定义路径：使用有意义的自定义访问路径，便于记忆和分享
  • 嵌入网站：直链模式链接（r/）可轻松嵌入到其他网站或用于直接下载
  • 交互体验：预览模式链接（p/）适合与他人共享，提供更完整的查看体验
  • 私密分享：为重要内容设置密码，确保只有知道密码的人能访问
  • 定时过期：为临时内容设置合适的过期时间，自动清理不再需要的数据
  • 高级接口: 如果你需要将接口对接到第三方程序，请查看 API Docs

⚠️ 安全提示

  • 内容仅能由创建者修改或删除
  • 建议为敏感或重要内容设置密码
  • 记录好您的访问路径和密码，这是再次访问内容的唯一方式