跳到主要内容

安装 - 云端

要在云端安装ONLYOFFICE 文档:

  1. 通过我们的官网上填写注册表单,在云端部署ONLYOFFICE文档开发者版解决方案。

  2. 在需要嵌入编辑器的目标 HTML 文件中,指定一个占位符 div 标签,用于传递所有关于编辑器参数的配置信息:

    <div id="placeholder"></div>
    <script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js"></script>

    documentserver 是您的云服务提供的公共 IP 地址或公共 DNS。该地址由系统自动分配,可在云控制台的实例部分查看。

    https://documentserver/web-apps/apps/api/documents/api.js 是 API JavaScript 文件的默认访问地址。

    信息

    从 8.1 版本开始,建议在 URL QueryString 中添加 shardkey 参数,并赋予其 key 值。例如:?shardkey=Khirz6zTPdfd7。此参数可用于请求负载均衡。

  3. 指定包含可变参数的页面代码:

    const config = {
    document: {
    fileType: "docx",
    key: "Khirz6zTPdfd7",
    title: "Example Document Title.docx",
    url: "https://example.com/url-to-example-document.docx",
    },
    documentType: "word",
    editorConfig: {
    callbackUrl: "https://example.com/url-to-callback.ashx",
    },
    };

    const docEditor = new DocsAPI.DocEditor("placeholder", config);

    此处 example.com 是您的云服务提供的公共 IP 或公共 DNS,需确保已在此地址部署文档管理器文档存储服务。关于 ONLYOFFICE 文档服务端与客户端的交互细节,请参阅工作原理章节。

    此后,docEditor 对象即可用于调用文档编辑器方法.

    以上示例包含确保 ONLYOFFICE 文档正常启动所需的全部必要参数。

  4. 添加非必需的可选参数,以实现文档的多样化配置(如修改文档权限、显示不同文档信息等)。具体参数列表及用法请参阅高级参数章节。

  5. 为请求添加加密签名令牌,防止关键参数被篡改。

后续步骤