raindev11/webtop Docker Image
raindev11查看中文加速指南
基于KasmVNC和Ubuntu-KDE的Web Linux桌面环境,支持韩语输入输出,预装实用工具、开发工具及GUI应用,提供浏览器访问的远程桌面解决方案,适用于多架构系统。
6 次收藏下载次数: 0状态:社区镜像维护者:raindev11仓库类型:镜像最近更新:2 天前
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) 기반으로 베이스 이미지 전환은 아직 미호환 패키지가 다수 있어, 연말경 전환 검토 예정입니다.
| Base image | Architecture |
|---|---|
| Ubuntu Jammy (22.04) | amd64 |
| Ubuntu Jammy (22.04) | arm64 |
Version Tags
모든 이미지는 Ubuntu KDE 기반입니다. latest 및 yymmdd 형식의 태그로 빌드됩니다.
| Tag | Description |
|---|---|
| latest | Latest build |
| yymmdd | Specific build |
Container Setup
아래 2개의 포트로 서비스됩니다.
- [***]
- [***]
지원되는 환경변수 옵션은 아래와 같습니다.
Optional environment variables
| Variable | Default | Description |
|---|---|---|
| CUSTOM_PORT | 3000 | HTTP 포트 |
| CUSTOM_HTTPS_PORT | 3001 | HTTPS 포트 |
| CUSTOM_USER | abc | HTTP Basic 인증 ID |
| PASSWORD | HTTP Basic 인증 PW (입력 시 HTTP Basic 인증 활성화) | |
| SUBFOLDER | / | Subfolder 형식으로 Reverse proxy 구성 시, 사용할 Subfolder 경로 |
| TITLE | KasmVNC Client | 브라우저 표시 제목 |
| START_DOCKER | true | 컨테이너 내부의 도커(Docker in Docker, DinD) 사용여부 |
| DRINODE | /dev/dri/renderD128 | 오픈소스 드라이버 기반 GPU 사용여부,https://www.kasmweb.com/kasmvnc/docs/master/gpu_acceleration.html참고 |
| DISABLE_IPV6 | false | IPv6 활성화 여부 |
| DOCKER_MODS | 추가 설정 가능한https://github.com/linuxserver/docker-mods항목 | |
| RESET_HOME | false | 컨테이너 재시작 시 홈 디렉토리 초기화 여부 |
| DESKTOP_ICONS | false | 바탕화면에 아이콘 배치여부 |
| TZ | Asia/Seoul | 시간대 |
| LC_ALL | ko_KR.UTF-8 | 사용 언어 (ko_KR.UTF-8 / en_US.UTF-8 등) |
| VIEW_ONLY | false | 보기전용 모드 |
| RESIZE | remote | 스케일링 설정 (off / scale / remote) |
| ENABLE_PERF_STATS | false | 성능정보 표시 |
| ENABLE_WEBRTC | false | WebRTC 사용 |
| ENABLE_WEBP | true | WebP 사용 |
| ENABLE_IME | true | IME 입력 활성화 |
| ENABLE_HIDPI | false | HiDPI 사용 |
| VIDEO_QUALITY | high | 스트리밍 품질 프리셋 (low / medium / high / extreme / lossless) |
| ANTI_ALIASING | dynamic | 안티 앨리어싱 설정 (dynamic / on / off) |
Optional run configurations
| Type | Variable | Essential | Description |
|---|---|---|---|
| Option | --privileged | ✅ | 컨테이너 내부의 도커(Docker in Docker, DinD) 사용을 위해 필요 |
| Option | --security_opt seccomp:unconfined | ✅ | 컨테이너 내부의 도커(Docker in Docker, DinD) 사용을 위해 필요 |
| Bind Mount | -v ./data:/config | ❌ | 호스트 폴더에 기본 홈 디렉토리 연결 |
| Bind Mount | -v ./docker:/var/lib/docker | ❌ | 호스트 폴더에 DinD 디렉토리 연결 |
| Bind Mount | -v /var/run/docker.sock:/var/run/docker.sock | ❌ | 호스트의 도커 제어가 필요할 경우 설정 |
| Bind Mount | -v ./certificates:/usr/local/share/ca-certificates | ❌ | 사설 인증서 등록이 필요할 경우 사용 |
| Bind Mount | -v /dev/shm:/dev/shm | ✅ | 원활한 사용을 위해 호스트의 Shared memory 공유 |
| Device | --device /dev/dri:/dev/dri | ✅ | 내부에서 GPU를 사용하기 위해 필요 |
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
| 항목 | 명칭 | 초기설정 내용 |
|---|---|---|
| 브라우저 | Brave | 한글 언어팩 적용, 우클릭 차단 확장 사전설치 |
| 텍스트 편집기 | VSCode | 한글 언어팩 적용 Docker, Indent-rainbow, Typora 확장 사전설치 |
| 오피스 | LibreOffice | StopBegging 확장 사전설치 |
| 원격접속 | Remmina | 기본 설정 |
| 가상화 | Docker/compose | |
| 네트워크 | Wireshark | 기본 설정 |
| 파일 탐색기 | Double Commander | 기본 설정 |
| 압축 | Ark | |
| 동영상 뷰어 | VLC | 기본 설정 |
| 이미지 뷰어 | Gwenview | 기본 설정 |
| 화면 녹화 | OBS Studio | 기본 설정 |
| 화면 캡쳐 | Spetacle |
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 : 최초 업로드
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull raindev11/webtop:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务