ttyd-remote-terminal-wsl2

用途

该技能用于在 WSL2 中搭建可通过浏览器访问的远程终端。它安装 ttyd（网页终端模拟器），并配合 ngrok、Cloudflare Tunnel 或 Tailscale 建立加密隧道，使用户能在手机、平板或远程电脑上通过浏览器操作 WSL2 终端。

主要能力

• 在 WSL2 上安装并运行 ttyd。
• 配置安全认证，防止 CVE-2021-34182 所涉及的不安全默认权限问题。
• 建立加密隧道，支持 ngrok、Cloudflare Tunnel 或 Tailscale。
• 提供一键安装、启动、停止、状态查询脚本。
• 自动显示连接 URL 和登录凭据。
• 默认生成 16 位强密码，凭据保存在 ~/.ttyd/.env 并设置 600 权限。
• ttyd 默认仅绑定 127.0.0.1，不直接暴露到网络。
• 资源占用较轻，资料称内存占用小于 50MB。

使用方式

1. 安装：进入 ~/.claude/skills/ttyd-remote-terminal-wsl2/scripts，运行 ./install.sh，按提示安装 ttyd 并选择隧道服务。
2. 配置认证：运行 ./configure-auth.sh，生成或自定义密码。
3. 启动会话：运行 ./ttyd-start.sh，脚本会启动 ttyd 与隧道，并显示连接 URL 和凭据。
4. 连接：在任意浏览器打开显示的 URL，使用用户名和密码登录。
5. 停止会话：运行 ./ttyd-stop.sh。
6. 查看状态：运行 ./ttyd-status.sh，可查看运行状态、连接 URL、凭据、会话时长和资源占用。

隧道服务选择：

• ngrok：适合初学者，免费额度 1GB/月，URL 每次重启会变化。
• Cloudflare Tunnel：适合生产，免费不限带宽，URL 持久。
• Tailscale：适合私有访问，不暴露公网，需要连接设备也安装 Tailscale。

适用场景

• 离开电脑时需要在 WSL2 上运行命令。
• 想从手机或平板访问终端。
• 需要快速远程访问，而不想配置完整 IDE。
• 偶尔的远程终端访问，而非永久 SSH 方案。

限制

• 仅适用于 WSL2，不适用于非 WSL2 的 Linux。
• 不适合需要完整 IDE 功能的场景，资料建议改用 code-server-remote-ide-wsl2。
• 不适合需要永久生产级远程访问的场景，资料建议考虑专用 SSH 方案。
• ngrok 免费版有 1GB/月流量限制，且 URL 会变化。
• Tailscale 需要连接设备也安装 Tailscale。
• 若 WSL2 系统本身被攻破，终端访问也会受影响。
• 若在终端中运行恶意代码，不在防护范围内。
• 社会工程、浏览器漏洞等不在防护范围内。
• 资料未提供具体价格、付费方案细节或性能保证。