WopiHost安装与配置完全指南

WopiHost安装与配置完全指南

wopihost office online preview and editor 项目地址: https://gitcode.com/gh_mirrors/wo/wopihost

项目基础介绍及编程语言

WopiHost 是一个基于 MIT 许可证 开发的开源项目，主要服务于 Office Online 预览与编辑需求。它通过实现WOPI协议，允许用户预览和编辑诸如 Word、Excel、PPT 及 PDF（仅限预览）等文档。本项目利用 Spring Boot 平台构建，确保了轻量级且易于部署的特点，适用于Java开发者集成自定义数据源到Office Online Server或类似WOPI客户端。

关键技术和框架

• Spring Boot: 快速搭建RESTful服务的基础，简化了配置与部署过程。
• WOPI协议: （Web Application Open Platform Interface）使得第三方应用能够接入Office Online或其他兼容WOPI的编辑器。
• Office Online Server: 提供文档在线预览和编辑的功能，需独立安装并配置。

安装与配置步骤

准备工作

1. 安装Java: 确保你的系统已安装JDK 1.8或更高版本。
2. 准备Office Online Server: 需要一个运行中的Office Online Server实例。这通常涉及到复杂的企业级软件部署，包括获取软件包，配置IIS等。
3. Git: 用于克隆项目源代码。

克隆项目

1. 打开命令行工具，使用以下命令克隆项目到本地:

   git clone https://github.com/ethendev/wopihost.git
   

修改配置

1. 进入项目目录，找到application.properties文件。

2. 配置文档存储路径，例如:

   file.path=E:\\
   

   更改为你希望存放文档的实际本地路径。

3. 如需修改其他配置，比如OWA服务器地址，请参考项目中的说明或根据实际需要调整。

运行项目

1. 打开命令行，在项目根目录下执行以下命令来启动Spring Boot应用:

   ./mvnw spring-boot:run
   

   或者在Windows环境下:

   ./mvnw.cmd spring-boot:run
   

2. 确认服务启动成功，通过访问http://localhost:8080/hosting/discovery查看是否返回正确的WOPI发现XML文件。

集成Office Online

1. 在Office Online Server上配置WOPI连接，指向你的WopiHost IP和端口。
2. 使用提供的URL模式进行文档预览和编辑，记得将 [owas_domain] 替换为Office Online Server的地址，将 [WopiHost_IP] 替换为你的WopiHost服务地址。

注意事项

• 对于中文文件名问题，需要URLEncoder编码两次才能正确预览和编辑。
• Word文档仅支持.docx格式编辑。
• 确保WopiHost与Office Online Server间的网络通畅，避免配置错误导致功能不可用。

完成以上步骤，你就已经成功设置了一个基本的WOPIHost环境，可以通过Office Online进行文档的在线操作了。如果遇到任何技术难题，建议查阅官方文档或社区讨论寻求帮助。

wopihost office online preview and editor 项目地址: https://gitcode.com/gh_mirrors/wo/wopihost