VPS.org API

Tài liệu API REST

API hệ điều hành

Truy xuất thông tin về các hệ điều hành và bản phân phối Linux khả dụng cho máy chủ VPS của bạn.

Điểm cuối 2 endpoints
Đường cơ sở /api/v1/operating-systems
LẤY /api/v1/operating-systems/

Liệt kê tất cả các hệ điều hành

Lấy danh sách tất cả các hệ điều hành có sẵn có thể cài đặt trên máy chủ VPS.

Tham số truy vấn

Tham số Kiểu Yêu cầu Mô tả
os_type string Không Filter by OS type: linux, windows
featured boolean Không Show only featured operating systems

Ví dụ về yêu cầu

cURL
Python
JavaScript
PHP
curl -X GET "https://admin.vps.org/api/v1/operating-systems/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/operating-systems/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/operating-systems/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const os = await response.json();
console.log(os);
$ch = curl_init('https://admin.vps.org/api/v1/operating-systems/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$operating_systems = json_decode($response, true);
curl_close($ch);

Ví dụ về câu trả lời

{
  "count": 12,
  "results": [
    {
      "id": 1,
      "name": "Ubuntu 22.04 LTS",
      "slug": "ubuntu-22-04",
      "version": "22.04",
      "os_type": "linux",
      "distribution": "Ubuntu",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Ubuntu 22.04 LTS (Jammy Jellyfish) - Long Term Support until 2027",
      "icon_url": "https://cdn.vps.org/os-icons/ubuntu.svg"
    },
    {
      "id": 2,
      "name": "Debian 12",
      "slug": "debian-12",
      "version": "12",
      "os_type": "linux",
      "distribution": "Debian",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Debian 12 (Bookworm) - Stable release",
      "icon_url": "https://cdn.vps.org/os-icons/debian.svg"
    },
    {
      "id": 3,
      "name": "CentOS Stream 9",
      "slug": "centos-stream-9",
      "version": "9",
      "os_type": "linux",
      "distribution": "CentOS",
      "architecture": "x86_64",
      "featured": false,
      "available": true,
      "min_disk_gb": 10,
      "description": "CentOS Stream 9 - Rolling release tracking RHEL development",
      "icon_url": "https://cdn.vps.org/os-icons/centos.svg"
    },
    {
      "id": 4,
      "name": "Fedora 39",
      "slug": "fedora-39",
      "version": "39",
      "os_type": "linux",
      "distribution": "Fedora",
      "architecture": "x86_64",
      "featured": false,
      "available": true,
      "min_disk_gb": 15,
      "description": "Fedora 39 - Cutting-edge Linux distribution",
      "icon_url": "https://cdn.vps.org/os-icons/fedora.svg"
    },
    {
      "id": 5,
      "name": "Rocky Linux 9",
      "slug": "rocky-linux-9",
      "version": "9",
      "os_type": "linux",
      "distribution": "Rocky Linux",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Rocky Linux 9 - Enterprise-grade Linux, RHEL compatible",
      "icon_url": "https://cdn.vps.org/os-icons/rocky.svg"
    }
  ]
}

Các trường phản hồi

Địa điểm Kiểu Mô tả
id integer Unique operating system identifier
name string Full operating system name with version
slug string URL-friendly OS identifier
version string OS version number
os_type string Operating system type: linux or windows
distribution string Distribution name (Ubuntu, Debian, CentOS, etc.)
architecture string CPU architecture (x86_64, arm64, etc.)
featured boolean Whether OS is featured/recommended
available boolean Whether OS is currently available for installation
min_disk_gb integer Minimum disk space required in gigabytes
description string Brief description of the operating system
icon_url string URL to OS icon/logo image

Mã trạng thái phản hồi

200 Đã truy xuất thành công danh sách hệ điều hành
401 Không được phép - Mã xác thực không hợp lệ hoặc bị thiếu.
LẤY /api/v1/operating-systems/{os_id}/

Lấy chi tiết hệ điều hành

Lấy thông tin chi tiết về một hệ điều hành cụ thể.

Tham số đường dẫn

Tham số Kiểu Yêu cầu Mô tả
os_id integer Đúng Unique operating system ID

Ví dụ về yêu cầu

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/operating-systems/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

os_id = 1
url = f"https://admin.vps.org/api/v1/operating-systems/{os_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const osId = 1;
const response = await fetch(`https://admin.vps.org/api/v1/operating-systems/${osId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const os = await response.json();
console.log(os);

Ví dụ về câu trả lời

{
  "id": 1,
  "name": "Ubuntu 22.04 LTS",
  "slug": "ubuntu-22-04",
  "version": "22.04",
  "os_type": "linux",
  "distribution": "Ubuntu",
  "architecture": "x86_64",
  "featured": true,
  "available": true,
  "min_disk_gb": 10,
  "description": "Ubuntu 22.04 LTS (Jammy Jellyfish) - Long Term Support until 2027",
  "icon_url": "https://cdn.vps.org/os-icons/ubuntu.svg",
  "release_date": "2022-04-21",
  "support_end_date": "2027-04-21",
  "default_user": "root",
  "package_manager": "apt",
  "init_system": "systemd",
  "kernel_version": "5.15",
  "features": [
    "Long Term Support (LTS) until 2027",
    "5 years of free security updates",
    "Extended Security Maintenance available",
    "Large community support",
    "Extensive package repository",
    "Cloud-optimized kernel",
    "Regular point releases"
  ],
  "recommended_for": [
    "Web servers (Apache, Nginx)",
    "Application servers",
    "Database servers (MySQL, PostgreSQL)",
    "Docker containers",
    "Kubernetes nodes",
    "Development environments",
    "Production workloads"
  ],
  "installation_notes": [
    "Requires minimum 10GB disk space",
    "SSH enabled by default on port 22",
    "UFW firewall available but not enabled by default",
    "Automatic security updates can be configured",
    "Cloud-init supported for automated setup"
  ]
}

Mã trạng thái phản hồi

200 Successfully retrieved operating system details
401 Không được phép - Mã xác thực không hợp lệ hoặc bị thiếu.
404 Not Found - Operating system does not exist

Featured Operating Systems

VPS.org khuyến cáo các hệ điều hành sau cho hầu hết các trường hợp sử dụng:

Ubuntu 22.04 LTS
  • Best for: General purpose servers, web hosting
  • Support: Until April 2027
  • Package Manager: APT
  • Why choose: Most popular, extensive documentation, large community
Debian 12
  • Best for: Stability-focused production servers
  • Support: ~5 years
  • Package Manager: APT
  • Why choose: Rock-solid stability, security-focused
Rocky Linux 9
  • Best for: Enterprise applications, RHEL workloads
  • Support: ~10 years
  • Package Manager: DNF/YUM
  • Why choose: RHEL compatible, enterprise-grade
AlmaLinux 9
  • Best for: Enterprise servers, cPanel hosting
  • Support: ~10 years
  • Package Manager: DNF/YUM
  • Why choose: RHEL compatible, backed by CloudLinux

Chọn hệ điều hành đúng

Theo trường hợp sử dụng

Vụ việc sử dụng Hệ điều hành khuyến nghị Lý do
Web Hosting Ubuntu 22.04 LTS, Debian 12 Excellent LAMP/LEMP stack support, large community
Docker/Containers Ubuntu 22.04 LTS, Debian 12 Native Docker support, optimized kernels
Enterprise Apps Rocky Linux 9, AlmaLinux 9 RHEL compatibility, long support cycles
Development Ubuntu 22.04 LTS, Fedora 39 Latest packages, developer-friendly tools
Database Servers Debian 12, Rocky Linux 9 Stability, performance, long-term support
cPanel Hosting AlmaLinux 9, Rocky Linux 9 Official cPanel support

Theo cấp độ kinh nghiệm

Cần giúp chọn? Liên hệ với đội hỗ trợ của chúng tôi tại hello@vps.org cho các khuyến nghị OS cá nhân dựa trên yêu cầu cụ thể của bạn.

Cài đặt & Cấu hình

Điều gì xảy ra khi cài đặt hệ điều hành

  1. Chọn ảnh: Mô hình hệ điều hành đã được chọn từ kho của chúng ta
  2. Phân vùng đĩa: Tự động phân vùng dựa trên kích thước bản đồ
  3. Cài đặt cơ bản: Các gói Core OS đã được cài đặt (5-10 phút)
  4. Cấu hình mạng: Đã cấu hình địa chỉ IP, DNS và cổng raName
  5. Cấu hình SSH: Máy phục vụ SSH đã được bật trên cổng 22
  6. Truy cập root: Mật khẩu root gửi qua thư điện tử
  7. Cloud-Init: Cấu hình ban đầu đã được áp dụng (nếu được hỗ trợ)

Bước sau khi cài đặt

Thông tin mặc định

Quan trọng: Thông tin đăng nhập root sẽ được gửi đến địa chỉ thư điện tử đã đăng ký ngay sau khi tạo máy phục vụ. Thay đổi mật khẩu mặc định khi đăng nhập lần đầu vì lý do an toàn.

Hỗ trợ và tài liệu

Để tìm hướng dẫn cài đặt riêng cho hệ điều hành, hãy truy cập trung tâm tài liệu: