raindev11/webtop

Webtop

linuxserver/webtop, kasmvnc + ubuntu-kde 기반으로 생성한 Web 기반의 리눅스 데스크탑 환경입니다.

국내 사용자를 위한 한국어 설정, 유용한 기본 프로그램들이 사전 설치 및 설정되어 있습니다.

Features

• 기본 쉘 : https://www.zsh.org/ (https://github.com/ohmyzsh/ohmyzsh)
• 사전 설치 라이브러리 : https://github.com/sharkdp/bat / https://github.com/eza-community/eza / https://github.com/sharkdp/fd / https://github.com/stedolan/jq / https://github.com/BurntSushi/ripgrep 등
• 기본 폰트
  • Sans/Sans-serif : https://notofonts.github.io
  • Monospace : https://github.com/ryanoasis/nerd-fonts
  • Fallback : https://github.com/naver/d2codingfont / https://github.com/googlefonts/noto-cjk
  • Emoji : https://github.com/googlefonts/noto-emoji
• 한국어 입력 : 지원
  • 전환키 : 한/영 키
  • 입력 불가시 왼쪽 사이드 버튼 클릭 → 설정 → IME Input Mode 선택
• 파일 업로드/다운로드, 사운드 출력 지원
• Docker/Docker-compose 지원
• root 권한 지원
  • sudo 명령어로 수행
• 다양한 아키텍처 지원 (amd64/arm64, multiarch 빌드)

Supported Architecture

amd64(x86-64) 및 arm64(aarch64) 를 지원합니다. 멀티 아키텍처 이미지로 다운로드 하는 서버에 해당되는 아키텍처로 Pull 됩니다.

Noble (24.04) 기반으로 베이스 이미지 전환은 아직 미호환 패키지가 다수 있어, 연말경 전환 검토 예정입니다.

Version Tags

모든 이미지는 Ubuntu KDE 기반입니다. latest 및 yymmdd 형식의 태그로 빌드됩니다.

Container Setup

아래 2개의 포트로 서비스됩니다.

• [***]
• [***]

지원되는 환경변수 옵션은 아래와 같습니다.

Optional environment variables

Optional run configurations

Usage

docker-compose 기반의 샘플 코드입니다. docker cli로 사용하려면 변환 사이트를 사용하세요.

docker-compose

yaml
---
version: '3.5'

services:
  webtop:
    image: raindev11/webtop:latest
    container_name: webtop
    hostname: webtop
    restart: unless-stopped
    privileged: true
    security_opt:
      - seccomp:unconfined
    environment:
      - PUID=1000
      - PGID=1000
      - SUBFOLDER=/
      - TITLE=liveLinux
      - RESET_HOME=true
      - DESKTOP_ICONS=false
      - DISABLE_IPV6=true
      # HTTP Basic Auth 사용시 ID/PW
      #- CUSTOM_USER=abc
      #- PASSWORD=abc
    volumes:
      - './data:/config'
      - './docker:/var/lib/docker'
      # 사설 인증서 등록 필요시 사용
      - './certificates:/usr/local/share/ca-certificates'
      # 호스트 도커연동 제외
      #- '/var/run/docker.sock:/var/run/docker.sock'
      # Shared Memory는 호스트와 연동하여 사용
      - '/dev/shm:/dev/shm'
    ports:
      - 3000:3000
      - 3001:3001
    devices:
      - /dev/dri:/dev/dri
    networks:
      - private

networks:
  private:
    name: private

Reverse proxy (NPM/NGiNX)

• Reverse proxy 구간은 비 암호화(3000) 설정 기준
• NPM의 경우 Advanced → Custom Nginx Configuration 항목에서 설정
• proxy_pass http://webtop:3000; 은 Nginx/NPM이 동일 네트워크로 연결된 겅우이며, 동일 네트워크가 아닌 경우 proxy_pass http://127.0.0.1:(호스트 매핑포트); 로 변경하여 적용 필요

