返回列表

博客

如何在 iPhone 上预览电脑的 localhost 网站:Tactic Portal 教程

从启动本地网站、连接电脑和确认端口,到在 iPhone 或 iPad 打开私有预览、选择性分享和停止访问,并按症状排查常见问题。

发布于 更新于 标签: 上手教程 / Portal / localhost
博客

继续查看该栏目下的产品与工程更新。

浏览此分类

开发服务器继续留在电脑上运行。这篇教程会先带你把一张不含敏感数据的测试页面接入 iPhone 或 iPad 的 Tactic Remote 进行私有预览,随后说明可选的分享步骤,以及如何安全地结束访问。

候选稿与证据范围:下方是 2026 年 10 月 29 日 iPhone 15、1.13 Build 45 和 Linux 1.13 测试主机的原始英文界面截图,来自真实设备操作,并非生成界面。它们不代表最终 Mac/Windows 安装包的重新验收。此前记录的本地检查验证了 HTTP 发现,没有创建新的外部分享。最终包的真机与断线恢复验收仍待完成。

开始前

手机或平板使用 Tactic Remote 1.13,电脑可选择 Mac 1.13 App、Windows 1.13 Preview,或 macOS/Linux 的 npm CLI 1.13.0(npx tacticremote@1.13.0)。Homebrew 公式也已提供 1.13.0。 下载对应 App,保持电脑处于唤醒状态,并按 连接指南 在 Tactic Remote 中完成配对连接。

请挑选一个不包含访问凭据、客户资料或管理后台的纯测试项目。你无需专门让 Agent 生成网站,也不需要为这次功能检查发起付费模型请求。

1. 在电脑上启动网站

运行项目原有的开发启动命令,并记下实际监听的端口号(当默认端口被占用时,前端框架可能会自动顺延切换端口)。启动后,请先确认电脑本地浏览器能够正常打开该页面——Portal 不会替你启动开发服务器。

如果你的电脑已经安装了 Python 3,也可以新建一个空白的测试文件夹,在里面保存一份不含敏感内容的 index.html,然后在这个文件夹内运行:

python3 -m http.server 5173 --bind 127.0.0.1

在电脑打开 http://localhost:5173。该命令会提供当前文件夹中的文件,因此不要在用户主目录或私有仓库根目录运行。Python 只用于这个可选示例;Node 项目可沿用已有服务器。历史截图使用 3000 端口,与此处示例的 5173 不同。

2. 连接电脑并选择项目

在手机 App 中选择正确电脑,确认它已连接。打开网站所属项目的对话,从对话菜单进入 Portal preview(网页预览)。连接电脑和发现网站是两个步骤;电脑离线时无法提供预览。

3. 核对端口

刷新正在运行的网站列表,优先查看标注属于当前项目的条目。如果显示 Project not verified(未验证项目),先对照开发服务器的端口,再决定是否选择。也可以使用 Enter a port manually(手动输入端口)。HTTP 服务选 HTTP,HTTPS 服务选 HTTPS。

iPhone 15 真机截图:localhost 3000 标为 Project not verified,下方提供手动输入端口选项。

10 月 29 日真机测试,英文界面。列表发现了 3000 端口,但未核实项目归属,不能把它当成自动推荐成功。

4. 打开并检查私有预览

选定已核对的目标,点 Open private preview(打开私有预览)。确认出现的是预期页面,而不是只要“连上了”就算成功。可切换预览宽度检查手机或桌面布局。电脑和开发服务器都要保持运行。

iPhone 15 真机私有预览显示 Your project, live 测试页面,内容由已连接的测试电脑提供。

测试网站已经通过 Portal 在 iPhone 中打开。这是真实主机提供的无敏感测试页面,不是客户项目。

5. 只在确实需要时分享

这一步是可选的。在 Preview settings(预览设置)中选择链接有效期,并阅读审核同意说明。同意后,分享页面、脚本和图片可发送给 OpenAI 审核;私有预览不进入这条分享审核链路。在支持地区,可再点 Create share link(创建分享链接)发起请求。持有链接的人不需要 Tactic 账号,就能访问已开放的网站及其配置服务。请用无敏感数据和较短有效期。

真机预览设置:一小时链接期限、OpenAI 内容审核同意开关,以及 Create share link 操作。
历史实测的审核同意界面。本次文章修订没有创建新分享或发起审核请求。

让指定访客打开链接并阅读访客说明,再决定是否继续。私有预览成功,不代表每个页面都能通过分享审核。只需要自己检查时,保持不分享即可。

6. 结束访问

Stop sharing(停止分享)撤销访客链接,私有预览可以继续;Stop preview(停止预览)结束整个预览。确认自己选的是哪一个,不要把关闭面板当成撤销分享。历史实测中,停止分享后,访客页面立即不可用,而私有预览继续运行。

iPhone 真机确认框:停止分享会立即移除访客访问,私有预览继续运行。
真实设备上的停止分享确认。原分享已失效,图中没有访问令牌。

按症状排查

现象先检查什么
没找到网站确认服务器已启动、电脑浏览器能打开;检查项目和实际端口,再刷新或手动输入。发现功能不会启动网站。
未验证项目自行核对端口。发现监听器不等于证明它属于当前项目。
预览不可用检查电脑连接和版本。账号总额:免费同时一个、Pro 最多五个;当前每台电脑最多两个,仍受账号总额限制。
本地 HTTPS 错误使用正确协议,以及对 localhost 有效且被电脑端运行环境信任的证书。不要关闭证书检查。
页面能打开,部分功能失败检查网站及本地后端是否运行。登录、实时流和框架行为可能不同;静态页成功不等于整个应用验收通过。
无法分享或审核拒绝检查地区、同意状态、电脑端版本和页面提示。不支持分享时保留私有预览,不要靠反复外发敏感内容排查。
链接过期、停止或连接中断确认电脑在线。1.13 的短暂恢复窗口不是保证;预览已结束时需重新建立,并仅在仍需分享时重新创建链接。

数据流与恢复限制见 Portal 如何工作;各平台当前版本与下载见 1.13 公告。

立即体验 Tactic Remote

用手机远程控制编程 Agent

连接 Mac、Windows 或 Linux 电脑上的 Claude Code、Codex 等 Agent,在 iPhone 或 iPad 上查看进展并发送下一条要求。