only-office以Docker方式安装使用

目录

• 安装Docker
  • 安装
  • 配置Docker
  • 验证docker是否正常
• 安装only-office server
  • 系统需求
  • 创建数据目录
  • 启动docker容器
  • 开放防火墙端口
  • 可配置的参数
• 使用文档
• 添加中文字体
  • 编辑字体
  • 删除自带字体
  • 将字体文件导入docker容器，此种方式设置后字体生效，但是字体选择列表中中文字体显示乱码
• 文件预览
• 文件编辑

安装Docker

安装

# 安装必要依赖
yum install -y yum-utils device-mapper-persistent-data lvm2

# 添加aliyum docker-ce yum源
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 重建yum缓存
yum makecache

# 安装指定版本docker，版本19.03.12
yum install -y docker-ce-19.03.12-3.el7

# 确保网络模块开机自动加载
lsmod | grep overlay
lsmod | grep br_netfilter

cat > /etc/modules-load.d/docker.conf <<EOF
overlay
br_netfilter
EOF

modprobe overlay
modprobe br_netfilter

# 使桥接流量对iptables可见
cat > /etc/sysctl.d/k8s.conf <<EOF
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
EOF

sysctl --system

# 验证是否生效，下面两个命令结果需均返回 1
sysctl -n net.bridge.bridge-nf-call-iptables
sysctl -n net.bridge.bridge-nf-call-ip6tables

配置Docker

# 创建docker镜像存储目录
cd ~
mkdir data
cd data/
mkdir docker
cd docker/
mkdir data-root
cd data-root/
pwd #输出结果：/root/data/docker/data-root

# 创建docker配置文件目录
mkdir /etc/docker

# 修改cgroup驱动为systemd[k8s官方推荐]、限制容器日志量、修改存储类型，最后的docker根目录可修改
cat > /etc/docker/daemon.json <<EOF
{
  "exec-opts": ["native.cgroupdriver=systemd"],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m"
  },
  "storage-driver": "overlay2",
  "storage-opts": [
    "overlay2.override_kernel_check=true"
  ],
  "registry-mirrors": ["https://7uuu3esz.mirror.aliyuncs.com"],
  "data-root": "/root/data/docker/data-root"
}
EOF

# 添加开机自启动，并立即启动
systemctl enable --now docker

验证docker是否正常

# 查看docker信息，判断是否与配置一致
docker info

# hello-docker测试
docker run --rm hello-world

# 删除测试的image
docker rmi hello-world

验证能否通过IP:Port方式访问Docker站点

# 查看docker server信息，确认最后一行是否报错
docker info

# 错误信息见下面最后一行，目前无错误信息
Client:
 Context:    default
 Debug Mode: false
 Plugins:
  app: Docker App (Docker Inc., v0.9.1-beta3)
  buildx: Build with BuildKit (Docker Inc., v0.5.1-docker)

Server:
 Containers: 0
  Running: 0
  Paused: 0
  Stopped: 0
 Images: 0
 Server Version: 19.03.12
 Storage Driver: overlay2
  Backing Filesystem: xfs
  Supports d_type: true
  Native Overlay Diff: true
 Logging Driver: json-file
 Cgroup Driver: systemd
 Plugins:
  Volume: local
  Network: bridge host ipvlan macvlan null overlay
  Log: awslogs fluentd gcplogs gelf journald json-file local logentries splunk syslog
 Swarm: inactive
 Runtimes: runc
 Default Runtime: runc
 Init Binary: docker-init
 containerd version: 05f951a3781f4f2c1911b05e61c160e9c30eaa8e
 runc version: 12644e614e25b05da6fd08a38ffa0cfe1903fdec
 init version: fec3683
 Security Options:
  seccomp
   Profile: default
 Kernel Version: 3.10.0-1127.el7.x86_64
 Operating System: CentOS Linux 7 (Core)
 OSType: linux
 Architecture: x86_64
 CPUs: 2
 Total Memory: 1.777GiB
 Name: localhost.localdomain
 ID: 2HIV:6EH2:KI53:BUGY:YD72:Q3BI:Y4MJ:X65V:YF2N:TFUZ:BRTD:ZOA3
 Docker Root Dir: /root/data/docker/data-root
 Debug Mode: false
 Registry: https://index.docker.io/v1/
 Labels:
 Experimental: false
 Insecure Registries:
  127.0.0.0/8
 Registry Mirrors:
  https://7uuu3esz.mirror.aliyuncs.com/
 Live Restore Enabled: false

