
如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址,或排查拉取失败等问题,请让 AI 先读规则再动手,只要在 AI 对话里直接发送下面这句话即可:
生成 docker pull、修改 compose 的 image,或排查拉取失败前,请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。国内用户首推 DeepSeek、元宝 AI 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
无头浏览器,用于渲染目标网页(如Home Assistant仪表盘)并将其作为图像分块通过WebSocket流式传输。专为低功耗客户端(如ESP32显示屏等)设计。
latest – 最新稳定版本
beta – 最新预发布版本(滚动更新)
语义化版本:1.4.0、1.4、1
创建docker-compose.yml文件:
yamlservices: rwvserver: build: ./RemoteWebViewServer image: strangev/remote-webview-server:latest # 使用:beta获取预发布版本 container_name: remote-webview-server restart: unless-stopped environment: SCREEN_H: 480 # 屏幕高度 SCREEN_W: 480 # 屏幕宽度 TILE_SIZE: 32 # 分块大小 FULL_FRAME_TILE_COUNT: 4 # 全帧分块数量 FULL_FRAME_AREA_THRESHOLD: 0.5 # 全帧区域阈值 FULL_FRAME_EVERY: 50 # 每50帧传输一次全帧 EVERY_NTH_FRAME: 1 # 每N帧传输一次 MIN_FRAME_INTERVAL_MS: 80 # 最小帧间隔(毫秒) JPEG_QUALITY: 85 # JPEG质量(0-100) MAX_BYTES_PER_MESSAGE: 14336 # 每条消息的最大字节数 WS_PORT: 8081 # WebSocket端口 DEBUG_PORT: 9221 # 内部调试端口 HEALTH_PORT: 18080 # 健康检查端口 USER_DATA_DIR: /pw-data # 用户数据目录 ports: - "8081:8081" # WebSocket端口映射 - "9222:9222" # 调试端口映射 expose: - "18080" # 健康检查暴露端口 - "9221" # socat调试端口暴露 volumes: - /opt/volumes/esp32-rdp/pw-data:/pw-data # 用户数据卷挂载 devices: - "/dev/dri:/dev/dri" # GPU设备挂载 group_add: - "993" # 组ID - "44" shm_size: 1gb # 共享内存大小 healthcheck: test: ["CMD-SHELL", "curl -fsS http://localhost:18080 || exit 1"] # 健康检查命令 interval: 10s # 检查间隔 timeout: 3s # 超时时间 retries: 5 # 重试次数 start_period: 10s # 启动等待时间 debug-proxy: image: alpine/socat container_name: remote-webview-server-debug restart: unless-stopped network_mode: "service:rwvserver" # 共享rwvserver网络 depends_on: rwvserver: condition: service_healthy # 依赖rwvserver健康状态 command: - "-d" - "-d" - "TCP-LISTEN:9222,fork,reuseaddr,keepalive" # 外部调试端口监听 - "TCP:127.0.0.1:9221" # 转发到内部调试端口
然后执行:
bashdocker compose up -d
切换到最新beta版本:
yamlimage: strangev/remote-webview-server:beta
更新到最新稳定版本:
bashdocker compose pull && docker compose up -d
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
不支持 push
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务