零上传!把 OnlyOffice 搬进浏览器,改敏感文档再也不用传服务器

不上传文件也能完整编辑Office文档

很多人默认在线改Word或Excel，文件必须先传到服务器。实际不是。有个开源项目直接把OnlyOffice跑进浏览器，DOCX、XLSX、PPTX、CSV在本地完成全部编辑，服务器连文件内容都碰不到。

我第一次打开演示站时，随手拖了个带敏感合同条款的docx进去。改完几处条款、调了下表格，再另存为。全程看网络面板，除了加载编辑器本身的静态资源，没有任何文件上传请求。那种“文件就在自己机器上转了一圈”的感觉，和以前用桌面版Office差不多，只是界面换成了网页。

这件事现在能成立，核心就两样：OnlyOffice的WebAssembly转换层，加上纯前端的SDK。文件进浏览器后就在内存里处理，保存时也是从浏览器直接导出。没有账号、没有后端、没有“临时存储”。对在乎隐私的人，或者只是懒得每次都登录云盘的人，这个差别比想象中大。

它凭什么敢说零上传

普通用户最直观的感受，就像在本地开了个Office，只是窗口变成了浏览器标签页。拖文件进去，改格式、插图、调公式，最后下载回去，中间没有任何“上传中”的等待。

这直接解决了两个常见麻烦。一是隐私。合同、报表、带个人信息的表格，以前要么用桌面软件，要么忍着传给第三方。现在多了一条路：编辑过程本身就不离开设备。二是部署成本。想给团队或客户一个临时编辑入口，不用自己搭OnlyOffice服务器，也不用管账号体系。静态页面挂上去就能用。

技术实现上，项目用了OnlyOffice的sdkjs和x2t-wasm。后者负责把各种Office格式在浏览器里转换成可编辑的内部结构，前者负责真正的编辑界面和操作。字体也是按需拉，文档用到哪个才下载哪个。整个应用构建完就是纯静态资源，可以丢到GitHub Pages、Vercel或者随便一个Nginx上。Docker镜像也有，一条命令就能起。

有个细节我当时没注意：它支持通过URL参数直接打开远程文件，比如?src=https://example.com/xxx.docx。前提是远程地址开了CORS。本地文件当然更直接，点上传或者拖进去就行。

实际打开后能干什么

支持的编辑格式主要是DOCX、XLSX、PPTX和CSV。PDF能打开看，但编辑能力有限。新建文档也有入口，Word、Excel、PPT都能从空白开始。

界面和正式版OnlyOffice接近，格式刷、样式、图表、公式这些常用功能都在。保存时直接导出对应格式，不会强制转成别的。PWA也支持，HTTPS环境下可以安装到桌面或手机，断网后还能继续改已经打开的文件。

对开发者更有意思的是嵌入能力。它提供完整的postMessage API。父页面负责鉴权和文件来源，iframe只负责编辑。打开文档、监听保存、设只读模式，都能通过消息控制。官方README里写了推荐架构：业务系统自己管上传和权限，编辑器只当纯前端组件用。

我试了下嵌入流程，大概就是把iframe指到部署地址，加上?embed=1，然后发document:open-url这类消息。保存时会收到带文件内容的回调，再自己决定怎么存。这个设计把“编辑”和“存储”彻底拆开了，比很多在线Office方案干净。

当然也有边界。远程URL必须支持CORS，否则打不开。字体库是预置的，自定义字体得自己改目录。Service Worker在file://协议下不工作，本地测试还是得起个简单服务器。这些都是纯前端方案的常见代价，不算意外。

怎么立刻试起来

最快的方式是直接打开官方演示：edit.chaxus.com。页面上有“Open a file”按钮，也支持拖拽。新建文档的入口也在。打开后改几下，点保存，浏览器会弹出下载。网络面板里确认一下，确实没有文件上传。

想本地跑也很简单。Docker一条命令：

docker run -d --name document -p 8080:80 ghcr.io/ranuts/document:latest

浏览器访问localhost:8080就行。需要HTTPS和基础认证的话，README里给了带证书挂载的完整命令。

自己构建也行：

git clone https://github.com/ranuts/document.gitcd documentpnpm installpnpm run dev

开发服务器起来后，改代码即时生效。生产构建用pnpm build，产物在dist目录，随便丢静态托管。

嵌入的话，先看docs里的embed-api文档。关键消息类型就那几个：打开、保存、只读切换。父页面处理好跨域和文件来源就够了。

有个小坑我踩过：同时传src和file参数时，file优先。文档里写了，但第一次用还是愣了一下。

这个项目现在GitHub上已经有一千八百多星，许可证是AGPL-3.0。对想自建隐私编辑入口的人，或者只是不想每次改文件都登录一堆账号的人，值得直接试一把。下次改合同或者报表之前，可以先拖进这个编辑器看看。

你下次改敏感文件时会先试试这个吗💬