从零到一：OnlyOffice中国版企业级完整落地指南

# Docker Hub 直接拉取
docker pull moqisoft/documentserver:9.3.0

# 国内加速（推荐）
docker pull docker.1ms.run/moqisoft/documentserver:9.3.0

docker run -itd \
    --name ds-china \
    -p 9000:80 \
    -p 9090:8000 \
    --restart=always \
    --privileged \
    -e ALLOW_PRIVATE_IP_ADDRESS=true \
    -e JWT_ENABLED=false \
    -v /data/onlyoffice/Data:/var/www/onlyoffice/Data \
    -v /data/onlyoffice/App_Data:/var/www/onlyoffice/App_Data \
    -v /data/onlyoffice/sdkjs-plugins:/var/www/onlyoffice/documentserver/sdkjs-plugins \
    -v /proc/cpuinfo:/host/proc/cpuinfo \
    -v /sys/class:/host/sys/class \
    moqisoft/documentserver:9.3.0

# 查看容器日志，确认无报错
docker logs -f ds-china

# 访问版本信息
curl http://your-server-ip:9090/info

# 访问欢迎页面
# 浏览器打开 http://your-server-ip:9000/welcome/

# 启动时挂载自定义字体目录
docker run -itd \
    --name ds-china \
    # 其他参数...
    -v /data/onlyoffice/custom-fonts:/usr/share/fonts/truetype/custom \
    moqisoft/documentserver:9.3.0

{
  "editorConfig": {
    "customization": {
      "font": {
        "size": 14,
        "name": "SimSun"
      }
    }
  }
}

<!-- 文档列表页面 -->
<div id="preloadPlaceholder" style="display:none"></div>
<script
  type="text/javascript"
  src="https://your-ds-server:9000/web-apps/apps/api/documents/api.js?placeholder=preloadPlaceholder"
></script>

<iframe
  src="https://your-ds-server:9000/web-apps/apps/api/documents/preload.html"
  style="display:none;"
></iframe>

docker cp ds-china:/var/www/onlyoffice/documentserver/fonts ./fonts

{
  "editorConfig": {
    "customization": {
      "resPrefix": [
        "https://font1.yourdomain.com",
        "https://font2.yourdomain.com",
        "https://font3.yourdomain.com"
      ]
    }
  }
}

# 字体服务器的 Nginx 配置
location /fonts/ {
    add_header Access-Control-Allow-Origin *;
    add_header Access-Control-Allow-Methods GET;
    expires 30d;
}

location / {
    proxy_pass http://127.0.0.1:9000;

    # 开启 gzip 压缩
    gzip on;
    gzip_types text/plain application/json application/javascript text/css;
    gzip_min_length 1024;

    # 静态资源缓存
    location ~* \.(js|css|png|jpg|gif|ico|woff|woff2|ttf)$ {
        proxy_pass http://127.0.0.1:9000;
        expires 7d;
        add_header Cache-Control "public, immutable";
    }

    # WebSocket 支持
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_http_version 1.1;

    # 超时设置（协同编辑需要长连接）
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
}

location /office/ {
    proxy_pass http://127.0.0.1:9000/;
    
    # 关键头部：告知后端应用实际访问路径
    proxy_set_header X-Forwarded-Prefix /office;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    # WebSocket 支持
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_http_version 1.1;
    
    # 超时设置
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
}

{
  "editorConfig": {
    "customization": {
      "logo": {
        "visible": true,
        "image": "https://your-domain.com/logo.png",
        "imageEmbedded": "https://your-domain.com/logo-small.png",
        "url": "https://your-domain.com"
      },
      "customer": {
        "address": "北京市朝阳区XX路XX号",
        "mail": "support@your-domain.com",
        "logo": "https://your-domain.com/logo-big.png",
        "name": "XX科技有限公司",
        "phone": "400-XXX-XXXX",
        "www": "your-domain.com"
      }
    }
  }
}

