开发者

快速上手：从注册到第一台云主机

云主机用标准的 CloudStack API 管理，命令行工具 cmk 和 Claude Code 都能直接用。

1. 注册并开通

   注册、验证邮箱、完成实名。审核通过后会开通云控制台账号，之后就可以充值。

   注册账户

2. 生成 API 密钥

   在账户页点「进入云控制台」，从右上角菜单进入个人资料，点「生成密钥」，会得到 API Key 和 Secret Key。

3. 安装并配置 cmk

   cmk（CloudMonkey）是 CloudStack 官方命令行工具。按你的系统下载后，指向软通云即可。密钥保存在你自己电脑的 ~/.cmk/config 里。

   # https://github.com/apache/cloudstack-cloudmonkey/releases
   cmk set url https://console.soft.cc/client/api
   cmk set apikey    <API Key>
   cmk set secretkey <Secret Key>
   cmk sync

4. 开第一台云主机

   先查区域、规格和镜像，再创建。费用按小时从余额扣除。要从外面 SSH 进去，在控制台给它配公网 IP 和端口转发规则。镜像只认 SSH 密钥；登录用户按镜像分别是 ubuntu、debian、rocky。

   cmk register sshkeypair name=me publickey="$(cat ~/.ssh/id_ed25519.pub)"
   cmk list zones filter=id,name
   cmk list serviceofferings filter=id,name,cpunumber,memory
   cmk list templates templatefilter=executable filter=id,name
   cmk deploy virtualmachine name=dev-01 keypair=me \
       zoneid=<zone> serviceofferingid=<offering> templateid=<template>
   # Ubuntu: ubuntu · Debian: debian · Rocky Linux: rocky
   ssh -p <port> ubuntu@<public IP>

5. 交给 Claude Code

   cmk 在你的终端里能用了，Claude Code 也就能用。在项目的 CLAUDE.md 里加几行说明，然后直接用自然语言说要做什么。

   # CLAUDE.md
   ## SOFT Cloud
   - Manage servers with `cmk` (CloudStack CLI, already configured).
   - Ask me before creating, resizing or deleting anything: it is billed hourly.
   - The database URL is in the DATABASE_URL environment variable.

   > 开一台 2 核 4 GB 的 Ubuntu 云主机，名字叫 dev-01，装好 Docker。

   不要把 Secret Key 贴进对话里，放在 cmk 配置或环境变量中。

6. 连接云数据库

   在「云数据库」页下单。运行后，详情页会显示连接串。只接受 TLS 加密连接。

   export DATABASE_URL='postgresql://app:<password>@<host>:<port>/app?sslmode=require'
   psql "$DATABASE_URL"

DISM /online /Get-CurrentEdition            # ServerStandardEval
# Datacenter: /Set-Edition:ServerDatacenter
DISM /online /Set-Edition:ServerStandard /ProductKey:XXXXX-XXXXX-XXXXX-XXXXX-XXXXX /AcceptEula
# restart (it restarts once more by itself), then:
slmgr /skms <your KMS>                     # only if you use your own KMS
slmgr /ato
slmgr /dlv                                  # License Status: Licensed