WopiHost 项目安装与使用教程

WopiHost 项目安装与使用教程

1. 项目目录结构及介绍

WopiHost 项目的目录结构如下：

WopiHost/
├── dist/
├── doc/
├── src/
│   └── Netnr/
│       └── WopiHandler/
├── .gitignore
├── LICENSE
└── README.md

目录结构说明：

• dist/：存放编译后的文件。
• doc/：存放项目文档。
• src/Netnr/WopiHandler/：项目的主要源代码目录，包含处理 WOPI 请求的逻辑。
• .gitignore：Git 忽略文件配置。
• LICENSE：项目许可证文件。
• README.md：项目介绍和基本使用说明。

2. 项目的启动文件介绍

WopiHost 项目的启动文件位于 src/Netnr/WopiHandler/ 目录下。主要的启动文件包括：

• Startup.cs：项目的启动类，负责配置服务和中间件。
• Program.cs：项目的入口文件，负责启动应用程序。

启动文件说明：

• Startup.cs：

  • 配置服务：注册依赖注入、配置 HTTP 请求管道等。
  • 配置中间件：设置路由、身份验证、授权等。

• Program.cs：

  • 创建 WebHost 并配置 Kestrel 服务器。
  • 调用 Startup 类进行服务和中间件的配置。

3. 项目的配置文件介绍

WopiHost 项目的配置文件主要位于 src/Netnr/WopiHandler/ 目录下，包括：

• appsettings.json：项目的配置文件，包含应用程序的配置项。

配置文件说明：

• appsettings.json：
  • Wopi:HostUrl：指向 WopiHost 实例的 URL。
  • Wopi:ClientUrl：指向 WOPI 客户端（如 Office Online Server）的基础 URL。
  • Wopi:StorageProvider:RootPath：存储提供者的根路径，用于文件系统提供者。
  • Wopi:UseCobalt：是否使用 MS-FSSHTTP 进行文件同步。

配置示例：

{
  "Wopi": {
    "HostUrl": "http://wopihost:5000",
    "ClientUrl": "http://owaserver",
    "StorageProvider": {
      "RootPath": "\\\\WopiHost\\wwwroot\\wopi-docs"
    },
    "UseCobalt": true
  }
}

以上是 WopiHost 项目的目录结构、启动文件和配置文件的详细介绍。通过这些信息，您可以更好地理解和使用该项目。