10分钟跑通CoopCycle用Docker Compose快速部署外卖配送平台的简单指南【免费下载链接】coopcycle-webLogistics marketplace platform. Only for worker-owned business.项目地址: https://gitcode.com/gh_mirrors/co/coopcycle-webCoopCycle 是一款自托管的外卖配送平台让社区用户点餐、由骑行的外卖骑手配送。与商业平台最大的不同在于它专为员工持股的合作社设计骑手可以拥有并运营自己城市的配送平台。这篇文章将带你用 Docker Compose 快速部署 CoopCycle 外卖配送平台全程只需 5 个步骤10 分钟即可在本地看到完整的外卖下单与骑手调度界面。 认识 CoopCycle骑手自己的外卖平台CoopCycle 的核心理念是去中心化每个城市的骑手组成合作社运行一套属于自己的外卖配送软件。平台内置了完整的外卖配送链路顾客端浏览附近餐厅、下单、在线支付骑手端接收最近订单推送、导航配送️调度端基于 OSRM 骑行路线规划与 VRP 派单算法Vroom数据看板基于 Cube.js 与 ClickHouse 的订单统计✅ 部署前准备安装 Docker 环境唯一的前置依赖是Docker 和 Docker Compose不需要手动安装 PHP、PostgreSQL 等组件系统推荐方式macOSDocker for Mac自带 docker 与 docker composeWindowsDocker Desktop WSL 2需在 BIOS 开启虚拟化Hyper-VLinux按发行版安装 Docker再单独安装最新版 docker-compose 如果 Docker 没有运行所有命令都会失败——先确认docker compose version能正常输出版本号。 一键启动5 个部署步骤第 1 步获取项目源码git clone https://gitcode.com/gh_mirrors/co/coopcycle-web cd coopcycle-web第 2 步准备环境变量配置cp .env.dist .env touch .env.test.local.env.dist是项目自带的默认配置模板已包含开发环境所需的全部默认值.env.test.local用于按需覆盖配置例如设置地址自动补全服务的 API KeyLOCATIONIQ_ACCESS_TOKEN或GEOCODE_EARTH_API_KEY对于初次体验保持默认值即可这些地理编码服务均为可选项。第 3 步拉取预构建镜像可选但推荐docker compose pull项目团队已将 PHP、Webpack 等镜像发布到公共镜像仓库跳过本地构建可显著缩短首次部署时间。第 4 步启动所有服务docker compose up一条命令即会拉起外卖平台所需的完整服务栈。首次运行需要构建与下载请耐心等待。如果想额外体验 Storybook 组件库或 Valhalla 路线引擎可以加参数启动docker compose --profile devFrontend up # 附带 Storybook docker compose --profile valhalla up # 附带 Valhalla 路线引擎第 5 步初始化数据库并载入演示数据make install这一步会创建数据库结构并首次下载巴黎的骑行路线数据用于配送路线规划因此第一次执行耗时最长。完成后平台已预置好演示数据。然后打开浏览器访问http://localhost一个完整的外卖配送平台就跑起来了 ️ 部署后的架构一览这些容器各自做什么docker compose up启动的不只是网站而是一整套协同工作的外卖配送平台服务栈定义在 docker-compose.yml 中服务端口作用nginx80外卖平台主入口浏览器访问这里nginx_test9080测试环境入口postgres5432PostgreSQL PostGIS 数据库存储订单、任务与地理数据redis6379缓存与消息队列传输php/php_worker—Symfony 后端 API 与异步任务 Workerosrm5000骑行路线规划引擎vroom3000VRP 骑手派单优化算法minio9000 / 9001对象存储商品图、餐厅图9001 是管理控制台centrifugo8100实时消息推送骑手端订单通知stripe_mock12111本地支付模拟服务️ 体验进阶如何配置外卖配送范围平台启动后可以在管理后台通过地图手绘多边形来圈定外卖配送区域并支持导出为 GeoJSON、KML 等格式方便与合作伙伴共享配送范围配送区域数据以 GeoJSON 形式存储仓库中自带示例fixtures/woopit_zone.geojson。 常见问题快速排查遇到问题时Makefile中内置了一系列便捷命令帮你快速定位外卖配送平台部署问题问题解决方案数据库状态混乱想完全重来make fresh-db清空重建再执行make setup拉取新代码后数据库模型不匹配make migrations-migrate执行数据库迁移页面报错想看日志make log实时彩色输出运行日志端口 80 被占用修改docker-compose.yml中 nginx 的端口映射Windows 上 Docker 无法启动检查 BIOS 是否开启虚拟化并按官方指引安装 WSL 2⚠️许可提醒CoopCycle 采用 Coopyleft 许可软件仅供符合合作社标准的社会企业使用——这正是骑手拥有平台的理念体现。 结语下一步可以做什么恭喜你已用 Docker Compose 在 10 分钟内部署了一套完整的外卖配送平台。接下来可以 以骑手身份登录体验订单推送与骑行导航 运行make behat或make cypress体验自动化测试 阅读项目贡献指南 CONTRIBUTING.md加入开源社区外卖配送平台的部署只是起点探索骑手合作运营的开源新模式才刚刚开始 【免费下载链接】coopcycle-webLogistics marketplace platform. Only for worker-owned business.项目地址: https://gitcode.com/gh_mirrors/co/coopcycle-web创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考