Webtop Docker로 나만의 클라우드 데스크탑 설치

— 로컬처럼 빠르고, 한글까지 완벽 지원되는 원격 리눅스 환경

“집 밖에서도, 집 안처럼 NAS·공유기에 접근한다.”
Webtop은 내 서버를 리눅스 기반 데스크탑 환경으로 바꿔주는 도커 컨테이너다.
브라우저만 있으면 언제 어디서나 “내 미니PC의 모니터”를 그대로 띄울 수 있다.
그리고 놀랍게도, 이 커스텀 Webtop은 한국어와 한글 입력까지 완벽히 지원한다.

우선 하드웨어 구성은 [시놀로지NAS+미니PC]로 하기 링크에서와 같은 구성이다.

시놀로지 NAS + 미니PC VLAN 기반 NFS 완벽 설정 가이드 (Ubuntu 24 + Synology DS923+) – Tech & Investment

1) Webtop이란?

Webtop은 리눅스 GUI 데스크탑을 웹 브라우저 안에서 직접 실행할 수 있게 해주는 오픈소스 컨테이너다.
쉽게 말해, 리눅스 데스크탑을 브라우저 탭 하나로 사용할 수 있는 원격 환경이다.

Ubuntu / Debian / Fedora 등 리눅스 기반 GUI 환경 제공
GPU 하드웨어 가속 지원 (VA-API / Radeon / Intel iGPU)
HTTP Basic Auth 로그인 가능
내부망(NAS, 공유기, Emby 등)에 직접 접근
Visual Studio Code, Gwenview, LibreOffice, OBS Studio, Double Commander, Brave Web Browser, Remmina 등 기본 앱 설치
- [기타 앱 별도 설치 필요 : KakaoTalk(리눅스판), Joplin 등]
한글 키보드 완벽 지원 (입력·조합 오류 없음)

개인적으로 정말 감사한 점은,
이 raindev11/webtop 컨테이너가 한국어 입력 환경을 완벽하게 지원한다는 것이다.
해외 기반 오픈소스 중 대부분이 한글 키보드입력에 문제가 있었지만,
이 버전은 별도 설정 없이도 한글 키보드 입력이 완벽하게 동작한다.

2) Docker Compose 설정 예시 (AMD GPU 가속 포함)

			
version: "3.8"
services:
  webtop:
    image: raindev11/webtop:latest        # 한글 지원 완벽한 Webtop 커스텀 이미지
    container_name: webtop
    hostname: webtop
    restart: unless-stopped
    shm_size: 6g                          # Shared Memory 크기 (브라우저/오피스 앱 렉 방지)
    security_opt:
      - seccomp:unconfined                # 그래픽 및 브라우저 가속용
    environment:
      - PUID=1000                         # 호스트 사용자 UID (권한 일치)
      - PGID=1000                         # 호스트 그룹 GID
      - SUBFOLDER=/
      - TITLE=My Webtop                   # 브라우저 탭 제목
      - RESET_HOME=false                  # 홈 폴더 초기화 방지
      - DESKTOP_ICONS=false               # 기본 데스크탑 아이콘 숨김
      - XDG_RUNTIME_DIR=/run/user/0
      - LIBVA_DRIVER_NAME=radeonsi        # AMD Radeon GPU 드라이버
      - LIBVA_DRIVERS_PATH=/usr/lib/x86_64-linux-gnu/dri
      - TZ=Asia/Seoul                     # 타임존
      - CUSTOM_USER=admin                 # 로그인 ID
      - PASSWORD=admin_PW                 # 로그인 PW (HTTP Basic Auth)
    volumes:
      - /opt/webtop/data:/config          # Webtop 설정, 사용자 홈, 캐시
      - /opt/webtop/var:/var/lib/docker   # 내부 앱 데이터 저장
    ports:
      - 21878:3000                        # 접속 포트 (http://IP:21878)
    devices:
      - /dev/dri:/dev/dri                 # GPU 가속 장치 (VA-API / Radeon / Intel)
    group_add:
      - 44                                # video 그룹 (가속 접근)
      - 110                               # render 그룹
    tmpfs:
      - /run/user/0:rw,mode=0755,size=16m # 런타임 디렉토리(tmpfs)
    networks:
      - private
networks:
  private:
    name: private

		

주요 포인트 정리

