从零搭建本地社区电商系统 零基础3小时完成部署和功能配置

前期准备（耗时30分钟）

1. 运行环境选择

本地测试可直接用Windows/mac电脑，正式上线推荐配置2核4G5M带宽的云服务器，系统选择CentOS7.9版本。所有环境依赖一键安装命令如下：

• 云服务器端：SSH连接服务器后直接执行 yum install -y docker docker-compose git，安装完成后执行 systemctl start docker && systemctl enable docker，输入docker -v、docker-compose -v有版本输出即为安装成功
• 本地电脑端：先安装Docker Desktop，下载地址：https://www.docker.com/products/docker-desktop/，安装时默认勾选WSL2组件；再安装Git工具，下载地址：https://git-scm.com/download/win，默认下一步安装即可

2. 开源程序获取

本次使用的CRMEB单商户开源版遵循MIT开源协议，可免费商用，无需支付授权费用。执行以下命令拉取代码：

``` git clone https://gitee.com/ZhongBangKeJi/CRMEB.git cd CRMEB ```

一键部署（耗时40分钟）

1. 配置文件修改

复制项目根目录下的.env.example文件重命名为.env，直接替换以下完整配置，仅需要修改2处参数即可：

``` APP_NAME=本地电商 APP_ENV=local APP_KEY=base64:qFw7eR8tY9uI0oP1aS2dF3gH4jK5lL6zX7cV8bN9m0 APP_DEBUG=false 此处替换为你的服务器公网IP，本地测试填http://127.0.0.1:8080 APP_URL=http://123.123.123.123:8080 LOG_CHANNEL=stack DB_CONNECTION=mysql DB_HOST=db DB_PORT=3306 DB_DATABASE=crmeb DB_USERNAME=crmeb 此处替换为你自定义的8位以上混合密码，包含大小写字母+数字 DB_PASSWORD=Dianshang@2024 DB_PREFIX=eb_ REDIS_HOST=redis REDIS_PASSWORD=null REDIS_PORT=6379 ```

2. 容器启动与系统安装

在项目根目录执行 docker-compose up -d，等待10分钟镜像拉取和容器启动完成后，在浏览器访问APP_URL对应的地址进入安装向导：

• 第一步环境检测：所有选项显示绿色对勾直接点击下一步
• 第二步数据库配置：直接自动读取.env配置，无需修改点击下一步
• 第三步创建管理员账号：设置后台登录账号（如admin）和密码（如Admin@123456），完成安装

安装完成后后台访问地址为：APP_URL+/admin，输入刚才设置的账号密码即可登录。

本地电商核心功能配置（耗时50分钟）

1. 配送范围与网点配置

这是本地电商和普通电商的核心差异，必须精准配置：

• 进入后台左侧菜单【系统】-【地理位置】-【配送范围】，点击“添加范围”直接拖拽地图绘制你要覆盖的本地小区/商圈，设置满减配送费规则，比如满39元免3元配送费
• 如果有多个自提点/配送站，进入【网点管理】添加每个网点的具体地址、联系电话、营业时间、可覆盖的配送范围，后续订单会自动匹配最近网点出货
• 需要社区团购模式的，进入【应用】-【团长管理】开启功能，允许本地居民申请成为团长，设置佣金比例，团长可自行核销自提订单

2. 本地商品上架配置

进入【商品】-【分类管理】，优先添加本地高频消费分类：生鲜果蔬、米面粮油、日用百货、跑腿代购，上传商品时注意：

• 勾选“本地专属”标签，设置库存对应到具体网点，避免超卖
• 生鲜类商品可设置当日达配送时段，比如上午10点前下单当日下午送达，10点后下单次日送达

3. 配送与核销配置

• 进入【订单】-【配送管理】-【配送员列表】，添加本地配送员的手机号、姓名，配送员可直接通过微信小程序登录接单，实时查看配送地址和用户联系方式
• 进入【系统】-【交易设置】-【自提设置】，开启自提功能，设置核销码有效期、核销短信提醒，用户下单选择自提后会收到含核销码的短信，到店后商家输入核销码即可完成订单

移动端适配与上线测试（耗时10分钟）

1. 快速上线方式

不需要审核即可快速上线的方式：直接访问APP_URL+/h5即可打开移动端H5页面，分享到本地微信群、朋友圈即可让用户下单，不需要任何资质审核。

2. 微信小程序发布流程

需要上线微信小程序的按以下步骤操作：

• 先在微信公众平台申请主体为企业/个体工商户的电商类小程序，获取AppID和AppSecret
• 进入后台【应用】-【微信小程序】，填写对应的AppID和AppSecret，点击“下载小程序代码包”
• 下载微信开发者工具，地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html，打开下载的代码包，上传后提交微信官方审核，审核通过即可发布

3. 全流程测试

正式运营前必须完成以下测试：

• 用户端：定位是否准确，是否只展示覆盖范围内的商品，下单支付、选择配送/自提是否正常
• 后台：是否能正常收到订单，派单给配送员是否有提醒
• 配送端：是否能正常接单、点击送达，用户是否能收到送达提醒
• 核销端：自提订单核销是否正常，团长佣金计算是否准确

常见卡壳问题排查

• 无法访问安装页面：云服务器检查安全组是否开放8080端口，执行命令 firewall-cmd --zone=public --add-port=8080/tcp --permanent && firewall-cmd --reload 开放端口；本地检查Docker Desktop是否正常启动
• 数据库连接失败：检查.env文件里的数据库密码和你设置的是否一致，密码必须包含大小写字母+数字，不能纯数字
• 小程序定位不准：在微信公众平台小程序后台开通“位置服务”权限，申请腾讯地图API Key填入后台【系统】-【地理位置】配置项即可
• 商品前端不显示：检查商品是否设置为上架状态，是否绑定了对应网点的库存