Instagram 手机工作台进入工作台 →

安装与维护

首次接入、软件更新或连接故障时使用。日常操作请查看逐步使用指南。

下载安装包

Instagram USB Fleet 2.4.0 · 包含 Windows 与 Mac 启动入口。

下载 2.4.0 安装包 ↓校验文件Windows 快速开始
安装包内容与校验

完整解压后运行包内入口。这是源码安装包，不包含任务记录、虚拟环境、手机配对或已签名的 WDA。

PowerShell：Get-FileHash .\Instagram_USB_Fleet_2.4.0.zip -Algorithm SHA256。将 Hash 与校验文件核对。

Windows 首次配置

  1. 在 Windows 10/11 x64 上完整解压安装包，例如 D:\InstagramUSB。不要在 ZIP 预览中运行。
  2. 双击根目录 “首次配置电脑.cmd”，等待软件准备结果。此时不需要连接手机。
  3. 系统询问是否允许安装时点“是”。工具自动安装 Apple 驱动并启动连接服务；等待显示“电脑准备完成”。提示重启时，重启后再次配置。
  4. 双击 “启动控制台.cmd”。按打开的页面完成电脑准备，然后连接手机。
自动安装内容与日志

入口调用 01_setup_windows.cmd，准备或复用 CPython 3.13 x64、独立依赖环境和手机连接组件。缺少 Python 时使用官方固定版本 3.13.16。依赖使用预编译包并核对 SHA256，无需在使用者电脑上安装 C++ 编译工具。

Python 安装目录为 %LOCALAPPDATA%\Programs\InstagramUSB\Python313，依赖环境为 work\usb-control\venv。不修改 PATH 或文件关联；Python 注册可能影响已有 py 启动器的自动默认选择。

首次配置会从 Apple 和微软官方源获取连接组件，自动安装 USB 驱动、设置并启动 Apple 连接服务，再验证 Apple 连接服务的本地通信。任何一步未通过都不会显示准备完成；服务停止后再次运行配置可恢复。电脑通过不代表手机已通过检查。安装日志在 work\service\computer-setup\，结果在 work\service\computer-setup.json。

之前安装失败时，重新下载 2.4.0，完整解压到新文件夹，再双击“首次配置电脑.cmd”。原目录的任务数据保留，需要沿用时按迁移步骤处理。当前手机系统范围为 iOS 17.4+；iOS 17.0–17.3 的 Windows tunneld 路线未适配。

Mac 首次配置

  1. 完整解压安装包，准备 Python 3.13。
  2. 在安装目录按顺序运行以下命令，进入应用目录后执行环境检查，等待检查通过。
  3. 双击根目录 “启动控制台.command”，按页面提示完成电脑准备。
python3 -m venv work/usb-control/venv
work/usb-control/venv/bin/python -m pip install pymobiledevice3==11.29.0
cd outputs/instagram-control
../../work/usb-control/venv/bin/python -B -m tools.check_environment --offline

电脑软件检查不操作手机。接入网址需要的连接配置见下一节；仅在本机使用时按电脑页的本地使用入口操作。

手机接入

交付前由负责人确认每台手机都已获得组件授权。当前正式组件采用付费签名，覆盖两台已登记的测试手机；须在北京时间 2027-10-15 23:18:15 前完成续签。其他手机需要先登记授权。已有手机是否采用新组件由负责人确认；完成授权并在目标 Windows 电脑实测后再交付。

  1. 连接并解锁手机，在手机上确认“信任”；需要开发者模式时，按页面提示在手机上确认。
  2. 用 USB 连接电脑，在手机上解锁并信任电脑，完成 Instagram 登录。
  3. 在工作台选择手机，点击“准备手机”，工具自动下载适用组件、安装并验证连接；随后确认账号。

显示“等待负责人准备”表示该手机授权尚未完成或已到期，负责人处理后再次准备即可，无需同事配置 Xcode。每台手机分别处理，不阻断其他已就绪手机。

远程访问与连接故障

每个工作台管理连接到对应电脑的手机。本机可使用 http://127.0.0.1:18765/；远程访问地址由负责人配置。

  1. 在接手机的电脑双击“启动控制台”，查看电脑页的具体提示。
  2. 需要远程访问时，负责人配置 OpenSSH、SSH 身份和主机别名，在电脑设置中填写网址与远端端口。仅本机使用无需此步骤。
  3. 修正原因后重新检查连接。恢复后核对原任务，不重复导入目标。
