2025년 07월 18일

🎥 FreeRDP 빌드 강좌 1편

**

**

1. 개요 및 시작

  • FreeRDP 프로젝트 폴더 생성 및 GitHub 레포 클론:

    bash
    $ git clone https://github.com/FreeRDP/FreeRDP.git
  • 클론할 때 레포 주소와 깃 브랜치 설명

2. 필수 도구 및 종속성 설치

  • ≥ gcc/g++ 컴파일러, CMake, pkg-config 등

  • 기본 Ubuntu 기준: sudo apt install build-essential cmake pkg-config libssl-dev ...

3. 빌드 디렉터리 설정

  • 소스 디렉터리 바깥에서 build 폴더 생성:

    bash
    mkdir build && cd build
    cmake ..
  • cmake 옵션 설명 (예: -DWITH_SERVER=ON, -DWITH_CLIENT=ON)

4. 컴파일 & 설치

  • Make 수행:

    bash
    make -j $(nproc)
    sudo make install
  • 빌드 완료 후 wfreerdp, xfreerdp 실행까지 일사천리

💡 팁: cmake 옵션을 켤수록 빌드 시간이 길어진다는 점 유의.


🎥 FreeRDP 빌드 강좌 2편

**

**

1. CMake 옵션 심층 해설

  • 주요 옵션:

    • WITH_PULSE, WITH_FFMPEG, WITH_CHANNEL_URBDP 등 활성화

  • cmake-gui, ccmake 도구를 사용해 설정 디버깅

2. 디버깅 & 에러 처리

  • build 실행 중 발생 가능한 주요 에러 예시:

    • 의존성 누락, path 문제, 헤더 불일치 등

  • 해결 팁:

    • /usr/local/include 등 올바른 CMAKE_PREFIX_PATH 추가

    • ldconfig 실행, cache clear 등

3. 설치 경로 조정

  • CMAKE_INSTALL_PREFIX=/opt/freerdp 등으로 커스텀 설치 가능

  • 나중에 LD_LIBRARY_PATH 혹은 /etc/ld.so.conf.d/ 설정 필요


🎥 FreeRDP 빌드 강좌 3편

**

**

1. 기본 연결 테스트

  • 윈도우 서버나 로컬 RDP 대상에 연결 테스트

  • xfreerdp /v:host /u:user 등 기본 명령어 실행

2. 옵션별 테스트

  • 오디오 리디렉션: +audio /sound:sys:alsa

  • 다이렉트 그래픽: +clipboard +printer

  • 네트워크 성능 튜닝: /network:auto

3. 고급 팁

  • 자동화 스크립트 작성 방법 안내

  • 실행 로그 활성화: --log-level=DEBUG 옵션 설명


🔧 종합 요약 — FreeRDP 빌드 가이드

단계 명령어 예시 설명
1. 클론 및 초기 설정 git clone ... && mkdir build 소스 준비
2. 의존성 설치 sudo apt ... 빌드에 필요한 라이브러리 준비
3. CMake 구성 cmake .. -DWITH_... 옵션 커스터마이징
4. 컴파일 & 설치 make -j && sudo make install 바이너리 및 라이브러리 생성
5. 실행 테스트 xfreerdp /v:... 실제 연결 테스트