Anyfile
打开文件

集成与嵌入

为 README 添加 Open in Anyfile 按钮,链接到公开文件预览,或在网站中嵌入查看器。文件直接在访问者的浏览器中读取。

点击工作区侧栏顶部的“打开链接”,输入公开文件直链,再点击“打开 URL”。复制预览链接、README Markdown 或 iframe HTML,放入你的内容中。

打开工作区

准备公开文件

支持你自己的网站、对象存储、公开数据集、GitHub Raw 或其他任意主机上的 HTTPS 文件直链。文件需要无需登录即可读取,来源服务器需要允许浏览器 CORS 请求。GitHub blob 页面是网页,不是文件直链。请在 URL 中保留文件扩展名,以便 Anyfile 选择查看器。

公开文件的服务器可返回 Access-Control-Allow-Origin: *。如果限定了允许来源,需要允许集成所用的 Anyfile origin(通常为 https://www.anyfile.top)。地址栏可以下载的文件,仍可能因缺少 CORS 而无法预览。Anyfile 不通过代理绕过来源限制。

体验可用示例

这个来自 seaborn-data 的公开 Iris CSV 可以直接打开为表格。点击按钮或体验下方的嵌入查看器,不需要上传本地文件。

打开示例

复制接入代码

README 平台通常支持 Markdown 图片链接,不支持 iframe。在允许嵌入内容的网站或教程中使用 iframe;根据版面调整 width 和 height,并保留描述性的 title。

预览链接

https://www.anyfile.top/zh-CN/view#file=https%3A%2F%2Fraw.githubusercontent.com%2Fmwaskom%2Fseaborn-data%2Fmaster%2Firis.csv

README Markdown 按钮

[![Open in Anyfile](https://www.anyfile.top/brand/open-in-anyfile.svg)](https://www.anyfile.top/zh-CN/view#file=https%3A%2F%2Fraw.githubusercontent.com%2Fmwaskom%2Fseaborn-data%2Fmaster%2Firis.csv)

网站 iframe

<iframe src="https://www.anyfile.top/zh-CN/embed#file=https%3A%2F%2Fraw.githubusercontent.com%2Fmwaskom%2Fseaborn-data%2Fmaster%2Firis.csv" title="Anyfile file preview" width="100%" height="600" style="border:0" loading="lazy" allow="fullscreen; cross-origin-isolated" referrerpolicy="no-referrer"></iframe>

URL 与语言

英语使用 /en/view,简体中文使用 /zh-CN/view;将 view 换成 embed 即为精简的 iframe 页面。完整文件 URL 经过 URLSearchParams 编码后放入 #file= 片段,代码生成器会完成编码。请保留片段形式,不要把文件地址改放到页面查询参数中。

为了保持示例稳定,建议使用带版本的对象地址或固定 GitHub commit 的地址。链接只引用已有公开文件;选择本地文件不会生成可分享的地址,也不会上传文件。

限制与兼容性

公开文件下载上限为 128 MiB;即使响应没有准确的 Content-Length,也会检查实际下载字节数。查看器自身的解码与内存限制仍然生效。URL 入口目前只打开单文件,不读取材质、字体、相机配对文件或其他关联资源。需要关联文件时,请使用本地文件夹或多文件打开。

请求不携带 Cookie、认证信息或来源页地址。目前不支持包含用户名、密码、查询参数或片段的文件 URL,也不支持需要重定向的地址。请使用无需认证的文件直链。

普通网页可以嵌入不依赖跨源隔离的查看器。需要 SharedArrayBuffer 或多线程 WASM 的格式,要求父页及全部祖先满足跨源隔离,并允许 iframe 使用相应能力;仅添加 allow="cross-origin-isolated" 不足以获得隔离。必要时使用嵌入查看器的“在新窗口打开”入口。实际能力还取决于浏览器和文件格式。

打不开时检查什么

确认地址返回文件本身、无需认证、没有重定向且允许 CORS;文件小于 128 MiB,文件名具有正确扩展名。下载成功不代表格式或编码一定受支持。缺少关联文件时通过本地文件夹打开;需要隔离能力时在新窗口打开。

隐私边界

文件由来源直接下载到访问者的浏览器,并在浏览器解析。Anyfile 不上传、存储或托管这些文件;来源主机会收到访问者的下载请求。文件地址放在不会进入 Anyfile 页面请求的片段中,分析与性能事件不发送完整文件地址、文件名或内容。