启动时自动连接

新配置默认使用本机，不要求连接公网。需要每次启动时连接远程网址，保存配置时勾选“启动时自动连接远程网址”；只点“检查远程连接”只尝试本次连接。

新配置的 SSH 主机默认是 xinruo-001，由负责人完成 SSH 身份和别名准备。升级会保留已保存的主机与连接行为，不会自动迁移旧服务器；迁移时由负责人更新电脑设置和系统通道，同事仍使用日常启动入口。远程连接失败时按提示处理，不影响已满足条件的本机使用。

多个电脑与现有公共入口

可分别配置多台电脑，任务和证据保存在各自电脑上。当前 instagram.xfyccm.cn 转发到一个已配置的工作台，不会自动聚合其他电脑。

新增远程工作台需要独立的接入端口和入口配置，不能让两个实例争用同一个远端端口。配置另一个电脑不需要停用无关电脑上的任务。

当前入口由 xinruo-001 的 Caddy 转发至 127.0.0.1:18766；安装教程和下载由 127.0.0.1:18764 独立提供。详细运维步骤见仓库 deploy/云部署维护.txt。

连接日志与常见原因

电脑配置：work/service/workstation-config.json；最近连接结果：work/service/workstation-status.json；软件检查：work/service/workstation-environment.json；服务日志：work/service/console.log。

检查电脑是否开机、唤醒并联网；再按实际错误检查 SSH 身份、主机别名、端口占用及网址对应关系。连接页面打开不等于手机已就绪；状态须以对应检查结果为准。

更新工作台

2.4.0 是唯一安装基线。首次使用或之前安装失败时，将 2.4.0 完整解压到新目录并完成首次配置。已完成 2.4.0 安装的工作台，后续发布的 2.4.1 等版本按以下流程通过网页更新。

  1. 下载新版 ZIP，在工作台“更新”中选择文件，点击“检查并暂存更新”。
  2. 停止执行并等待设备空闲，点击“应用更新并重启”。
  3. 等待网页重新连接，核对版本和记录，再按需要继续任务。

远程网页更新的是该网址对应的电脑。当前更新方式是手动选择发行包；不会自动发现新版本。

保留内容与恢复

更新保留 work 内的任务、配置和证据，源码与数据库备份在 work/fleet/updates/backups。ZIP 不更新 Python 或 Apple 驱动；依赖有变化时重新运行首次配置。

安装后无法启动时查看 work/service/console.log，由负责人恢复源码备份。不要用旧数据库覆盖当前记录。辅助 API Key 只保存在内存，服务重启后需重新填写。

迁移某个工作台

  1. 在要迁移的旧工作台停止执行，等待操作结束，退出服务后备份完整 work/fleet。
  2. 新电脑完成软件和手机准备，迁移需要的记录；核对手机、账号和历史任务。
  3. 若要沿用原网址，先停止旧接入通道，再让新电脑使用该入口；核对网址与新电脑显示同一份记录。
  4. 最后按需开启执行，暂停或中断的任务分别处理。

迁移只针对选定工作台。其他电脑可以继续独立运行；不同电脑的数据库不会自动合并。

部署验证范围

2.4.0 是当前源码交付基线。自动测试与本地更新验证不等于 Windows 真机验收；Windows 接实体 iPhone 从未验收过。软件安装与浏览器下载按发布记录单独核验；接实体手机后须另外完成仅验证检查。

目标 Windows 验收顺序
  1. 不接手机，验证首次配置、软件检查和 Apple 服务的分项结果。
  2. 验证启动、页面访问、独立运行和所需的远程连接。
  3. 逐台接手机，检查 USB、WDA、登录账号与截图。
  4. 使用“仅验证，不点击关注”检查任务、暂停、停止、断线恢复及多手机互不阻断。
  5. 设备空闲后验证网页更新、记录保留和更新后的执行状态。

每一步保留实际结果；未完成或失败项单独记录，不用离线回归代替真机结果。

依赖官方资料

Python 3.13.16 · Windows 安装参数 · 设备库安装 · iOS 隧道范围