灯塔 CMS 使用文档

安装与入门

运行环境、部署方式、首次登录和后台导航。

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

这份文档面向网站管理员、运营人员、商品维护人员和销售跟单人员。目标是让团队不用阅读源码，也能完成灯塔 CMS 的部署、后台配置、内容维护、询盘处理、插件管理和上线检查。

1.3.4当前源码版本
249Google Translate 在线翻译语言
22版本化数据库迁移
0运行期外部 PHP 包依赖
适用范围

本文档按 灯塔 CMS v1.3.4 编写。后台入口通常是 /admin/login，演示环境常见初始账号为 admin / admin123。生产环境首次登录后必须立即修改默认密码。

角色与阅读路线

不同岗位关注点不同，可以按下面路线阅读：

角色重点章节目标
管理员安装部署、首次登录、系统设置、员工权限、上线检查完成站点初始化、账号安全、权限和基础配置。
运营人员产品中心、内容管理、外观区块、菜单和轮播持续维护产品、文章、案例、页面和首页展示。
销售跟单收件箱与询盘、产品价格模式、日常流程快速识别客户需求，准备报价和后续跟进。
站点维护人员程序更新、备份、迁移状态、常见问题保持系统可更新、可回滚、可排查。

安装部署

灯塔 CMS 的部署设计接近传统 PHP 虚拟主机体验，不需要 Composer、Node.js 或前端构建工具。准备好 PHP 和 SQLite 扩展后，上传源码并访问站点即可触发初始化。

运行环境要求

项目最低要求说明
PHP8.1+推荐使用当前稳定的 PHP 8.x 版本。
PHP 扩展sqlite3、mbstring、fileinfoSQLite 数据库、字符串处理、上传 MIME 校验依赖这些扩展。
Web 服务器Apache 或 NginxApache 需要启用 mod_rewrite；Nginx 使用 try_files 转发到 index.php。
写入目录storage/、uploads/数据库、区块配置、上传文件、备份和更新日志会写入这两个目录。
HTTPS生产环境必备表单、后台登录和客户询盘都应通过 HTTPS 提交。

三种部署方式

Git Clone
git clone https://github.com/zhpelo/shopagg-b2b-website.git
cd shopagg-b2b-website
chmod -R 755 storage uploads
ZIP 源码包
wget https://github.com/zhpelo/shopagg-b2b-website/archive/refs/heads/main.zip
unzip main.zip
mv shopagg-b2b-website-main shopagg-b2b-website
chmod -R 755 shopagg-b2b-website/storage shopagg-b2b-website/uploads
云端部署
打开 https://www.shopagg.com/dashboard/b2b-sites/create
按页面提示填写站点信息
无需配置服务器、上传代码或手动初始化数据库

Apache 配置要点

源码内置 .htaccess，常规 Apache 环境只需要确保站点目录允许重写：

AllowOverride All
Options FollowSymLinks

部署完成后访问首页。如果系统发现数据库不存在，会自动创建 storage/site.db，执行迁移并写入默认数据。

Nginx 配置要点

Nginx 环境需要把不存在的路径转发到 index.php：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ ^/(storage|app|Documents)/ {
deny all;
}

生产环境注意

不要让浏览器直接访问 storage/、app/、Documents/、.env 和数据库文件。上线后建议立即测试 https://你的域名/storage/site.db 是否被拒绝访问。

首次登录与初始化

首次安装后访问 /admin/login。登录成功后先不要急着录入大量内容，建议按下面顺序完成基础配置。

1. 修改密码

替换默认管理员密码，使用足够长度的强密码。

2. 设置公司资料

填写网站名称、Logo、联系方式、公司简介和 SEO 信息。

3. 测试表单

从前台提交联系留言和产品询盘，确认后台能收到。

初始化检查清单

  • 确认后台右下角或更新页显示版本为 v1.3.4。
  • 确认 storage/ 和 uploads/ 可写。
  • 确认当前主题已启用，前台首页能正常打开。
  • 确认默认货币代码，例如 USD、EUR、CNY。
  • 确认 Google Translate 翻译入口是否按业务需要显示。
  • 确认后台员工账号只有必要权限。

后台导航说明

后台菜单按日常运营流程组织。管理员可以看到全部模块，员工账号看到的菜单取决于授权。

菜单用途常见使用者
仪表盘查看商品、内容、询盘、留言、近期活动和安全提示。管理员、运营
收件箱处理联系留言和商品询单，查看客户需求和来源。销售、客服
商品维护商品、分类、图片、标签、供应商、价格模式和 SEO。商品运营
内容发布文章、案例、独立页面，管理媒体库。内容运营
外观管理网站模板、模板区块、菜单和轮播图。管理员、设计运营
扩展浏览应用商店，安装、启停、升级和配置插件。管理员、维护人员
系统管理站点资料、翻译、自定义代码、员工、备份和更新。管理员、维护人员

仪表盘怎么用

仪表盘适合每天登录后快速判断站点状态：

  • 产品总数、已发布产品数量。
  • 文章、案例、页面数量。
  • 新留言和新询盘数量。
  • 最近提交的客户信息。
  • 安全检查提示，例如数据库文件权限、敏感目录访问规则。
  • 程序更新、迁移和备份状态入口。

如果你看到询盘或留言数量异常增长，应优先检查来源 IP、表单内容和是否存在垃圾提交。