location / {
  proxy_http_version      1.1;
  proxy_set_header        Host $host;
  proxy_set_header        Upgrade $http_upgrade;
  proxy_set_header        Connection "upgrade";
  proxy_set_header        X-Real-IP $remote_addr;
  proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header        X-Forwarded-Proto $scheme;
  proxy_set_header        Cookie "";
  proxy_read_timeout      3600s;
  proxy_send_timeout      3600s;
  add_header              'Access-Control-Allow-Origin' '*' always;
  add_header              'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
  add_header              'Access-Control-Allow-Headers' 'Authorization,Content-Type,Accept,Origin,User-Agent,DNT,Cache-Control,X-Mx-ReqToken,Keep-Alive,X-Requested-With,If-Modified-Since';
  add_header              'Access-Control-Allow-Credentials' 'true';
  add_header              'Cross-Origin-Embedder-Policy' 'require-corp';
  add_header              'Cross-Origin-Opener-Policy' 'same-origin';
  add_header              'Cross-Origin-Resource-Policy' 'same-site';
  proxy_pass               http://webtop:3000;
  proxy_buffering          off;
}

location /websockify {
  proxy_http_version      1.1;
  proxy_set_header        Host $host;
  proxy_set_header        Upgrade $http_upgrade;
  proxy_set_header        Connection "upgrade";
  proxy_set_header        X-Real-IP $remote_addr;
  proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header        X-Forwarded-Proto $scheme;
  proxy_set_header        Cookie "";
  proxy_read_timeout      3600s;
  proxy_send_timeout      3600s;
  add_header              'Access-Control-Allow-Origin' '*' always;
  add_header              'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
  add_header              'Access-Control-Allow-Headers' 'Authorization,Content-Type,Accept,Origin,User-Agent,DNT,Cache-Control,X-Mx-ReqToken,Keep-Alive,X-Requested-With,If-Modified-Since';
  add_header              'Access-Control-Allow-Credentials' 'true';
  add_header              'Cross-Origin-Embedder-Policy' 'require-corp';
  add_header              'Cross-Origin-Opener-Policy' 'same-origin';
  add_header              'Cross-Origin-Resource-Policy' 'same-site';
  proxy_pass               http://webtop:3000;
  proxy_buffering          off;
}

Preinstalled GUI Applications

Update periods

보안 및 어플리케이션 정기 업데이트는 업데이트는 매주 일요일 새벽 3시에 진행됩니다.

비정기 업데이트는 수시로 진행될 수 있습니다.

Versions

• 24.07.28 : 컴포지터 비활성화 → 활성화로 변경 (Brave 브라우저 내 우클릭 메뉴 등, 사각박스 문제 수정)
• 24.05.26 : exa → eza로 변경
• 24.03.24 : 폰트 기본설정 변경 (서브픽셀 렌더링: RGB, 힌팅: 완전히)
• 24.03.18 : Brave 브라우저 초기 실행 오류 수정
• 24.03.18 : UID/GID가 1000:1000이 아닐 경우 정상 부팅되지 않는 문제 수정
• 24.03.18 : 기본 한글폰트 변경(Noto → D2Coding → Noto CJK), 폰트 기본 우선순위 변경 (최우선 → 후순위)
• 24.03.17 : Pretendard 폰트 제외
• 24.03.03 : 베이스 이미지에 적용된 내용 반영 (변경된 옵션 등)
• 23.10.29 : KasmVNC 초기 설정을 환경변수로 설정 가능하도록 변경
• 23.10.22 : KasmVNC 초기 설정 변경 (WebP 압축 활성화, IME 입력 활성화, 기본 스트리밍 품질 프리셋 높음 설정)
• 23.09.17 : python pip 추가
• 23.07.23 : LibreOffice의 툴바 아이콘들이 보이지 않는 문제 수정
• 23.07.23 : VSCode 실행 시 KDE Wallet 창 제거
• 23.07.23 : Terminal 실행 시 oh-my-zsh 업데이트 프롬프트 제거
• 23.06.10 : RESET_HOME 설정 추가, DESKTOP_ICONS 값을 1/0 에서 true/false 로 변경
• 23.06.09 : SUBFOLDER 설정관련 버그 수정, 인증서 설치로직 추가
• 23.06.06 : 최초 업로드