快速本地化部署 OnlyOffice服务 （ Linux+Docker）

三天不学习2024-12-13 9:39

文章目录

一、OnlyOffice介绍📖

💎OnlyOffice 是由 Ascensio System SIA 开发的一套综合办公套件。提供了文档、表格和演示文稿的编辑功能。它包括桌面版、在线版和移动版，支持多平台使用。主要功能和特点如下：

  • 文档编辑器 ：支持各种文档格式，包括DOCX、PDF等，提供丰富的文本编辑工具。

  • 电子表格 ：具备复杂的公式、数据透视表和图表功能，支持 XLSX 等格式。

  • 演示文稿 ：提供多种模板和动画效果，支持 PPTX 等格式。

  • 团队协作：基于房间的在线协作平台，提供文档评论、版本历史和权限管理功能。

  • 集成 ：可以与其他第三方应用集成，如Nextcloud、OwnCloud 等，提高工作效率。

  • 安全性 ：提供 数据加密 和 权限控制 ，确保文档安全。

OnlyOffice 适用于个人、企业和教育机构，帮助用户在不同设备和平台上高效处理各种办公任务。

二、集成OnlyOffice🧩

本篇文章讲解如何使用 Docker 在本地 Linux 服务器上安装 ONLYOFFICE ，并结合 cpolar 内网穿透实现公网访问本地部署的文档编辑器与远程协作。

Community Edition 允许您在本地服务器上安装 ONLYOFFICE 文档，并将在线编辑器与 ONLYOFFICE 协作平台或其他流行系统集成。它是一个在线办公套件，包括文本、电子表格和演示文稿的查看器和编辑器，完全兼容 Office Open XML 格式：.docx、.xlsx、.pptx，并支持实时协作编辑。

2.1 环境准备🖥️

本次演示环境：

2.2 搜索镜像

我这里用的是 onlyoffice/documentserver:7.3 版本的

bash 复制代码 
docker search onlyoffice

2.3 拉取镜像

🎯注意 ：如果因为网络原因拉取不到镜像，请参考 Linux虚拟机 Docker 配置阿里云镜像加速 。

在 docker hub下载 OnlyOffice 镜像 。

bash 复制代码 
sudo docker pull onlyoffice/documentserver:7.3

2.4 查看镜像

bash 复制代码 
 docker images

🎯提示：镜像文件还是蛮大的，虚拟机分配内存要给足！！！

2.5 创建容器

  1. 🎯将本机的 9000端口 映射到 docker 的 80端 口上，访问时通过服务器IP：9000 访问

  2. 并且用 -v 将本机机 /home/onlyOffice 文件夹挂载到 docker 的 /var/www/onlyoffice/documentserver/web-apps/wsData 文件下，后续直接通过 http 请求读取对应的文件夹。JWT_SECRET 填写自己定义的密钥，JWT_ENABLED 设置为 true 开启 token 验证。

bash 复制代码 
sudo docker run -i -t -d -p 9000:80 -v /home/myOnlyOffice:/var/www/onlyoffice/documentserver/web-apps/wsData --env JWT_SECRET=VI71S3cGtXg96HgFWzQhblz1KwMc1Jzk -e JWT_ENABLED=false onlyoffice/documentserver:7.3

🔌提示：设置成开机启动：

bash 复制代码 
docker update --restart=always 容器id/名称

2.6 进入容器配置

bash 复制代码 
#进入容器
docker exec -it 容器名 bash
#找到配置文件local.json
cd /etc/onlyoffice/documentserver/
#如果不能编辑，需要安装vim命令
apt-get update     
apt-get install vim

2.7 重启服务

bash 复制代码 
supervisorctl restart all

2.8 添加字体字号

  1. ❌删除原有字体。
bash 复制代码 
#切换目录
cd /usr/share/fonts/ 
rm -rf *
#切换目录
cd /var/www/onlyoffice/documentserver/core-fonts/
rm -rf *
  1. 从 windows 系统中找到字体文件夹，压缩 上传到服务器下。
    通过 docker 命令 拷贝
    docker cp /home/fonts/ 容器id: /usr/share/fonts/
bash 复制代码 
cd /usr/share/fonts/font
cp * ../
ls
rm -rf font
  1. ✒️添加字号，下载 app.js 文件到本地编辑。
bash 复制代码 
sudo docker cp cf321c512a6a:/var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/app.js /Users/jianchenghou/uploadjar
  1. 🗳️本地编辑，把以下内容复制到 {value:8,displayValue:"8"}前面。
