Repolode
Git-Agni

Git-Agni/prod-FARM-IOS-Core

在 Mac 上管理和自动化一组真实 iPhone 的自托管开源工具,内置 TikTok 定时任务。

Star
1,854
Fork
329
未关闭 Issue
4
最近提交
2个月前

这是什么?

Phone Farm iOS 是一个独立的自托管应用,用于管理实体 iPhone 设备,并在上面执行定时工作流。它提供引导式设备注册、WebDriverAgent 与 Appium 监管、带远程输入的实时视频画面,以及基于 PostgreSQL 的调度器,支持一次性和周期性任务、文件上传与执行历史。控制台和 API 服务器统一承载这些功能。

任务以插件 ID、任务类型、任务版本和 JSON 载荷的形式持久化,已保存的计划不会在新的任务协议下悄悄执行。TikTok 自动化作为内置插件提供,也可以通过 ESM 包加载其他任务插件。插件可以添加带版本的任务、注册检查、设备页面面板和带命名空间的 HTTP 路由,无需修改核心调度代码。

应用默认在本地回环地址上运行且无需认证。若要将控制台暴露到回环地址之外,需要提供认证提供者,否则服务无法启动。运行环境要求 Node 22+、PostgreSQL、Xcode、已签名的真机 WebDriverAgent,以及 Appium 的 XCUITest 驱动。

核心功能

  • 01通过 WebDriverAgent 和 Appium 引导完成真实 iOS 设备的注册与监管
  • 02为已连接的 iPhone 提供实时视频和远程输入
  • 03基于 PostgreSQL 的调度器,支持一次性和周期性任务
  • 04带版本的任务插件,避免旧计划套用新的任务协议
  • 05内置 TikTok 自动化插件并保留执行历史

适用场景

  • 在一台 Mac 上统一管理一小批实体 iPhone 用于应用测试
  • 在多台设备上定时执行 TikTok 工作流
  • 通过插件系统开发定制化的 iOS 设备自动化

快速上手

  1. 1

    安装 Node 依赖

    npm install
  2. 2

    从示例创建环境变量文件

    cp .env.example .env
  3. 3

    启动 PostgreSQL、运行数据库迁移并准备 WebDriverAgent(完整前置条件见 README)

    npm run db:up
  4. 4

    启动控制面板和 API 服务器

    npm run web

使用前须知

  • 需要配备 Xcode 的 Mac、真实 iPhone 以及已签名的 WebDriverAgent 构建。
  • 需要 Node 22+ 和 PostgreSQL 数据库。
  • 在本机回环地址上认证是可选的;若要暴露到回环之外,必须先提供你自己的 AuthProvider。

收录于专题

标签

#ios-automation#appium#webdriveragent#device-farm#scheduler#postgresql#self-hosted#marketing-automation#phone-farm#tiktok-automation-script

常见问题

prod-FARM-IOS-Core 是什么?
在 Mac 上管理和自动化一组真实 iPhone 的自托管开源工具,内置 TikTok 定时任务。 Phone Farm iOS 是一个独立的自托管应用,用于管理实体 iPhone 设备,并在上面执行定时工作流。它提供引导式设备注册、WebDriverAgent 与 Appium 监管、带远程输入的实时视频画面,以及基于 PostgreSQL 的调度器,支持一次性和周期性任务、文件上传与执行历史。控制台和 API 服务器统一承载这些功能。
prod-FARM-IOS-Core 可以免费使用吗?用的什么许可证?
prod-FARM-IOS-Core 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
prod-FARM-IOS-Core 还在维护吗?
半年内有更新。prod-FARM-IOS-Core 最近一次提交是在 2026年9月7日。
prod-FARM-IOS-Core 适合用来做什么?
在一台 Mac 上统一管理一小批实体 iPhone 用于应用测试 在多台设备上定时执行 TikTok 工作流 通过插件系统开发定制化的 iOS 设备自动化
prod-FARM-IOS-Core 怎么安装和运行?
安装 Node 依赖: npm install 从示例创建环境变量文件: cp .env.example .env 启动 PostgreSQL、运行数据库迁移并准备 WebDriverAgent(完整前置条件见 README): npm run db:up 启动控制面板和 API 服务器: npm run web
在哪里获取 prod-FARM-IOS-Core?
源代码和安装说明在 GitHub 上:https://github.com/Git-Agni/prod-FARM-IOS-Core

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目