Node Agent

A distributed Remote Code Execution (RCE) Agent built in Go. This service listens for incoming execution jobs via TCP, processes them, and safely executes code inside isolated Docker containers.

Architecture

The agent follows a strict layered architecture to ensure separation of concerns:

1. Network Layer (internal/network): Handles TCP connections and protocol parsing.
2. Control Layer (internal/control): Manages business logic and job routing.
3. Execution Layer (internal/execution): Interfaces with the Docker Engine to create ephemeral sandboxes for code execution.

Project Structure

node-agent/
├── cmd/
│   └── agent/
│       └── main.go           #  Application Entry Point
│
├── internal/
│   ├── network/              # TCP Server & Protocol Definitions
│   ├── control/              # Job Handling Logic
│   └── execution/            # Docker SDK Integration (Sandboxing)
│
├── playground/               #  Folder for experiments
│
├── go.mod                    # Dependencies

└── README.md                 # Project Documentation

graph TD
    subgraph cmd ["cmd/agent"]
        Main["main()"]
    end

    subgraph internal_network ["internal/network"]
        StartServer["StartServer(port string)"]
        HandleConn["handleConnection(conn net.Conn)"]
    end

    subgraph internal_control ["internal/control"]
        HandleJob["HandleJob(commandPayLoad string)"]
    end

    subgraph internal_execution ["internal/execution"]
        RunCommand["RunCommand(command string)"]
    end

    Main -->|Initializes the TCP listener on the provided port| StartServer
    StartServer -->|Accepts connections and spawns a new goroutine| HandleConn
    HandleConn -->|Decodes JSON; if type is 'job', forwards payload| HandleJob
    HandleJob -->|Requests execution and formats the returned stdout/stderr| RunCommand
    RunCommand -->|Spawns an ephemeral Alpine container via Docker SDK| DockerEngine[(Docker Engine)]

Loading