Files

yuanyuanxiang 5a325a202b Init: Migrate SimpleRemoter (Since v1.3.1) to Gitea

2026-04-19 22:55:21 +02:00

29 KiB

Raw Blame History

SimpleRemoter

Warning

Important Legal Notice

This software is intended solely for educational purposes and authorized use cases such as:

Remote IT administration within your own organization

Authorized penetration testing and security research

Personal device management and technical learning

Unauthorized access to computer systems is illegal. Users are fully responsible for compliance with all applicable laws. The developers assume no liability for misuse.

Overview
Disclaimer
Features
Technical Highlights
Architecture
Getting Started
Client Support
Changelog
Related Projects
Contact

Overview

SimpleRemoter is a full-featured remote control solution, rebuilt from the classic Gh0st framework using modern C++17. Started in 2019, it has evolved into an enterprise-grade remote management tool supporting both Windows and Linux platforms.

Core Capabilities

Category	Features
Remote Desktop	Real-time screen control, multi-monitor support, H.264 encoding, adaptive quality
File Management	Bi-directional transfer, resumable uploads, C2C transfer, SHA-256 verification
Terminal	Interactive shell, ConPTY/PTY support, modern web terminal
System Management	Process/service/window management, registry browsing, session control
Media Capture	Webcam monitoring, audio listening, keylogging
Networking	SOCKS proxy, FRP tunneling, port forwarding

Use Cases

Enterprise IT Operations: Batch management of intranet devices, remote troubleshooting
Remote Work: Secure access to office computers, file synchronization
Security Research: Penetration testing, red team exercises, security audits
Technical Learning: Network programming, IOCP model, encrypted transmission practice

Original Source: zibility/Remote | Started: 2019.1.1

Disclaimer

Please read the following statement carefully before using this software:

Lawful Use: This project is intended solely for legitimate technical research, educational exchange, and authorized remote management. It is strictly prohibited to use this software for unauthorized access to others' computer systems, data theft, privacy surveillance, or any other illegal activities.
User Responsibility: Users must comply with the laws and regulations of their country/region. Any legal liability arising from the use of this software shall be borne by the user.
No Warranty: This software is provided "as is" without any express or implied warranties, including but not limited to warranties of merchantability or fitness for a particular purpose.
Limitation of Liability: The developers shall not be liable for any direct, indirect, incidental, special, or consequential damages arising from the use, misuse, or inability to use this software.
Copyright Notice: This project is open-sourced under the MIT License, allowing free use, modification, and distribution, provided that the original copyright notice is retained.

By continuing to use this software, you acknowledge that you have read, understood, and agreed to all the above terms.

Important

Network Connection & Privacy Notice

The master program (server) communicates with the authorization server based on license status:

License Type Connection Behavior

Trial Version Maintains persistent connection to authorization server

V1/V2 Licensed Connects at startup for verification, disconnects after

V2 Offline License No connection to authorization server required

Unless offline authorization is obtained, the master program will exchange necessary data with the authorization server (e.g., detecting cracking attempts, validating license status).

By using this software, you accept the data transmission between the master program and the authorization server. If you do not agree, please do not use this software.

License Type	Connection Behavior
Trial Version	Maintains persistent connection to authorization server
V1/V2 Licensed	Connects at startup for verification, disconnects after
V2 Offline License	No connection to authorization server required

Features

Remote Desktop

Multiple Capture Methods: GDI (high compatibility), DXGI (high performance), Virtual Desktop (background operation)
Smart Compression Algorithms:
- DIFF algorithm - SSE2 optimized, transmits only changed regions
- RGB565 algorithm - 50% bandwidth savings
- H.264 encoding - Video-level compression for high frame rate scenarios
- Grayscale mode - Minimal bandwidth consumption
Adaptive Quality: Automatically adjusts frame rate (5-30 FPS), resolution, and compression based on network RTT
Multi-Monitor: Support for screen switching and multi-screen wall display
Privacy Screen: Hide controlled screen, supports control during lock screen
File Drag & Drop: Ctrl+C/V cross-device copy and paste files
Web Remote Desktop: Access remote desktop via browser, supports mobile/tablet (Configuration Guide)

File Management

V2 Transfer Protocol: Newly designed, supports large files (>4GB)
Resumable Transfer: Automatic recovery after network interruption, persistent state
C2C Transfer: Direct transfer between clients without going through master
Integrity Verification: SHA-256 hash verification ensures file integrity
Batch Operations: Supports file search, compression, batch transfer

