This repository is a customized full-stack fork of Wei-Shaw/sub2api. Parts of its channel monitoring and operations features reference kiss-kedaya/sub2api. It keeps the upstream gateway foundation, adds the AIFOO interface, and publishes releases from this repository.
For the upstream project's general features and documentation, see Wei-Shaw/sub2api.
- V3 channel monitoring with scheduled connectivity and quality checks, including Pelican SVG review and answer-matching candy questions.
- Per-account control for automatic pause after repeated degradation results, with group-capacity protection.
- Full-stack releases that bundle the AIFOO interface and backend. The built-in updater uses this repository's GitHub Releases and GHCR images.
-
GitHub Releases provide Linux amd64 binaries, the update control-plane bundle, and versioned full-stack container images.
-
For a standalone binary installation, use this repository's installer:
curl -sSL https://raw.githubusercontent.com/JayHome137/sub2api/sub2api-custom/deploy/install.sh | sudo bash -
Existing full-stack deployments can use the admin update panel after installing the matching update control plane. See the update guide.
-
Docker Compose templates are in
deploy/. SetSUB2API_IMAGEandSUB2API_QUALITY_RENDERER_IMAGEto the same release version; the templates' default tags may lag behind.
The installation script and releases belong to JayHome137/sub2api; upstream releases are not used by this fork's updater.
Licensed under LGPL-3.0-or-later. Original project copyright: Wesley Liddick, 2026.