bash 复制代码 
{value:42,displayValue:"初号"},{value:36,displayValue:"小初"},{value:26,displayValue:"一号"},{value:24,displayValue:"小一"},{value:22,displayValue:"二号"},{value:18,displayValue:"小二"},{value:16,displayValue:"三号"},{value:15,displayValue:"小三"},{value:14,displayValue:"四号"},{value:12,displayValue:"小四"},{value:10.5,displayValue:"五号"},{value:9,displayValue:"小五"},{value:7.5,displayValue:"六号"},{value:6.5,displayValue:"小六"},{value:5.5,displayValue:"七号"},{value:5,displayValue:"八号"},
  1. 将修改好的 app.js 拷贝到容器中
    docker cp app.js cf321c512a6a:/var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/
bash 复制代码 
#进入容器
docker exec -it cf321c512a6a /bin/bash
cd /usr/bin
#执行：
./documentserver-generate-allfonts.sh

至此，服务已搭建完毕，可以运行本地地址查看服务运行效果。

2.9 测试OnlyOffice服务

访问网址：192.168.93.128:9000，需要以 IP加端口 方式访问，不能用 localhost 访问。

看到这个画面就说明服务已经成功运行了。

三、在线预览office文档

onlyoffice 服务已经创建完成了，接下来我们需要验货了，简简单单创建个测试 Vue3 项目。

服务端地址：

http://192.168.93.128:9000/web-apps/apps/api/documents/api.js

html 复制代码 
<!DOCTYPE html>
<html lang="zh">

	<head>
		<meta charset="UTF-8">
		<title>测试onlyoffice在线预览文件功能</title>
		<script type="text/javascript" src="http://192.168.93.128:9000/web-apps/apps/api/documents/api.js"></script>
		<style>
			 
			html {
				height: 100%;
				width: 100%;
				padding: 0;
				margin: 0;
			}

			body {
				height: 100%;
				width: 100%;
				padding: 0;
				margin: 0;
			}
		</style>
	</head>

	<body class="full-screen">
		<div id="placeholder"></div>

		<script language="javascript" type="text/javascript">
			//        var docEditor = new DocsAPI.DocEditor("placeholder", {

			//            "document": {
			//                "fileType": "docx",
			//                "title": "2024xxxx移动云应用合同.docx",
			//                //地址必须文件服务器能访问到
			//                "url": "https://minio.nbweixin.cn/private/xxx/file/20241212/2024%E5%8D%97%E4%BA%AC%E5%85%86%E4%BA%BF%E7%A7%BB%E5%8A%A8%E4%BA%91%E5%BA%94%E7%94%A8%E5%90%88%E5%90%8C-1733983002.docx"
			//            },
			//            });

			var docEditor = new DocsAPI.DocEditor("placeholder", {

				"document": {
					"fileType": "docx",
					//每次打开需要生成不同的key
					"key": "253566000196390912",
					"title": "2024xxx云应用合同.docx",
					//地址必须文件服务器能访问到
					"url": "https://minio.nbweixin.cn/private/xxx/file/20241212/2024%E5%8D%97%E4%BA%AC%E5%85%86%E4%BA%BF%E7%A7%BB%E5%8A%A8%E4%BA%91%E5%BA%94%E7%94%A8%E5%90%88%E5%90%8C-1733983002.docx"
				},
				"editorConfig": {
					//回调地址，当点击保存时触发，wjbh为数据库的文件标识，可以在回调方法中做业务处理，回调程序的服务器必须能访问到文件服务器
					"callbackUrl": "http://192.168.1.180:8000/word/callbackSave?wjbh=253566000196390912",
					"lang": "zh-CN", // 中文
					 "mode": "view",//查看模式
					//"mode": "edit", //编辑模式
					"customization": { //定制部分允许自定义编辑器界面，使其看起来像您的其他产品，并更改是否存在其他按钮，链接，更改徽标和编辑者所有者详细信息。
						"help": false, //定义是显示还是隐藏"帮助"菜单按钮。默认值为true。
						"hideRightMenu": false, //定义在第一次加载时是显示还是隐藏右侧菜单。默认值为false。
						"autosave": false, //定义是启用还是禁用"自动保存"菜单选项。请注意，如果您在菜单中更改此选项，它将被保存到浏览器的localStorage中。默认值为true。
						"forcesave": true, //定义保存按钮是否显示默认false
						"chat": false, //定义"聊天"菜单按钮是显示还是隐藏；请注意，如果您隐藏"聊天"按钮，则相应的聊天功能也将被禁用。默认值为true。
						"commentAuthorOnly": false, //定义用户是否只能编辑和删除他的评论。默认值为false。
						"comments": true, //定义是显示还是隐藏"注释"菜单按钮；请注意，如果您隐藏"评论"按钮，则相应的评论功能将仅可用于查看，评论的添加和编辑将不可用。默认值为true。
						"compactHeader": false, //定义是否将菜单栏放在在徽标旁边使界面更加紧凑默认false。
						"compactToolbar": false, //定义显示的顶部工具栏类型是完整（false）还是紧凑true。默认值为false 多余菜单将在右侧折叠点击显示。
						"compatibleFeatures": false, //定义仅与OOXML格式兼容的功能的使用。例如，不要在整个文档上使用注释。默认值为false。
						"macros": true, //定义是否将运行文档宏以及可用的宏设置。默认值为true。
						"macrosMode": "warn", //定义是否将运行文档宏。可以采用以下值： disable -根本不运行；enable -自动运行所有宏；warn -警告宏并请求允许运行。默认值为original。
						"plugins": false, //定义是否将启动插件并可用。默认值为true。
						"showReviewChanges": false, //定义在加载编辑器时是否自动显示或隐藏审阅更改面板。默认值为false。
						"spellcheck": true, //定义在加载编辑器时是否自动打开或关闭拼写检查器。拼写检查器仅适用于文档编辑器和演示文稿编辑器。默认值为true。
						"toolbarNoTabs": false, //定义是突出显示顶部工具栏选项卡样式。默认值为false。
						"unit": "cm", //定义在标尺和对话框中使用的度量单位。可以采用以下值：cm -厘米，pt-点，inch -英寸。默认值为厘米（cm）。
						"zoom": 100, //定义以百分比为单位的文档显示缩放值。可以取大于0的值。对于文本文档和演示文稿，可以将此参数设置为-1（使文档适合页面选项）或-2（使文档页面宽度适合编辑器页面）。默认值为100。
						"goback": { //定义"打开文件位置"菜单按钮和右上角按钮的设置。该对象具有以下参数：
							"blank": true, //在新的浏览器选项卡/窗口（如果值设置为true）或当前选项卡（如果值设置为false）中打开网站。默认值为true，
							"requestClose": false, //定义如果单击"打开文件位置"按钮，则调用events.onRequestClose事件，而不是打开浏览器选项卡或窗口。默认值为false，
							"text": "Open file location", //将在"打开文件位置"菜单按钮和右上角按钮（即，而不是"转到文档"）上显示的文本，
							"url": "https://www.baidu.com" //单击"打开文件位置"菜单按钮时将打开的网站地址的绝对URL ，
						}
					},
					"user": { //用户信息
						"id": "111111", //用户ID
						"name": "张三" //用户全名称
					},
					// "documentType": "cell", //表格
					  "documentType": "word",//文档
					// "documentType": "slide",//ppt演示
					// "type": "desktop"
				}
			});
		</script>
	</body>
	<style type="text/css">
		.full-screen {
			height: 100%;
			overflow: hidden;
		}
	</style>

