入门指南

欢迎使用 LndevCloud 云服务平台。本文档将帮助您快速开始使用我们的服务。

创建账户

要开始使用 LndevCloud，首先需要创建一个账户：

1. 访问 注册页面
2. 输入您的邮箱地址和设置密码
3. 验证您的邮箱地址
4. 完成账户设置

创建第一台云服务器

登录控制台后，按照以下步骤创建云服务器：

步骤1：选择区域

选择离您的用户最近的数据中心区域，以获得最佳性能。

步骤2：选择镜像

LndevCloud 提供多种操作系统镜像：

• Ubuntu - 20.04 LTS, 22.04 LTS
• CentOS - 7, 8 Stream
• Debian - 10, 11
• Windows Server - 2019, 2022
• 自定义镜像 - 支持上传自定义镜像

步骤3：选择配置

根据您的需求选择合适的资源配置：

步骤4：配置网络

配置服务器的网络设置：

• 公网IP：选择是否分配公网IP地址
• 带宽：选择公网带宽大小（1Mbps-100Mbps）
• 安全组：配置防火墙规则

步骤5：创建服务器

确认配置信息，点击"创建服务器"按钮。服务器将在1-3分钟内创建完成。

连接到服务器

服务器创建完成后，您可以通过以下方式连接：

Linux服务器

使用SSH连接到Linux服务器：

# 使用密码登录
ssh root@服务器IP地址

# 使用密钥登录
ssh -i 密钥文件路径 root@服务器IP地址

Windows服务器

使用RDP连接到Windows服务器：

1. 下载RDP文件从控制台
2. 使用远程桌面连接工具打开RDP文件
3. 输入用户名和密码登录

下一步

现在您已经成功创建并连接到服务器，接下来可以：

• 学习如何管理服务器
• 配置自动备份
• 了解API使用方法
• 部署您的第一个应用

服务器管理

了解如何管理和维护您的云服务器。

服务器状态管理

您可以在控制台中对服务器执行以下操作：

• 启动：启动已停止的服务器
• 停止：正常关闭服务器
• 重启：重启服务器
• 强制重启：强制重启无响应的服务器
• 重置密码：重置服务器登录密码
• 重装系统：重新安装操作系统

服务器配置变更

LndevCloud 支持在线调整服务器配置：

升级配置

升级CPU、内存、存储等配置：

1. 在控制台选择要升级的服务器
2. 点击"升级配置"
3. 选择新的配置规格
4. 确认升级（服务器将自动重启）

降级配置

降级配置需要在当前计费周期结束后生效：

1. 在控制台选择要降级的服务器
2. 点击"降级配置"
3. 选择新的配置规格
4. 确认降级（下个计费周期生效）

使用API管理服务器

您可以使用LndevCloud API管理服务器：

列出所有服务器

// 使用JavaScript SDK
const LndevCloud = require('lndevcloud-sdk');

const client = new LndevCloud({
  apiKey: '您的API密钥',
  apiSecret: '您的API密钥'
});

// 获取服务器列表
client.servers.list()
  .then(servers => {
    console.log('服务器列表:', servers);
  })
  .catch(error => {
    console.error('获取服务器列表失败:', error);
  });

创建服务器

# 使用Python SDK
from lndevcloud import LndevCloud

client = LndevCloud(api_key="您的API密钥", api_secret="您的API密钥")

# 创建服务器参数
server_params = {
    "name": "my-server",
    "region": "cn-east-1",
    "image": "ubuntu-22.04",
    "size": "s1.small",
    "ssh_keys": ["my-ssh-key-id"]
}

# 创建服务器
server = client.servers.create(**server_params)
print(f"服务器创建成功，ID: {server.id}")

管理服务器状态

# 使用命令行工具
# 启动服务器
lndevcloud server start server-id

# 停止服务器
lndevcloud server stop server-id

# 重启服务器
lndevcloud server reboot server-id

# 删除服务器
lndevcloud server delete server-id

API参考

LndevCloud 提供完整的RESTful API，用于以编程方式管理云资源。

API基础

API端点

所有API请求都发送到以下基础URL：

https://api.lndevcloud.com/v1

请求格式

API支持JSON请求和响应格式：

GET /v1/servers HTTP/1.1
Host: api.lndevcloud.com
Authorization: Bearer your-api-token
Content-Type: application/json
Accept: application/json

响应格式

所有API响应都遵循以下格式：

