Clawdship — 代理原生托管

通过一条命令将静态站点和 Docker 应用部署到 clawdship.dev。无需注册、无需控制面板、无需信用卡。

快速部署

bash

打包并部署（零注册 — 自动创建账户）

bash {baseDir}/deploy.sh my-app ./dist

使用现有 API 密钥

bash {baseDir}/deploy.sh my-app ./dist cshipYOURKEY

或通过环境变量

CLAWDSHIPAPIKEY=cshipYOURKEY bash {baseDir}/deploy.sh my-app ./dist

该脚本会返回一个实时 URL、一个 API 密钥（仅首次部署）以及一个账单链接。

⚠️ 请立即保存 API 密钥 — 密钥无法恢复。请使用密码管理器或加密存储。

首次部署流程

1. 1. 您将获得一个实时 URL：https://my-app.clawdship.dev
2. 您将获得一个 API 密钥：cship_...（请保存！）
3. 您将获得一个账单 URL：与用户分享以完成支付
4. 站点享有 7 天免费试用期，之后每月 $5

⚠️ 务必告知用户试用期

部署后，您必须告知用户：

您的站点已上线，访问地址为 https://my-app.clawdship.dev 🚀
该站点享有 7 天免费试用期。试用期结束后，每月 $5。
请在此处添加信用额度：{billingUrl}

切勿让用户误以为永久免费。

API 参考

基础 URL： https://api.clawdship.dev/v1
认证： Authorization: Bearer cship_...

部署静态站点（脚本替代方案）

bash
tar czf /tmp/archive.tar.gz -C ./dist .
curl -s -X POST https://api.clawdship.dev/v1/sites \
-F name=my-app -F type=static -F slug=my-app \
-F archive=@/tmp/archive.tar.gz

部署 Docker 应用

在归档文件中包含 Dockerfile。Clawdship 会自动构建并运行它。

bash
tar czf /tmp/archive.tar.gz -C ./my-project .
curl -s -X POST https://api.clawdship.dev/v1/sites \
-H Authorization: Bearer $CLAWDSHIPAPIKEY \
-F name=my-api -F type=docker -F slug=my-api -F port=3000 \
-F archive=@/tmp/archive.tar.gz

• - type: docker — 从 Dockerfile 构建
• port — 应用监听的端口（默认：3000）
• 环境变量：在请求中传递 -F envVars[KEY]=value

管理站点

bash

列出站点

curl -s -H Authorization: Bearer $CLAWDSHIPAPIKEY https://api.clawdship.dev/v1/sites

获取站点详情

curl -s -H Authorization: Bearer $CLAWDSHIPAPIKEY https://api.clawdship.dev/v1/sites/SITE_ID

重新部署

curl -s -X POST -H Authorization: Bearer $CLAWDSHIPAPIKEY https://api.clawdship.dev/v1/sites/SITE_ID/redeploy

删除

curl -s -X DELETE -H Authorization: Bearer $CLAWDSHIPAPIKEY https://api.clawdship.dev/v1/sites/SITE_ID

检查信用额度

curl -s -H Authorization: Bearer $CLAWDSHIPAPIKEY https://api.clawdship.dev/v1/credits

自定义域名

先配置 DNS，然后添加域名：

• - 子域名： CNAME www.example.com → my-app.clawdship.dev
• 根域名： A 记录 example.com → 135.125.179.231

bash
curl -s -X PATCH https://api.clawdship.dev/v1/sites/SITE_ID \
-H Authorization: Bearer $CLAWDSHIPAPIKEY \
-H Content-Type: application/json \
-d {customDomain: example.com}

SSL 通过 Lets Encrypt 自动配置（约 30 秒）。

使用新文件重新部署

bash
tar czf /tmp/archive.tar.gz -C ./dist .
curl -s -X POST https://api.clawdship.dev/v1/sites/SITE_ID/redeploy \
-H Authorization: Bearer $CLAWDSHIPAPIKEY \
-F archive=@/tmp/archive.tar.gz

支付

面向代理（x402 协议）

bash

充值信用额度 — 返回 402 状态码及 x402 支付指令

curl -X POST -H Authorization: Bearer $CLAWDSHIPAPIKEY \
https://api.clawdship.dev/v1/credits/topup/5

金额：$5、$10、$20、$50

需要：兼容 x402 的 SDK + Base 链上的 USDC（链 ID 8453）

您的 x402 SDK 会自动处理 402 响应。零 Gas 费用（由平台赞助）。

面向用户（账单页面）

每个 API 响应都包含 billingUrl。分享该链接 — 用户连接钱包并使用 Base 链上的 USDC 支付。

定价

试用期	首个站点免费 7 天
月费

每个站点每月 $5 | | 支付方式 | Base 链上的 USDC |

核心概念

• - 零注册 — 无需注册。首次部署即创建您的账户。
• API 密钥 — cship_ + 64 位十六进制字符。您的唯一凭证。无法恢复。
• billingUrl — 每个响应中的魔法链接。与用户分享以完成支付。
• 信用额度 — 预付费的美元余额。通过 x402（代理）或账单页面（用户）充值。