Terminal Management

Interactive Shell: Full command line experience with Tab completion
ConPTY Technology: Native pseudo-terminal support for Windows 10+
Modern Web Terminal: Based on WebView2 + xterm.js (v1.2.7+)
Terminal Resizing: Adaptive window size

Process & Window Management

Process Management	Window Management

Process Management: View process list, CPU/memory usage, start/terminate processes
Code Injection: Inject DLL into target process (requires admin privileges)
Window Control: Maximize/minimize/hide/close windows

Media Features

Video Management	Audio Management

Webcam Monitoring: Real-time video stream, adjustable resolution
Audio Listening: Remote sound capture, bi-directional voice support
Keylogging: Online/offline recording modes

Other Features

Service Management: View and control Windows services
Registry Browsing: Read-only browsing of registry contents
Session Control: Remote logout/shutdown/restart
SOCKS Proxy: Establish proxy tunnel through client
FRP Tunneling: Built-in FRP support for easy intranet penetration
Code Execution: Remote DLL execution with hot update support

Technical Highlights

High-Performance Network Architecture

┌─────────────────────────────────────────────────────────┐
│                    IOCP Communication Model              │
├─────────────────────────────────────────────────────────┤
│  • I/O Completion Ports: Most efficient async I/O on    │
│    Windows                                               │
│  • Single master supports 10,000+ concurrent connections │
│  • Supports TCP / UDP / KCP transport protocols          │
│  • Auto-chunking for large packets (max 128KB send buf)  │
└─────────────────────────────────────────────────────────┘

Adaptive Quality Control

Intelligent quality adjustment system based on RTT (Round-Trip Time):

RTT Latency	Quality Level	FPS	Resolution	Compression	Use Case
< 30ms	Ultra	25 FPS	Original	DIFF	LAN office
30-80ms	High	20 FPS	Original	RGB565	General office
80-150ms	Good	20 FPS	≤1080p	H.264	Cross-network/Video
150-250ms	Medium	15 FPS	≤900p	H.264	Cross-network office
250-400ms	Low	12 FPS	≤720p	H.264	Poor network
> 400ms	Minimal	8 FPS	≤540p	H.264	Very poor network

Zero Overhead: Reuses heartbeat packets to calculate RTT
Fast Downgrade: Triggers after 2 detections, responds to network fluctuations
Cautious Upgrade: Quality improves only after 5 stable readings
Cooldown Mechanism: Prevents frequent switching

V2 File Transfer Protocol

// 77-byte protocol header + filename + data payload
struct FileChunkPacketV2 {
    uint8_t   cmd;            // COMMAND_SEND_FILE_V2 = 85
    uint64_t  transferID;     // Transfer session ID
    uint64_t  srcClientID;    // Source client ID (0=master)
    uint64_t  dstClientID;    // Destination client ID (0=master, C2C)
    uint32_t  fileIndex;      // File index (0-based)
    uint32_t  totalFiles;     // Total file count
    uint64_t  fileSize;       // File size (supports >4GB)
    uint64_t  offset;         // Current chunk offset
    uint64_t  dataLength;     // Current chunk data length
    uint64_t  nameLength;     // Filename length
    uint16_t  flags;          // Flags (FFV2_LAST_CHUNK, etc.)
    uint16_t  checksum;       // CRC16 checksum (optional)
    uint8_t   reserved[8];    // Reserved for extension
    // char filename[nameLength];  // UTF-8 relative path
    // uint8_t data[dataLength];   // File data
};

Features:

Large file support (uint64_t breaks 4GB limit)
Resumable transfer (state persisted to %TEMP%\FileTransfer\)
SHA-256 integrity verification
C2C direct transfer (client to client)
V1/V2 protocol compatibility

Screen Transmission Optimization

SSE2 Instructions: Hardware-accelerated pixel difference calculation
Multi-threaded Parallel: Thread pool for chunked screen data processing
Scroll Detection: Identifies scrolling scenarios, reduces bandwidth by 50-80%
H.264 Encoding: Based on x264, GOP control, video-level compression

Security Mechanisms

Layer	Measures
Transport Encryption	AES-256 data encryption with configurable IV
Authentication	Signature verification + HMAC authentication
Authorization Control	Serial number binding (IP/domain), multi-level authorization
File Verification	SHA-256 integrity verification
Session Isolation	Session 0 independent handling

Dependencies

