spree
开源无头电商平台，内置 REST API、TypeScript SDK 和 Next.js 前端，原生支持 B2B、多供应商市场、跨境电商和多租户。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
一句话：全栈开源电商，花 5 分钟就能跑起来，支持 B2B 和跨境。
核心功能
- 开箱即用的 Next.js 前端（React 19、Tailwind CSS 4），支持 Stripe / Apple Pay / Google Pay 等支付
- 完整的 REST API + TypeScript SDK，后端和前端的类型安全通信
- 原生跨境电商：按国家设置币种、语言、支付方式和运费，内置多语言翻译中心和合规价格历史记录
- B2B 批发：客户组、价格表、专属目录，支持促销引擎和礼品卡
- 多供应商市场 / 多租户 SaaS 模式：一套后台管理多个独立店铺或供应商
避坑指南
- •免费版 Render 实例闲置后会休眠 30-60 秒，不适合生产。生产环境推荐官方文档中的服务器规格。学习曲线稍陡：需要了解 Ruby on Rails 和 Docker 基础。建议先阅读官方 Quickstart 文档。
适用场景
- 搭建面向全球的跨境电商独立站
- 构建 B2B 批发商城，支持客户分组和阶梯价格
- 运营多供应商市场（如本地商家联盟）
- 创建多租户电商 SaaS 平台，为不同租户提供独立店铺
详细介绍
Spree Commerce 是一个基于 Ruby on Rails 构建的生产级开源无头电商平台。它提供完整的 REST API（含 OpenAPI 3.0 规范）、TypeScript SDK 以及官方 Next.js 前端（Next.js 16、React 19、Tailwind CSS 4）。原生支持复杂电商场景：跨境电商（多币种、多语言、按国家设置支付和物流）、B2B 批发（目录、价格表、客户组）、多供应商市场、数字商品以及多租户 SaaS。内置促销引擎、礼品卡、MeiliSearch 搜索集成、Webhook、事件总线以及带角色权限管理的后台面板。Spree 由专业团队提供企业级支持，并提供长期维护（LTS）选项。其模块化架构让企业可以从简单起步，逐步扩展到企业级复杂业务，无需更换平台。
常见问题与排障 (2)
故障排除如何在启动使用 PostgreSQL 18 的 Spree Commerce 时修复 'major-version-specific directory names' 错误？
PostgreSQL 18 Docker 镜像现在要求数据存储在主版本特定的子目录中。默认 Spree 的 docker-compose.yml 卷挂载路径 /var/lib/postgresql/data 会触发此错误。修复方法：在 docker-compose.yml 中，将卷挂载路径改为 /var/lib/postgresql，然后移除旧卷并使用 docker compose down -v && docker volume rm my-store_postgres_data && docker compose up -d 重启。如果卷名称不同，请相应调整。
故障排除当order total为0时，如何修复Spree checkout跳过confirmation step？
在Spree v4.3.1中，一个bug导致即使订单总额为0，确认步骤也会被跳过。问题出在一个损坏的remove_transition行上，该行忽略了:unless条件。修复方案（PR #13901）移除了那一行；正确的行为由go_to_state :confirm上的:if条件控制。请将你的Spree安装升级到包含此修复的版本，或手动应用该补丁。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
确保本地已安装 Node.js 22+ 和 Docker（用来跑数据库和 Redis）
在终端运行：npx create-spree-app@latest my-store
按照提示设置管理员账号，访问 http://localhost:3000 即可使用后台和前店
- 确保本地已安装 Node.js 22+ 和 Docker（用来跑数据库和 Redis）
- 在终端运行：npx create-spree-app@latest my-store
- 按照提示设置管理员账号，访问 http://localhost:3000 即可使用后台和前店
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
删除项目目录，然后使用 docker compose down -v 清理容器和数据卷。如果使用本地数据库，手动删除数据库。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs