CRMEB（开源商城系统 v8）项目介绍

一句话定位：国内最常被拿来做「私域商城」的一套 PHP 开源系统，v8.0 把后台换成了 ThinkPHP 8 + Vue3，前端用 uni-app 一套代码铺 H5、小程序和 App；协议是宽松的 Apache-2.0，可以闭源商用。代价是运行环境不轻（PHP 8.2+、MySQL 8、Redis、Supervisor 三件套常驻进程），而且「开源版」只是获客入口，赚钱的是官网上的标准版、多商户版和各种行业版本。

1. 项目是什么

它是一套「商品—订单—支付—售后—会员—营销」全链路的私域商城系统，不是只有一个商品列表的脚手架。仓库里装着四份东西：一个 ThinkPHP 8 后端、一个 Vue3 管理端、一个 uni-app 移动端、外加一套 Docker 编排和文档。

它和 ShopXO、Mall4j 这类项目的差别主要在组织方式上。CRMEB 从 v5 起就在讲「中台化」，v8 把这件事做得更彻底：

需要先想清楚三点：

• 开源的是「社区版」，不是全部产品线。官网同时卖标准版、多商户版、多门店版、知识付费版、SaaS 云商城等，社区版属于功能最基础的那一档，具体差什么见第 8 节。
• 它不是「装完就能卖货」。支付要自己配商户号，短信、对象存储、物流查询、地图都要自己申请第三方账号，开箱只有一套空库结构。
• v8.0 是 2026 年的大版本，把 PHP 下限拉到 8.2、后台从 Vue2 升到 Vue3，还塞进了 AI Agent 与 MCP 服务。新东西多，落地前务必自己在测试机跑一遍，别直接拿演示站的效果当交付标准。

2. 核心特性

3. 技术架构

整体结构：单体 ThinkPHP 8 应用 + 两个独立前端工程 + 若干常驻进程。没有微服务、没有注册中心，属于「一台 4C8G 云服务器能撑起一个中型私域商城」的经典形态。

后端目录分工（backend/）：

几个关键取舍：

• ThinkPHP 8 而不是 Laravel：国内 PHP 团队上手快、文档中文、部署简单；代价是生态与国际化程度不如 Laravel，遇到冷门需求基本只能自己写。
• uni-app 一套代码铺多端：省人力，但小程序与 App 的原生能力差异要靠条件编译兜，复杂交互仍然要为单端写特例。
• 模块化 + 驱动化：好处是装卸方便、二次开发边界清楚；坏处是新手容易在「模块里再套模块」，调试链路变长。
• 常驻进程三个：队列、定时任务、WebSocket 都要 Supervisor 看着，这是它比「纯 FPM 项目」重的地方，也是很多新手部署失败的原因。

4. 目录结构

一个细节：仓库根目录同时放了 AGENTS.md、CLAUDE.md、llms.txt 和 .crmeb/ 一整套 AI 规范文件，这在国产 PHP 项目里很少见，说明 v8 确实把「让 AI 参与开发」当成了产品卖点，而不是随口提一句。

5. 快速上手

路线 A：Docker 一把梭（推荐先跑通）

cp .env.example .env
# 编辑 .env，至少改数据库密码、Redis 密码、APP_KEY
./run.sh start
./run.sh ps
./run.sh logs

默认端口：Nginx 8011、MySQL 33061、Redis 63791、WebSocket 40001。起来后访问 http://服务器IP:8011/admin 进后台。

路线 B：源码直装

cd backend
composer install
cp .env.example .env
# 编辑 .env 填数据库、Redis、APP_KEY
php think run --host 127.0.0.1 --port 8011

前台管理端另开一个终端：

cd frontend/admin
npm ci
npm run dev

管理端开发端口 1619，/adminapi 代理到 8011。

路线 C：移动端

cd frontend/uni-app
npm install
npm run dev:h5
# 微信小程序换成
npm run dev:mp-weixin

小程序产物用微信开发者工具导入，记得在 manifest.json 里换掉自己的 appid，并在小程序后台配置 request 合法域名。

路线 D：生产环境三个常驻进程

php think queue:listen --queue
php think timer start --d
php think workerman start --d

三条都用 Supervisor 守护，缺一个就会出问题：没有队列，订单超时与消息推送不动；没有 timer，优惠券和统计任务不跑；没有 workerman，客服与实时提醒失效。

环境要求（容易漏的几条）

• PHP 扩展：bcmath、curl、mbstring、json、zip、simplexml、fileinfo、redis；
• 必须解除禁用函数：proc_open、pcntl_signal、pcntl_signal_dispatch、pcntl_fork、pcntl_wait、pcntl_alarm，否则 workerman 起不来；
• MySQL 必须是 8.0，字符集 utf8mb4，引擎 InnoDB；
• Node 18 以上，管理端与 uni-app 都用 Vite 5；
• Web 根目录指向 backend/public，伪静态要配 ThinkPHP 规则。

6. 功能模块清单

管理后台

移动端（H5 / 小程序 / App）

7. 版本与授权

Apache-2.0 对使用者的意义要说清楚，因为这是它相对同类项目最大的优势：

• 可以免费商用、闭源二次开发、对外提供服务，不必开源你的修改；
• 需要保留版权声明与 NOTICE，修改过的文件要标注；
• 附带专利授权条款，比 MIT 多一层保护；
• 但协议只覆盖仓库里的代码，官网卖的商业版、插件、主题、素材是另外的授权，不能混为一谈。

换句话说：法律上你可以拿社区版做一个对外收费的商城 SaaS，只要不改掉版权声明。真正拦住你的是功能边界与运维成本，不是协议。

