跳转至正文
ColliePWA

01/Documentation

五分钟完成安装

推荐配置逐步说明：在电脑上安装 Tailscale、Herdr 和 Collie，然后将手机配对，并把 Collie 添加到手机主屏幕

本指南介绍如何在手机上配置 Collie。在电脑上安装三个工具，启动 Collie，然后配对手机。

指南采用推荐配置：以 Tailscale 作为入口，Herdr 作为多路复用器，并使用安装脚本。其他配置方式请参见 安装。

注意。 Collie 的设计使其具备对机器的远程 shell 访问权限。安装前请阅读 安全性。

准备工作

  • 一台 Linux 或 macOS 电脑（宿主机）。Mac 需要 Apple Silicon 芯片以及 macOS 13 或更高版本。
  • 一部 iPhone 或 Android 手机。
  • 一个 Tailscale 账号。

1. 安装 Tailscale

Tailscale 通过专属私有网络（即 tailnet）连接宿主机和手机。Collie 仅可在此网络中访问。

在 Linux 宿主机上：

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --operator=$USER

--operator=$USER 允许当前用户运行 tailscale serve，Collie 在步骤 4 中需要该权限。

在 Mac 上，从 tailscale.com/download 安装 Tailscale 并登录。在应用设置中安装 tailscale 命令。Collie 需要调用该命令。

接下来，配置 tailnet 和手机：

  1. 打开 admin console 并选择 启用 HTTPS。Collie 必须依赖该选项。
  2. 在手机上安装 Tailscale 应用。使用相同账号登录。

2. 安装 Herdr

断开连接后，Herdr 仍可在宿主机上保持终端窗格和编码 agent 继续运行。Collie 会在手机上显示这些窗格。

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr

Herdr 会打开一个窗格。在其中启动 agent，例如 claude。保持 Herdr 运行。

3. 安装 Collie

在宿主机上打开第二个终端，运行安装脚本：

curl -fsSL https://colliepwa.dev/install.sh | sh

脚本会将 collie 二进制文件保存到 ~/.local/bin。它不使用 sudo。如果 shell 找不到 collie，请将 ~/.local/bin 添加到 PATH 中。独立安装 介绍了详细信息。

4. 启动 Collie

COLLIE_MUX=herdr collie start

start 会在后台运行 Collie，并通过 tailscale serve 将其暴露在 tailnet 上。它会将 herdr 保存为多路复用器。以后运行时只需执行 collie start。就绪后，它会输出 Collie 正在运行 并在 tailnet 这一行显示访问 URL，例如 https://myhost.tail1234.ts.net。

如果通过 SSH 连接到远程 Linux 宿主机，请确保在登出后继续运行 Collie：

loginctl enable-linger $USER

5. 将 Collie 添加到手机并进行配对

collie qr
  1. 用手机摄像头扫描二维码，在浏览器中打开 Collie。
  2. 将 Collie 添加到主屏幕，以便像应用一样全屏打开。- iPhone： 在 Safari 中，轻点 分享，轻点 添加到主屏幕，然后轻点 添加。- Android： 在 Chrome 中，打开 Collie 设置 并轻点顶部卡片上的 安装。
  3. 通过新图标打开 Collie。
  4. 在主机上运行 collie pair 以输出一个 8 位代码，有效期 10 分钟。
  5. 在 Collie 中，打开 设置 → 系统 → 已配对设备。
  6. 输入该代码和一个名称（例如 my phone），然后轻点 配对该设备。

请在主屏幕应用中配对，不要在浏览器标签页中配对。在 iPhone 上，主屏幕应用拥有独立于 Safari 的自身存储。在 Safari 中进行的配对不会继承过来。

只要配对了一台设备，就只有已配对的设备可以向窗格输入内容。在此之前，tailnet 上的任何设备都可以输入。请在 start 之后立即配对。在与他人共享的 tailnet 上，还需设置 COLLIE_TRUSTED_USER（配置）。

仪表盘列出了你的 Herdr 窗格。等待输入的窗格排在最前面。轻点窗格可查看输出并回复。

后续步骤

在 GitHub 上编辑本页

The rest of the documentation