技能简介
Perry Workspaces 用于在 Tailscale 私有网络中创建和管理隔离的 Docker 工作区,预装 Claude Code 和 OpenCode 代码代理,支持通过 SSH 直接连接远程开发环境。
业务背景
Perry隔离工作区为开发团队提供安全可控的远程开发环境。通过Tailscale私有网络一键创建隔离Docker容器,预装Claude Code与OpenCode代码代理,开发者无需配置本地环境即可通过SSH直达标准化开发空间,既保障代码资产安全,又实现开发环境快速就绪与统一管控。
落地案例:某后端工程师需紧急排查生产问题,在本地电脑执行perry create bugfix-2024 –repo=company/api-service,系统自动在Tailscale网络中拉起隔离容器并克隆代码仓库。工程师通过perry shell bugfix-2024进入环境,直接调用claude分析日志,同时浏览器访问:4096端口使用OpenCode Web界面比对版本差异,全程数据不落地本地,排查完毕后执行perry delete清理现场。
能做什么
- 一键创建带 Git 仓库克隆的隔离容器工作区
- 通过 SSH 或交互式 Shell 访问远程开发环境
- 内置 OpenCode Web UI 和 Claude Code 命令行工具
- 列出、停止、删除工作区进行生命周期管理
使用说明
安装前提:需已安装 Docker 和 Tailscale,并加入同一 tailnet。
基础命令:
# 创建工作区(自动克隆仓库)
perry start myproject --clone git@github.com:user/repo.git
# 查看所有工作区
perry ls
# 进入交互式 Shell
perry shell myproject
# 停止或删除
perry stop myproject
perry remove myproject
SSH 连接:用户固定为 workspace,主机名或 IP 均可
ssh workspace@myproject
ssh workspace@100.x.x.x
访问代码代理:
- OpenCode:浏览器打开
http://<workspace>:4096 - Claude Code:先执行
perry shell <name>,再运行claude
注意:项目实际位于 ~/<name> 而非 /workspace
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | 工作区名称(必填)、Git 仓库地址(–clone 可选)、Tailscale tailnet 成员身份 |
| 输出 | 隔离 Docker 容器、SSH 服务端点、OpenCode Web 服务(端口 4096)、Claude Code CLI 环境 |
| 适用人群 | 远程开发工程师、DevOps 人员、Tailscale 用户、需要快速启动预配置开发环境者 |
| 不包含 | 本地 IDE 插件集成、图形桌面环境、自动数据备份、多用户权限系统 |
风险提示
- SSH 登录用户名必须为
workspace,使用本地用户名会导致认证失败 - MagicDNS 解析异常时需改用 IP 地址连接
- 容器启动较慢时可观察 OpenCode Web UI 进度指示
- 工作区完全隔离,宿主机文件需通过 Git 或卷映射交换
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/gricha/perry-workspaces/SKILL.md
来源类型:GitHub 开源技能
常见问题
Q1:Perry隔离工作区 适合哪些场景?
A:适合需要「Perry Workspaces 用于在 Tailscale 私有网络中」的场景,尤其是希望快速验证并落地的团队与个人。
Q2:第一次使用应该先做什么?
A:先明确目标任务,再按照页面中的“能做什么”和“使用说明”完成最小可行流程。
Q3:如何判断是否值得长期使用?
A:建议连续使用 1-2 周,对比效率、稳定性和协作成本,再决定是否纳入长期工具栈。