安装only-office server

参考地址：https://helpcenter.onlyoffice.com/installation/docs-community-install-docker.aspx?_ga=2.248226951.1825569553.1616058768-1266077697.1607495094

系统需求

• CPU: dual core 2 GHz or better
• RAM: 2 GB or more
• HDD: at least 40 GB of free space
• Additional requirements: at least 4 GB of swap
• OS: amd64 Linux distribution with kernel version 3.10 or later
• Additional requirements
  • Docker: version 1.10 or later

创建数据目录

• /var/log/onlyoffice for ONLYOFFICE Docs logs
• /var/www/onlyoffice/Data for certificates
• /var/lib/onlyoffice for file cache
• /var/lib/postgresql for database

# 进入数据存储目录
cd /root/data
mkdir onlyoffice
cd onlyoffice
mkdir DocumentServer
cd DocumentServer
pwd
# 显示路径：/root/data/onlyoffice/DocumentServer

# 创建对应目录
mkdir logs
mkdir data
mkdir lib
mkdir db
ls

启动docker容器

# 启动docker容器，默认启动端口为80，可以进行修改
docker run -i -t -d -e TZ="Asia/Shanghai" -p 81:80 --restart=always \
    -v /root/data/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \
    -v /root/data/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  \
    -v /root/data/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
    -v /root/data/onlyoffice/DocumentServer/db:/var/lib/postgresql  onlyoffice/documentserver

# 查看镜像下载
docker images

# 查看容器
docker ps

# 查看启动日志
docker logs -f 容器ID

开放防火墙端口

# 开放端口
firewall-cmd --add-port=81/tcp --permanent

# 重新加载配置
firewall-cmd --reload

# 查看防火墙开放情况
firewall-cmd --list-port

# 验证外网是否可以访问，查看此文件能否查看或打开
http://192.168.110.129:81/

可配置的参数

Please refer the docker run command options for the --env-file flag where you can specify all required environment variables in a single file. This will save you from writing a potentially long docker run command.

• ONLYOFFICE_HTTPS_HSTS_ENABLED: Advanced configuration option for turning off the HSTS configuration. Applicable only when SSL is in use. Defaults to true.
• ONLYOFFICE_HTTPS_HSTS_MAXAGE: Advanced configuration option for setting the HSTS max-age in the onlyoffice NGINX vHost configuration. Applicable only when SSL is in use. Defaults to 31536000.
• SSL_CERTIFICATE_PATH: The path to the SSL certificate to use. Defaults to /var/www/onlyoffice/Data/certs/onlyoffice.crt.
• SSL_KEY_PATH: The path to the SSL certificate private key. Defaults to /var/www/onlyoffice/Data/certs/onlyoffice.key.
• SSL_DHPARAM_PATH: The path to the Diffie-Hellman parameter. Defaults to /var/www/onlyoffice/Data/certs/dhparam.pem.
• SSL_VERIFY_CLIENT: Enable verification of client certificates using the CA_CERTIFICATES_PATH file. Defaults to false.
• POSTGRESQL_SERVER_HOST: The IP address or the name of the host where the PostgreSQL server is running.
• POSTGRESQL_SERVER_PORT: The PostgreSQL server port number.
• POSTGRESQL_SERVER_DB_NAME: The name of a PostgreSQL database to be created on the image startup.
• POSTGRESQL_SERVER_USER: The new user name with superuser permissions for the PostgreSQL account.
• POSTGRESQL_SERVER_PASS: The password set for the PostgreSQL account.
• AMQP_SERVER_URL: The AMQP URL to connect to the message broker server.
• AMQP_SERVER_TYPE: The message broker type. Supported values are rabbitmq or activemq. Defaults to rabbitmq.
• REDIS_SERVER_HOST: The IP address or the name of the host where the Redis server is running.
• REDIS_SERVER_PORT: The Redis server port number.
• NGINX_WORKER_PROCESSES: Defines the number of NGINX worker processes.
• NGINX_WORKER_CONNECTIONS: Sets the maximum number of simultaneous connections that can be opened by a NGINX worker process.
• JWT_ENABLED: Specifies the enabling the JSON web token validation by ONLYOFFICE Docs. Defaults to false.
• JWT_SECRET: Defines the secret key to validate the JSON web token in the request to ONLYOFFICE Docs. Defaults to secret.
• JWT_HEADER: Defines the HTTP header that will be used to send the JSON web token. Defaults to Authorization.