{
  "success": true,
  "data": {
    // 实际数据
  },
  "pagination": {
    "total": 100,
    "page": 1,
    "per_page": 20
  },
  "error": null
}

身份验证

LndevCloud API使用Bearer Token进行身份验证：

获取API Token

1. 登录控制台
2. 进入"API管理"页面
3. 点击"创建API Token"
4. 复制生成的Token

使用API Token

在所有API请求的Header中包含Token：

Authorization: Bearer your-api-token-here

服务器API

获取服务器列表

GET /v1/servers

查询参数

响应示例

{
  "success": true,
  "data": [
    {
      "id": "server-123456",
      "name": "my-web-server",
      "status": "active",
      "region": "cn-east-1",
      "image": "ubuntu-22.04",
      "size": "s1.medium",
      "cpu": 2,
      "memory": 4096,
      "disk": 100,
      "ip_address": "192.168.1.100",
      "created_at": "2023-06-15T10:30:00Z",
      "updated_at": "2023-06-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "per_page": 20
  }
}

创建服务器

POST /v1/servers

请求体

{
  "name": "my-new-server",
  "region": "cn-east-1",
  "image": "ubuntu-22.04",
  "size": "s1.small",
  "ssh_keys": ["ssh-key-id-1"],
  "backups": false,
  "ipv6": true,
  "user_data": "#cloud-config\nruncmd:\n  - [sh, -c, 'echo Hello World']"
}

错误处理

API错误返回标准HTTP状态码和错误信息：

常见错误码

错误响应示例

{
  "success": false,
  "data": null,
  "error": {
    "code": "invalid_request",
    "message": "Missing required parameter: region",
    "details": {
      "field": "region",
      "requirement": "required"
    }
  }
}

命令行工具

LndevCloud CLI 是一个命令行工具，用于管理您的云资源。

安装

macOS / Linux

# 使用Homebrew (macOS)
brew install lndevcloud/tap/lndevcloud

# 使用安装脚本
curl -fsSL https://cli.lndevcloud.com/install.sh | sh

Windows

# 使用Scoop
scoop bucket add lndevcloud https://github.com/lndevcloud/scoop-bucket
scoop install lndevcloud

# 或下载可执行文件
# 从 https://cli.lndevcloud.com/windows/lndevcloud.exe 下载

配置

首次使用需要配置API Token：

lndevcloud auth login
# 按照提示输入API Token

验证配置：

lndevcloud auth status

常用命令

服务器管理

# 列出所有服务器
lndevcloud server list

# 创建服务器
lndevcloud server create \
  --name my-server \
  --region cn-east-1 \
  --image ubuntu-22.04 \
  --size s1.small

# 查看服务器详情
lndevcloud server get server-id

# 执行服务器操作
lndevcloud server start server-id
lndevcloud server stop server-id
lndevcloud server reboot server-id
lndevcloud server delete server-id

存储管理

# 列出存储桶
lndevcloud storage bucket list

# 创建存储桶
lndevcloud storage bucket create my-bucket --region cn-east-1

# 上传文件
lndevcloud storage object put my-bucket /path/to/file

# 下载文件
lndevcloud storage object get my-bucket/file.txt /local/path/

网络管理

# 查看防火墙规则
lndevcloud firewall list

# 添加防火墙规则
lndevcloud firewall add-rule \
  --name ssh-access \
  --protocol tcp \
  --port 22 \
  --source 0.0.0.0/0 \
  --action allow

# 查看负载均衡器
lndevcloud loadbalancer list

使用脚本

CLI可以与Shell脚本结合使用，实现自动化管理：

#!/bin/bash
# 自动创建服务器并配置

set -e

# 创建服务器
SERVER_ID=$(lndevcloud server create \
  --name auto-created-server \
  --region cn-east-1 \
  --image ubuntu-22.04 \
  --size s1.small \
  --output json | jq -r '.id')

echo "服务器创建成功: $SERVER_ID"

# 等待服务器就绪
sleep 30

# 获取服务器IP
SERVER_IP=$(lndevcloud server get $SERVER_ID --output json | jq -r '.ip_address')

echo "服务器IP地址: $SERVER_IP"

# 添加防火墙规则
lndevcloud firewall add-rule \
  --server $SERVER_ID \
  --name ssh \
  --protocol tcp \
  --port 22 \
  --source 0.0.0.0/0 \
  --action allow

echo "防火墙规则已添加"

# 完成
echo "服务器配置完成，可以通过SSH连接: ssh root@$SERVER_IP"