Library	Version	Purpose
zlib	1.3.1	General compression
zstd	1.5.7	High-speed compression
x264	0.164	H.264 encoding
libyuv	190	YUV conversion
HPSocket	6.0.3	Network I/O
jsoncpp	1.9.6	JSON parsing

Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                      Multi-Layer Authorization Architecture                  │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│                          ┌─────────────────────┐                            │
│                          │    Super Admin      │                            │
│                          │ (Authorization      │                            │
│                          │     Server)         │                            │
│                          └─────────┬───────────┘                            │
│                                    │                                         │
│                     ┌──────────────┼──────────────┐                         │
│                     │ V2 License   │ V2 License   │ V2 License              │
│                     │ (ECDSA)      │ (ECDSA)      │ (ECDSA)                  │
│                     ▼              ▼              ▼                          │
│             ┌───────────┐  ┌───────────┐  ┌───────────┐                     │
│             │ Layer-1 A │  │ Layer-1 B │  │ Layer-1 C │  ◄── Independent    │
│             │           │  │           │  │           │      & Isolated     │
│             └─────┬─────┘  └─────┬─────┘  └─────┬─────┘                     │
│                   │              │              │                            │
│          ┌────────┴────────┐     │       ┌──────┴──────┐                    │
│          │ V1 License      │     │       │ V1 License  │                    │
│          ▼                 ▼     ▼       ▼             ▼                    │
│    ┌──────────┐     ┌──────────┐ ...  ┌──────────┐  ┌──────────┐           │
│    │ Sub A1   │     │ Sub A2   │      │ Sub C1   │  │ Sub C2   │           │
│    │ Master   │     │ Master   │      │ Master   │  │ Master   │           │
│    └────┬─────┘     └────┬─────┘      └────┬─────┘  └────┬─────┘           │
│         │                │                 │             │                  │
│         ▼                ▼                 ▼             ▼                  │
│    ┌─────────┐     ┌─────────┐       ┌─────────┐   ┌─────────┐             │
│    │ Clients │     │ Clients │       │ Clients │   │ Clients │             │
│    │ 10,000+ │     │ 10,000+ │       │ 10,000+ │   │ 10,000+ │             │
│    └─────────┘     └─────────┘       └─────────┘   └─────────┘             │
│                                                                              │
├─────────────────────────────────────────────────────────────────────────────┤
│  License Type    Verification             Features                           │
│  ─────────────────────────────────────────────────────────────────────────  │
│  V2 License      ECDSA P-256 Signature    Offline verify, connection limits  │
│  V1 License      HMAC + Online Verify     Connects to upstream server        │
│  Trial           Online Verify            Limited features, always connected │
└─────────────────────────────────────────────────────────────────────────────┘

Architecture Advantages

Feature	Description
Hierarchical Control	Super user manages any master, supports unlimited tiers
Complete Isolation	Different Layer-1 users have isolated licenses, data, and clients
Independent Operation	Layer-1 users can set pricing, issue licenses, build their brand
Horizontal Scaling	Single master supports 10,000+ clients, multi-layer scales to millions
Offline Support	V2 license supports full offline verification, no upstream dependency

Master Program (Server)

The master program YAMA.exe provides a graphical management interface:

High-performance server based on IOCP
Client group management
Real-time status monitoring (RTT, geolocation, active window)
One-click client generation

Controlled Program (Client)

Runtime Forms:

Type	Description
`ghost.exe`	Standalone executable, no external dependencies
`TestRun.exe` + `ServerDll.dll`	Separate loading, supports in-memory DLL loading
Windows Service	Background operation, supports lock screen control
Linux Client	Cross-platform support (v1.2.5+)

Getting Started

5-Minute Quick Start

No compilation required, download and run:

Download Release - Get the latest version from Releases
Launch Master - Run YAMA.exe and enter the license info (see trial license below)
Generate Client - Click the "Generate" button in the toolbar, configure server IP and port
Deploy Client - Copy the generated client to the target machine and run it
Start Control - Once the client comes online, double-click to open remote desktop

Tip

For initial testing, run both master and client on the same machine using 127.0.0.1 as the server address.

Build Requirements

Operating System: Windows 10/11 or Windows Server 2016+
Development Environment: Visual Studio 2019 / 2022 / 2026
SDK: Windows 10 SDK (10.0.19041.0+)

Build Steps

# 1. Clone the repository (must use git clone, do not download as zip)
git clone https://github.com/yuanyuanxiang/SimpleRemoter.git

