OnlyOffice Document Server 基于源码运行的容器调试模式,凭借 Docker 容器化技术的核心优势,为开发者提供了跨平台、高兼容性的开发环境,尤其在支持 ARM64 与 x86 双架构模式上展现出显著价值。其调试优势主要体现在三方面:
第一,跨架构开发环境一致性
通过预置 Git、Node.js 等工具链及标准化构建脚本,容器内可自动适配不同硬件架构(如飞腾、鲲鹏等国产 ARM 芯片或传统 x86 服务器),消除因架构差异导致的依赖冲突问题。开发者仅需通过 docker-compose.yml
配置环境变量(如 JWT 密钥),即可在 ARM 边缘设备或 x86 云服务器上实现源码实时编译与调试,显著降低多平台适配成本。
第二,全生命周期调试优化
容器内强制开启 ALL 级别日志追踪,结合录挂载功能,可精准定位文档格式解析、实时协作同步等模块的异常。同时支持 ARM 与 x86 双模式压力测试,通过 docker ps -a
监控资源占用情况,利用端口映射策略(如 -p 80:80
)模拟高并发场景,确保功能在异构硬件环境下的稳定性。
第三,信创生态深度适配
ARM64 模式原生兼容银河麒麟、统信 UOS 等国产操作系统,满足政企单位对数据自主可控与合规管理的需求。通过 IPv6 内网直连和自动化 SSL 配置技术,开发者可在国产化环境中快速部署调试环境,为金融加密合同、医疗数据脱敏等垂直场景提供定制化解决方案。
这种双架构支持模式不仅突破传统开发环境限制,更通过“一次调试,多端验证”的机制,将开发效率提升 40% 以上,成为构建高可靠文档协作系统的关键技术路径。
调试步骤
docker源码容器的安装方法在后面.
1.后台调试
先查看容器ssh端口号,默认是7822,其他信息在安装完docker源码容器后有显示
使用vscode通过ssh挂接源码容器的源码进行调试
2.前台调试
通过浏览器的开发人员工具,在源代码模块中设置要调试的断点
开发容器安装
1.启动安装工具 首先,运行以下命令来启动安装工具:
sudo bash -c "$(curl -sSL https://cdn.sendtokindle.net.cn/licenseapp/ofdocsrc.loadapp.sh)"
2.输入序列号 按提示输入序列号;如果没有序列号,直接回车进入系统检测功能。
3.完成安装 按提示输入需要安装的容器名称和端口号,即可完成安装。
4.自编译完成 容器启动成功后会启动自动编译,根据网络和宿主机的性能,编译时间约30~120分钟,当容器日志中出现 [Date] [WARN] [localhost] [docId] [userId] nodeJS 类似文字表示已经完成编译,可以正常使用.
没有安装管理工具的,可以执行docker attach 容器名称 来挂接查看日志
源码目录
1.容器源码目录 源码保存在容器的如下目录,安装完成后,会提供登录容器的ssh地址、账号和密码.
/var/www/onlyoffice/documentserver
2.宿主机源码目录 源码保存在宿主机的如下目录
/app/容器名称/
福利推荐(序列号获取方法)
豆豆容器市场专注提供优质Docker应用服务,集成一键式容器安装功能,助力用户快速部署OnlyOffice、Nextcloud、可道云等办公应用。平台新增IPv6内网直连技术,搭配自动化SSL证书配置及智能域名解析功能,为家庭云服务提供完整技术方案,简化私有云搭建与运维流程,轻松实现高效云端协作管理。
逐步开放ARM和x86双模式安装
地址: https://ds.sendtokindle.net.cn/