GoWindGoWind
Home
Framework
GoWind Toolkit
  • Open Source

    • GoWind Admin (Admin Platform)
    • GoWind CMS (Content Management)
    • GoWind UBA (Behavior Analytics)
    • GoWind Shop (E-commerce)
    • GoWind Kanban (Kanban Boards)
    • GoWind Ledger (Personal Finance)
    • GoWind ShortPlay (Short Drama)
    • GoWind Ops (Operations Platform)
    • RushWind (Rust Ecosystem)
  • Open Core (Community + Enterprise)

    • GoWind OA (Office Collaboration)
    • GoWind ERP (Procure-to-Pay)
    • GoWind WMS (Warehousing)
  • Commercial

    • GoWind IM (Instant Messaging)
    • GoWind IoT (IoT Platform)
    • GoWind Edu (AI Education)
    • GoWind MES (Manufacturing Execution)
    • GoWind CDC (Data Pipeline)
    • GoWind SDP (Zero-Trust Gateway)
    • GoWind Quant (Quant Research)
    • GoWind Trade Radar (Export Sourcing)
    • GoWind Game Radar (Game Greenlight)
  • 简体中文
  • English
GitHub
Home
Framework
GoWind Toolkit
  • Open Source

    • GoWind Admin (Admin Platform)
    • GoWind CMS (Content Management)
    • GoWind UBA (Behavior Analytics)
    • GoWind Shop (E-commerce)
    • GoWind Kanban (Kanban Boards)
    • GoWind Ledger (Personal Finance)
    • GoWind ShortPlay (Short Drama)
    • GoWind Ops (Operations Platform)
    • RushWind (Rust Ecosystem)
  • Open Core (Community + Enterprise)

    • GoWind OA (Office Collaboration)
    • GoWind ERP (Procure-to-Pay)
    • GoWind WMS (Warehousing)
  • Commercial

    • GoWind IM (Instant Messaging)
    • GoWind IoT (IoT Platform)
    • GoWind Edu (AI Education)
    • GoWind MES (Manufacturing Execution)
    • GoWind CDC (Data Pipeline)
    • GoWind SDP (Zero-Trust Gateway)
    • GoWind Quant (Quant Research)
    • GoWind Trade Radar (Export Sourcing)
    • GoWind Game Radar (Game Greenlight)
  • 简体中文
  • English
GitHub
  • GoWind Ops

    • GoWind Ops Product Overview
    • GoWind Ops Quick Start

GoWind Ops Product Overview

GoWind Ops is an out-of-the-box multi-node operations platform, implemented full-stack in Go and open-sourced under the MIT license. Managing machines, running projects, dispatching scripts, and building & distributing artifacts are all done in one place, with foundation capabilities such as organization & permissions, auditing, and dictionaries built in — it can serve directly as an enterprise internal operations middle platform.

Current version: v1.0.0 being finalized (Phases 1-10 all complete) · License: MIT License · Repository: github.com/tx7do/go-wind-ops

1. Product Positioning

Day-to-day operations across multiple machines is scattered across SSH terminals, script folders, cron jobs, and chat logs — hard to audit and hard to collaborate on. GoWind Ops consolidates these actions into one platform:

  • Manage machines: machine fingerprint admission, heartbeat metrics, online status, and resource trends — full lifecycle control over nodes
  • Run projects: a project consists of a node + directory + start/stop commands — start/stop has a basis and changes have a timeline
  • Dispatch scripts: versioned script management, batch dispatch to multiple hosts, the whole process on record
  • Build and distribute: from source build to gray-release artifact distribution, orchestrated in one pipeline
  • Foundation built in: platform-foundation capabilities such as organization & permissions, audit logs, and dictionaries work out of the box

Tips

The Agent is an edge proxy: no UI, outbound-only MQTT connection. A managed node only needs outbound access to EMQX to join — no inbound ports need to be opened on the node.

2. Core Highlights

  • Secure admission: TOFU (Trust On First Use) machine fingerprint admission, combined with heartbeat online status, keeps unknown nodes out
  • Full auditing: the command ledger records receipts, exit codes, durations, and idempotent request_id; web terminal sessions are fully audited with read-only replay
  • Trustworthy signaling: command envelopes are signed with HMAC-SHA256; MQTT QoS1 + idempotent deduplication; encrypted transport over TLS 8883
  • Closed-loop governance: alerts auto-flagged RECOVERY on recovery, operation approvals (create a ticket first for sensitive operations), and maintenance-window muting
  • Multi-cloud view: Alibaba Cloud / Tencent Cloud / Huawei Cloud / AWS account onboarding — resource inventory, cost ledger, and bill import on one screen
  • Platform foundation: MFA TOTP + backup codes, OIDC SSO, six categories of audit logs + hash chain + ECDSA signatures with verification tools

3. Feature Overview

1. Nodes and Projects