# 2. Open the solution
#    Open SimpleRemoter.sln with VS2019+

# 3. Select configuration
#    Release | x86 or Release | x64

# 4. Build
#    Build -> Build Solution

Common Issues:

Dependency library conflicts: #269
Non-Chinese system garbled text: #157
Compiler compatibility: #171

Deployment Methods

Intranet Deployment

Master and clients are on the same LAN, clients connect directly to master IP:Port.

Internet Deployment (FRP Tunneling)

Client ──> VPS (FRP Server) ──> Local Master (FRP Client)

For detailed configuration, please refer to: Reverse Proxy Deployment Guide

Authorization

Starting from v1.2.4, a trial password is provided (2-year validity, 20 concurrent connections, intranet only):

Authorization: Bound by computer IP
Master IP: 127.0.0.1
Serial: 12ca-17b4-9af2-2894
Password: 20260201-20280201-0020-be94-120d-20f9-919a
Verification: 6015188620429852704
Valid: 2026-02-01 to 2028-02-01

Note

Multi-Layer Licensing

SimpleRemoter uses an enterprise-grade multi-layer authorization architecture, supporting independent operation for agents/developers:

Offline Verification: First-layer users can operate completely offline after obtaining authorization

Independent Control: Your downstream users connect only to your server, with data fully under your control

Free Customization: Supports secondary development to create your own branded version

📖 View Full Licensing Documentation

Client Support

Windows Client

System Requirements: Windows 7 SP1 and above

Feature Completeness: ✅ All features supported

Linux Client (v1.2.5+)

System Requirements:

Display Server: X11/Xorg (Wayland not yet supported)
Required: libX11
Recommended: libXtst (XTest extension), libXss (idle detection)

Feature Support:

Feature	Status	Implementation
Remote Desktop	✅	X11 screen capture, mouse/keyboard control
Remote Terminal	✅	PTY interactive shell
File Management	✅	Bi-directional transfer, large file support
Process Management	✅	Process list, terminate processes
Heartbeat/RTT	✅	RFC 6298 RTT estimation
Daemon Process	✅	Double fork daemonization
Clipboard	⏳	In development
Session Management	⏳	In development

Build Instructions:

cd linux
cmake .
make

Changelog

v1.3.1 (2026.4.15)

Web Remote Desktop & Multi-Master Sharing Enhancement

New Features:

Web Remote Desktop: WebSocket-based implementation, access remote desktop via mobile/tablet browser (Configuration Guide)
Revoke sharing menu: Support revoking clients shared to other masters
Toolbar audio control: Added system audio toggle icon to remote desktop toolbar

Improvements:

Disable adaptive quality for multi-monitor: Auto-disable when client has multiple monitors
Status bar auto-refresh expiration date: Immediate refresh after license renewal
Reduce invalid offline logs: Less logging when client not in host list
Multi-layer authorization auto-update: Layer-2+ master authorizations sync automatically
Enhanced usage tips: Added more operation hints for better UX
DLL cache reuse: Save DLL to registry for reuse on next startup

Bug Fixes:

Fixed keylogger may not work properly while sharing client to other master

v1.3.0 (2026.4.8)

Multi-Tier FRP Architecture & UI Branding

New Features:

Local FRPS server support (64-bit only): Built-in FRP server for simplified deployment
Multi-tier architecture automatic FRP integration: Downstream masters auto-acquire upstream FRP config
V2 authorization downstream connection limit: Control concurrent connections for downstream
License file import/export support (.lic format)
Expired authorization renewal support: No need to regenerate license
Enhanced hardware ID (V2): Fix VPS duplicate SN issue
MaxDepth control: Limit hierarchical master depth level
License management enhancements: Quota support, dynamic dialog, delete functionality
IP geolocation API multi-provider fallback: Improved location success rate
UI branding customization: Support custom program name, logo, copyright, etc.
Runtime feature limits: Configurable trial version restrictions
Input history dropdown: Quick selection of previous inputs
Client generation new options: More customization settings
Dynamic project links: Change help/feedback URLs without recompiling

Bug Fixes:

