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で再起動します。ボリューム名が異なる場合は適宜調整してください。
トラブル対応注文合計が0の場合にSpreeのチェックアウトが確認ステップをスキップする問題を修正する方法は？
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