항목	설명
`/opt/webtop/data`	사용자 홈·설정 저장. 재시작에도 유지
`/dev/dri`	GPU 가속용 장치. VA-API 기반
`CUSTOM_USER`, `PASSWORD`	브라우저 로그인 계정
`tmpfs`	런타임용 tmpfs로 성능 향상
`ports`	외부 접속용 포트 (예: `http://서버IP:21878`)

3) 설치 및 접속 절차

YAML 파일 작성sudo nano /opt/webtop/docker-compose.yml 위 설정을 붙여넣고 저장합니다.
컨테이너 실행docker compose up -d
브라우저 접속http://서버IP:21878
로그인
- ID: admin
- PW: admin_PW

로그인 후 바로 리눅스 데스크탑 환경(Webtop XFCE or KDE 등)을 사용할 수 있으며,
한글 입력도 즉시 작동합니다 — 따로 IME 설정을 할 필요가 없습니다.

4) GPU 마운트의 체감 차이 — NAS vs 미니PC

처음엔 GPU가 없는 Synology NAS에 Webtop을 설치했을 때,
LibreOffice나 웹 브라우저가 굉장히 버벅거렸다.
CPU만으로 GUI를 렌더링하니 브라우징 자체가 답답했다.

하지만 Ryzen 7840HS 기반 미니PC로 옮겨 /dev/dri를 마운트하고
VA-API 가속을 활성화하자, 체감이 확 달라졌다.

스크롤·탭 전환이 즉각 반응
영상 렌더링 부드러움
LibreOffice 입력 딜레이 완전 해소

구분	NAS (CPU-only)	미니PC (GPU 가속)
브라우저 반응속도	매우 느림	빠르고 자연스러움
LibreOffice 편집	입력 지연 있음	실시간 입력 가능
유튜브·웹렌더링	끊김	부드러움
한글 입력	딜레이 있음	완벽한 조합·전환

GPU 없는 NAS에서는 “실행은 되지만 불편”,
GPU가 있는 미니PC에서는 “정말 쓸 수 있는 데스크탑”이다.

5) VPN 없이 “내부망처럼” 접근 가능

Webtop은 VPN 기능은 없지만,
브라우저 안의 리눅스 환경이 곧 내부 네트워크다.

즉, 외부에서 접속하더라도 Webtop 내부에서는
집 안의 네트워크(192.168.x.x)로 인식된다.

NAS (192.168.1.100:5000) 접속
공유기 관리자 진입 (192.168.0.1)
Emby, Nextcloud, Portainer 관리

VPN 연결 없이도 NAS 파일과 공유기 설정에 접근할 수 있는
로컬 우회형 클라우드 데스크탑이다.

6) 리눅스 기반의 자유 — KakaoTalk이나 Joplin 등의 앱까지

Webtop은 단순한 원격 화면이 아니라, 완전한 리눅스 OS 데스크탑이다.
따라서 원하는 앱을 직접 설치해 사용할 수 있다.

⚙️ 참고:
Joplin이나 KakaoTalk은 리눅스용 .AppImage 또는 .deb 설치파일을
공식 사이트에서 직접 내려받아 /opt/webtop/data 내부에 설치하면 된다.

7) Webtop의 활용 시나리오

시나리오	설명
📁 사무용 클라우드 PC	외부에서도 내 데스크탑 환경 그대로 접속
🧾 문서작업 / 보고서 편집	LibreOffice로 NAS 문서 실시간 수정
🧠 노트·메모 관리	Joplin + Nextcloud 동기화로 지식관리
🔍 브라우징 & 개발작업	Brave + VSCode로 작업환경 완비
🖱️ 서버 통합관리 허브	Emby, Portainer 등 내부 IP 직접 제어

8) 결론 — GPU 가속 + 한글 지원 + 로컬 접근의 완전체

Webtop은 “내 미니PC를 브라우저로 옮겨놓는 기술”이다.
그리고 이제는 한글까지 완벽히 지원하는 훌륭한 환경이다.

GPU 가속으로 쾌적한 작업 환경
한국어·한글 입력 완벽 지원 (조합 오류 없음)
NAS·공유기 등 로컬망 직접 접근
Joplin, KakaoTalk 등 리눅스 앱 자유 설치
VPN 없이 로컬 네트워크 활용 가능

Webtop은 내 클라우드 데스크탑이다.
한국어를 완벽히 지원해주는 개발자에게 진심으로 감사하며,
이 프로젝트 덕분에 리눅스 환경의 한글 장벽이 한층 낮아졌다.

webtop공식 홈페이지