SimpleRemoter

简体中文 | 繁體中文 | English

⚠️ 유지보수 중단 및 법적 고지

[!CAUTION] 이 프로젝트는 더 이상 유지보수되지 않습니다. 사용에 따른 책임은 사용자 본인에게 있습니다.

⚖️ 규정 준수 알림

• 법적 용도로만 사용: 무단 원격 접속은 엄격히 금지됩니다. 모든 현지 법률을 준수하십시오.
• 명시적 동의: 사용 전에 반드시 기기 소유자의 명시적 승인을 받아야 합니다.
• 보안 위험: 보안 패치가 제공되지 않습니다. 계속 사용하면 취약점에 노출될 수 있습니다.

[!WARNING] 중요 법적 고지

본 소프트웨어는 교육 목적 및 승인된 사용 시나리오에 한해서만 제공됩니다:

• 조직 내 원격 IT 관리
• 승인된 침투 테스트 및 보안 연구
• 개인 기기 관리 및 기술 학습

승인되지 않은 컴퓨터 시스템 접근은 불법 행위입니다. 사용자는 모든 관련 법률을 준수할 전적인 책임이 있습니다. 개발자는 어떠한 오용 행위에 대해서도 책임을 지지 않습니다.

목차

• 프로젝트 소개
• 면책 조항
• 주요 기능
• 기술 하이라이트
• 시스템 아키텍처
• 빠른 시작
• 사용자 문서
• 클라이언트 지원
• 업데이트 내역
• 관련 프로젝트
• 연락처

프로젝트 소개

SimpleRemoter는 클래식 Gh0st 프레임워크를 기반으로 재구축된 완전한 기능의 원격 제어 솔루션으로, 최신 C++17로 개발되었습니다. 2019년에 시작된 이 프로젝트는 지속적인 반복 개발을 통해 Windows + Linux 이중 플랫폼을 지원하는 엔터프라이즈급 원격 관리 도구로 발전했습니다.

핵심 기능

사용 시나리오

• 기업 IT 운영: 내부 네트워크 장비 일괄 관리, 원격 장애 진단
• 원격 근무: 사무용 컴퓨터 안전 접속, 파일 동기화 전송
• 보안 연구: 침투 테스트, 레드팀 훈련, 보안 감사
• 기술 학습: 네트워크 프로그래밍, IOCP 모델, 암호화 전송 실습

원본 소스: zibility/Remote | 시작일: 2019.1.1

면책 조항

본 소프트웨어를 사용하기 전에 다음 고지 사항을 주의 깊게 읽어 주십시오:

1. 합법적 용도: 본 프로젝트는 합법적인 기술 연구, 학습 교류 및 승인된 원격 관리 용도로만 제공됩니다. 타인의 컴퓨터 시스템에 대한 무단 접근, 데이터 도용, 타인 사생활 감시 등 모든 불법 행위에 본 소프트웨어를 사용하는 것을 엄격히 금지합니다.

2. 사용자 책임: 사용자는 소속 국가/지역의 법률과 규정을 준수해야 합니다. 본 소프트웨어 사용으로 인해 발생하는 모든 법적 책임은 사용자 본인에게 있습니다.

3. 보증 없음: 본 소프트웨어는 "있는 그대로" 제공되며, 상품성 또는 특정 목적에의 적합성에 대한 보증을 포함하되 이에 국한되지 않는 어떠한 명시적 또는 묵시적 보증도 제공되지 않습니다.

4. 책임 면제 조항: 개발자는 본 소프트웨어의 사용, 오용 또는 사용 불가로 인해 발생하는 직접적, 간접적, 우발적, 특수적 또는 결과적 손해에 대해 책임을 지지 않습니다.

5. 저작권 고지: 본 프로젝트는 MIT 라이선스로 오픈소스로 제공되며, 자유로운 사용, 수정 및 배포가 허용되지만 원본 저작권 고지는 유지해야 합니다.

본 소프트웨어를 계속 사용하면 위의 모든 조항을 읽고 이해했으며 이에 동의한 것으로 간주됩니다.

[!IMPORTANT] 네트워크 연결 및 개인정보 고지

제어 프로그램(서버)은 인증 상태에 따라 인증 서버와 네트워크 통신을 수행합니다:

