如何导出使用Dotcms搭建的完整网站并完成跨服务器迁移
DotCMS站点完整备份迁移操作指南
此前使用HTTrack、wget爬取DotCMS站点效果不佳,核心原因是这两类通用爬取工具完全不适配DotCMS这类动态CMS的架构:
- DotCMS的核心可运行站点逻辑(页面结构、模板、内容条目、权限配置)全部存储在后端数据库,爬取工具仅能拿到渲染后的静态HTML和零星暴露的静态资源,完全无法获取站点的运行配置
- 零散抓取的contentAsset只是DotCMS存储用户上传静态资源的目录,脱离了数据库和站点配置的绑定,单独的资源文件没有任何部署价值
一、拥有原站点后台/服务器操作权限(唯一可实现完整部署的方案)
只有通过DotCMS原生导出流程,才能得到可直接迁移到其他服务器正常运行的完整站点,操作步骤如下:
- 导出官方标准站点配置包
登录原DotCMS后台,进入Site Management > Export模块,选择要备份的目标站点,勾选全量关联项后生成导出压缩包,需要纳入导出范围的内容包括:- 站点基础配置(域名、访问规则、权限设置)
- 所有内容类型、内容条目、分类标签
- 页面模板、容器、自定义JS/CSS、脚本组件
- 所有关联的静态资源(即contentAsset目录下的全部文件)
- 备份后端核心存储
仅导出配置包仍不完整,需要同步备份两类核心数据:- 导出DotCMS关联的全量数据库(支持PostgreSQL、MySQL等,使用对应数据库的官方导出工具生成全量备份文件即可)
- 备份原服务器上DotCMS安装目录下的
assets、custom、docs目录,重点核对contentAsset对应的实际物理存储路径,确保所有自定义上传的文件没有遗漏
- 校验备份完整性
检查导出包的生成日志,确认没有漏导出的模板、内容类型或资源;核对备份的assets目录总大小与后台显示的站点资源总大小一致,避免迁移后出现资源加载失败的问题
二、无后台权限的静态快照补救方案
如果无法操作原站点后台,仅能通过前端访问站点做静态存档,需要调整爬取工具的规则,解决之前抓取资源零散、缺失多的问题:
- 优先使用wget进行全量爬取(相比HTTrack,对动态站点的路径识别更稳定),使用如下命令(替换为实际域名和首页地址):
wget --mirror --page-requisites --convert-links --adjust-extension --execute robots=off --restrict-file-names=windows --domains=你的站点域名 --no-parent https://你的站点首页地址
核心参数作用:--mirror开启递归全量爬取--page-requisites自动抓取所有页面引用的CSS、JS、图片资源--convert-links将页面内的绝对链接转换为本地相对路径,保证本地打开可用--execute robots=off绕过站点的robots协议爬取限制
- 针对零散的contentAsset资源,可单独指定爬取该目录:直接将
https://你的站点域名/contentAsset/作为爬取入口,让工具遍历该目录下所有子层级的资源文件,最后将抓取的资源文件和静态页面路径对应归置
特别说明:该方案仅能得到站点的静态浏览快照,无法还原表单提交、动态内容筛选、权限控制等DotCMS核心动态功能,不能直接作为可运行的站点包部署
常见避坑提示
- 不要依赖通用整站爬取工具做DotCMS的迁移,爬取结果永远缺失核心运行逻辑,无法实现正常部署
- 不要单独归集爬取到的零散contentAsset文件,DotCMS的资源路径是和数据库内的内容对象绑定的,脱离配置的静态资源无部署价值
- 跨服务器迁移时优先保证新旧服务器的DotCMS版本一致,避免导入导出时出现兼容问题
内容的提问来源于stack exchange,提问作者ZuZu
相关产品推荐
相关产品推荐

