開發者

快速上手：從註冊到第一臺雲主機

雲主機用標準的 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