基于Debian12搭建OnlyOffice8.3并集成到owncloud-南小濡的技术窝

前提提要：

已部署owncloud并改为https访问；
已准备好纯净的Debian系统。
已在AD DNS上将office.xx.xx解析到onlyoffice主机

注意：本文基于系统直接安装，非docker。所有过程均基于root账户进行。

注意：在Debian12中可能需要手动禁用从光盘安装软件

安装&配置PostgreSQL

由于目前版本仅支持PostgreSQL，所以先安装此数据库。

sudo apt-get install postgresql

安装 PostgreSQL 后，创建 PostgreSQL 数据库和用户：

数据库用户必须具有 onlyoffice 名称。您可以指定任何密码。

根据官方提示我们使用默认的用户名和密码，注意不要开放外部访问权限

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

安装 rabbitmq

sudo apt-get install rabbitmq-server

更改默认的 ONLYOFFICE Docs 端口

因为我们后期要使用https，所以无需更改端口。如果实际情况需要则按需更改。

安装ONLYOFFICE

添加GPG秘钥

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

添加 ONLYOFFICE 文档存储库

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

更新包管理器缓存

sudo apt-get update

安装：mscorefonts

sudo apt-get install ttf-mscorefonts-installer

注意：此处有一个坑，Debian12默认已弃用这个库，所以无法通过这个命令直接安装，请直接通过手动安装：

cd /tmp

wget http://ftp.us.debian.org/debian/pool/contrib/m/msttcorefonts/ttf-mscorefonts-installer_3.7_all.deb

sudo dpkg -i ttf-mscorefonts-installer_3.7_all.deb

sudo apt install -f

安装ONLYOFFICE文档

此过程中会要求输入数据库密码，如果安装上面提供的代码则是：onlyoffice ，否则请输入自行定义的密码。安装过程较为漫长，请耐心等候

sudo apt-get install onlyoffice-documentserver

配置HTTPS

由于onlyoffice安装时会自带NGINX，所以我们做反代及https直接修改本机的cofig即可。

如果使用ip+https的方式推荐自签证书并于owncloud处打开关闭证书校验 。

首先将 .crt 和 .key 证书上传到 /tmp/ssl 目录（ssl目录自行创建），然后将其移动到 /etc/onlyoffice/ssl/ ：

sudo mkdir -p /etc/onlyoffice/ssl
sudo mv /tmp/ssl /etc/onlyoffice/ssl/

创建配置文件并写入配置：

sudo nano /etc/nginx/conf.d/onlyoffice-documentserver.conf

配置中的 xx 替换为实际名称
proxy_pass http://xx:80; 中的xx替换为本地服务IP

server {
    listen 443 ssl;
    server_name office.xx.xx;
    
    ssl_certificate /etc/onlyoffice/ssl/xx.pem;
    ssl_certificate_key /etc/onlyoffice/ssl/xx.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass http://xx:80;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

以上修改完毕后重启NGINX：

sudo systemctl restart nginx

使用https访问应正常访问 /welcome 则配置完成。

owncloud接入onlyoffice

首先启用onlyoffice插件，然后于 额外的 选项进行配置。注意：owncloud必须同步配置https否则会出现无法访问https报错。

ONLYOFFICE Docs地址：输入相应的地址

秘钥(留空为关闭)：查看地址位于：/etc/onlyoffice/documentserver/local.json下的 services-CoAuthoring-secret-string

授权标头 (留空以使用默认的标头)：留空即可

服务器内部请求 ONLYOFFICE Docs 的地址：填写onlyoffice地址

ONLYOFFICE Docs 内部请求服务器的地址：填写owncloud地址

点击保存即可，配置无误后此时下方应该多出如下即配置成功：

重点提炼

安装ttf-mscorefonts-installer 基本上需要手动安装；
安装过程需要耐心等待；

目录CONTENT

基于Debian12搭建OnlyOffice8.3并集成到owncloud