云阶CloudStep ：网页管理的轻量级策略反向代理与负载均衡神器

​云阶是一款安全、高性能、可私有化独立部署的服务地址管理与反向代理工具，集自助代理、负载均衡、持久化地址管理于一体。它既能通过代理直连目标服务，也能返回可用地址让客户端自助发起请求，实现“前端负载均衡 + 后端反向代理”的双栈策略，兼顾带宽瓶颈与服务弹性扩展。

关键能力与关键词

• 反向代理与根路径代理: 支持根路径代理与子路径代理，代理公网地址与域名，功能相同或不同、相对路径一致与否均可“找平”代理，帮助前后端统一请求入口与路径规约。
• 自助模式与自助负载均衡: 通过自助模式返回“可用请求地址”，由客户端直连，提高整体并发上限，突破单台代理带宽限制，适合大促、查分、热点流量等高峰场景。
• 负载均衡策略与映射集: 以映射集为粒度管理服务节点，可为“way（坐标）”绑定“point（映射集）”，配置多种负载策略，统一调度同服务不同节点或同机多服务的多相对路径。
• 健康检查与自动熔断: 一键从服务器 Ping，自动心跳检查，失效地址暂时停用 10 分钟后重试，连续三次失败触发失效告警并长期停用，后台可手动恢复，增强高可用与稳定性。
• 安全加盐与出口限制: 通过“加盐”实现代理出口变化限制与自嵌套加密，结合后台自定义 Token 取值集和长度，以及自定义验密方式，保障链路安全与访问控制。
• 热更新与无感迭代: 后端请求地址与功能可热更新，无需改动前端代码；类似 k8s 的“用户无感”迭代流程，分批停用、更新、上线，支持蓝绿、灰度与多活实践。
• 持久化与私有化部署: 依赖 sqlite3（随二进制打包或系统自带），本地持久化；单二进制即可落地，适合边缘计算、内网环境、离线场景与企业级私有化部署。
• 可观测性与运维特性: 空路径默认模式、手动生效/失效、服务器携密钥自申请停用（可指定时间）、地址失效告警、SSL 证书支持，贴合 DevOps、SRE 的日常运维需求。
• 关键词覆盖: 反向代理、负载均衡、自助代理、服务发现、地址治理、健康检查、熔断、心跳、热更新、零停机、蓝绿发布、灰度发布、多活、微服务、API 统一入口、可观测性、私有化部署、边缘计算、SSL、Token、加盐、加密、持久化、二进制部署、sqlite3、网关前置、统一路径管理。

典型使用场景

• 热点洪峰削峰填谷: 查分、大促、抢票、直播秒杀等瞬时高并发，前端调用自助模式获取“直连地址”，分散单点代理压力，提升整体吞吐。
• 多环境与多路径统一入口: 同一业务多版本或多相对路径的后端接口，通过映射集“找平”路径与功能，实现统一访问与灰度切换。
• 边缘节点聚合与容器多服务: 在资源有限的设备或容器上，通过代理模式统一代理多服务，提升硬件利用率并降低网络开销。
• 高可用与持续交付: 自动剔除失效节点、告警通知、分批上线，保证服务迭代期间用户无感知且可快速回滚。

快速部署与使用

• 环境准备:
  • 安装 gcc 或具备 sqlite3 支持的运行环境（通常系统自带或随二进制打包）。
• 启动与端口:
  • 解压压缩包，启动二进制主程序（可在程序名后追加端口号参数）。
• 后台与默认账户:
  • 访问 /web 进入管理界面；默认用户名：admin96，默认密码：admin96（请在“系统管理”中及时修改）。
• 映射与模式配置:
  • 在“映射管理”添加映射集；在“自助模式”“代理模式”配置 way（坐标）、point（映射集）与负载均衡模式。
• 二次开发与编译提示:
  • 可在代码中自定义后台 Token 取值集、Token 长度以及验密方式；自行编译时将 static 目录手动复制到 dist 目录以保证前端资源可用（layui 引入需手动处理）。

接口与调用示例

自助模式 self

• 路径: /self
• 作用: 返回“可用请求地址”，供调用方自主请求实现客户端负载均衡
• 请求方式: 任意
• 请求参数:
  • way: 自助模式坐标
• 示例返回:

json

{
  "code": 0,
  "msg": "success",
  "url": "http://abc.def",
  "way": "abc"
}

• curl 示例:

bash

curl -G "http://your-cloudstep-host/self" --data-urlencode "way=abc" --data-urlencode "t=1690000000"

代理模式 agent

• 路径: /agent（支持根代理与子代理）
• 作用: 反向代理目标地址并返回响应体；请求方式默认与调用方式一致
• 请求参数:
  • way: 代理模式坐标（仅支持使用路径后 ?way=xx 传递）
• 冲突处理: 若被代理请求本身含有名为 way 的参数，转发时原参数名将改为“way*”，避免与代理坐标冲突
• 路径约束: 根代理不支持相对路径替换；子代理仅支持根路径及其下级路径代理
• 示例返回: 直接返回被代理请求结果（body）
• curl 示例:

bash

# 子路径反向代理
curl -X POST "http://your-cloudstep-host/agent/api/v1/orders?way=abc" -H "Content-Type: application/json" -d '{"id":123}'

# 根代理
curl "http://your-cloudstep-host/agent?way=abc"

提示：启用加盐后，需按加盐规则补充签名或盐值参数；开启心跳检查后，失效节点将自动暂时停用 10 分钟并重试，连续三次失败触发告警并长期停用，后台可手动解除。

想要更轻、更稳、更弹性的服务地址治理、反向代理与负载均衡，现在就试用云阶 CloudStep。 GitHub 开源地址：https://github.com/Mutantcat-Working-Group/CloudStep

相关搜索关键词建议：云阶、CloudStep、反向代理、代理模式、自助模式、负载均衡、服务发现、地址管理、健康检查、熔断、心跳检测、私有化部署、热更新、零停机、蓝绿发布、灰度发布、多活、微服务、DevOps、SRE、SSL、Token、加盐、加密、sqlite3、二进制部署、网关、统一接入、路径代理、根路径代理、公网代理、域名代理、智能家居控制中心、边缘计算、可观测性。

​