Perry Workspaces

🐳 Tailscale 隔离开发空间一键部署

基于 Tailscale 网络的隔离式 Docker 工作空间,预装 Claude Code 与 OpenCode,实现安全远程开发环境快速部署。

收藏
6.9k
安装
2.6k
版本
1.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Perry Workspaces 是一套基于 Tailscale 私有网络的容器化远程开发方案。用户通过简单 CLI 命令即可在 tailnet 内创建完全隔离的 Docker 工作空间,自动完成网络穿透与安全组网。

主要命令:

  • perry start <name> --clone <repo>:一键创建并克隆代码仓库
  • perry ls/stop/remove:生命周期管理
  • perry shell <name>:交互式进入容器

访问方式:

  • SSH 直连:ssh workspace@<name>(固定用户名为 workspace)
  • OpenCode Web UI:http://<workspace>:4096
  • Claude Code:进入 shell 后直接运行 claude 命令

显著优点

1. 网络零配置:依托 Tailscale 实现自动 NAT 穿透,无需公网 IP 或端口映射
2. 环境即代码:Docker 隔离确保开发环境一致性,避免"在我机器上能跑"

3. AI 原生集成:Claude Code 与 OpenCode 预装,开箱即用的 AI 辅助编程体验

4. 安全组网:tailnet 私有网络替代传统 VPN,基于 WireGuard 的加密通信

5. 资源轻量化:按需启停,适合个人开发者或小型团队协作

潜在缺点与局限性

  • 生态依赖:强制绑定 Tailscale,非 Tailscale 用户无法使用
  • 权限约束:SSH 用户名固定为 workspace,与本地用户习惯冲突易造成困惑
  • 路径陷阱:项目克隆至 ~/<name> 而非 /workspace,文档强调不足易引发操作失误
  • 诊断能力有限:故障排查主要依赖用户手动检查 tailscale status,缺乏内置诊断工具
  • 扩展性存疑:文档未说明多容器编排、持久化存储策略或资源限制配置

适合人群

  • 已使用 Tailscale 的个人开发者寻求远程开发方案
  • 需要快速隔离环境的 AI 编程工具用户(Claude Code/OpenCode)
  • 追求"零运维"网络配置的小型技术团队
  • 对本地机器性能有限,希望将重负载移至云端/服务器的开发者

常规风险

  • 密钥管理:克隆仓库需配置 SSH 密钥,存在密钥泄露或误传至容器风险
  • 网络单点:Tailscale 服务中断将直接导致工作空间不可达
  • 数据持久化:容器删除(perry remove)后数据丢失风险,需自行备份 ~/<name> 目录
  • MagicDNS 故障:文档提示需备援 IP 直连方案,说明 DNS 可靠性并非绝对
  • AI 工具安全:Claude Code 在容器内运行,需警惕其自动执行代码带来的潜在风险

Perry Workspaces 内容

暂无文件树

手动下载zip · 931 B
contentapplication/octet-stream
请选择文件