帮助与功能

Boxie 的所有功能介绍。

上传文件

前往首页，将文件拖放到上传区域，或点击浏览文件。您可以一次上传多个文件——每个文件都有独立的分享链接。

• 文件夹 — 拖入文件夹会在上传前自动压缩为 ZIP。
• 图片 — 自动生成预览缩略图。可通过 URL 中的 ?w=800 在下载时调整尺寸。
• 代码文件 — 自动语法高亮，支持多种配色主题。
• Markdown — 在查看页面渲染为格式化 HTML。
• PDF — 内嵌显示，侧边栏显示页数。
• 含 EXIF 的照片 — 侧边栏显示相机型号、光圈、快门速度、ISO 及 GPS 地图。

上传后您将获得可分享的链接。任何持有链接的人均可查看和下载（受您设置的访问限制约束）。

代码粘贴

使用 Paste 无需上传文件即可分享代码片段。

• 自动检测 — Boxie 自动分析内容以识别编程语言。
• 手动选择语言 — 从下拉列表中选择（Go、Python、Rust、SQL 等 20 余种）。
• 配色主题 — 在代码视图中切换高亮主题（Dracula、Monokai、GitHub、Nord 等）。
• 原始文本与下载 — 每个粘贴均有 Raw 链接和下载按钮。
• Tab 键 — 在编辑器中插入 4 个空格。

分享类型

管理员可在管理面板中修改上传后的分享类型。

群组

将多个文件整合为一个可分享的画廊。

• 在上传表单中启用文件群组，自动创建新群组，或将文件添加到已有群组。
• 群组拥有独立 URL /g/{token}，展示所有成员的卡片网格。
• 点击任意卡片内嵌预览文件；再次点击下载。
• 全部下载按钮可即时压缩整个群组。
• 群组可设置独立的 IP 白名单。
• 当所有成员文件过期时，群组将自动清理。

自定义链接

为分享设置个性化短链接。

• 在上传表单或粘贴时，通过自定义链接字段设置。
• 格式：小写字母、数字、连字符；3–50 个字符。 示例：my-logo → /s/my-logo
• 管理员可在编辑页面中设置或修改短链接。
• 原始 Token 链接始终有效。

访问控制

IP / CIDR 白名单

将分享限制为特定 IP 地址或网络范围。留空则不受限制，允许公开访问。

10.0.0.0/8, 192.168.1.5, 2001:db8::/32

密码保护

要求访客输入密码才能查看或下载分享内容。密码使用 bcrypt 哈希存储——Boxie 从不以明文保存密码。解锁 Cookie 每次浏览器会话有效 1 小时。

内嵌分享

/s/{token}/img 路由以正确的 Content-Type 内嵌提供文件——无下载提示——非常适合嵌入 Wiki、Markdown 文档或网站。

<img src="https://boxie.to/s/bright-crane-42/img?w=800">

可选参数 ?w=N 和/或 ?h=N 可即时调整图片尺寸。此路由不计入下载次数。

REST API

Boxie 提供完整的 REST API，详见 API 文档。

• 使用 API 密钥（Authorization: Bearer bxk_…）或会话 Cookie 进行认证。
• 在账户页面创建 API 密钥。
• 接口覆盖分享、粘贴和群组的管理操作。

账户与访问

• 通行密钥 — Boxie 使用 WebAuthn 通行密钥（Touch ID、Face ID、硬件密钥），无需记忆密码。可添加多个密钥作为备份。
• 邀请 — 生成邀请链接邀请他人注册（普通用户每 30 天最多 5 个；管理员不限）。邀请 7 天后过期。
• API 密钥 — 为脚本和集成生成具名 Bearer Token。密钥经过哈希处理，仅在创建时显示一次。
• 活动日志 — 记录您的上传、删除、登录及 API 操作。管理员可查看所有用户的活动。
• 存储配额 — 每个账户均有存储限制，可在账户页面查看。

在 /account 管理您的设置。

有疑问？请发邮件至 support@boxie.to