Automation Slim 是一个专为轻量化、高性能自动化任务设计的 Docker 工控平台。
相比于传统的臃肿桌面镜像，本项目移除了 60% 以上的冗余组件（如 Firefox、Office 等），使用极简的 Openbox 窗口管理器替代了 XFCE。它在一个极其精简的容器内集成了 Google Chrome、AutoKey、Python (Selenium/Playwright) 以及一套可视化的 Web 任务调度面板。
非常适合用于：网页爬虫、RPA 自动化、定时签到、浏览器操作录制等场景。
- Openbox + Tint2: 替换了 XFCE 桌面，待机内存占用极低（仅约 100MB），启动速度飞快。
- 体积缩减: 镜像体积大幅减小，更适合低配 VPS 部署。
- 中文支持: 内置文泉驿微米黑字体 (
fonts-wqy-microhei)，完美解决 Chrome 中文乱码问题。
- Google Chrome: 官方稳定版，预置了防检测配置 (Anti-bot)，隐藏 WebDriver 特征。
- Selenium & Playwright: 环境已预装，可直接调用系统 Chrome 运行。
- AutoKey (GTK): 系统级键盘/鼠标宏工具，已修复崩溃问题，支持 Python 脚本控制系统输入。
- 任务管理: 在网页上添加、编辑、删除定时任务。
- 在线代码编辑: 内置代码编辑器，直接在浏览器中编写 Python 脚本。
- 拟人化调度: 支持 Cron 表达式，独创 “随机时间窗口” (Random Delay) 模式，模拟真人操作时间的不确定性。
- NoVNC: 直接在浏览器中访问远程桌面，无需安装客户端。
- 剪贴板同步: 完美支持宿主机与容器之间的复制粘贴（由
autocutsel驱动）。 - Cloudflare Tunnel: 内置内网穿透支持，无需公网 IP 即可远程管理。
- 消息推送: 任务成功或失败可推送到 Telegram Bot 或 Email。
- 低内存运行: 针对 Railway/Zeabur/Koyeb 等 PaaS 平台优化，支持在 1GB 内存环境下运行。
- Chrome 内存优化: 预置 7 项内存节省参数，V8 堆限制为 256MB。
- 自动 Swap: 启动时自动创建 512MB swap 文件，应对内存压力峰值。
- 分辨率适配: 默认 1360x768 分辨率 + 16bit 色深，减少 VNC 带宽占用。
你需要一台安装了 Docker 和 Docker Compose 的服务器（Linux/Windows/Mac 均可）。
在你的服务器上执行：
mkdir -p automation/data automation/logs automation/Downloads
cd automation-aio创建名为 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
- SMTP_USER=your_email@gmail.com
- SMTP_PASSWORD=your_app_password
- EMAIL_FROM=your_email@gmail.com
- EMAIL_TO=receiver@example.com
# === Cloudflare Tunnel 配置 ===
# 必须提供 Token，否则脚本会报错并跳过启动 开启:true 关闭:false
- ENABLE_CLOUDFLARE_TUNNEL=false
- CLOUDFLARE_TUNNEL_TOKEN=eyJhIjoi...
- 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: 40sdocker-compose up -d等待几秒钟，服务即可启动。
打开浏览器访问 http://<服务器IP>:8080。
- 默认账号:
admin - 默认密码:
admin123 - 注意: 如果在
docker-compose.yml中设置了ADMIN_PASSWORD，每次容器重启时，系统都会强制将 Admin 用户的密码重置为该环境变量指定的值。
点击面板右上角的 "🖥️ 远程桌面" 按钮进入 NoVNC 界面。
-
界面布局:
- 你会看到一个 纯色背景（通常是深灰色），这不是死机了，而是 Openbox 的极简风格。
- 屏幕底部有一个细长的任务栏 (
tint2)，显示当前打开的窗口和时间。 - 右下角托盘区应该能看到红色的 AutoKey 图标。
-
如何打开菜单？
- 点击鼠标右键：在桌面任意空白处点击右键，即可弹出主菜单。
- 从中可以打开 Terminal (终端)、File Manager (文件管理器) 等工具。
-
📋 剪贴板如何同步？
- 从 VNC 复制到 电脑: 在 VNC 里选中文字复制 -> 打开 VNC 侧边栏 -> 点击 Clipboard -> 文本框中会出现内容 -> 手动复制出来。
- 从 电脑 复制到 VNC: 电脑复制 -> 打开 VNC 侧边栏 -> 点击 Clipboard -> 粘贴到文本框 -> 在 VNC 内部按
Ctrl+V。
- 在 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()- 回到首页，"+ 新建任务"，选择该脚本并点击 "▶ 立即运行"。
- 在 "📂 脚本管理" -> AutoKey 选项卡新建脚本。
- 输入 AutoKey 代码（例如模拟键盘输入）：
# 输入 Hello World 并回车
keyboard.send_keys("Hello World")
keyboard.send_keys("<enter>")- 自动重载: 系统会自动检测 AutoKey 脚本的变更并重载服务，新建脚本后可立即使用。
- 注意：AutoKey 脚本通常配合窗口触发，但在本平台中，你可以通过 Web 面板直接触发它。
为了极致压缩体积，镜像中未预装 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()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 .