小型 API 服务配置单：从单机到可扩容

小型 API 服务（内部系统、SaaS 后端、小程序接口、AI 应用网关）的架构演进有一条被反复验证的路径：单机起步 → 分离存储 → 横向扩展。本篇是场景方案中心的 API 服务专篇：每个阶段的配置单、升级触发信号，以及最重要的纪律——不过度设计。价格以美元计，以在售列表实时价为准。

阶段一：单机 VPS（0 → 验证期）

配置单：AXVPS-1C1G（$5.34/月真实基线）起步，业务上量后升 2C4G 档（价格待实测，以在售为准）；应用 + 数据库 + 缓存全部同机，用 systemd 管理进程；Nginx 反代 + HTTPS（证书自动化续签）。

# 单机最小部署基线（一次配好，后面所有阶段复用）
systemctl enable --now nginx
certbot --nginx -d api.你的域名        # 证书自动签发+续签
# 进程守护：systemd unit 而不是 nohup
systemctl status 你的服务 && journalctl -u 你的服务 -n 50
# 资源水位监控（升级信号的数据来源）
sar -u -r 1 10                          # CPU/内存 10 秒采样
df -h / && ss -s                        # 磁盘与连接数

本阶段纪律：不碰微服务、不上 K8s、不做读写分离——验证期的唯一目标是「跑通业务闭环 + 攒下监控数据」。过度设计在这个阶段的成本是 100%，收益是 0。

阶段二：数据库分离（验证期 → 增长期）

触发信号（满足任一即启动）：数据库内存占用挤压应用（swap 频繁换入）；慢查询开始影响 API P99；单机磁盘 IO %util 长期 >70%。架构动作：数据库迁到独立机器（同机房内网互联），应用机专注计算；备份策略升级（每日 dump + binlog 连续归档）。成本增量：一台同档或高一档 VPS——用「一次故障的损失」对比「每月几十美元的增量」，这笔账永远划算。

阶段三：独服 + 横向扩展（增长期）

触发信号：负载曲线连续 30 天平直高位（独占单价反超弹性溢价，临界点算法见选型中心裸金属篇）；或单机纵向加配已到顶。架构动作：应用层无状态化（会话进 Redis/JWT，文件进对象存储）→ 负载均衡下挂多台应用机 → 数据库按压力决定主从或分库。配置单参考：AXDED-E3 独服（$70.80/月真实基线）跑数据库 + 2–3 台 VPS 跑应用层，月成本压在 $100 内即可支撑相当规模。

# 无状态化自查三问（横向扩展的前提）：
grep -rn "session" 你的代码目录 | grep -i "file\|local"   # ① 会话还在本地文件?
ls /var/www/uploads 2>/dev/null                            # ② 上传文件还在本地盘?
grep -rn "localhost" 配置文件                              # ③ 还有硬编码单机依赖?
# 三问清零后，加机器才等于加容量；否则加机器 = 加故障面

贯穿三阶段的四条纪律

• 监控先行：每个阶段的升级决策都靠数据触发，不靠感觉——可达性、P99、资源水位三项从第一天就采；
• 备份随架构升级：阶段二的 binlog、阶段三的多副本，备份等级永远不低于数据的重要性；恢复演练每季度一次（脚本见安全中心）；
• 安全基线不跳级：SSH 加固、防火墙最小放行、密钥管理从单机阶段就做齐——阶段越后补越贵；
• 每次只动一层：分离数据库的那周不做横向扩展，变更可归因是排障的前提。

网关与限流：API 服务的门面基线

单机阶段就该配齐的门面三件套：①限流——按 IP 与按 token 双维度（Nginx limit_req 起步即可），超限返回 429 + Retry-After 头；没有限流的 API 被脚本扫爆只是时间问题；②超时与重试口径——网关超时（如 30s）、应用内下游调用超时（更短）、客户端重试策略（指数退避 + 幂等键）三层对齐，任何一层缺失都会在故障时放大成雪崩；③版本与契约——URL 版本前缀（/v1/）从第一天就用，破坏性变更只进新版本；错误响应结构统一（错误码 + 可读消息 + requestId），客户端与工单排查都靠它。这三样的实现成本在单机阶段是「小时级」，在横向扩展之后补课是「天级」——地基要在房子小的时候打。

什么时候考虑 Serverless/云函数替代

流量波峰波谷差十倍以上、日均请求量却不大的 API（营销页表单、Webhook 接收），云函数的按量计费可能比常驻 VPS 便宜——但冷启动延迟、供应商锁定、调试复杂度是代价。判断口径：P99 容忍 >500ms 且请求稀疏 → 可以试；实时交互或稳定流量 → 常驻机器更省心。混合架构（常驻核心 + 边缘函数）是成熟期的常见形态。

下一步：从 $5.34 单机起步，把监控三件套配好，等触发信号而不是等焦虑 → 在售配置。方法论总纲与其他场景 → 场景方案中心。