eworkerinc/remote-runner

E-Worker Remote Runner

Remote Runner是E-Worker的Docker镜像，作为容器运行后，已授权的E-Worker AI工具可将其作为独立的Linux环境执行命令行工作，实现工作负载与主应用进程的隔离。

核心功能

• 文件同步：复制项目到容器或取回生成结果
• 命令执行：运行脚本、测试、构建和代码检查
• 工件管理：收集日志、生成文件及ZIP格式工件
• 终端支持：提供浏览器端交互式终端会话
• 安全控制：需API密钥访问，支持非root用户运行模式

使用场景

• 项目构建与测试：在隔离环境中执行构建脚本和测试用例
• 工具安装：在挂载目录中安装项目依赖工具
• 多团队协作：为不同项目或团队部署独立的运行器容器
• 开发预览：通过指定端口范围运行开发服务器并预览结果

镜像信息

• 运行器服务镜像：eworkerinc/remote-runner:0.6.3（轻量服务层）
• 工具环境镜像：eworkerinc/remote-runner-env:2026.06.02（包含.NET、Python、Node.js等常用SDK及浏览器工具）

快速部署（Docker Compose）

以下示例启动带持久化数据和工作空间的运行器容器：

yaml
services:
  remote-runner:
    image: eworkerinc/remote-runner:0.6.3
    restart: unless-stopped
    environment:
      EW_REMOTE_RUNNER_LISTEN_ADDR: 0.0.0.0:62480
      EW_REMOTE_RUNNER_DATA_DIR: /data
      EW_REMOTE_RUNNER_WORKSPACE_ROOT: /workspace
      EW_REMOTE_RUNNER_CORS_ORIGINS: https://app.eworker.ca
      EW_REMOTE_RUNNER_PREVIEW_BIND_ADDR: "127.0.0.1"
      EW_REMOTE_RUNNER_PREVIEW_PORTS: "13000-13099"
      EW_REMOTE_RUNNER_PREVIEW_HOST_PORTS: "13000-13099"
      EW_REMOTE_RUNNER_API_KEY: change-me  # 替换为自定义密钥
      EW_REMOTE_RUNNER_API_KEY_FILE: /data/remote-runner-api-key
      EW_REMOTE_RUNNER_MAX_CONCURRENT: "10"
      EW_REMOTE_RUNNER_MAX_TERMINAL_SESSIONS: "20"
      EW_REMOTE_RUNNER_DEFAULT_TIMEOUT_MS: "600000"
      EW_REMOTE_RUNNER_SYNC_WAIT_TIMEOUT_MS: "600000"
      EW_REMOTE_RUNNER_RUN_AS_USER: "false"
    ports:
      - "127.0.0.1:62480:62480"  # API端口（本地仅访问）
      - "127.0.0.1:13000-13099:13000-13099"  # 预览端口范围
    volumes:
      - ./Data:/data  # 持久化数据目录
      - ./Workspace:/workspace  # 工作空间目录
    shm_size: 1g
    pids_limit: 1024
    mem_limit: 4g
    cpus: 4

启动命令：

bash
docker compose up -d

安全注意事项

• 勿直接暴露运行器到公网，建议通过私有网络或***访问
• API密钥需妥善保管，如同密码
• 为不同项目/工作空间使用独立的运行器容器以增强隔离性
• 仅挂载必要的目录，避免符号链接在工作空间路径中
• 调整CPU、内存和进程限制以适配工作负载
• 定期执行安全更新以修复基础镜像和工具链的漏洞
• 禁用预览端口或限制其访问范围以降低安全风险

E-Worker配置步骤

1. 在E-Worker AI生态系统中添加Remote Runner记录，填写Base URL（如http://127.0.0.1:62480）和API密钥
2. 授权Agent Console使用Remote Runner工具，即可执行命令任务、文件操作和终端会话
3. 通过AI生态系统或工作空间浏览器打开交互式终端，选择bash/sh/pwsh等shell

开发预览端口使用

在容器内启动开发服务器时，需绑定到0.0.0.0并使用预览端口范围（如***-***），示例：

bash
# Vite
npm run dev -- --host 0.0.0.0 --port 13000
# 访问http://127.0.0.1:13000查看预览

若需修改端口范围，需同步更新环境变量EW_REMOTE_RUNNER_PREVIEW_PORTS和EW_REMOTE_RUNNER_PREVIEW_HOST_PORTS。