后端平台部署指南
本指南将引导运维工程师从零开始部署 SlaunchX 后端平台。首次部署请按章节顺序阅读;有经验的操作人员可直接跳转到特定章节。
架构
后端平台是一个容器化多服务系统,通过 Docker 运行在单台 Linux 主机上。
┌─────────────────────────────────────────────────────────────────┐
│ Host: slaunchx-intra (Debian 12) │
│ │
│ ┌─ Middleware ──────────────────────────────────────────────┐ │
│ │ MySQL 8.4 Redis 7.2 RabbitMQ 3.13 MinIO │ │
│ │ (127.0.0.1) (127.0.0.1) (127.0.0.1) (127.0.0.1) │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ ┌─ Application Services (0.0.0.0) ─────────────────────────┐ │
│ │ │ │
│ │ app-prometheus ──── Core API gateway + business logic │ │
│ │ support-email ───── Email sending service │ │
│ │ support-file ────── File upload/download (MinIO) │ │
│ │ support-schedule ── Scheduled tasks + event consumer │ │
│ │ partner-slash ───── Slash platform integration │ │
│ │ partner-stripe ──── Stripe payment integration │ │
│ │ support-tron ────── TRON blockchain wallet │ │
│ │ support-solana ──── Solana blockchain wallet │ │
│ │ │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ Docker Network: slaunchx-intra (172.30.0.0/24) │
└─────────────────────────────────────────────────────────────────┘服务依赖关系
app-prometheus ──→ MySQL, Redis, RabbitMQ, MinIO
support-email ───→ Redis, SMTP (external)
support-file ────→ MinIO
support-schedule → RabbitMQ, MySQL
partner-slash ───→ Slash API (external)
partner-stripe ──→ Stripe API (external)
support-tron ────→ TRON RPC (external), MySQL
support-solana ──→ Solana RPC (external), MySQLapp-prometheus 是核心服务——在中间件之后优先部署。其他服务根据所需功能可选部署。
环境矩阵
| 环境 | 应用端口 | 中间件端口 | Profile | 用途 |
|---|---|---|---|---|
| dev | 33xxx | 35xxx/36xxx | dev | 本地开发(局域网可访问) |
| test | 18xxx | 18xxx | test | 集成测试 |
| alpha | 19xxx | 19xxx | alpha | 预发布/预生产 |
| product | 29xxx | 29xxx | product | 生产环境 |
各模块端口后缀:
| 后缀 | 模块 |
|---|---|
| 020 | app-prometheus |
| 030 | support-email |
| 040 | support-file |
| 050 | support-schedule |
| 060 | support-tron-wallet |
| 070 | support-solana-wallet |
| 101 | partner-slash |
| 102 | partner-stripe |
示例:app-prometheus 在 test 环境 = 端口 18020,在 alpha 环境 = 端口 19020。
阅读顺序
| # | 章节 | 操作内容 |
|---|---|---|
| 1 | 前置条件 | 验证服务器、安装工具、创建 Docker 网络 |
| 2 | 中间件部署 | 部署 MySQL、Redis、RabbitMQ、MinIO |
| 3 | 构建与镜像仓库 | 构建 Java 应用、创建 Docker 镜像、搭建私有仓库 |
| 4 | 应用配置 | 了解配置层级、准备环境变量文件 |
| 5 | 部署服务 | 按依赖顺序启动所有应用容器 |
| 6 | 健康检查与验证 | 验证每个服务正常运行 |
| 7 | 备份与维护 | 设置备份、日志轮转、升级流程 |
| 8 | 参考资料 | 端口表、命名规范、命令速查表 |