</html>

运行结果：

四、Cpolar内网穿透

Cpolar 内网穿透工具 教程请移步：Cpolar 内网穿透工具 。

至此，就大功告成了。

觉得有帮助就点个赞赞吧 💕💕💕

相关推荐
yqcoder5 分钟前
本地储存和服务器储存区别
运维·服务器
乱蜂朝王1 小时前
Linux更改远程默认SSL端口
linux·服务器·ssl
RayLink远程控制电脑1 小时前
企业IT运维人员如何利用手机远程控制电脑来进行移动管理的？
运维·智能手机·电脑
马立杰1 小时前
LVS能否实现两台服务器的负载均衡
linux·lvs
kaoa0001 小时前
Linux入门攻坚——41、Linux集群系统入门-lvs（2）
linux·运维
阿秋.1221 小时前
Ansible运维实战-自动化安装nginx
linux·运维·服务器·自动化·ansible
两张不够花1 小时前
ansible自动化运维（三）jinja2模板&&roles角色管理
运维·自动化·ansible
运维小文1 小时前
ansible安装和常用模块的使用
linux·运维·自动化·ansible·devops
明明跟你说过2 小时前
在CentOS 7中安装与配置【Ansible】的详细指南
linux·运维·centos·ansible
两张不够花2 小时前
ansible自动化运维（二）playbook模式详解
运维·自动化·ansible
热门推荐
01Windows11 Copilot助手开启教程(免费GPT-4)0204 - matlab m_map地学绘图工具基础函数 - 设置网格03玄机平台应急响应—webshell查杀04量化方法怎么选？如何评估量化后的大模型LLM？05【halcon】halcon字符识别——OCR06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07『手写ahooks系列-useClickAway』一个hook解决监听点击元素外部08支付宝短视频平台创作分成激励项目09Docker 夺命连环 15 问10MacBook外接键盘修改键位