核心思路：通过目录挂载实现本地修改容器文件，避免反复进入容器操作，便于二次开发和配置调整。

---

1，拉取OnlyOffice镜像

从华为云镜像仓库拉取指定版本(8.3.3.1)：

docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/onlyoffice/documentserver:8.3.3.1

若需最新版可使用官方镜像：

docker pull onlyoffice/documentserver

---

2，创建本地目录结构

在D盘创建以下目录（Windows系统）：

D:\onlyoffice
├─ web-apps
├─ document-server
└─ sdkjs

此目录将作为容器内文件的映射目录，实现本地化修改。

---

3，初始化本地文件（首次部署必做）

启动临时容器：

docker run -itd --name onlyoffice_temp \
swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/onlyoffice/documentserver:8.3.3.1

复制容器文件到本地：

docker cp onlyoffice_temp:/var/www/onlyoffice/documentserver/web-apps D:\onlyoffice\web-apps
docker cp onlyoffice_temp:/var/www/onlyoffice/documentserver/document-server D:\onlyoffice\document-server
docker cp onlyoffice_temp:/var/www/onlyoffice/documentserver/sdkjs D:\onlyoffice\sdkjs

清理临时容器：

docker stop onlyoffice_temp && docker rm onlyoffice_temp

---

4，启动正式容器并挂载目录

docker run -d --name onlyoffice-ds -p 8000:80 -e JWT_ENABLED=false -v onlyoffice-data:/var/www/onlyoffice/Data -v onlyoffice-log:/var/log/onlyoffice onlyoffice/documentserver:latest

参数说明：

• -p 8000:80：将容器80端口映射到主机8000端口
• -v 参数实现目录双向绑定

---

修改配置与生效

直接编辑本地文件：

• 修改SDKJS脚本：D:\onlyoffice\sdkjs
• 调整文档服务配置：D:\onlyoffice\document-server
• 自定义Web应用：D:\onlyoffice\web-apps

重启容器使修改生效：

docker restart onlyoffice

访问控制台：

http://localhost:8000

---

关键目录说明

容器内路径	本地路径	作用
/var/www/onlyoffice/documentserver/web-apps	D:\onlyoffice\web-apps	OnlyOffice插件和Web应用
/var/www/onlyoffice/documentserver/document-server	D:\onlyoffice\document-server	文档处理服务核心文件
/var/www/onlyoffice/documentserver/sdkjs	D:\onlyoffice\sdkjs	前端SDK和编辑器脚本

---

5，常见问题解决

权限问题
解决方案：启动时添加 --user root 参数

docker run ... --user root ...

修改不生效

• 确保执行了 docker restart onlyoffice
• 清除浏览器缓存
• 检查目录映射是否正确：

  docker exec -it onlyoffice ls /var/www/onlyoffice/documentserver/sdkjs
  

日志查看

docker logs onlyoffice  # 检查启动错误

---

调试建议

进入容器检查文件状态：

docker exec -it onlyoffice bash

在容器内验证文件：

ls -l /var/www/onlyoffice/documentserver/sdkjs

---

优势总结：通过目录挂载实现「修改即生效」，特别适合需要深度定制OnlyOffice的场景（如汉化、UI修改、功能增强等），避免了反复构建镜像的繁琐过程。

部署完成后，所有对D:\onlyoffice下文件的修改都会实时同步到容器内，结合docker restart即可快速验证修改效果，极大提升开发调试效率！