使用文档

官方文档地址：https://api.onlyoffice.com/editors/basic.

添加中文字体

编辑字体

• 在Windows目录的C:\Windows\Fonts查找常用中文字体文件；
• 使用字体编辑软件FontCreator修改参数配置：
  • 选择 字体属性；
  • 将字体家族改为中文；
    
    字体子族改为常规；
    
    注意：这里字体家族中间得加个空格。
• 将修改后的字体导出为新的字体包。

删除自带字体

# 进入容器内
docker ps
docker exec -it 51 bash

# 删除原版自带字体
cd /usr/share/fonts/
rm -rf *

cd /var/www/onlyoffice/documentserver/core-fonts/
rm -rf *

将字体文件导入docker容器，此种方式设置后字体生效，但是字体选择列表中中文字体显示乱码

# 在服务器创建字体目录
cd /root/data/onlyoffice
mkdir fonts
cd fonts/

# 将字符文件复制到该目录
rz

# 将字体复制到容器的对应目录下
docker cp /root/data/onlyoffice/fonts/ 51e38c77ddbd:/usr/share/fonts/truetype/custom

docker cp /root/data/onlyoffice/dockerImage/Contents.json e13c3a79dc43:/var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/resources/help/zh

# 进入容器内
docker ps
docker exec -it 51 bash

# 确认字体文件是否是最新的
cd /usr/share/fonts/truetype/custom/fonts
ll

# 执行字体重新加载脚本
cd /usr/bin/
./documentserver-generate-allfonts.sh

# 输出内容如下：
Generating AllFonts.js, please wait...Done
Generating presentation themes, please wait...Done
ds:docservice: stopped
ds:docservice: started
ds:converter: stopped
ds:converter: started

# 生成的字体JS配置文件
/var/www/onlyoffice/documentserver/server/FileConverter/bin/AllFonts.js

文件预览

创建Html页面，在html文件中编写对应预览代码。

documentType参数说明

# 5.4.2 版本
# 字符串类型，定义文档打开类型：

1、text(.doc, .docm, .docx, .dot, .dotm, .dotx, .epub, .fodt, .htm, .html, .mht, .odt, .ott, .pdf, .rtf, .txt, .djvu, .xps);

2、spreadsheet(.csv, .fods, .ods, .ots, .xls, .xlsm, .xlsx, .xlt, .xltm, .xltx);

3、presentation(.fodp, .odp, .otp, .pot, .potm, .potx, .pps, .ppsm, .ppsx, .ppt, .pptm, .pptx).

World

<!DOCTYPE html>
<html style="height: 100%;">
<head>
    <title>ONLYOFFICE Word</title>
    <link rel="icon" href="https://oa.cnki.net/v/home/cnki.ico" type="image/x-icon" />
    <link rel="shortcut icon" href="https://oa.cnki.net/v/home/cnki.ico" type="image/x-icon" />
