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）选项。其模块化架构让企业可以从简单起步，逐步扩展到企业级复杂业务，无需更换平台。
문제 해결 & FAQ (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로 다시 시작하세요. 볼륨 이름이 다른 경우 조정하세요.
문제 해결Spree 체크아웃에서 주문 합계가 0일 때 확인 단계를 건너뛰는 문제를 해결하는 방법은?
Spree v4.3.1에서 버그로 인해 주문 합계가 0인 경우에도 확인 단계가 건너뛰어지는 문제가 발생했습니다. 문제는 :unless 조건을 무시하는 잘못된 remove_transition 라인이었습니다. 수정(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