버전 유형	연결 동작
평가판	인증 서버와의 지속적인 연결 유지
V1/V2 인증 버전	시작 시 연결 검증 후 연결 해제
V2 오프라인 인증 버전	인증 서버 연결 불필요

오프라인 인증을 받은 경우를 제외하고, 제어 프로그램은 인증 서버와 필수 데이터 교환(예: 크랙 행위 탐지, 인증 유효성 검증)을 수행합니다.

본 소프트웨어를 사용하면 제어 프로그램과 인증 서버 간의 데이터 전송에 동의하는 것으로 간주됩니다. 동의하지 않으면 본 소프트웨어를 사용하지 마십시오.

주요 기능

원격 데스크톱

• 다양한 화면 캡처 방식: GDI(호환성 우수), DXGI(고성능), 가상 데스크톱(백그라운드 실행)
• 지능형 압축 알고리즘:
  • DIFF 차분 알고리즘 - SSE2 최적화, 변경된 영역만 전송
  • RGB565 알고리즘 - 대역폭 50% 절약
  • H.264 인코딩 - 비디오급 압축, 고프레임률 시나리오에 적합
  • 그레이스케일 모드 - 매우 낮은 대역폭 소비
• 적응형 품질: 네트워크 RTT에 따라 프레임률(5-30 FPS), 해상도 및 압축 알고리즘 자동 조정
• 다중 모니터: 다중 화면 전환 및 다중 화면 동시 표시 지원
• 프라이버시 화면: 피제어 클라이언트의 화면을 숨길 수 있으며, 잠금 화면 상태에서도 제어 가능
• 파일 드래그: Ctrl+C/V로 기기 간 파일 복사 및 붙여넣기
• 웹 원격 데스크톱: 브라우저를 통해 원격 데스크톱에 접속, 모바일/태블릿 지원(구성 가이드)

파일 관리

• V2 전송 프로토콜: 전면 재설계, 대용량 파일(>4GB) 지원
• 이어받기: 네트워크 중단 후 자동 복구, 상태 영속화
• C2C 전송: 제어 프로그램을 거치지 않고 클라이언트 간 직접 전송
• 무결성 검증: SHA-256 해시 검증으로 파일 무결성 보장
• 일괄 작업: 파일 검색, 압축, 일괄 전송 지원

터미널 관리

• 대화형 Shell: 완전한 명령줄 환경, Tab 자동 완성 지원
• ConPTY 기술: Windows 10+ 네이티브 가상 터미널 지원
• 최신 웹 터미널: WebView2 + xterm.js 기반(v1.2.7+)
• 터미널 크기 조정: 창 크기에 맞게 자동 조정

프로세스 및 창 관리

프로세스 관리	창 관리

• 프로세스 관리: 프로세스 목록, CPU/메모리 사용량 확인, 프로세스 시작/종료
• 코드 주입: 대상 프로세스에 DLL 주입(관리자 권한 필요)
• 창 제어: 창 최대화/최소화/숨기기/닫기

미디어 기능

비디오 관리	음성 관리

• 웹캠 모니터링: 실시간 비디오 스트림, 해상도 조정 지원
• 오디오 감청: 원격 소리 수집, 양방향 음성 지원
• 키로깅: 온라인/오프라인 기록 모드

기타 기능

• 서비스 관리: Windows 서비스 확인 및 제어
• 레지스트리 탐색: 레지스트리 내용 읽기 전용 탐색
• 세션 제어: 원격 로그오프/종료/재시작
• SOCKS 프록시: 클라이언트를 통한 프록시 터널 구축
• FRP 터널링: FRP 내장 지원, 내부 네트워크 간편 우회
• 코드 실행: 원격 DLL 실행, 핫 업데이트 지원

기술 하이라이트

고성능 네트워크 아키텍처

┌─────────────────────────────────────────────────────────┐
│                    IOCP 通信模型                          │
├─────────────────────────────────────────────────────────┤
│  • I/O 完成端口：Windows 最高效的异步 I/O 模型            │
│  • 单主控支持 10,000+ 并发连接                            │
│  • 支持 TCP / UDP / KCP 三种传输协议                      │
│  • 自动分块处理大数据包（最大 128KB 发送缓冲）             │
└─────────────────────────────────────────────────────────┘

적응형 품질 제어