{
  "editorConfig": {
    "customization": {
      "about": false,
      "feedback": false,
      "goback": false,
      "help": false,
      "loaderLogo": "https://your-domain.com/loading-logo.png",
      "loaderName": "正在加载文档...",
      "features": {
        "spellcheck": false
      }
    }
  }
}

{
  "editorConfig": {
    "customization": {
      "polling": true
    }
  }
}

{
  "editorConfig": {
    "customization": {
      "miniToolbar": true
    }
  }
}

{
  "editorConfig": {
    "customization": {
      "browserFonts": true
    }
  }
}

{
  "editorConfig": {
    "customization": {
      "privateView": true
    }
  }
}

app.post("/onlyoffice/callback", async (req, res) => {
  const { status, url, key, users } = req.body;

  switch (status) {
    case 1:
      // 正在编辑中，有用户连接
      console.log(`文档 ${key} 正在被编辑，用户: ${users}`);
      break;

    case 2:
      // 文档已保存（所有用户退出编辑后触发）
      // 下载最新文档并更新存储
      await downloadAndSave(url, key);
      console.log(`文档 ${key} 已保存`);
      break;

    case 6:
      // 强制保存触发
      await downloadAndSave(url, key);
      console.log(`文档 ${key} 强制保存完成`);
      break;

    case 4:
      // 关闭文档，无更改
      console.log(`文档 ${key} 已关闭，无更改`);
      break;
  }

  // 必须返回 {"error": 0}
  res.json({ error: 0 });
});

async function downloadAndSave(fileUrl, docKey) {
  const response = await fetch(fileUrl);
  const buffer = await response.buffer();

  // 根据 docKey 找到对应的文档记录
  const doc = await findDocByKey(docKey);

  // 将新文件保存到存储（OSS/本地）
  await saveToStorage(doc.storagePath, buffer);

  // 更新文档版本号
  await updateDocVersion(doc.id);
}

// 方式一：使用自增版本号
const key = `doc_${documentId}_v${versionNumber}`;

// 方式二：使用文件内容的 hash
const key = `doc_${documentId}_${fileContentHash}`;

// 方式三：使用时间戳（简单但不适合需要协同的场景）
const key = `doc_${documentId}_${lastModifiedTimestamp}`;

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>文档编辑</title>
  <!-- 引入 OnlyOffice API -->
  <script src="http://your-ds-server:9000/web-apps/apps/api/documents/api.js"></script>
</head>
<body>
  <div id="editor-container" style="width:100%;height:100vh;"></div>

  <script>
    // 从后端获取开档配置
    async function openDocument(docId) {
      const response = await fetch(`/api/documents/${docId}/editor-config`);
      const config = await response.json();

      // 初始化编辑器
      const docEditor = new DocsAPI.DocEditor("editor-container", {
        document: {
          fileType: config.fileType,
          key: config.key,
          title: config.title,
          url: config.fileUrl,
          permissions: config.permissions
        },
        documentType: config.documentType, // word, cell, slide
        editorConfig: {
          callbackUrl: config.callbackUrl,
          lang: "zh",
          mode: config.mode, // edit 或 view
          user: {
            id: config.userId,
            name: config.userName
          },
          customization: {
            about: false,
            feedback: false,
            forcesave: true, // 支持手动保存
            font: {
              size: 14,
              name: "SimSun"
            }
          }
        },
        events: {
          onReady: function () {
            console.log("编辑器加载完成");
          },
          onError: function (event) {
            console.error("编辑器错误:", event.data);
          }
        }
      });
    }

    // 页面加载时打开文档
    const docId = new URLSearchParams(location.search).get("id");
    if (docId) openDocument(docId);
  </script>
</body>
</html>

docker exec ds-china sudo supervisorctl start ds:adminpanel

AdminPanel SETUP REQUIRED | Bootstrap code: IK6HKVU0YMB3 | Expires: ...