Fixed Use-after-free crash in RebuildFilteredIndices
Fixed IOCP race condition crash in CLock::Lock (#215)
Fixed crash protection service cleanup and agent elevation issue
Fixed potential crash from unlimited message log growth
Fixed UpperHash string length issue after FeatureFlags introduction
Fixed client SN generation to support HWIDVersion setting

Improvements:

Restructured res/ directory with menu icons
Expired passwords no longer auto-cleared
Maintain stable connection between downstream and Layer-1 master

v1.0.2.9 (2026.3.27)

Network Security & Stability Enhancement

New Features:

Network configuration dialog: IP whitelist/blacklist management, takes effect immediately
Configurable rate limiting: DLL request limiting, adjustable IP ban thresholds
IP history dialog: View license IP login history
Status bar displays MTBF/runtime and license expiration date
Agent crash protection: Auto-switch to normal mode after 3 crashes within 5 minutes
Client search function: Ctrl+F to quickly search IP, location, computer name
Auto-ban malicious IPs: Auto-ban for 1 hour if >15 connections within 60 seconds
Proxy Protocol v2 support: Get real client IP behind FRP proxy
Linux clipboard sync and V2 file transfer support
Right-click menu to run client program on host
Multi-layer authorization obfuscation support

Bug Fixes:

Fixed race condition crash in OnUserOfflineMsg
Fixed FrpcParam lost when client requests FRPC DLL
Increased max packet size from 10MB to 50MB
Support mstsc remote session for reading user registry
Fixed clipboard false trigger when remote desktop minimized
Fixed master crash when operating process dialog
Status bar host count updates in real-time
Reset timeval before each select() call on Linux
Passcode format validation to filter garbage data

Improvements:

Enhanced authorization check with IP ban notifications
Support master program running with user privilege
Large DLL auto-fallback to TinyRun

v1.2.8 (2026.3.11)

Email Notification & Remote Audio

Host online email notification (SMTP config, keyword matching, right-click quick add)
Remote audio playback (WASAPI Loopback) + Opus compression (24:1)
Multiple FRPS servers simultaneous connection support
Custom cursor display and tracking
V2 authorization protocol (ECDSA signature)
Fixed garbled text on non-Chinese Windows systems
Linux client screen compression algorithm optimization

v1.2.7 (2026.2.28)

V2 File Transfer Protocol

Support C2C (client-to-client) direct transfer
Resumable transfer and large file support (>4GB)
SHA-256 file integrity verification
WebView2 + xterm.js modern terminal
Linux file management support
Host list batch update optimization, reduced UI flickering

v1.2.6 (2026.2.16)

Remote Desktop Toolbar Rewrite

Status window showing RTT, FPS, resolution
Fullscreen toolbar supports 4 positions and multi-monitor
H.264 bandwidth optimization
License management UI improvements

v1.2.5 (2026.2.11)

Adaptive Quality Control & Linux Client

RTT-based intelligent quality adjustment
RGB565 algorithm (50% bandwidth savings)
Scroll detection optimization (50-80% bandwidth savings)
Linux client initial release

For complete update history, see: history.md

HoldingHands - Full English interface remote control
BGW RAT - Big Grey Wolf 9.5
Gh0st - Classic Gh0st implementation

Contact

Channel	Link
QQ	962914132
Telegram	@doge_grandfather
Email	yuanyuanxiang163@gmail.com
LinkedIn	wishyuanqi
Issues	Report Issues
PR	Contribute

Sponsorship

This project originated from technical learning and personal interest. The author will update irregularly based on spare time. If this project has been helpful to you, please consider sponsoring:

_{If you like this project, please give it a ⭐ Star!}

29 KiB Raw Blame History

SimpleRemoter

Table of Contents

Overview

Core Capabilities

Use Cases

Disclaimer

Features

Remote Desktop

File Management

Terminal Management

Process & Window Management

Media Features

Other Features

Technical Highlights

High-Performance Network Architecture

Adaptive Quality Control

V2 File Transfer Protocol

Screen Transmission Optimization

Security Mechanisms

Dependencies

Architecture

Architecture Advantages

Master Program (Server)

Controlled Program (Client)

Getting Started

5-Minute Quick Start

Build Requirements

Build Steps

Deployment Methods

Intranet Deployment

Internet Deployment (FRP Tunneling)

Authorization

Client Support

Windows Client

Linux Client (v1.2.5+)

Changelog

v1.3.1 (2026.4.15)

v1.3.0 (2026.4.8)

v1.0.2.9 (2026.3.27)

v1.2.8 (2026.3.11)

v1.2.7 (2026.2.28)

v1.2.6 (2026.2.16)

v1.2.5 (2026.2.11)

Related Projects

Contact

Sponsorship

29 KiB

Raw Blame History