schiplat /
super
背景介绍 每台服务器上，总有一批需要“长期活着”的进程：自建网关、队列 Worker、边缘采集脚本、或者本地运行的模型推理服务。 管好这些进程，大家通常会选择经典的 Supervisor 或 PM2： 但 PM2 拖家带口带着庞大的 Node.js 运行时，在精简 VPS 或边缘设备上显得格外沉重； Supervisor 的配置和体验还停留在 ini / CLI 时代，缺乏原生的现代 HTTP API，CI/CD 和 Agent 很难通…
Product images
About
背景介绍 每台服务器上，总有一批需要“长期活着”的进程：自建网关、队列 Worker、边缘采集脚本、或者本地运行的模型推理服务。 管好这些进程，大家通常会选择经典的 Supervisor 或 PM2： 但 PM2 拖家带口带着庞大的 Node.js 运行时，在精简 VPS 或边缘设备上显得格外沉重； Supervisor 的配置和体验还停留在 ini / CLI 时代，缺乏原生的现代 HTTP API，CI/CD 和 Agent 很难通过代码灵活操控； 至于 systemd，它虽强大但强依赖 root 权限，不跨平台，且动态管理进程门槛高；而 Docker Compose 有时又显得杀鸡用牛刀，很多人并不想为了两个常驻脚本去承受构建镜像的额外开销。 为了兼顾“极致轻量”与“可编程性”，我们用 Rust 编写了 Super：一个无额外运行时依赖的 API-First 轻量进程编排器。 架构设计：极简清晰的双二进制 Super 采用了经典的 Daemon-Client（守护进程 + 客户端） 架构，打包发布为两个独立的纯静态二进制文件： superd（后台引擎 / Daemon）： 核心守护进程，通常作为开机自启系统服务静默运行。它负责进程生命周期托管、健康检测、崩溃重启、日志汇聚与安全沙箱，并对外暴露统一规范的 REST API & WebSocket。 super（命令行客户端 / CLI）： 提供给开发者操作的终端工具。super 本身不直接拉起进程，它只是 superd 的一个官方 HTTP API 客户端。 这意味着：你在 CLI 里能做的一切，CI 流水线、自动运维脚本、或者外部 Agent 都可以无缝直接调用 superd 的 API 实现。 核心特性 Rust 纯静态编译，零运行时依赖：无 Python、Node 等环境依赖，只有 superd 和 super 两个体积精巧的二进制文件，极简容器、精简 VPS、边缘盒子直接开箱即用。 API-First（进程即可编程资源）： 单行命令托管：super add --name demo --autostart python3 -m http.server 8080； 声明式栈管理：支持通过 TOML 声明服务依赖链、健康检查与环境变量，一条 super apply 一键收敛整套服务栈； 原生标准接口：彻底告别解析 CLI 终端文本输出的时代，所有状态查询与管理均走标准 HTTP/WS。 崩溃自愈与稳健守护：异常退出自动拉起、退出码判断、启动时延防护、优雅停机（SIGTERM ➔ 超时 SIGKILL），该有的守护逻辑一个不少。 平滑无损发布（事务式更新）：服务版本更新内置事务保障：“备份 ➔ 校验 ➔ 切换 ➔ 失败自动回滚”，告别手工替换文件重启赌命的裸奔操作。 可观测性与事件账本（Audit Ledger）：实时日志流（WebSocket）、历史日志检索；内置事件账本，记录服务状态变更的完整因果链，出事能复盘，不靠盲猜。 默认安全：superd 默认仅监听本地 Loopback 地址（可按需配置监听外网并启用鉴权）；敏感环境变量在 API 与 CLI 输出中自动脱敏打码。 一条命令自动注册系统服务：安装脚本在校验 SHA-256 后，会自动将 superd 注册为各平台的系统自启服务（Linux systemd / macOS launchd / FreeBSD rc.d），开机自启无需手写 unit。 快速上手 1. 一键脚本安装（推荐） 通过官方自动化脚本完成安装（自动校验 SHA-256 并注册 superd 为系统开机自启服务，非 root 用户可能需要 sudo 权限）： bash curl -fsSL | sh 2. 手动下载与安装 若处于离线环境或需要手动分发部署： 下载预编译包：前往 GitHub Releases 页面 下载对应系统架构的二进制包（提供 Linux x8664/arm64、macOS、FreeBSD 的 .tar.gz 及 SHA-256 校验和文件）； 完整安装与配置指南：手动解压后的二进制文件放置位置、权限设置及自启服务注册步骤，请参考官方文档：快速开始与安装指南（Getting Started）。 3. 基础管理操作 托管并拉起一个常驻服务： bash 通过 super CLI 向 superd 注册并自动拉起服务 super add --name demo --autostart python3 -m http.server 8080 查看当前运行与健康状态 super list 实时追踪日志流 super logs demo --tail AI 协作彩蛋：项目根目录维护了一份针对 AI 上下文工程优化的 SKILL.md。你可以直接把它喂给 Cursor、Claude 或 ChatGPT，让你的 AI 助手瞬间掌握 Super 的所有规范，秒级帮你编写编排配置与排障指令。 当前状态与平台支持 系统支持：支持 Linux (x8664 / arm64)、macOS、FreeBSD；Windows 推荐使用官方 Docker 镜像运行。 阶段说明：项目目前处于公测阶段，核心编排与 API 路径有较完整的集成测试覆盖，且在作者团队的自有服务中日常运行。但仍建议大家优先在开发环境、Staging 或非核心负载上试用。 现阶段大家的每一次试用、批评和提 Issue，都是对项目最大的帮助与支持！ GitHub schiplat/super 版本发布（Releases）：github.com/schiplat/super/releases 快速安装指南：super.docs.sconts.com/docs/01-getting-started/ 完整文档站：super.docs.sconts.com
Discovery history
- HelloGitHub·用户投稿
- 阮一峰周刊·用户投稿
Discuss this product