RTT(Round-Trip Time) 기반 지능형 품질 조정 시스템:

• 추가 오버헤드 없음: 하트비트 패킷을 재사용하여 RTT 계산
• 빠른 품질 저하: 2회 감지 시 즉시 적용, 네트워크 변동에 대응
• 신중한 품질 향상: 5회 안정화 후에만 품질 향상
• 쿨다운 메커니즘: 잦은 전환 방지

V2 파일 전송 프로토콜

// 77 字节协议头 + 文件名 + 数据载荷
struct FileChunkPacketV2 {
    uint8_t   cmd;            // COMMAND_SEND_FILE_V2 = 85
    uint64_t  transferID;     // 传输会话 ID
    uint64_t  srcClientID;    // 源客户端 ID (0=主控端)
    uint64_t  dstClientID;    // 目标客户端 ID (0=主控端, C2C)
    uint32_t  fileIndex;      // 文件编号 (0-based)
    uint32_t  totalFiles;     // 总文件数
    uint64_t  fileSize;       // 文件大小（支持 >4GB）
    uint64_t  offset;         // 当前块偏移
    uint64_t  dataLength;     // 本块数据长度
    uint64_t  nameLength;     // 文件名长度
    uint16_t  flags;          // 标志位 (FFV2_LAST_CHUNK 等)
    uint16_t  checksum;       // CRC16 校验（可选）
    uint8_t   reserved[8];    // 预留扩展
    // char filename[nameLength];  // UTF-8 相对路径
    // uint8_t data[dataLength];   // 文件数据
};

특징:

• 대용량 파일 지원(uint64_t로 4GB 제한 돌파)
• 이어받기(상태를 %TEMP%\FileTransfer\에 영속화)
• SHA-256 무결성 검증
• C2C 직접 전송(클라이언트 간)
• V1/V2 프로토콜 호환

화면 전송 최적화

• SSE2 명령어 세트: 픽셀 차분 계산 하드웨어 가속
• 멀티스레드 병렬 처리: 스레드 풀로 화면 데이터 분할 처리
• 스크롤 감지: 스크롤 시나리오 인식, 대역폭 50-80% 절감
• H.264 인코딩: x264 기반, GOP 제어, 비디오급 압축

보안 메커니즘

의존 라이브러리

시스템 아키텍처

┌─────────────────────────────────────────────────────────────────────────────┐
│                         多层授权架构 (Multi-Layer Authorization)             │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│                          ┌─────────────────────┐                            │
│                          │    超级管理员        │                            │
│                          │   (授权服务器)       │                            │
│                          │   Super Admin       │                            │
│                          └─────────┬───────────┘                            │
│                                    │                                         │
│                     ┌──────────────┼──────────────┐                         │
│                     │ V2 授权      │ V2 授权      │ V2 授权                  │
│                     │ (ECDSA)      │ (ECDSA)      │ (ECDSA)                  │
│                     ▼              ▼              ▼                          │
│             ┌───────────┐  ┌───────────┐  ┌───────────┐                     │
│             │ 第一层 A   │  │ 第一层 B   │  │ 第一层 C   │  ◄── 独立运营      │
│             │ Layer-1 A │  │ Layer-1 B │  │ Layer-1 C │      完全隔离       │
│             └─────┬─────┘  └─────┬─────┘  └─────┬─────┘                     │
│                   │              │              │                            │
│          ┌────────┴────────┐     │       ┌──────┴──────┐                    │
│          │ V1 授权         │     │       │ V1 授权     │                    │
│          ▼                 ▼     ▼       ▼             ▼                    │
│    ┌──────────┐     ┌──────────┐ ...  ┌──────────┐  ┌──────────┐           │
│    │ 下级 A1  │     │ 下级 A2  │      │ 下级 C1  │  │ 下级 C2  │           │
│    │ Master   │     │ Master   │      │ Master   │  │ Master   │           │
│    └────┬─────┘     └────┬─────┘      └────┬─────┘  └────┬─────┘           │
│         │                │                 │             │                  │
│         ▼                ▼                 ▼             ▼                  │
│    ┌─────────┐     ┌─────────┐       ┌─────────┐   ┌─────────┐             │
│    │ 客户端  │     │ 客户端  │       │ 客户端  │   │ 客户端  │             │
│    │ 10,000+ │     │ 10,000+ │       │ 10,000+ │   │ 10,000+ │             │
│    └─────────┘     └─────────┘       └─────────┘   └─────────┘             │
│                                                                              │
├─────────────────────────────────────────────────────────────────────────────┤
│  授权类型        验证方式              特点                                   │
│  ─────────────────────────────────────────────────────────────────────────  │
│  V2 授权         ECDSA P-256 签名      支持离线验证，下级连接数限制            │
│  V1 授权         HMAC + 在线验证       连接上级服务器验证                      │
│  试用版          在线验证              功能受限，需保持连接                    │
└─────────────────────────────────────────────────────────────────────────────┘

