FIRERPA 星连平台¶

星连平台是一个面向分布式 Android 设备与自动化任务执行的管理系统，数据完全本地化，覆盖设备接入、设备监控、脚本开发、任务编排、模型配置与用户管理等核心场景，适合远程设备运营、批量自动化执行和 AI/RPA 脚本，支持跨网设备互联、支持本地与远程设备的统一接入及 P2P 接入。

支持管理大规模设备节点，编写、版本化和调试自动化脚本、向设备动态下发及执行脚本、追踪任务运行状态、结果与失败原因、配置 AI 模型，支撑 Prompt/混合脚本执行、管理平台用户等。

主要功能¶

设备管理¶

Starlink 提供完整的设备管理能力，支持设备列表分页检索、排序和批量选择，支持按分组查看设备并识别在线、离线、忙碌等状态。设备接入支持直连、P2P、转发等模式，便于适配不同网络环境。平台同时提供设备品牌、型号、架构、服务版本、注册时间、心跳时间、电量等信息展示，并支持在设备详情中进行用户绑定管理。

实时监控¶

平台提供设备实时监控能力，支持设备总览、分组筛选和状态筛选，并可实时预览设备画面。设备详情页可以持续查看 CPU、内存、网络、线程、文件描述符、崩溃数等实时与历史指标，结合图表能力帮助用户持续观测设备状态变化，适合用于远程巡检和异常排查。

批量操作¶

在批量操作场景下，Starlink 支持将文件同时推送到多台设备，并提供上传进度反馈与失败重试机制；也支持从多台设备拉取文件并统一打包下载。除此之外，平台还支持批量执行 Shell 命令，并按设备查看输出结果、错误信息和退出状态，方便进行集中式运维与批量处理。

任务编排¶

平台内置任务编排与执行能力，支持在任务列表中进行分页查看、搜索、状态筛选、时间筛选与排序，并可直观看到运行中、暂停、完成等任务状态。系统同时提供任务总览统计，包括运行数、成功数、失败数、超时数与趋势数据。创建任务时可以配置脚本版本、目标分组、执行模式、优先级、超时、重试等参数，并支持循环、次数、按设备次数、截止时间、Crontab 等多种调度模式。

任务追踪¶

在任务详情中，用户可以查看任务基本信息、脚本版本、执行配置、参数来源和时间信息，也可以从设备维度追踪任务下发、成功、失败、超时和绑定状态。平台还提供执行实例明细，用于查看执行状态、耗时、异常、traceback、结果和资源信息，并支持对任务进行运行控制与版本切换。

脚本中心¶

脚本中心面向脚本开发、维护与协作场景，支持脚本列表搜索、类型筛选、时间筛选和批量删除，支持代码脚本与 Prompt/混合脚本两类内容。平台支持脚本共享给其他用户，脚本详情页集成 Monaco Editor，能够提供较完整的在线开发体验，同时支持脚本版本历史浏览与 Diff 对比，便于持续迭代和回溯变更。

在线调试¶

Starlink 提供内置在线调试能力，支持在脚本页面直接进入调试模式，并在选择目标设备与模型后发起调试运行。调试过程中支持 Step In、Step Over、Step Out、Continue、Quit 等控制操作，支持查看源码停靠位置、调用栈、局部变量和调试输出，也支持在调试控制台执行表达式。结合实时投屏能力，用户可以把脚本执行过程与设备画面联动观察。

模型管理¶

平台提供 AI 模型管理能力，支持维护模型名称、Endpoint、模型名、Key 等配置，并支持视觉模式开关。用户还可以配置视觉缩放、最大 Token、Temperature、Step Delay 等参数，使模型能够更好地适配 Prompt/混合脚本与 AI 驱动任务的执行需求。

安装平台¶

我们的服务生态完全基于 Docker，所以您的电脑或者服务器上必须已安装 Docker。为了流程顺畅的进行，我们建议您使用 Linux 系列的系统如 Ubuntu、Debian 等而非 Windows/Mac。

首先，您需要先克隆我们的配置文件，您可以执行如下命令

git clone https://github.com/firerpa/starlink.git

完成克隆后，进入该目录，目录下包含一个隐藏文件 .env.example，您需要将其重命名为 .env 并适当里面的配置项， 配置项的修改依据您的实际需求，部分配置一旦设置后续将无法更改。

DOMAIN=starlink.local

# 以下变量在第一次初始化后严禁修改。
API_PORT=65000
WEB_PORT=8000
FWD_PORT=7123

# 设置相关数据库的默认密码（随机设置即可）
REDIS_PASSWORD=9XdTBBn11m5ugEGUavmR4C
RABBITMQ_PASSWORD=6LVc53IVJcRpiDsY0CyLcN
POSTGRES_PASSWORD=P5FinxzLZToVzAaAIZvsIw

# 设置当前服务器所在的物理网络网段、网关以及接口名。
# 如果运行在公网，则您无需配置下列三项，并移除 starlink.yaml 中的所有 lan-macvlan 节
LOCAL_LAN_SUBNET=192.168.50.0/24
LOCAL_LAN_GATEWAY=192.168.50.1
LOCAL_LAN_INTERFACE=enp7s0
# 设置当前服务的本地 IP，取决于您的宿主机是否支持 docker lan-macvlan 模式以及您是否需要接入本地网络的设备
# 您需要在这里使用一个当前内网未使用的 IP，如不需要接入本地设备或者不支持 lan-macvlan 模式，请设置为 127.0.0.1，该项不可为空。
LOCAL_LAN_IP=192.168.50.200

# 设置当前服务器的公网IP，如果您不打算部署在公网，设置为与 LOCAL_LAN_IP 相同的值，否则请设置正确的服务器公网地址（可通过命令 curl -4 ip.sb 获得）
PUBLIC_IP=192.168.50.200

# 部署 https://github.com/firerpa/hub-bridge 来获得以下参数
# P2P 模式可以让您在内网运行的情况下接入外网设备，如果不准备使用 P2P 模式，只需要保持当前注释状态即可

#TOP_ENDPOINT=http://x.x.x.x:9000
#TOP_CLIENT_KEY=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAq...QIDAQAB
#TOP_SECRET=49c98730-....-bb0c9f22a310

配置完成后，在当前目录执行如下命令即可。

docker compose -f starlink.yaml up --force-recreate -d

稍等片刻您可以在浏览器访问 https://{LOCAL_LAN_IP}:{WEB_PORT} 来访问后台，公网部署的情况下，请将 LOCAL_LAN_IP 替换为 PUBLIC_IP，使用默认用户名 admin，密码 starlink 来登录后台，登录后台后，请及时修改默认密码。

人工服务¶

如果这些步骤对您来说仍然颇有具复杂性，您也可以选择付费的安装服务，使用微信扫码选择需要的安装数量，我们将会依据您的需求为您提供合适的远程安装服务，让您省却一切烦恼。

您可以在支付订单后的跳转页面长按二维码添加我们的人工服务微信（或在 技术支持 章节添加我们的企业微信），并附带订单生成的服务凭证或订单截图，我们将竭诚为您服务。