appgarden
通过SSH一键部署和管理远程服务器上的Web应用
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:appgarden。 它的用途是:通过SSH一键部署和管理远程服务器上的Web应用 完整的 Skill 内容见:https://321skill.com/skills/appgarden/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'将我的静态网站部署到服务器,源码在./dist,域名为mysite.example.com,用AppGarden实现',它会自动执行 `appgarden server add myserver --host 203.0.113.10 --ssh-user root --ssh-key ~/.ssh/id_rsa --domain example.com` 添加服务器,然后 `appgarden server init myserver` 初始化,最后 `appgarden deploy --name mysite --method static --source ./dist/ --url mysite.example.com` 完成部署,全程无需手动配置 nginx 或 Docker。
介绍
AppGarden 解决的是远程服务器上 Web 应用的全生命周期管理问题,包括部署、路由、TLS 证书和运行状态监控。它不需要在服务器上安装持久化守护进程,所有状态都编码在文件系统和配置文件中,操作通过 SSH 和 pyinfra 执行,安全且轻量。
使用方式非常简单:先通过 appgarden server add 添加服务器(支持直接指定 IP 或 Hetzner Cloud 动态创建),然后 appgarden server init 初始化服务器(自动安装 Docker 和 Caddy,可选启用防火墙、SSH 加固、fail2ban 等),最后用 appgarden deploy 部署应用。支持多种部署方式:静态站点、直接运行命令、Dockerfile、docker-compose,甚至自动检测 Node.js/Python/Go/Ruby/Rust 运行时并生成 Dockerfile。
适合运维工程师、后端开发者、全栈开发者以及需要快速将自己或团队的项目部署到自有服务器的个人开发者。尤其是那些希望摆脱 Heroku、Vercel 等平台限制,又想享受一键部署便利性的用户。
使用建议:提前配置好服务器的 DNS 通配符记录(如 *.apps.example.com),这样 AppGarden 部署的任何新子域名都会自动解析并获取 TLS 证书。注意 Cloudflare 的免费计划不支持代理通配符域名,需要将代理状态设为“仅 DNS”。另外,对于需要高可用集群或复杂微服务编排的场景,AppGarden 并不适合,它更适合单机部署或少量服务器。
核心特点
与传统 Capistrano、Fabric 或 Docker Compose 配合 nginx 的方式不同,AppGarden 无需在服务器上运行任何持久化守护进程,直接通过 SSH 和 pyinfra 操作,并且内置了 Caddy 自动获取 Let's Encrypt TLS 证书,同时支持静态站点、命令、Dockerfile、docker-compose 和自动检测运行时等多种部署方式,开箱即用。
注意事项
不适合需要水平扩展、集群编排或实时交互式管理的复杂微服务架构,它针对单机或少量服务器的 Web 应用部署场景设计。
常见问题
AppGarden 是否支持已有服务器,还是必须用 Hetzner Cloud 创建新服务器?
两种都支持:你可以通过 `--host` 直接指定现有服务器的 IP,也可以通过 `--hcloud-name` 和 `--hcloud-context` 让 AppGarden 自动在 Hetzner Cloud 上创建并初始化服务器。
部署后如何访问应用?需要手动配置 nginx 反向代理吗?
不需要。AppGarden 会自动安装 Caddy 作为反向代理和 TLS 证书管理器,你只需在部署时指定 `--url` 参数,Caddy 会自动为域名获取 TLS 证书并路由流量。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/appgarden/raw/index.md 读取 appgarden 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/appgarden/raw/index.md(查看排版版本)