아키텍처 장점

제어 프로그램(서버)

제어 프로그램 YAMA.exe는 그래픽 관리 인터페이스를 제공합니다:

• IOCP 기반 고성능 서버
• 클라이언트 그룹 관리
• 실시간 상태 모니터링(RTT, 지리적 위치, 활성 창)
• 원클릭 클라이언트 생성

피제어 프로그램(클라이언트)

실행 형태:

빠른 시작

5분 빠른 체험

컴파일 없이 다운로드 후 바로 사용 가능:

1. 릴리스 버전 다운로드 - Releases에서 최신 버전 다운로드
2. 제어 프로그램 시작 - YAMA.exe 실행, 인증 정보 입력(아래 평가판 인증번호 참조)
3. 클라이언트 생성 - 도구 모음의「생성」버튼 클릭, 서버 IP 및 포트 구성
4. 클라이언트 배포 - 생성된 클라이언트를 대상 머신에 복사하여 실행
5. 제어 시작 - 클라이언트가 온라인 상태가 되면 더블 클릭으로 원격 데스크톱 열기

[!TIP] 첫 테스트에서는 동일한 머신에서 제어 프로그램과 클라이언트를 실행하고 127.0.0.1을 서버 주소로 사용하는 것이 좋습니다.

컴파일 요구 사항

• 운영 체제: Windows 10/11 또는 Windows Server 2016+
• 개발 환경: Visual Studio 2019 / 2022 / 2026
• SDK: Windows 10 SDK (10.0.19041.0+)

컴파일 단계

# 1. 克隆代码（必须使用 git clone，不要下载 zip）
git clone https://github.com/yuanyuanxiang/SimpleRemoter.git

# 2. 打开解决方案
#    使用 VS2019+ 打开 SimpleRemoter.sln

# 3. 选择配置
#    Release | x86 或 Release | x64

# 4. 编译
#    生成 -> 生成解决方案

자주 묻는 질문:

• 의존 라이브러리 충돌: #269
• 비중국어 시스템 문자 깨짐: #157
• 컴파일러 호환성: #171

배포 방식

내부 네트워크 배포

제어 프로그램과 클라이언트가 동일한 LAN에 있으며, 클라이언트가 제어 프로그램의 IP:Port에 직접 연결됩니다.

외부 네트워크 배포(FRP 터널링)

客户端 ──> VPS (FRP Server) ──> 本地主控 (FRP Client)

자세한 구성은 역방향 프록시 배포 설명을 참조하십시오.

인증 설명

v1.2.4부터 평가판 인증번호가 제공됩니다(2년 유효기간, 20개 동시 연결, 내부 네트워크 전용):

授权方式：按计算机 IP 绑定
主控 IP：127.0.0.1
序列号：12ca-17b4-9af2-2894
密码：20260201-20280201-0020-be94-120d-20f9-919a
验证码：6015188620429852704
有效期：2026-02-01 至 2028-02-01

[!NOTE] 다중 계층 인증 체계

SimpleRemoter는 엔터프라이즈급 다중 계층 인증 아키텍처를 채택하여 대리점/개발자의 독립 운영을 지원합니다:

• 오프라인 검증: 1계층 사용자는 인증을 받은 후 완전히 오프라인으로 사용 가능
• 독립 제어: 하위 사용자는 사용자의 서버에만 연결되며, 데이터는 전적으로 사용자가 관리
• 자유로운 맞춤화: 2차 개발을 지원하여 사용자만의 전용 버전 구축 가능

📖 전체 인증 체계 설명 보기

사용자 문서

다양한 사용자 역할에 맞는 완전한 사용 문서를 제공합니다:

