私有化部署（可选）
将 ShopFaaS 部署到自己的服务器，数据完全私有，适合对数据主权有要求的客户。
大多数用户无需阅读本章。ShopFaaS 提供托管服务，注册即可使用，无需自行部署。本章仅面向有私有化部署需求的客户（如数据合规要求、定制化需求、离线环境等）。
什么是私有化部署
私有化部署是将 ShopFaaS 安装到你自己服务器上的部署方式，数据完全存储在你的基础设施中，不依赖任何外部云服务。
托管服务 vs 私有化部署
| 对比项 | 托管服务 | 私有化部署 |
|---|---|---|
| 上手速度 | 注册即用 | 需自行安装配置 |
| 数据存储 | 平台托管 | 自己的服务器，完全私有 |
| 店铺数量 | 按套餐配额 | 由购买版本决定（开源版 1 店/专业版 1 店/企业版 3 店/10 店/不限） |
| 升级维护 | 平台自动升级 | 自行管理 |
| 技术支持 | 平台提供 | 社区支持，或购买商业支持 |
| 适合场景 | 中小商家、快速上线 | 数据合规、大规模、定制化需求 |
部署方式
- Docker 部署（推荐） — 使用 Docker Compose 一键部署
- 手动部署 — 手动安装各组件，适合定制化场景
- 环境变量参考 — 完整的环境变量清单
系统要求
最低配置
- CPU：2 核
- 内存：4 GB
- 磁盘：20 GB SSD
- 操作系统：Linux（Ubuntu 22.04+ / Debian 12+ / CentOS 9+）
推荐配置
- CPU：4 核
- 内存：8 GB
- 磁盘：100 GB SSD
- 操作系统：Ubuntu 24.04 LTS
必需软件
- Node.js 20+（仅部署预构建产物；Bun 仅开发环境需要，生产部署使用预构建产物只需 Node.js 运行时）
- PostgreSQL 18.4+
- Redis 8.8+
- Docker 24+（仅 Docker 部署方式需要）
数据安全
私有化部署的核心价值是数据主权：
- 所有店铺数据存储在你的 PostgreSQL 数据库中
- 文件存储在你的对象存储中
- 不向平台发送任何业务数据
- 升级时仅替换镜像/预构建产物，不涉及数据迁移
升级与维护
- 升级前务必备份数据库
- 关注 GitHub Releases 获取新版本
- 建议在测试环境验证升级后再更新生产环境
获取帮助
- GitHub Issues — 提交问题
- GitHub Discussions — 社区讨论
- 商业支持请联系官方团队
相关文档
- 开始使用 → 本地开发 — 本地开发环境搭建
- Docker 部署
- 环境变量