Repository navigation
Releases
GOST Manager v2.0.3
GOST Manager v2.0.3
Released: 2026-08-02
GOST Manager v2.0.3 improves Watchdog probe accuracy and reduces Monitoring
overhead under high connection and file-descriptor load while preserving the
existing Direct Mode traffic lifecycle.
Watchdog stability
- Added explicit per-profile Ping and TCP health checks. Ping remains the
compatible default, and operators opt individual profiles into TCP checks. - TCP checks connect only to the allowlisted
KHAREJ_IP:TUNNEL_PORTtarget. - Local configuration, execution, and resource failures are classified as
non-actionableprobe_error; they do not change success/failure counters or
create traffic actions. - Historical profile events retain the check mode used when the event occurred.
Watchdog schema v3 adds a nullable, allowlisted event-time mode and safely
backfills profile events from Ping-only releases. - Production policy snapshots normalize a missing legacy v2.0.1 or v2.0.2
check_modeto Ping while preserving explicit Ping/TCP, maintenance, manual
override, and stop ownership.
Monitoring stability
- Fresh installations use 20-second Fast, 60-second TCP, 120-second Slow, and
1,800-second maintenance cadences. - Added an atomic high-traffic Monitoring preset with validation, private backup,
no-op detection, and an optional collector-only restart. - Separated Fast, TCP, and Slow collection so CPU/stat sampling remains timely
while socket, filesystem, static process, and FD work runs less frequently. - Large 10,000-FD process fixtures prove descriptor enumeration remains on the
Slow cycle. - Added persistent collection load shedding after overruns, with bounded recovery
after three on-time cycles. - Reduced SQLite write overhead with one main collection transaction, bounded
retention work, post-commit checkpoint maintenance, and no automatic VACUUM.
Upgrade compatibility
- Deterministic fixtures cover upgrades from both v2.0.1 and v2.0.2.
- Upgrades preserve Direct Mode env files, units, service identity/state,
Monitoring configuration/history, Watchdog configuration/history, manual
override, and existing check modes. - Installation and upgrade perform zero GOST traffic lifecycle actions and no
firewall changes. - The production rollout and rollback procedure is documented in
docs/GM-203-PRODUCTION-RUNBOOK.md, with a read-only preflight/postflight
verification script atscripts/gm-203-production-check.sh.
Known limitations
- TCP connect is not full SOCKS authentication or forwarding validation.
- This release does not enable BBR.
- This release does not make 2 GiB RAM sufficient for approximately 8,000
connections; add RAM or reduce traffic before rollout when headroom is unsafe. - Production rollout and soak are still pending.
Upgrade
Use the checksum-verified latest-release setup flow, or pin this release with:
GOST_MANAGER_VERSION=v2.0.3 \
bash <(curl -fsSL https://raw.githubusercontent.com/WikiPanel/GOST-Manager/main/setup.sh)After upgrade, keep existing profiles on Ping unless TCP checks are explicitly
approved. Apply the high-traffic Monitoring preset and perform controlled probe
tests only during the documented rollout window.
GOST Manager v2.0.2
GOST Manager v2.0.2
GOST Manager v2.0.2 adds the production-hardened Iran Upstream Watchdog for managed Direct Mode profiles.
Highlights
- Central per-profile health monitoring for every managed Iran profile.
- Disabled, Monitor Only, and Auto Protect modes.
- Exact default policy: checks every 2 seconds, declares an outage after 10 failures, and requires 10 successful checks plus hold and jitter before recovery.
- Auto Protect stops only the exact affected Iran GOST service and starts only a service whose stop it owns.
- Durable start and stop intents recover exactly once after daemon or host restart.
- Local Ping execution errors never count as upstream outages or trigger traffic actions.
- Manual service changes, maintenance, and operator overrides are preserved safely.
- Dedicated bounded 24-hour Watchdog event history and operational summaries.
Compatibility and safety
Installation and upgrade leave every Watchdog profile Disabled and perform zero GOST traffic lifecycle actions. Direct Mode runners, env formats, firewall behavior, Server Stability values, and Monitoring schema 4 remain unchanged.
The release passed the full automated gate on Ubuntu 22.04 and Ubuntu 24.04. Controlled real-server tests validated Monitor Only and Auto Protect on both low-traffic and high-traffic profiles. During the high-traffic outage test, the exact affected service stopped at the configured threshold, its process socket descriptors fell to zero, host TCP allocation dropped substantially, the Iran host remained responsive, probing continued, and one qualified automatic recovery restored service.
A successful Ping proves host reachability, not the health of the remote SOCKS5 application itself.
Upgrade
Use the normal GOST Manager latest-release setup flow. After upgrade, explicitly enable Auto Protect only for approved profiles through Upstream Watchdog menu option 12 or the administration CLI.
GOST Manager v2.0.1
GOST Manager v2.0.1
GOST Manager v2.0.1 is a narrowly scoped setup compatibility hotfix for
supported Ubuntu hosts that use the standard /etc/os-release symlink to
/usr/lib/os-release.
Fixed
- Public setup now accepts a safe regular
/etc/os-releasefile. - Public setup now accepts the standard relative or absolute symlink whose
canonical target is/usr/lib/os-release. - Public setup falls back to a safe regular
/usr/lib/os-releasewhen
/etc/os-releaseis absent. - OS validation still completes before release download, source activation,
local installation, or any service operation.
Security
The resolver uses only /etc/os-release and /usr/lib/os-release as trusted
canonical targets. It rejects missing or broken paths, symlink loops,
unexpected targets, non-regular files, group/world-writable metadata,
non-root-owned production metadata, oversized files, control characters, and
malformed required fields. The metadata file is parsed as data and is never
sourced, evaluated, or executed.
Compatibility
- Ubuntu 22.04 LTS and Ubuntu 24.04 LTS remain the only supported releases.
- Direct Mode runners, profile management, traffic units, tunnel env files,
firewall behavior, GOST installation, Server Stability, release archives,
and transactional source/runtime ordering are unchanged. - Monitoring remains outside the traffic path and its schema remains version
4 with unchanged retention.
Install
Latest stable release:
bash <(curl -fsSL https://raw.githubusercontent.com/WikiPanel/GOST-Manager/main/setup.sh)Pinned release after v2.0.1 is published:
GOST_MANAGER_VERSION=v2.0.1 \
bash <(curl -fsSL https://raw.githubusercontent.com/WikiPanel/GOST-Manager/main/setup.sh)The release workflow validates the exact version tag, runs the complete test
gate, creates the deterministic archive and SHA256 record, verifies both, and
publishes the non-draft stable Release. No v2.0.1 tag or asset is created
before review approval.
GOST Manager v2.0.0
GOST Manager v2.0.0
GOST Manager v2.0.0 is the first stable major release. It provides a focused
Direct Mode control plane for official upstream GOST binaries, with local
observability and transactional installation outside the traffic path.
Highlights
- Stable Direct Mode architecture using the unmodified official
go-gost/gostrelease artifact. - Independent numbered Iran and Kharej profiles, including multiple Iran
servers connecting to one Kharej server and multiple independent Kharej
profiles on one host. - Multi-profile create, inspect, edit, clone, selected/all restart, and delete
workflows with strict profile identity and rollback. - Profile-scoped firewall rules with canonical multiple-source support and
legacyIRAN_IPcompatibility. - Monitoring Lite for host, network, TCP, storage, services, processes,
sockets, tunnels, and collector health. Optional conntrack state is reported
as available, unsupported, or failed without loading kernel modules. - An idempotent Server Stability wizard for bounded sysctl settings and exact
per-profile systemd resource-limit drop-ins without restarting GOST. - A safe transactional local installer that validates source, Bash, Python,
monitoring configuration, and systemd content before committing changes. - Public one-command
setup.shinstallation from checksum-verified GitHub
Release assets, with pinned-version support and rollback-safe source storage
at/opt/GOST-Manager. - Ubuntu 22.04 and Ubuntu 24.04 support on
amd64andarm64hosts.
Upgrade Safety
Rerunning the latest setup command upgrades the manager without intentionally
starting, stopping, restarting, or reloading any existing Iran or Kharej
traffic service. Existing tunnel-service PIDs and restart counters are
preserved during a manager-only upgrade. The installer preserves numbered
Direct Mode env files and units, operator-valid monitoring configuration,
SQLite monitoring history, service drop-ins, and managed stability settings.
Monitoring remains optional and is never placed in the traffic path.
Install
Latest stable release:
bash <(curl -fsSL https://raw.githubusercontent.com/WikiPanel/GOST-Manager/main/setup.sh)Pinned release:
GOST_MANAGER_VERSION=v2.0.0 \
bash <(curl -fsSL https://raw.githubusercontent.com/WikiPanel/GOST-Manager/main/setup.sh)The setup entrypoint downloads gost-manager.tar.gz and its SHA256 file to a
private directory, verifies and inspects the archive, atomically activates the
verified source at /opt/GOST-Manager, then runs that source's local
transactional installer. The installer verifies the installed VERSION and
manager executable before committing. Setup removes the prior private source
backup only after source and runtime versions are aligned.
Release Validation Sequence
Before merge, validate the exact release/v2.0.0-setup branch on an approved
staging server by cloning it to /opt/GOST-Manager-v2-review and running
bash install.sh --install-dependencies. This Phase A check validates the
local transactional installer and manager upgrade while comparing traffic
PIDs/restart counts, env/unit/drop-in/firewall checksums, monitoring history,
collector health, and active-user continuity. It does not validate the still
unpublished public Release URL, and the production /opt/GOST-Manager source
must not be replaced manually without explicit operator approval.
After setup.sh is merged, the v2.0.0 tag exists, and both release assets
are published, run the public latest setup command on a fresh supported
staging server and one approved existing canary server. This Phase B smoke
repeats the preservation and continuity checks. The public latest-release URL
is a post-release check, not a pre-merge executable blocker.
Product Scope
- Direct Mode is the only supported traffic mode.
- There is no NGINX Gateway or Native GOST Gateway.
- There is no automatic failover controller or hidden routing runtime.
- The project does not include a custom GOST fork.
- Monitoring is observational and is not in the traffic path.
This stable release establishes the supported v2 foundation; later releases
may extend the manager while preserving these compatibility and safety
boundaries.
GOST Manager v1.9.0
Retrospective milestone release: This release was created on
July 14, 2026 to document an actual historical development milestone.
The tag points to the original milestone commit; the GitHub publication date
is not the original development date.
Milestone
Optional Conntrack handling and the production baseline before v2.0.0.
Historical scope
This snapshot adds explicit unsupported handling for optional Conntrack monitoring and establishes the production baseline immediately before v2.0.0.
Installation notice
This is a historical source snapshot and is not the recommended version for a
new production installation.
Use the latest stable release for new deployments.
Integrity
- Exact target commit:
313b5b6603e7cc68c8704bbc5936eaf0b8ae28fb - Retrospective metadata only
- No source files were rewritten to manufacture this version
- No custom binary or release asset was uploaded
GOST Manager v1.5.0
Retrospective milestone release: This release was created on
July 14, 2026 to document an actual historical development milestone.
The tag points to the original milestone commit; the GitHub publication date
is not the original development date.
Milestone
Server Stability Wizard.
Historical scope
This snapshot adds the Server Stability Wizard and its tested bounded sysctl and systemd resource-limit workflow.
Installation notice
This is a historical source snapshot and is not the recommended version for a
new production installation.
Use the latest stable release for new deployments.
Integrity
- Exact target commit:
42e4777c3823e1fe2e105e9292fee49d1af4b2c5 - Retrospective metadata only
- No source files were rewritten to manufacture this version
- No custom binary or release asset was uploaded
GOST Manager v1.1.0
Retrospective milestone release: This release was created on
July 14, 2026 to document an actual historical development milestone.
The tag points to the original milestone commit; the GitHub publication date
is not the original development date.
Milestone
Independent multi-profile Iran and Kharej management.
Historical scope
This snapshot improves independent Iran and Kharej multi-profile management and hardens profile firewall and service transactions.
Installation notice
This is a historical source snapshot and is not the recommended version for a
new production installation.
Use the latest stable release for new deployments.
Integrity
- Exact target commit:
7c37eb877e4e24a1820812c64910136d849dcbef - Retrospective metadata only
- No source files were rewritten to manufacture this version
- No custom binary or release asset was uploaded
GOST Manager v1.0.0
Retrospective milestone release: This release was created on
July 14, 2026 to document an actual historical development milestone.
The tag points to the original milestone commit; the GitHub publication date
is not the original development date.
Milestone
Official upstream GOST Direct Mode and Monitoring Lite product architecture.
Historical scope
This snapshot removes the cancelled Gateway and NGINX product paths while preserving official upstream GOST Direct Mode and optional Monitoring Lite.
Installation notice
This is a historical source snapshot and is not the recommended version for a
new production installation.
Use the latest stable release for new deployments.
Integrity
- Exact target commit:
f6fcbef86e086f64153a689829087a4e58829cc4 - Retrospective metadata only
- No source files were rewritten to manufacture this version
- No custom binary or release asset was uploaded
GOST Manager v0.6.0
Retrospective milestone release: This release was created on
July 14, 2026 to document an actual historical development milestone.
The tag points to the original milestone commit; the GitHub publication date
is not the original development date.
Milestone
Integrated Monitoring Lite and operator workflows.
Historical scope
This snapshot integrates Monitoring Lite operator workflows, bounded SQLite history, isolated systemd support, and safe install, upgrade, and uninstall behavior.
Installation notice
This is a historical source snapshot and is not the recommended version for a
new production installation.
Use the latest stable release for new deployments.
Integrity
- Exact target commit:
ca7e3379120e334ce6f2ddae9208205b5cee4a7c - Retrospective metadata only
- No source files were rewritten to manufacture this version
- No custom binary or release asset was uploaded
GOST Manager v0.5.0
Retrospective milestone release: This release was created on
July 14, 2026 to document an actual historical development milestone.
The tag points to the original milestone commit; the GitHub publication date
is not the original development date.
Milestone
Monitoring query layer and dashboard.
Historical scope
This snapshot adds the read-only Monitoring query engine, mixed-cadence dashboard, bounded historical summaries, health views, and versioned JSON/CSV exports.
Installation notice
This is a historical source snapshot and is not the recommended version for a
new production installation.
Use the latest stable release for new deployments.
Integrity
- Exact target commit:
4209afc8258651310474514be2154ccb7b87f470 - Retrospective metadata only
- No source files were rewritten to manufacture this version
- No custom binary or release asset was uploaded