方案特點(diǎn)

• 無需手動(dòng)安裝依賴：使用官方安裝包自動(dòng)集成 PostgreSQL、RabbitMQ、Erlang

• ?一鍵式安裝：全程僅需運(yùn)行安裝程序，無需配置復(fù)雜參數(shù)

• 最小化資源占用：僅保留核心編輯功能，關(guān)閉非必要服務(wù)

一、安裝 OnlyOffice Document Server

1. 下載安裝包

• 訪問 ONLYOFFICE 官方下載頁

• 選擇 Windows 版本（如 onlyoffice-documentserver-7.x.x.exe）

2. 運(yùn)行安裝程序（管理員身份）

• 安裝路徑：建議 C:\ONLYOFFICE（避免中文或空格）

• 端口設(shè)置：

• 若 IIS 已占用 80 端口，改為其他端口（如 8080）

• 命令行靜默安裝示例：（powershell）

.\onlyoffice-documentserver.exe /DS_PORT=8080 /S

3. 驗(yàn)證安裝

• 訪問 http://服務(wù)器IP:端口/welcome/，出現(xiàn)歡迎頁即成功

• 檢查服務(wù)是否運(yùn)行（服務(wù)名 DsExampleSvc）：（powershell）

net start | findstr "DsExampleSvc"

二、C# 集成代碼（ASP.NET Core 完整示例）

1. 后端代碼（DocumentController.cs）

public class DocumentController : Controller
{
    private readonly string _docServerUrl = "http://your-server-ip:端口/"; // 替換為實(shí)際地址
    private readonly string _storagePath = Path.Combine("App_Data", "Documents");


    // 文檔編輯頁面
    [HttpGet]
    public IActionResult Edit(string fileName)
    {
        var config = new
        {
            documentServerUrl = _docServerUrl,
            key = Guid.NewGuid().ToString(),
            title = fileName,
            url = Url.Content($"~/Documents/{fileName}"),
            callbackUrl = Url.Action("Save", "Document", null, Request.Scheme)
        };
        return View(config);
    }


    // 保存文檔回調(diào)接口
    [HttpPost]
    public IActionResult Save()
    {
        try
        {
            var file = Request.Form.Files[0];
            var savePath = Path.Combine(_storagePath, file.FileName);
            Directory.CreateDirectory(_storagePath); // 確保目錄存在


            using (var stream = new FileStream(savePath, FileMode.Create))
            {
                file.CopyTo(stream);
            }
            return Json(new { error = 0 });
        }
        catch (Exception ex)
        {
            return Json(new { error = 1, message = ex.Message });
        }
    }
}

2. 前端頁面（Edit.cshtml）

@model dynamic
<div id="editor" style="height: 95vh;"></div>


@section Scripts {
    <script src="@Model.documentServerUrl/web-apps/apps/api/documents/api.js"></script>
    <script>
        const config = {
            document: {
                fileType: "@Model.title.split('.').pop()",
                key: "@Model.key",
                title: "@Model.title",
                url: "@Model.url"
            },
            editorConfig: {
                callbackUrl: "@Model.callbackUrl",
                lang: "zh-CN",
                user: { id: "user-001", name: "Guest" } // 可自定義用戶信息
            },
            documentServerUrl: "@Model.documentServerUrl"
        };


        new DocsAPI.DocEditor("editor", config);
    </script>
}

三、關(guān)鍵配置說明

1. IIS 配置

• 應(yīng)用程序池：設(shè)置為 無托管代碼

• MIME 類型：

.docx → application/vnd.openxmlformats-officedocument.wordprocessingml.document  
.xlsx → application/vnd.openxmlformats-officedocument.spreadsheetml.sheet  
.pptx → application/vnd.openxmlformats-officedocument.presentationml.presentation

• 目錄權(quán)限：確保 App_Data/Documents 目錄有寫入權(quán)限

2. OnlyOffice 配置優(yōu)化

• 關(guān)閉 JWT 驗(yàn)證（簡化調(diào)試）：
  修改 C:\ONLYOFFICE\DocumentServer\config\local.json：

"token": { "enable": { "request": { "inbox": false, "outbox": false }, "browser": false } }

• 允許私有 IP 訪問：
  修改 C:\ONLYOFFICE\DocumentServer\config\default.json：

"request-filtering-agent": { "allowPrivateIPAddress": true }

3. 數(shù)據(jù)庫簡化（可選）

• 默認(rèn)使用安裝包內(nèi)嵌的 PostgreSQL，無需額外操作

• 若需替換為 SQL Server：
  修改 C:\ONLYOFFICE\DocumentServer\config\local.json 中的數(shù)據(jù)庫配置段（需手動(dòng)遷移數(shù)據(jù)）

四、系統(tǒng)架構(gòu)圖

瀏覽器 → IIS ASP.NET Core 應(yīng)用 → OnlyOffice Document Server (8080)
               ↑                           ↑
        SQL Server 數(shù)據(jù)庫        內(nèi)嵌 PostgreSQL/RabbitMQ
               ↑
        文件存儲（App_Data/Documents）

五、常見問題與排查

六、擴(kuò)展功能（可選）

1. 用戶權(quán)限控制：在 editorConfig 中設(shè)置 permissions 字段限制編輯權(quán)限

2. 版本歷史：結(jié)合 SQL Server 記錄每次保存的版本

3. 文檔預(yù)覽：通過 /ConvertService.ashx 接口生成 PDF 預(yù)覽

通過此方案，您可在 30 分鐘內(nèi)完成 OnlyOffice 的部署與集成，實(shí)現(xiàn)基礎(chǔ)的在線編輯功能。如需進(jìn)一步優(yōu)化，可參考 ONLYOFFICE API 文檔。