yesyunxin/automation

•Updated about 1 month ago

Image

6.8K

yesyunxin/automation repository overview

⁠🚀 Automation Slim

Automation Slim 是一个专为轻量化、高性能自动化任务设计的 Docker 工控平台。

相比于传统的臃肿桌面镜像，本项目移除了 60% 以上的冗余组件（如 Firefox、Office 等），使用极简的 Openbox 窗口管理器替代了 XFCE。它在一个极其精简的容器内集成了 Google Chrome、AutoKey、Python (Selenium/Playwright) 以及一套可视化的 Web 任务调度面板。

非常适合用于：网页爬虫、RPA 自动化、定时签到、浏览器操作录制等场景。

⁠✨ 核心特性

⁠⚡ 极致轻量 (Ultra-Slim)

Openbox + Tint2: 替换了 XFCE 桌面，待机内存占用极低（仅约 100MB），启动速度飞快。
体积缩减: 镜像体积大幅减小，更适合低配 VPS 部署。
中文支持: 内置文泉驿微米黑字体 (fonts-wqy-microhei)，完美解决 Chrome 中文乱码问题。

⁠🤖 强大的自动化工具链

Google Chrome: 官方稳定版，预置了防检测配置 (Anti-bot)，隐藏 WebDriver 特征。
Selenium & Playwright: 环境已预装，可直接调用系统 Chrome 运行。
AutoKey (GTK): 系统级键盘/鼠标宏工具，已修复崩溃问题，支持 Python 脚本控制系统输入。

⁠📅 可视化 Web 调度台

任务管理: 在网页上添加、编辑、删除定时任务。
在线代码编辑: 内置代码编辑器，直接在浏览器中编写 Python 脚本。
拟人化调度: 支持 Cron 表达式，独创 “随机时间窗口” (Random Delay) 模式，模拟真人操作时间的不确定性。

⁠🛠️ 远程管理与辅助

NoVNC: 直接在浏览器中访问远程桌面，无需安装客户端。
剪贴板同步: 完美支持宿主机与容器之间的复制粘贴（由 autocutsel 驱动）。
Cloudflare Tunnel: 内置内网穿透支持，无需公网 IP 即可远程管理。
消息推送: 任务成功或失败可推送到 Telegram Bot 或 Email。

⁠☁️ PaaS 平台优化 (NEW)

低内存运行: 针对 Railway/Zeabur/Koyeb 等 PaaS 平台优化，支持在 1GB 内存环境下运行。
Chrome 内存优化: 预置 7 项内存节省参数，V8 堆限制为 256MB。
自动 Swap: 启动时自动创建 512MB swap 文件，应对内存压力峰值。
分辨率适配: 默认 1360x768 分辨率 + 16bit 色深，减少 VNC 带宽占用。

⁠🛠️ 3分钟快速部署指南

⁠前置条件

你需要一台安装了 Docker⁠ 和 Docker Compose⁠ 的服务器（Linux/Windows/Mac 均可）。

⁠1. 创建项目目录

在你的服务器上执行：

mkdir -p automation/data automation/logs automation/Downloads
cd automation

⁠2. 创建配置文件

创建名为 docker-compose.yml 的文件，并填入以下内容：

version: '3.8'

services:
  automation-slim:
    image: ghcr.io/workerspages/automation:slim
    container_name: Automation-Slim
    ports:
      - "8080:8080"
    environment:
      - VNC_RESOLUTION=1360x768               # 远程桌面分辨率 (PaaS优化: 降低至1360x768节省内存)
      - TZ=Asia/Shanghai                      # 容器时区
      - VNC_PW=admin
      - SECRET_KEY=your-secret-key-change-this
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=admin123
      - DISPLAY=:1                            # 显示面画在编号为 1 的虚拟显示器上 (请误修改)
      - MAX_SCRIPT_TIMEOUT=600                # 全局环境变量-如果你代码里的 sleep 时间超过了 600 秒，Flask 后端会认为任务卡死
      - SWAP_SIZE_MB=1024                     # Swap 交换空间大小 (MB)


      # === 数据库配置 (可选：连接外部 MariaDB) ===
      # --- 数据库 (可选，留空默认使用内置 SQLite) ---
      # 如需外接 MariaDB/MySQL，请填写以下变量:
    # - MARIADB_HOST=                                           # 例如: 192.168.1.100
    # - MARIADB_PORT=3306
    # - MARIADB_USER=root
    # - MARIADB_PASSWORD=root
    # - MARIADB_DB=automation_slim
    # - DB_SSL_ENABLED=true                                     # (可选) 极简模式 (仅需开启 SSL，使用默认系统证书)
    # - DB_SSL_CA_PATH=/etc/ssl/certs/ca-certificates.crt       # (可选) 自定义 CA 证书路径 推荐
      # =======================================

      # === Telegram 通知配置 ===
      - TELEGRAM_BOT_TOKEN=
      - TELEGRAM_CHAT_ID=

      # === 邮件通知配置 ===
       # 开启邮件通知:true   关闭邮件通知:false 
      - ENABLE_EMAIL_NOTIFY=false
      - SMTP_HOST=smtp.gmail.com
      - SMTP_PORT=587
      - [email protected]
      - SMTP_PASSWORD=your_app_password
      - [email protected]
      - [email protected]

      # === Cloudflare Tunnel 配置 ===
      # 必须提供 Token，否则脚本会报错并跳过启动  开启:true 关闭:false 
      - ENABLE_CLOUDFLARE_TUNNEL=false
      - CLOUDFLARE_TUNNEL_TOKEN=your-tunnel-token-here
      - APP_PUBLIC_DOMAIN=                                         # Cloudflare Tunnel后台配置的域名
    volumes:
      - ./Downloads:/home/headless/Downloads
      - ./data:/app/data
      - ./logs:/app/logs
      - ./scripts:/home/headless/.config/autokey/data/MyScripts    # autokey脚本文件目录
    restart: unless-stopped
    shm_size: '2gb'
    healthcheck:
      test: [ "CMD", "curl", "-f", "http://localhost:8080/health" ]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