</head>
<body style="height: 100%; margin: 0;">
    <div id="placeholder" style="height: 100%"></div>
    <script type="text/javascript" src="http://192.168.110.129:81/web-apps/apps/api/documents/api.js"></script>

    <script type="text/javascript">

        window.docEditor = new DocsAPI.DocEditor("placeholder",
            {
                "document": {
                    "fileType": "docx",
                    "key": "D24A86BDE9A2-01-10",
                    "permissions": {
                        "comment": false,
                        "copy": true,
                        "download": true,
                        "edit": false,
                        "fillForms": false,
                        "modifyContentControl": false,
                        "modifyFilter": true,
                        "print": true,
                        "review": false
                    },
                    "title": "test.docx",
                    "url": "http://192.168.110.129/onlyoffice/word01.docx"
                },
                "documentType": "word",
                "editorConfig": {
                    "mode": "view",
                    "lang": "zh-CN",
                    "customization": {
                        "chat": false,
                        "comments": false,
                        "compactHeader": false,
                        "compactToolbar": false,
                        "compatibleFeatures": false,
                        "customer": {
                            "address": "北京",
                            "info": "中国知网",
                            "logo": "https://oa.cnki.net/v/home/cnki.ico",
                            "mail": "oa@cnki.net",
                            "name": "中国知网",
                            "www": "https://oa.cnki.net"
                        },
                        "feedback": {
                            "url": "https://oa.cnki.net",
                            "visible": false
                        },
                        "help": false,
                        "hideRightMenu": true,
                        "logo": {
                            "image": "https://oa.cnki.net/v/home/cnki.ico",
                            "imageEmbedded": "https://oa.cnki.net/v/home/cnki.ico",
                            "url": "https://oa.cnki.net"
                        },
                        "plugins": false,
                        "toolbarHideFileName": true
                    }
                },
                "type": "desktop",
                "height": "100%",
                "width": "100%"
            });

    </script>
</body>
</html>

Excel

<!DOCTYPE html>
<html style="height: 100%;">
<head>
    <title>ONLYOFFICE Excel</title>
</head>
<body style="height: 100%; margin: 0;">
    <div id="placeholder" style="height: 100%"></div>
    <script type="text/javascript" src="http://10.120.160.113:81/web-apps/apps/api/documents/api.js"></script>

    <script type="text/javascript">

        window.docEditor = new DocsAPI.DocEditor("placeholder",
            {
                "document": {
                    "fileType": "xlsx",
                    "key": "138E9734B413-01",
                    "title": "Example Spreadsheet Title.xlsx",
                    "url": "http://oa.cnki.net/api/file/File/Download?fileId=065F87CE9C724D2AA26313E449A59809" //"http://10.120.160.100/fs/test-onlyoffice/test01.xlsx"
                },
                "documentType": "cell",
                "editorConfig": {
                    "mode": "view"
                },
                "height": "100%",
                "width": "100%"
            });

    </script>
</body>
</html>

PPT

<!DOCTYPE html>
<html style="height: 100%;">
<head>
    <title>ONLYOFFICE PPT</title>
</head>
<body style="height: 100%; margin: 0;">
    <div id="placeholder" style="height: 100%"></div>
    <script type="text/javascript" src="http://10.120.160.113:81/web-apps/apps/api/documents/api.js"></script>

    <script type="text/javascript">

        window.docEditor = new DocsAPI.DocEditor("placeholder",
            {
                "document": {
                    "fileType": "pptx",
                    "key": "D24A86BDE9A2-01-03-123",
                    "title": "Example Presentation Title.pptx",
                    "url": "http://10.120.160.100/fs/test-onlyoffice/ppt01.pptx"
                },
                "documentType": "slide",
                "editorConfig": {
                    "mode": "view"
                },
                "height": "100%",
                "width": "100%"
            });

    </script>
</body>
</html>

测试预览URL

http://192.168.110.129/onlyoffice/index-word.html

http://192.168.110.129/onlyoffice/index-word-cnki.html

http://192.168.110.129/onlyoffice/index-excel.html

http://192.168.110.129/onlyoffice/index-ppt.html