클라이언트 지원

Windows 클라이언트

시스템 요구 사항: Windows 7 SP1 이상

기능 완성도: ✅ 전체 기능 지원

Linux 클라이언트(v1.2.5+)

시스템 요구 사항:

• 디스플레이 서버: X11/Xorg(Wayland는 아직 지원되지 않음)
• 필수 라이브러리: libX11
• 권장 라이브러리: libXtst(XTest 확장), libXss(유휴 감지)

기능 지원:

컴파일 방법:

cd linux
cmake .
make

업데이트 내역

v1.3.1 (2026.4.15)

웹 원격 데스크톱 & 다중 제어 프로그램 공유 강화

새로운 기능:

• 웹 원격 데스크톱: WebSocket 기반 구현, 모바일/태블릿에서 브라우저를 통한 원격 데스크톱 접속 지원(구성 가이드)
• 공유 취소 메뉴: 다른 제어 프로그램에 공유된 클라이언트의 공유 취소 지원
• 도구 모음 오디오 제어: 원격 데스크톱 도구 모음에 시스템 오디오 켜기/끄기 아이콘 추가

개선 사항:

• 다중 모니터에서 적응형 비활성화: 클라이언트에 모니터가 여러 개인 경우 적응형 품질 자동 비활성화
• 상태 표시줄 만료일 자동 업데이트: 인증 갱신 후 상태 표시줄 즉시 새로고침
• 불필요한 오프라인 로그 감소: 클라이언트가 호스트 목록에 없을 때 오프라인 로그 출력 감소
• 다중 계층 인증 자동 업데이트: 2계층 이하 제어 프로그램의 인증 자동 동기화 업데이트
• 사용 힌트 강화: 사용자 경험 개선을 위한 여러 작업 힌트 추가
• DLL 캐시 재사용: DLL을 레지스트리에 저장하고, 다음 시작 시 바로 재사용

버그 수정:

• 공유 클라이언트에서 키로깅이 정상 작동하지 않을 수 있는 문제 수정

v1.3.0 (2026.4.8)

다중 계층 FRP 아키텍처 & 브랜드 맞춤화

새로운 기능:

• 로컬 FRPS 서버 지원(64비트 전용): FRP 서버 내장, 배포 간소화
• 다중 계층 아키텍처 자동 FRP 통합: 하위 제어 프로그램이 상위 FRP 구성 자동 획득
• V2 인증 하위 연결 수 제한: 하위 동시 연결 수 제어 지원
• 라이선스 파일 가져오기/내보내기 지원(.lic 형식)
• 만료 인증 갱신 지원: 라이선스를 다시 생성할 필요 없음
• 향상된 하드웨어 ID(V2): VPS 중복 SN 문제 해결
• MaxDepth 제어: 계층형 Master의 레벨 깊이 제한
• 라이선스 관리 강화: 할당량 지원, 동적 대화상자, 삭제 기능
• IP 위치 API 다중 제공자 폴백: 위치 확인 성공률 향상
• UI 브랜드 맞춤화: 프로그램 이름, 로고, 저작권 등 사용자 정의 지원
• 런타임 기능 제한: 평가판 기능 제한 구성 가능
• 입력 기록 드롭다운: 이전 입력 빠른 선택
• 클라이언트 생성에 새 옵션 추가: 더 많은 사용자 정의 구성
• 프로젝트 링크 동적 수정 지원: 재컴파일 없이 도움말/피드백 링크 변경

버그 수정:

