灯塔 CMS 使用文档

上线检查与常见问题

上线前验收清单、备份要求和常见问题处理。

适用版本:1.3.4更新日期:2026-10-12

上线前检查清单

已修改默认管理员密码。
网站名称、Logo、Favicon、SEO、OG 图已设置。
全局货币 site_currency 已设置正确。
至少发布了核心产品、文章、案例和基础页面。
产品价格模式展示正常。
产品详情页询盘按钮可用。
联系表单可提交,后台能收到留言。
菜单、轮播图和首页区块已配置。
当前主题正确启用,手机端展示正常。
Google Translate 语言入口按市场配置。
员工权限已按职责分配。
storage/、app/、.env 等敏感路径不能直接访问。
storage/site.db 和 uploads/ 已备份。
站点已启用 HTTPS。
robots.txt 和 sitemap.xml 可访问。

常见问题

为什么上传主题后不能启用?

常见原因:

  • zip 包里包含多个主题目录。
  • 主题根目录缺少 style.css。
  • style.css 没有主题元数据。
  • 压缩包结构多套了一层无关目录。
  • 上传包被服务器大小限制拦截。

为什么主题没有封面图?

后台优先读取主题目录里的 screenshot.jpg。如果主题没有这个文件,主题列表会显示无预览图,但不一定影响启用。

为什么产品别名会被自动改成小写?

Slug 用于 URL,系统会统一过滤和标准化,避免中文、空格、特殊符号导致链接不稳定。

当前支持多少种翻译语言?

当前多语言功能基于 Google Translate 在线翻译能力实现,后台语言目录支持 249 种语言。官网、后台和文档都应以 249 种语言作为统一口径。

为什么保存模板区块后前台没变化?

先确认当前启用主题,再确认修改的是当前主题对应区块。如果仍然无效,检查主题模板是否调用了该区块字段。

更新失败后怎么办?

不要重复点击更新。先查看更新日志和备份文件,确认数据库是否完整,再恢复备份或交给维护人员处理。