⁠3. 启动服务

docker-compose up -d

等待几秒钟，服务即可启动。

⁠📖 使用指南

⁠1. 访问控制台

打开浏览器访问 http://<服务器IP>:8080。

默认账号: admin
默认密码: admin123
注意: 如果在 docker-compose.yml 中设置了 ADMIN_PASSWORD，每次容器重启时，系统都会强制将 Admin 用户的密码重置为该环境变量指定的值。

⁠2. 远程桌面 (重要：Openbox 操作说明)

点击面板右上角的 "🖥️ 远程桌面" 按钮进入 NoVNC 界面。

界面布局:
- 你会看到一个 纯色背景（通常是深灰色），这不是死机了，而是 Openbox 的极简风格。
- 屏幕顶部有一个细长的任务栏 (tint2)，显示当前打开的窗口和时间。
- 右下角托盘区应该能看到红色的 AutoKey 图标。
如何打开菜单？
- 点击鼠标右键：在桌面任意空白处点击右键，即可弹出主菜单。
- 从中可以打开 Terminal (终端)、File Manager (文件管理器) 等工具。
📋 剪贴板如何同步？
- 从 VNC 复制到电脑: 在 VNC 里选中文字复制 -> 打开 VNC 侧边栏 -> 点击 Clipboard -> 文本框中会出现内容 -> 手动复制出来。
- 从电脑复制到 VNC: 电脑复制 -> 打开 VNC 侧边栏 -> 点击 Clipboard -> 粘贴到文本框 -> 在 VNC 内部按 Ctrl+V。

⁠3. 编写与运行脚本

⁠方式 A：编写 Python/Selenium 脚本

在 Web 面板点击 "📂 脚本管理" -> Downloads 选项卡。
点击 "+ 新建脚本"，输入文件名（如 test_chrome.py）。
输入以下示例代码并保存：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
import time

options = Options()
options.add_argument("--no-sandbox")
# 注意：在 Openbox 环境下，可以设为 False 观察浏览器动作
browser = webdriver.Chrome(options=options)

browser.get("https://www.baidu.com")
print(browser.title)
time.sleep(5)
browser.quit()

回到首页，"+ 新建任务"，选择该脚本并点击 "▶ 立即运行"。

⁠方式 B：使用 AutoKey 模拟键鼠

在 "📂 脚本管理" -> AutoKey 选项卡新建脚本。
输入 AutoKey 代码（例如模拟键盘输入）：

# 输入 Hello World 并回车
keyboard.send_keys("Hello World")
keyboard.send_keys("<enter>")

自动重载: 系统会自动检测 AutoKey 脚本的变更并重载服务，新建脚本后可立即使用。
注意：AutoKey 脚本通常配合窗口触发，但在本平台中，你可以通过 Web 面板直接触发它。

⁠⚙️ 进阶配置

⁠关于 Playwright 的使用

为了极致压缩体积，镜像中未预装 Playwright 自带的庞大浏览器二进制包。如果你使用 Playwright，必须在代码中指定使用系统安装的 Chrome：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(
        executable_path="/usr/bin/google-chrome-stable", # 👈 必须指定此路径
        headless=False
    )
    page = browser.new_page()
    page.goto("http://example.com")
    print(page.title())
    browser.close()

⁠❓ 常见问题 (FAQ)

Q: 为什么启动后看不到“开始菜单”？ A: 这是 Openbox 的特性。它没有开始菜单。请在桌面空白处 点击鼠标右键 呼出菜单。

Q: Chrome 启动时崩溃或报错 "Crashpad"? A: 请检查 docker-compose.yml 中是否配置了 shm_size: '2gb'。现代浏览器在 Docker 中需要较大的共享内存空间。

Q: 为什么没有 Firefox 了？ A: 这是 Ultra-Slim (极致瘦身) 版本。为了将镜像体积控制在最小，我们移除了 Firefox。如果你必须使用 Firefox，请使用本项目的旧版分支或自行修改 Dockerfile 安装。

Q: 如何查看脚本的运行日志？ A: 在 Web 面板的任务卡片上，会显示最后一次运行的状态。你可以通过 SSH 进入容器查看详细日志：/app/data/automation.log。

Q: 部署到 PaaS 平台（Railway/Zeabur/Koyeb）很卡怎么办？ A: 本项目已针对 PaaS 平台进行优化。如仍卡顿，请确保：

平台分配至少 1GB RAM
使用优化后的默认配置（VNC_RESOLUTION=1360x768）
避免同时运行多个 Chrome 实例

Q: shm_size 在 PaaS 上不生效怎么办？ A: 本镜像已内置 --disable-dev-shm-usage 参数绕过此限制，无需额外配置。

⁠👨‍💻 开发者信息

如果你想自己构建镜像：

克隆代码:

git clone https://github.com/workerspages/automation.git

准备依赖文件: 构建前必须确保 browser-configs/chrome.zip 存在（可以是个空的 zip，但在构建时必须要有）：
```
mkdir -p browser-configs && touch browser-configs/dummy && zip browser-configs/chrome.zip browser-configs/dummy
```

构建镜像:

docker build -t automation .

构建多架构镜像 (AMD64 + ARM64):

docker buildx build --platform linux/amd64,linux/arm64 -t automation --push .

⁠Enjoy your automation! 🚀

Tag summary

Recent tags

Content type

Image

Digest

sha256:df69defb9…

Size

729.2 MB

Last updated

about 1 month ago

docker pull yesyunxin/automation