FeatureDescription
Node admissionTOFU (Trust On First Use) machine fingerprint admission; admit / revoke / restore
Heartbeat metricsMetrics reported with every 30s heartbeat; online status; CPU / memory / disk trends
Project managementA project is node + directory + start/stop commands; change timeline
Command ledgerFull auditing: receipts / exit codes / durations / idempotent request_id
Run logsLive tailing via WebSocket

2. Terminal and Files

FeatureDescription
Web terminalBased on xterm.js; full session auditing + read-only replay; one-time tickets; idle auto-disconnect
File managerOnline editing; drag-and-drop upload; presigned direct upload to object storage
Batch commandsMulti-host matrix execution
Batch uploadBatch file upload across multiple nodes

3. Scripts, Build and Distribution

FeatureDescription
Script managementVersioned; timeouts automatically kill the process tree
Source repositoriesGit repositories stored AES-encrypted
BuildsArtifacts stored in object storage; build logs live-tailed; artifact retention policies
Distributionzip hardened against Zip Slip attacks; batched gray release; Docker image tag injection
Build pipelineBUILD-SCRIPT-DISTRIBUTION three-stage orchestration
Scheduled tasksScheduled execution of scripts / commands
Configuration centerTemplate-rendered dispatch; configuration drift detection

4. Observability and Governance

FeatureDescription
Monitoring & alertsFour types: project liveness / node thresholds / lost contact / process guard; automatic RECOVERY flag on recovery
Notification channelsDingTalk, Feishu (with signature), WeCom, email
Certificate ledgerCertificate inventory with expiry alerts
Backup & restoreBackup tasks + one-click restore to a node
Inspection reportsOne-click aggregation; scheduled inspections supported
Log snapshotsCross-project search
Operations dashboardGlobal operations overview
Operation approvalsSensitive operations create a ticket first; approval tickets expire on timeout
Maintenance windowsAlert suppression during quiet periods

5. Cloud Management

FeatureDescription
Multi-cloud accountsAlibaba Cloud / Tencent Cloud / Huawei Cloud / AWS
Resource inventoryECS / CVM / EC2 inventory across all regions; node IP reconciliation
Cost ledgerMonthly trends; multi-currency
Bill fetchingOne-click import into the ledger
Budget alertsBudget and spike-detection alerts

6. Platformization

FeatureDescription
OpenAPIAPI Key authentication; build / distribution pipeline trigger endpoints
Git WebhookTriggered by GitHub / GitLab / Gitea webhooks
Release consoleEnvironment promotion pipeline: the same artifact promoted stage by stage across environments
Plugin commandsPlugin-based command extension
Agent upgradeRemote upgrade with self-replacement + relayed restart

7. Security Foundation

FeatureDescription
MFATOTP + backup codes
SSOOIDC single sign-on
Session managementSession viewing and forced sign-out
AuditingSix categories of audit logs; hash chain + ECDSA signatures; verification tools

4. Client Forms

ClientFormDescription
Admin frontendWeb (React 19 + AntD 6)The single operations entry for ops staff
AgentEdge proxy (no UI)Deployed on managed nodes; connects to the platform over outbound-only MQTT

5. Technical Architecture

Backend Tech Stack

LayerTechnologyDescription
LanguageGo 1.26+A single language for the whole stack
Microservice frameworkgo-kratosFour-service architecture
Signaling channelEMQX (MQTT)Shared subscriptions / QoS1 + idempotency / TLS 8883 / broker authentication callback
Object storageMinIOPresigned direct upload
ORM / databaseEnt + PostgreSQL / MySQLRelational storage
Task queueRedis + AsynqAsynchronous task scheduling
Command securityHMAC-SHA256-signed command envelopesTamper-proof and replay-proof (idempotent)
ObservabilityJaeger + OpenTelemetryDistributed tracing

System Architecture

Four-Service Responsibilities

ServicePortResponsibilities
Coreinternal gRPCCore business logic and data layer
Admin BFF:18600Admin console HTTP API
Front BFF:18700Frontend HTTP API
Agent—Edge proxy, no UI, connects over outbound-only MQTT

The platform and the Agent exchange signaling through EMQX: shared subscriptions enable horizontal scaling, QoS1 + idempotency guarantee at-least-once delivery without duplicate execution, TLS 8883 encrypts the channel, and the broker authentication callback hooks into platform admission.

6. UI Preview

Operations dashboardNode management
Operations dashboardNode management (machine fingerprint admission)
Project managementWeb terminal
Project management (start/stop commands + change timeline)Web terminal (full auditing + read-only replay)
File managerBatch commands
File manager (online editing + presigned direct upload)Batch commands (multi-host matrix)
Command ledgerAlert records
Command ledger (full auditing)Alert records (four types of monitoring alerts)
Build history
Build history (artifacts + log tail)

7. Repository and Contact

  • Source repository: github.com/tx7do/go-wind-ops
  • Quick start: GoWind Ops Quick Start
  • Business contact: WeChat yang_lin_bo | Email yanglinbo@gmail.com
Edit this page
Last Updated:: 11/3/26, 2:14 PM
Contributors: Bobo
Next
GoWind Ops Quick Start