返回博客
2026 年 5 月 8 日

Redock 设置指南:连接你的 Mac、VPS 或开发服务器

先在同一 Wi-Fi 下跑通,再根据需要使用 Tailscale、ngrok 或加固后的公网主机。

理解 Redock 最快的方式,是把它连接到一台你已经用于开发的真实机器。建议从最少配置的路径开始:让 iPhone 或 iPad 与 Mac 连接同一个 Wi-Fi。这个第一次连接会让你理解 Redock 的几个关键点:它如何连接主机,手机终端如何使用,Project 和 Action 如何减少重复输入,以及为什么 tmux 对移动开发很重要。

简短答案是:先在开发机器上开启 SSH,用 Redock 连上它,把常用项目目录保存成 Project,为 agent 启动、测试、构建、日志等命令创建 Action,再开启 tmux 让会话可恢复。Claude Code、Codex、OpenCode、Git、Node、Python、Rust、包管理器和构建工具都应该安装在远程主机上。Redock 做的是手机端的工作台。

先在同一网络下跑通

在 macOS 的系统设置里打开 Remote Login,也就是标准 SSH 服务。然后在 Redock 添加 Host。如果本地发现能找到你的 Mac,就使用预填地址和端口;如果没有发现,手动填写 Mac 的局域网地址,通常类似 192.168.x.x,端口是 22

第一次测试可以先用密码认证。连接跑通后,长期使用建议换成 SSH Key。Key 更适合日常反复连接,也能避免在手机上频繁输入系统密码。

排查问题时,先确认这些基础项:

  • Mac 和 iPhone 是否在同一个 Wi-Fi。
  • Remote Login 是否允许当前开发账号登录。
  • Host 是否是手机能访问到的 IP 或 hostname。
  • Port 是否为 22,除非你明确改过 SSH 端口。
  • Username 是否是 macOS 账号名,而不是显示昵称。

如果同一 Wi-Fi 下 SSH 都没有跑通,Tailscale 或 ngrok 通常也不会直接解决问题。先把最简单路径跑通。

创建第一个有用的 Project

终端打开后,进入项目目录,并运行远程主机上已经安装好的工具:

cd ~/Projects/your-project
git status
codex

这一步之后,Redock 就不只是一个保存的 SSH 连接。把工作目录保存成 Project,这样每次回到手机时,不需要重新记路径、命令和上下文。

一个有用的 Project 通常包含:

  • 一个 Host,例如 Home MacVPS Prod
  • 一个工作目录,例如 ~/Projects/redock
  • 一组和这个项目相关的 snippets。
  • 一个启动 agent 的 Action。
  • 一个运行常用验证命令的 Action。

目标很简单:当你在沙发上、地铁上、临时离开电脑时,打开 Redock 后应该尽快回到工作现场,而不是先回忆路径和命令。

为重复命令创建 Action

Action 适合保存任何高频命令,或者任何在手机上输入起来很烦的命令。开始时不需要把所有流程都配置进去,先保存最常用的几个。

Action 示例命令 推荐模式
启动 agent codexclaude --resume Terminal Interactive
查看 Git git status --short Quick Task
运行测试 npm testpnpm test Quick Task 或 Background Long Task
查看日志 tail -f logs/app.log Terminal Interactive
构建项目 npm run build Background Long Task

需要持续交互的命令适合 Terminal Interactive,AI coding agent 通常属于这一类。执行一次并产出结果的命令适合 Quick Task。可能跑很久、希望手机断开后继续执行的命令适合 Background Long Task

这种区分对手机很重要。电脑上可以临时发挥,手机上则需要更明确的入口,才能降低操作成本。

开启 tmux 以便恢复

如果远程主机安装了 tmux,可以在 Host 设置里开启 Redock tmux。Redock 会提供创建、附着和恢复会话的入口,不需要每次手动输入 tmux newtmux attach

这对移动端非常关键。网络会切换,App 会进入后台,长时间 agent run 也可能跑很久。tmux 能让远程会话在手机断开后继续运行。

一个实用布局是:

  • 一个 pane 跑 Claude Code、Codex、OpenCode 或 shell。
  • 一个 pane 跑测试、日志或 Git diff。
  • session 名称和 Project 或任务相关。
  • 构建、迁移、长测试使用后台 Action。

tmux 需要安装在远程主机上。Redock 不负责替你安装 tmux,但只要主机上有 tmux,Redock 就能把它接入移动工作流。

让连接可以跨网络使用

同一 Wi-Fi 下 SSH 跑通后,再选择稳定的远程访问方式。

Tailscale 是很多开发者日常使用的推荐方案,因为它让手机和开发机器处在一个私有网络里,不需要把 SSH 直接暴露到公网。在 Redock 里可以填写 Tailscale IP,也可以使用 MagicDNS 名称。

ngrok TCP 适合临时访问没有公网 IP 的机器。它本质上会创建一个公网入口,因此要使用强认证,用完关闭 tunnel,不要在不了解安全边界的情况下把它当作长期生产路径。

VPS 或公网主机适合服务端项目、个人自动化、长期运行任务,前提是你能控制 SSH Key、用户权限、防火墙和系统加固。

第一次连接后应该配置什么

连接成功后,不要急着配置几十个命令。优先添加真正能减少手机操作摩擦的内容:

  • 保存常用工作目录。
  • 保存 agent 启动、测试、构建、部署检查和日志命令。
  • 使用待输入区组织较长 prompt,再发送到终端。
  • 尝试语音输入,转写后先检查再发送。
  • 开启 tmux,让长任务不依赖手机一直在线。
  • LAN、Tailscale、ngrok 建成不同 Host,不要反复编辑同一个 Host。

当这些能力组合起来后,Redock 就不再只是远程访问工具,而是围绕真实开发周期组织起来的移动工作台。

快速结论

要用 Redock 在手机上进行 AI coding,先在 Mac、VPS 或开发服务器上开启 SSH;在同一 Wi-Fi 下连接成功后,把项目目录保存成 Project,为 agent 和验证命令创建 Action,再为 Host 开启 tmux。等本地链路稳定后,日常跨网络访问优先使用 Tailscale,临时访问可以使用 ngrok TCP。

在 iPhone 或 iPad 上试试 Redock

用手机控制 Coding Agent,随时进行开发

免费获取 Redock