跳到主内容

自部署

30 分钟拥有
自己的独立站

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

部署方式

三种方式,按需选择

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

推荐

Docker 镜像包

平台方打包交付镜像 tar + Compose 编排,客户服务器一键启动,无需编译任何代码

难度
简单
耗时
30 分钟
  • 获取部署包与配置
  • 填写 .env(SUITE_API_URL + DEPLOY_TOKEN)
  • ./start-standalone.sh 一键启动
  • License 自动激活,访问独立站

自动 HTTPS

启用 Caddy 自动申请并续期 Let's Encrypt 证书,无需手动配置 Nginx 与证书

难度
简单
耗时
无需额外时间
  • 配置域名 A 记录(主域名 + www)
  • .env 设置 COMPOSE_PROFILES=https + DOMAIN
  • 重启后自动签发证书
  • 浏览器地址栏显示安全锁

轻量部署

小型单店、商品图片少的场景可不含对象存储,store 自动降级本地磁盘存储

难度
简单
耗时
30 分钟
  • 平台方生成配置时关闭「包含 rustfs」
  • .env 中存储相关变量留空
  • COMPOSE_PROFILES 不含 rustfs
  • 启动即用,无需对象存储
环境要求

部署前需要准备什么

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

服务器

  • 操作系统Ubuntu 22.04+ / Debian 12+
  • CPU2 核+(推荐 4 核)
  • 内存4 GB+(推荐 8 GB)
  • 磁盘40 GB+ SSD

运行时

  • Docker24.0+(推荐 26.x)
  • Docker ComposeV2(docker compose)
  • Node.js无需安装
  • 源码/构建环境无需安装

网络

  • 出站 HTTPS需回连平台 suite
  • 端口80 / 443
  • 域名主域名 + www 两条 A 记录
  • SSL 证书Caddy 自动签发(推荐)

平台联动

  • SUITE_API_URL平台方交付
  • DEPLOY_TOKEN48h 有效,激活后失效
  • LicenseEd25519 签名证书 + 心跳
  • 店主账号平台方生成部署配置时指定
快速开始

Docker 镜像包四步部署

1

获取部署包与部署配置

联系平台方获取私有化部署包(镜像 tar 文件 + Compose 编排 + 启动脚本)与部署配置(SUITE_API_URL + DEPLOY_TOKEN)。

mkdir -p /opt/shopfaas-store
cd /opt/shopfaas-store
# 上传部署包文件:
#   images-<版本号>-full.tar     全量正式包(首次部署用)
#   docker-compose.standalone.yml
#   Caddyfile 或 nginx.conf
#   start-standalone.sh
2

填写联动变量

首次运行启动脚本会自动生成 .env 模板(含随机密码),你只需填写平台方交付的两个必填联动变量。

nano .env
# === 平台联动(必填,从平台方获取) ===
SUITE_API_URL=https://platform.example.com
DEPLOY_TOKEN=your-deploy-token
3

一键启动

脚本自动加载镜像、启动全部服务(postgres/redis/rustfs/schema-init/store/chat/nginx 或 caddy),并完成 License 激活与店主账号初始化。

chmod +x start-standalone.sh
./start-standalone.sh
# 等待健康检查通过(约 30-90 秒)
4

域名解析与访问

配置主域名与 www 的 A 记录指向服务器 IP,启用自动 HTTPS 后访问你的独立站。店主后台入口为 /admin。

# 前台
https://your-domain.com
# 店主后台
https://your-domain.com/admin
运维清单

上线后的日常运维

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

日常运维

  • 每周检查 docker compose logs 是否有错误
  • 每月检查磁盘空间
  • 定期备份 .env(密钥首次部署后不可更改)
  • 定期更新系统补丁

监控告警

  • 用 /health 与 /health/ready 对接监控
  • 监控 CPU/内存/磁盘
  • 监控响应时间
  • 配置 SSL 到期告警

数据备份

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

安全加固

  • 防火墙只开放必要端口
  • 数据库/Redis 不暴露公网
  • 妥善保管 .env 备份
  • SSH 禁用密码登录
常见问题

部署前你可能想了解

自部署需要懂多少技术?
基础 Linux 命令(ssh/scp/cd 等) + 跟着文档操作的能力。部署包是打包好的 Docker 镜像,一键启动,不需要懂 Node.js、不需要编译代码,不需要专业运维背景。
服务器配置怎么选?
起步推荐 2 核 4G,日 PV 5000 以下足够。日 PV 1 万-10 万建议 4 核 8G + CDN。日 PV 10 万以上建议多实例 + 负载均衡。
可以托管在哪里?
任何云服务商的 VPS 都可以:阿里云、腾讯云、华为云、AWS、GCP、Vultr、DigitalOcean 等。建议选离目标用户近的地域。国内业务需备案。
数据备份怎么做?
部署包自带 pg_dump 备份方案,配合 crontab 定时执行,备份文件上传到对象存储或异地服务器。建议每日备份 + 每月演练恢复。
升级到新版本会丢数据吗?
不会。版本升级由平台方提供新的镜像包,客户执行 docker load 后重启即可。schema-init 会自动执行增量迁移(schema_migrations 跟踪),绝不 DROP 表,数据安全保留。建议升级前先备份。
出问题了怎么排查?
查看 ./logs/ 下的 app.log 和 error.log,或用 docker compose logs 查看容器日志。也可通过留言表单或 GitHub Issues 联系平台方协助排查。

准备好自部署了吗?

联系平台方获取部署包,30 分钟拥有自己的独立站。遇到问题可在留言表单或 GitHub Issues 反馈。

联系我们获取部署包查看定价方案