Skip to content

Mofangbao/midscene-pc-docker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐳 Midscene PC Docker 容器

基于 Ubuntu GNOME 桌面的 Docker 容器,预装了 Midscene PC 服务,支持通过 VNC 访问图形界面

Docker Ubuntu VNC

📖 原始项目地址 | 📚 Midscene PC 服务文档


📖 项目简介

本项目在原始项目基础上预装了以下组件:

  • 🌐 Chrome 浏览器
  • 🖥️ 支持文件夹右键打开的终端
  • 🤖 Midscene PC 自动化服务

系统预览


演示

查看资源占用(连接到远程服务)

remote-service.mp4

✨ 核心特性

特性 描述
🖥️ Ubuntu GNOME 桌面环境 完整的图形界面体验
🚀 Midscene PC 自动启动 使用 supervisor 进程管理器自动运行
🌐 VNC 远程访问 通过浏览器或 VNC 客户端访问
🔍 Chrome 浏览器 预装 Google Chrome 浏览器
Node.js 环境 支持运行 JavaScript 应用程序

🚀 快速开始

📥 获取镜像

🔨 自行构建
git clone https://github.com/mofangbao/midscene-pc-docker.git
cd midscene-pc-docker
docker build -t ppagent/midscene-ubuntu-desktop:latest .
📦 从 Docker Hub 拉取
docker pull ppagent/midscene-ubuntu-desktop:latest

🏃‍♂️ 运行容器

使用启动脚本(推荐)

# 使用提供的启动脚本
./start.sh

暂不支持 docker-compose 运行

⚠️ 注意: 目前暂不支持使用 docker-compose 运行


🔧 服务管理

📊 查看服务状态

# 查看进程
ps aux | grep midscene

# 查看日志
tail -f /var/log/midscene-pc.log
tail -f /var/log/midscene-pc-error.log

🎛️ 手动控制服务

# 通过 supervisor 管理
supervisorctl start midscene-pc
supervisorctl stop midscene-pc
supervisorctl restart midscene-pc

# 手动运行命令
npx midscene-pc

🆙 Midscene-pc 服务更新

# 在容器内更新到最新版本(临时更新)
npx midscene-pc@latest

# 更新后重启服务
supervisorctl restart midscene-pc

Important

♻️ 永久更新需要重新编译镜像。

Important

🕐 启动提示: 启动后需要等待约 10 秒钟初始化桌面,如果 VNC 连接出现黑屏,请稍等片刻。


🌐 端口配置

端口 服务 访问地址
10081 VNC Web 界面 http://localhost:10081
3333 Midscene PC 服务 -

❓ 常见问题

🔧 如何预装其他软件?

将需要预装的 deb 文件拷贝到 software 目录,然后重新编译镜像即可实现预装。

📋 已测试软件: 微信、钉钉、VSCode、WPS 等常用软件均可正常运行。

🔐 VNC 的密码是什么?

如果没有在 start.sh 或自定义的 docker run 脚本中指定密码相关的环境变量,则使用默认密码 headless

可修改的环境变量:

  • VNC_PASS
  • VNC_PASS_RO
  • SSH_PASS

默认 start.sh 启动配置:

SSH_PASS=midscene-pc
VNC_PASS=midscene-pc
VNC_PASS_RO=midscene_pc
📱 桌面应用在哪里?
  1. 点击左上角的 活动 按钮
  2. 出现收藏栏后,点击收藏栏的菜单按钮
  3. 即可看到应用程序面板(dashboard)

应用面板


⚠️ 已知问题

平台 问题描述 影响范围
🍎 macOS 创建 midscene-pc 设备时不支持手动圈画功能 全屏和固定区域功能正常
🍎 macOS VNC 连接后无法自动适配 Retina 显示 不影响自动化操作功能
🐳 Docker 暂时只支持 docker run 启动 不支持 docker-compose
💾 数据持久化 目前不支持完整的数据持久化,但可通过挂载外部目录到容器中使用 使用 -v 挂载外部目录以保留数据

🎉 感谢使用 Midscene PC Docker 容器!

如有问题或建议,欢迎提交 IssuePull Request

About

Midscenejs pc connetor server.Based on ubuntu20 gnome desktop,accessed via VNC.一个支持运行各类Ubuntu软件的Docker镜像,如chrome、微信、钉钉、QQ、WPS等。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors