自部署

30 分钟拥有
自己的独立站

Docker Compose 一键部署,无需复杂配置。完整指南覆盖从环境准备到运维监控的全流程。

部署方式

三种方式,按需选择

从简单到复杂,总有一种适合你。

Docker Compose

适合大多数商家,一键启动所有服务,无需手动配置

难度

简单

耗时

30 分钟

克隆仓库
配置 .env
docker compose up -d
访问初始化页面

源码部署

适合需要深度定制的开发者,可以自由修改任何代码

难度

中等

耗时

1-2 小时

克隆仓库
安装 Node.js 运行时
配置 PostgreSQL + Redis + RustFS
构建 + 启动服务

Kubernetes

适合企业级多实例部署,水平扩展、滚动更新、健康检查

难度

复杂

耗时

2-4 小时

准备 K8s 集群
配置 Helm Chart
创建 Secrets/ConfigMap
kubectl apply

环境要求

部署前需要准备什么

基础要求,大多数 VPS 都能满足。

运行时

Node.js20+
Docker24+(可选)

数据库

PostgreSQL18.4+(使用 pgvector/pgvector:pg18 镜像)
Redis8.8.0+(使用 redis:8-alpine 镜像)
RustFS1.0.0-beta.10+(使用 rustfs/rustfs:latest 镜像)

服务器

CPU2 核+
内存4 GB+
磁盘40 GB+ SSD

网络

带宽5 Mbps+
域名已备案(国内)
SSL 证书Let's Encrypt 免费

快速开始

Docker Compose 四步部署

克隆仓库

从 GitHub 克隆 ShopFaaS 仓库到服务器。

git clone https://github.com/shopfaas/shopfaas.git
cd shopfaas

配置环境变量

复制示例配置,修改数据库密码、域名、密钥等。

cp .env.example .env
nano .env  # 修改以下关键字段:
# DATABASE_URL=postgresql://user:password@localhost:5432/shopfaas
# REDIS_URL=redis://localhost:6379
# JWT_SECRET=your-random-secret-at-least-32-chars
# SITE_URL=https://your-domain.com

启动服务

一键拉起所有服务:Web、数据库、Redis、Worker。

docker compose up -d

# 查看启动状态
docker compose ps

# 初始化数据库(首次部署)
docker compose exec web bun run db:migrate
docker compose exec web bun run db:seed

访问与初始化

浏览器打开你的域名,进入初始化向导,创建超级管理员账号。

# 配置 Nginx 反向代理后访问
https://your-domain.com

# 或本地访问(开发环境)
http://localhost:4322

运维清单

上线后的日常运维

部署只是开始,持续运维才能稳定运行。

日常运维

每日检查日志是否有错误
每周检查磁盘空间
每月备份数据库
定期更新系统补丁

监控告警

配置健康检查告警
监控 CPU/内存/磁盘
监控响应时间
配置 SSL 到期告警

数据备份

每日自动备份数据库
备份文件上传到对象存储
每月演练恢复流程
保留 30 天备份历史

安全加固

启用防火墙只开放必要端口
数据库不暴露公网
定期更换密钥
启用 fail2ban 防 SSH 暴力破解

常见问题

部署前你可能想了解

自部署需要懂多少技术?

基础 Linux 命令(ssh/cp/nano 等) + 跟着文档操作的能力。Docker Compose 方式几乎零配置,小白也能上手。源码部署需要懂 Node.js 生态。

服务器配置怎么选?

起步推荐 2 核 4G,日 PV 5000 以下足够。日 PV 1 万-10 万建议 4 核 8G + CDN。日 PV 10 万以上建议多实例 + 负载均衡。

可以托管在哪里?

任何云服务商的 VPS 都可以:阿里云、腾讯云、华为云、AWS、GCP、Vultr、DigitalOcean 等。建议选离目标用户近的地域。国内业务需备案。

数据备份怎么做?

ShopFaaS 提供 pg_dump 备份脚本,配合 crontab 定时执行,备份文件上传到对象存储或异地服务器。建议每日备份 + 每月演练恢复。

升级到新版本会丢数据吗?

不会。ShopFaaS 采用数据库迁移机制,升级时自动执行 schema 迁移,数据安全保留。建议升级前先备份,升级后在测试环境验证再上线。

出问题了怎么排查?

查看 ./logs/ 下的 app.log 和 error.log,或用 docker compose logs 查看容器日志。GitHub Issues 提交问题,社区会协助排查。

准备好自部署了吗?

克隆仓库,30 分钟拥有自己的独立站。遇到问题可在 GitHub Issues 反馈。

GitHub 仓库查看定价方案