8. 商业模式说明

开源仓库本身免费，商业化的重心全在官网。社区版是漏斗口，付费产品是主营收。官网在售的产品线（2026-11 抓取）：

除产品线外还有三个变现口：插件市场、主题广场、技术服务商体系（招商、定制、部署服务）。官网自我宣传的口径是「50 万+ 企业客户、40 万+ 开发者、900+ 技术服务商、12 年+ 行业经验」，这些数字属于官方宣传，没有第三方审计，看的时候打个折。

对使用者的实际影响：

• 社区版够不够用，取决于你要不要多商户、多门店、跨境这些能力；单店私域卖货，社区版基本能覆盖。
• 很多「高级玩法」在插件市场里单独收费，预算里要留出这部分。
• 官方技术支持只对付费版本开放，社区版遇到问题只能看文档、翻 issue、加群。

9. 生态与周边

生态上要提醒两点：一是 GitHub 侧没有找到可用的官方镜像，国内访问以 Gitee 为准；二是社区版的插件生态与商业版并不完全互通，买插件前先确认版本与产品线，别按官网截图直接下单。

10. 选型建议

适合你，如果：

• 做单商户私域商城，卖实物、虚拟卡密或到店核销，规模在几千到几十万用户；
• 团队会 PHP，能读 ThinkPHP，愿意在现成业务骨架上改；
• 需要一套「后台 + H5 + 小程序 + App」齐活的前端，不想自己从零搭；
• 看重协议宽松，可能要做闭源交付或对外的付费商城；
• 能接受 PHP 8.2+、MySQL 8、Redis 这套较新的运行环境。

不适合你，如果：

• 服务器还是 PHP 7.x 或 MySQL 5.7 的老环境，短期不打算升级；
• 运维只有一个人、不熟悉 Supervisor 和常驻进程，出问题排查成本高；
• 要做平台型多商户，又不准备买商业版——社区版没有入驻与分账；
• 需要强一致的资金账务、需要审计级对账，这套系统只能算「够用」；
• 想要轻量、无依赖、一台虚拟机就能跑的极简商城。

和同类怎么比：ShopXO 更轻、依赖更少、装完即用，适合中小商家快速上线；CRMEB 功能更全、营销玩法更多、前后端更现代，但部署与运维门槛明显更高。如果你要的是「开箱能卖」，ShopXO 更省心；如果你要的是「能长期做私域运营、能二次开发成自己的产品」，CRMEB 的底座更完整。

11. 风险与坑

• 仓库里躺着一对明文 app_id / app_key：backend/.version 里除了版本号，还有 app_id 与 app_key 字段，看起来是官方云端服务（升级、插件）的凭据。这类信息不该进公开仓库，如果你要用官方云服务，先确认这对凭据的用途与归属，别直接拿去用。
• .env.example 的默认值全是坑：APP_DEBUG = true、数据库 crmeb / 123456、Redis 密码 123456、CACHE_PREFIX 与 QUEUE_NAME 是 change_me。上线前必须逐项改掉，APP_DEBUG 一定要设成 false，否则报错页会直接把路径、SQL、配置吐给访客。
• APP_KEY 是占位符：模板里写的是 app_key_REPLACE_WITH_RANDOM_HEX，不换会导致 JWT 签名可伪造。生成后用固定值保存，别每次部署重新随机，否则所有登录态失效。
• 三个常驻进程是硬门槛：队列、timer、workerman 少一个就有一批功能静默失效，而且不会报错，只会「订单一直不关」「消息一直不发」。Supervisor 配好自动重启，并加监控。
• 必须解除 PHP 禁用函数：proc_open、pcntl_* 系列被宝塔等面板默认禁用，workerman 直接起不来。解除范围要按需最小化，别图省事把整张禁用表清空。
• PHP 8.2 是硬下限：composer.json 约束到 8.5 以下，老服务器上的 PHP 7.4 装不上依赖。PHP 8.2 以下的项目要共存时，得用多版本 PHP 分开跑。
• 默认只启用 7 个模块、15 个驱动：内置 22 模块 30 驱动，但新装并非全开。看似「功能少」，实际是要你去扩展管理里手动开；开之前先确认模块之间的依赖。
• v8.0 太新：2026 年才发布，AI Agent、MCP 这些能力还在快速迭代，社区踩坑记录少。生产环境建议先在测试机跑一到两周，别把演示站当稳定性证明。
• 184 个 open issue：issue 多不等于项目差，但意味着你遇到的问题大概率没人及时回。付费版有工单，社区版只能自助。
• 官网数字是宣传口径：「50 万+ 企业客户」「40 万+ 开发者」「12 年+」均来自官网，没有第三方来源，做技术选型时不要当客观指标。
• Apache-2.0 不等于全部免费：代码可商用，但商业版功能、插件、主题、素材各自有授权，混淆这一点会在采购时踩坑。
• AI / MCP 能力需要实测：README 宣传的 AI 对话、流式响应、多模型管理、Skill 管理、MCP 开放工具，属于新功能，实际效果与稳定性以你部署的版本为准，别据此做架构决策。
• 演示站账号是公开的：demo / crmeb.com 谁都能登，别在里面填任何真实数据，也别把演示站当成自己的测试环境。

12. 参考链接

本文基于 2026-11-10 的 v8.0 分支源码（composer.json、.version、.env.example、目录结构、help/docs）、Gitee 项目数据与官网产品页整理；Star 数、issue 数、模块与驱动数量均以该日为准。部分子目录细节因接口限流未能逐一核对，落地前请以仓库实际内容为准。