文档下载接口测试：http://oa.cnki.net/api/file/File/Download?fileId=065F87CE9C724D2AA26313E449A59809

文件编辑

下面以word文件编辑作为示例进行验证。

在文档编辑时，需指定编辑的回调地址，此回调程序使用Java语言编写，以jar包方式在服务器上面运行，因此需要在服务器上面安装JDK环境。

<!DOCTYPE html>
<html style="height: 100%;">
<head>
    <title>ONLYOFFICE Api Documentation</title>
</head>
<body style="height: 100%; margin: 0;">
    <div id="placeholder" style="height: 100%"></div>
    <script type="text/javascript" src="http://192.168.110.129:82/web-apps/apps/api/documents/api.js"></script>

    <script type="text/javascript">

        window.docEditor = new DocsAPI.DocEditor("placeholder",
            {
                "document": {
                    "fileType": "docx",
                    "key": "E7FAFC9C2210-020",
                    "title": "word01.docx",
                    "url": "http://192.168.110.129/onlyoffice/word01.docx"
                },
                "documentType": "text",
                "editorConfig": {
                    "lang": "zh-cn",
                    "callbackUrl": "http://192.168.110.129:8080/test/getRequestData",
                    "customization": {
                        "chat": false,
                        "comments": false,
                        "compactHeader": false,
                        "compactToolbar": false,
                        "compatibleFeatures": false,
                        "customer": {
                            "address": "北京",
                            "info": "中国知网",
                            "logo": "https://oa.cnki.net/v/home/cnki.ico",
                            "mail": "oa@cnki.net",
                            "name": "中国知网",
                            "www": "https://oa.cnki.net"
                        },
                        "feedback": {
                            "url": "https://oa.cnki.net",
                            "visible": false
                        },
                        "help": false,
                        "hideRightMenu": true,
                        "logo": {
                            "image": "https://oa.cnki.net/v/home/cnki.ico",
                            "imageEmbedded": "https://oa.cnki.net/v/home/cnki.ico",
                            "url": "https://oa.cnki.net"
                        },
                        "plugins": false,
                        "toolbarHideFileName": true
                    }
                },
                "height": "100%",
                "width": "100%"
            });

    </script>
</body>
</html>

测试编辑URL

# word
http://192.168.110.129/onlyoffice/edit-word.html

http://192.168.110.129/onlyoffice/edit-word-cnki.html

# 查看验证
http://192.168.110.129/onlyoffice/index-word.html

# 协同编辑
http://192.168.110.129/onlyoffice/co-edit-01.html
http://192.168.110.129/onlyoffice/co-edit-02.html

回调样例数据

// 进入编辑
{
  "actions" : [ {
    "type" : 1,
    "userid" : "uid-1617000391704"
  } ],
  "forcesavetype" : 0,
  "key" : "E7FAFC9C22A8",
  "status" : 1,
  "users" : [ "uid-1617000391704" ]
}

////////////////////////////////////////////////////////////////////////////////////////////////////////

// 关闭页面后，自动保存的回调
{
  "actions" : [ {
    "type" : 0,
    "userid" : "uid-1617000391704"
  } ],
  "changesurl" : "http://192.168.110.129:81/cache/files/E7FAFC9C22A8_2529/changes.zip/changes.zip?md5=tOXiIFPV9i59huCMjv5iMg&expires=1617001678&disposition=attachment&filename=changes.zip",
  "forcesavetype" : 0,
  "history" : {
    "changes" : [ {
      "created" : "2021-03-29 06:46:57",
      "user" : {
        "id" : "uid-1617000391704",
        "name" : "Anonymous"
      }
    } ],
    "serverVersion" : "6.1.0"
  },
  "key" : "E7FAFC9C22A8",
  "status" : 2,
  "url" : "http://192.168.110.129:81/cache/files/E7FAFC9C22A8_2529/output.docx/output.docx?md5=ROMKlDaRuRgCBti99kZH2Q&expires=1617001678&disposition=attachment&filename=output.docx",
  "users" : [ "uid-1617000391704" ]
}