【DOCKER】DOCKER容器部署的ONLYOFFICE 启用HTTPS

DOCKER容器部署的ONLYOFFICE 启用HTTPS

      • [1. 准备工作(备份与判断部署方式)](#1. 准备工作(备份与判断部署方式))
      • [2. 停止 Nginx 服务(可选)](#2. 停止 Nginx 服务(可选))
      • [3. 复制 HTTPS 模板覆盖原配置](#3. 复制 HTTPS 模板覆盖原配置)
      • [4. 修改 `ds.conf` 中的参数](#4. 修改 ds.conf 中的参数)
      • [5. 重启 ONLYOFFICE 容器](#5. 重启 ONLYOFFICE 容器)
      • [✅ 验证配置](#✅ 验证配置)

背景:已准备好私钥文件onlyoffice.key和证书文件onlyoffice.pem,onlyoffice通过docker容器部署


1. 准备工作(备份与判断部署方式)

在进行任何配置更改前,强烈建议先备份原有配置文件。

  1. 进入正在运行的 ONLYOFFICE 容器:

    bash 复制代码
    sudo docker exec -it <容器名称或ID> /bin/bash

    提示:可使用 sudo docker ps 查看容器信息。

  2. 在容器内备份原始 ds.conf:

    bash 复制代码
    cp /etc/onlyoffice/documentserver/nginx/ds.conf /etc/onlyoffice/documentserver/nginx/ds.conf.backup

2. 停止 Nginx 服务(可选)

可以不停止服务,后续直接重启,但为避免配置加载冲突,建议先停止:

bash 复制代码
sudo systemctl stop nginx

3. 复制 HTTPS 模板覆盖原配置

仅适用于 v5.3 及以上版本,使用 SSL 模板:

bash 复制代码
sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf

其他版本请参考官方文档:Switching ONLYOFFICE Docs to HTTPS protocol


4. 修改 ds.conf 中的参数

使用编辑器打开配置文件:

bash 复制代码
sudo vim /etc/onlyoffice/documentserver/nginx/ds.conf

将以下 {``{...}} 占位符替换为实际值:

参数 说明
{``{SSL_CERTIFICATE_PATH}} SSL 证书路径(如 /etc/ssl/onlyoffice.crt)
{``{SSL_KEY_PATH}} 证书私钥路径(如 /etc/ssl/onlyoffice.key)
{``{SSL_VERIFY_CLIENT}} 是否启用客户端证书验证,可选:on、off、optional、optional_no_ca
{``{CA_CERTIFICATES_PATH}} 客户端 CA 证书路径(如需双向认证)
{``{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} HSTS 最大有效期(默认 31536000,单位:秒)
{``{SSL_DHPARAM_PATH}} Diffie-Hellman 参数文件路径(增强密钥交换安全)

更多 Nginx SSL 参数配置可参考:Module ngx_http_ssl_module

例如:

bash 复制代码
include /etc/nginx/includes/http-common.conf;

## Normal HTTP host
server {
  listen 0.0.0.0:80;
  listen [::]:80 default_server;
  server_name _;
  server_tokens off;
  set $secure_link_secret verysecretstring;

  ## Redirects all traffic to the HTTPS host
  root /nowhere; ## root doesn't have to be a valid path since we are redirecting
  rewrite ^ https://$host$request_uri? permanent;
}

#HTTP host for internal services
server {
  listen 127.0.0.1:80;
  listen [::1]:80;
  server_name localhost;
  server_tokens off;
  set $secure_link_secret verysecretstring;
  include /etc/nginx/includes/ds-common.conf;
  include /etc/nginx/includes/ds-docservice.conf;
}

## HTTPS host
server {
  listen 0.0.0.0:443 ssl http2;
  listen [::]:443 ssl default_server http2;
  server_tokens off;
  set $secure_link_secret verysecretstring;
  root /usr/share/nginx/html;
  ## Strong SSL Security
  ## https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html
  ssl_certificate /var/www/onlyoffice/Data/certs/onlyoffice.pem;
  ssl_certificate_key /var/www/onlyoffice/Data/certs/onlyoffice.key;
  # Uncomment string below and specify the path to the file with the password if you use encrypted certificate key
  # ssl_password_file {{SSL_PASSWORD_PATH}};
  ssl_verify_client off;
  ssl_ciphers "EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH";
  ssl_protocols TLSv1.2;
  ssl_session_cache  builtin:1000  shared:SSL:10m;
  ssl_prefer_server_ciphers   on;
  add_header Strict-Transport-Security max-age=31536000;
  add_header X-Content-Type-Options nosniff;
  include /etc/nginx/includes/ds-*.conf;

}

5. 重启 ONLYOFFICE 容器

  1. 停止ONLYOFFICE 容器:

    bash 复制代码
    sudo docker stop  <容器名称或ID>
  2. 删除ONLYOFFICE 容器:

    bash 复制代码
    sudo docker rm  <容器名称或ID>
  3. 启动ONLYOFFICE 容器:

    这条命令有很多参数可视情况自行选择,不要照搬

    bash 复制代码
    sudo docker run -itd -p 8081:80 -p 7443:443 -v /home/wst/docx_deploy/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data -v /home/wst/docx_deploy/onlyoffice/DocumentServer/data/nginx/ds.conf:/etc/onlyoffice/documentserver/nginx/ds.conf --name onlyoffice-document-server-9.0.4.1  --privileged -e JWT_SECRET=my_jwt_secret --restart=always onlyoffice/documentserver:9.0.4.1

✅ 验证配置

  1. 在容器内检查 Nginx 配置语法:

    bash 复制代码
    sudo nginx -t
  2. 访问您的 ONLYOFFICE Docs 地址,确认已通过 https://ip:7443 正常访问,并且 HTTP 请求被重定向。


相关推荐
csdn_aspnet2 小时前
Docker 啟動MySQL Server連上MySQL Workbench
mysql·docker·容器
月夏3 小时前
我把全栈项目塞进已有 nginx 的服务器,卡我最久的是三个斜杠
nginx·react.js·docker
瑞克-桑切斯19 小时前
Kubernetes 1.28 保姆级新手学习教程
运维·学习·docker·云原生·容器·kubernetes
对象存储与RustFS1 天前
对象锁遇上版本化:删掉的对象还在,真删的又删不掉
后端·docker·云原生
遇雪长安1 天前
wslc 来了:Docker Desktop 还要留着吗?
运维·docker·容器
csdn_aspnet1 天前
【Docker 攻略】MySQL 安裝篇
运维·mysql·docker·容器
艺杯羹1 天前
ufw 已 active,Docker 端口却仍对外开放的复盘
运维·docker·容器
goehou1 天前
healthcheck 配了不生效,depends_on 默认只等容器起来
docker·容器编排·ai agent·healthcheck
木头左1 天前
【Linux运维】服务器磁盘清理与Docker日志治理实战:一次巡检释放70G空间
linux·docker·磁盘清理·日志治理
csdn_aspnet2 天前
Docker MySql 5.7、MySql8.x 进阶配置
mysql·docker·容器