mrcolorrain/vnc-browser

VNC-Browser

🌟 如果您喜欢此镜像，请在https://github.com/MRColorR/vnc-browser%E4%B8%8A%E7%BB%99%E4%B8%AA%E6%98%9F%E6%A0%87%EF%BC%81%E6%84%9F%E8%B0%A2%E6%82%A8%E7%9A%84%E6%94%AF%E6%8C%81%E3%80%82%F0%9F%99%82

概述 📖

VNC-Browser是一个最小化、可定制的基于Linux的Docker镜像，旨在提供通过VNC浏览网页的轻量级环境。

提供两个版本：

• 基于Debian（带Chromium浏览器）→ mrcolorrain/vnc-browser:debian
• 基于Alpine（带Firefox浏览器）→ mrcolorrain/vnc-browser:alpine

镜像包含 ✨：

• VNC服务器
• 自动启动的网页浏览器
• noVNC（用于浏览器访问）

为低资源消耗和高性能构建，适用于开发和生产环境。

先决条件

• Docker已安装

快速开始 🚀

Docker CLI 🐳

bash
docker run -d -p 5900:5900 -p 6080:6080 \
  --name vnc-browser \
  -e VNC_PASSWORD="mypassword" \
  mrcolorrain/vnc-browser:debian

Docker Compose 🐳

yaml
version: "3.9"
services:
  vnc-browser:
    container_name: vnc-browser
    image: mrcolorrain/vnc-browser:debian
    ports:
      - "5900:5900"
      - "6080:6080"
    environment:
      VNC_PASSWORD: "mypassword"
    restart: unless-stopped

启动后，您可以通过以下方式连接：

• 使用浏览器访问noVNC客户端：localhost:6080；若正确配置，也可通过HOSTIP:6080从其他设备访问
• 使用VNC客户端连接：localhost:5900；若正确配置，也可通过HOSTIP:5900从其他设备访问

自定义 🎨

您可以在Docker运行命令中通过传递环境变量来自定义容器设置。所有当前设置将打印在容器日志中。以下是一些示例：

• 设置初始网站URL：STARTING_WEBSITE_URL="https://www.google.com"
• 设置VNC密码：VNC_PASSWORD="mypassword"
• 设置分辨率：VNC_RESOLUTION="1280x720"
• 启用/禁用浏览器自动启动：AUTO_START_BROWSER=true 或 AUTO_START_BROWSER=false
• 启用/禁用xterm自动启动：AUTO_START_XTERM=true 或 AUTO_START_XTERM=false
• 启用/禁用窗口管理器（fluxbox）自动启动：AUTO_START_WM=true 或 AUTO_START_WM=false
• 启用/禁用x11vnc自动启动：AUTO_START_X11VNC=true 或 AUTO_START_X11VNC=false
• 启用/禁用xvfb自动启动：AUTO_START_XVFB=true 或 AUTO_START_XVFB=false
• 启用/禁用noVNC（websockify）自动启动：AUTO_START_NOVNC=true 或 AUTO_START_NOVNC=false
• 添加浏览器命令选项：BROWSER_OPTIONS="--start-fullscreen --kiosk --incognito --noerrdialogs --no-first-run --disk-cache-dir=/dev/null"
• 添加x11vnc命令选项：X11VNC_OPTIONS="-nocursor"
• 添加xvfb命令选项：XVFB_OPTIONS="-nocursor"
• 添加窗口管理器（fluxbox）命令选项：WM_OPTIONS="-rc /app/fluxbox.conf"
• 添加noVNC（websockify）命令选项：NOVNC_OPTIONS="--heartbeat=10"
• 添加xterm命令选项：XTERM_OPTIONS="-leftbar"

可用变量 ⚙️

• 示例：docker run -d -p 5900:5900 -p 6080:6080 -e STARTING_WEBSITE_URL="https://www.bing.com" -e VNC_PASSWORD="mypassword" -e VNC_RESOLUTION="1920x1080" -e AUTO_START_BROWSER=true -e AUTO_START_XTERM=true mrcolorrain/vnc-browser:alpine

添加自定义入口点 📜

此镜像允许添加自定义脚本，在容器启动时执行（需启用自定义）。

自定义入口点说明：

• 将此镜像作为基础创建自定义镜像，或挂载卷并将脚本添加到自定义入口点目录：
  • 选项1：基于此镜像创建新镜像，将自定义脚本复制到自定义入口点目录
  • 选项2：将包含自定义脚本的目录挂载到/app/custom_entrypoints_scripts目录
    • 示例：docker run -d -p 5900:5900 -p 6080:6080 -v /path/to/your/scripts:/app/custom_entrypoints_scripts -e CUSTOMIZE=true mrcolorrain/vnc-browser:debian
• 自定义入口点更多信息：
  • 如需自定义镜像，将.sh（bash）或.py（Python）脚本放入上述目录，并设置环境变量CUSTOMIZE=true以启用自定义脚本执行
    • 确保脚本具有必要权限（如：使脚本可执行）
    • 确保脚本以正确的shebang开头（如：#!/bin/bash或#!/usr/bin/env python3）
  • 执行顺序：
    • 此目录中的所有脚本将按字母顺序执行
    • 建议使用单个bash入口点以降低复杂度
  • 日志：
    • 脚本的执行过程和输出可在容器日志中查看

支持

如需支持和报告问题，请使用GitHub仓库的问题跟踪器https://github.com/MRColorR/vnc-browser%E3%80%82

贡献 🤲

欢迎为此Docker镜像贡献代码。请向GitHub仓库https://github.com/MRColorR/vnc-browser%E6%8F%90%E4%BA%A4%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E5%92%8C%E9%97%AE%E9%A2%98%E3%80%82