• RebuildFilteredIndices의 Use-after-free 크래시 수정
• CLock::Lock의 IOCP 경합 조건 크래시 수정(#215)
• 크래시 보호 서비스 정리 및 에이전트 권한 상승 문제 수정
• 메시지 로그 무한 증가로 인한 잠재적 크래시 수정
• FeatureFlags 도입 후 UpperHash 문자열 길이 문제 수정
• HWIDVersion 설정을 지원하도록 클라이언트 SN 생성 수정

개선 사항:

• res/ 디렉터리 구조 리팩터링, 메뉴 아이콘 추가
• 만료된 비밀번호가 더 이상 자동으로 삭제되지 않음
• 하위 제어 프로그램과 1계층 제어 프로그램 간 연결 안정성 유지

v1.0.2.9 (2026.3.27)

네트워크 보안 & 안정성 강화

새로운 기능:

• 네트워크 구성 대화상자: IP 화이트리스트/블랙리스트 관리, 실시간 적용
• 구성 가능한 연결 속도 제한: DLL 요청 제한, IP 차단 임계값 조정 가능
• IP 기록 대화상자: 인증된 IP의 로그인 기록 보기
• 상태 표시줄에 MTBF/가동 시간 및 인증 만료일 표시
• 에이전트 크래시 보호: 5분 내 3회 크래시 시 일반 모드로 자동 전환
• 클라이언트 검색 기능: Ctrl+F로 IP, 위치, 컴퓨터 이름 빠른 검색
• 비정상 IP 자동 차단: 60초 내 15회 이상 연결 시 1시간 자동 차단
• Proxy Protocol v2 지원: FRP 프록시 뒤에서 실제 클라이언트 IP 획득
• Linux 클립보드 동기화 및 V2 파일 전송 지원
• 마우스 오른쪽 버튼 메뉴에서 클라이언트 프로그램 실행
• 다중 계층 인증 난독화 지원

버그 수정:

• OnUserOfflineMsg 경합 조건으로 인한 크래시 수정
• 클라이언트가 FRPC DLL을 요청할 때 FrpcParam 누락 문제 수정
• 최대 데이터 패킷을 10MB에서 50MB로 증가
• mstsc 원격 세션에서 사용자 레지스트리 읽기 지원
• 원격 데스크톱 최소화 시 클립보드 오작동 수정
• 프로세스 대화상자 조작 시 제어 프로그램 크래시 수정
• 상태 표시줄 호스트 수 실시간 업데이트
• Linux에서 select() 호출 전 timeval 재설정
• 인증 코드 형식 검증, 쓰레기 데이터 필터링

개선 사항:

• 인증 검사 강화, IP 차단 알림 추가
• 제어 프로그램을 사용자 권한으로 실행 지원
• 대용량 DLL은 자동으로 TinyRun 폴백 방식 사용

v1.2.8 (2026.3.11)

이메일 알림 & 원격 오디오

• 호스트 온라인 이메일 알림(SMTP 구성, 키워드 매칭, 마우스 오른쪽 버튼 빠른 추가)
• 원격 오디오 재생(WASAPI Loopback) + Opus 압축(24:1)
• 다중 FRPS 서버 동시 연결 지원
• 사용자 정의 커서 표시 및 추적
• V2 인증 프로토콜(ECDSA 서명)
• 비중국어 Windows 시스템의 글자 깨짐 문제 수정
• Linux 클라이언트 화면 압축 알고리즘 최적화

v1.2.7 (2026.2.28)

V2 파일 전송 프로토콜

• C2C(클라이언트 간) 직접 전송 지원
• 이어받기 및 대용량 파일 지원(>4GB)
• SHA-256 파일 무결성 검증
• WebView2 + xterm.js 최신 터미널
• Linux 파일 관리 지원
• 호스트 목록 일괄 업데이트 최적화, UI 깜빡임 감소

v1.2.6 (2026.2.16)

원격 데스크톱 도구 모음 재작성

• 상태 창에 RTT, 프레임률, 해상도 표시
• 전체 화면 도구 모음이 4개 위치 및 다중 모니터 지원
• H.264 대역폭 최적화
• 인증 관리 UI 개선

v1.2.5 (2026.2.11)

적응형 품질 제어 & Linux 클라이언트

• RTT 기반 지능형 품질 조정
• RGB565 알고리즘(대역폭 50% 절약)
• 스크롤 감지 최적화(대역폭 50-80% 절약)
• Linux 클라이언트 초기 버전 출시

전체 업데이트 내역은 history.md에서 확인하세요.

관련 프로젝트

• HoldingHands - 전체 영어 인터페이스 원격 제어
• BGW RAT - 大灰狼 9.5
• Gh0st - 클래식 Gh0st 구현

연락처

후원 지원

본 프로젝트는 기술 학습과 취미에서 시작되었으며, 저자는 여가 시간에 따라 비정기적으로 업데이트합니다. 이 프로젝트가 도움이 되셨다면 후원을 환영합니다:

_{이 프로젝트가 마음에 드신다면 ⭐ Star를 남겨 주세요!}