logo
0
0
Login
feat: 添加腾讯云服务器一键重装系统功能

腾讯云(轻量应用)服务器一键重装系统

License: MIT CNB Platform

本项目提供了基于 CNB 平台的云服务器一键重装系统功能,通过自定义 Web 触发器实现便捷的操作系统重装操作。

🌟 项目概述

本项目使用 CNB(云原生构建)平台的 Web 触发器功能,实现了腾讯云服务器的一键重装系统操作。用户只需点击对应的执行按钮,填写必要参数,即可自动完成云服务器的操作系统重装。

✨ 功能特点

  • 🚀 一键操作:一键 dd,绝不废话!
  • 🌍 多地域支持:支持腾讯云全球所有地域
  • 🐧 多系统支持:支持主流 Linux 发行版
  • 📋 版本选择:每个操作系统提供下拉式版本选择
  • 🔐 安全可靠:基于 CNB 平台的安全密钥管理
  • 📊 实时监控:流水线执行过程全程可视化

🚀 快速开始

前置条件

  1. 拥有 CNB 平台账号和仓库访问权限
  2. 准备好腾讯云 API 密钥(已存储在密钥仓库中)
  3. 准备好 SSH 公钥用于登录重装后的服务器
  4. 实例需要开通 自动化助手(免费)

使用步骤

  1. Fork 本仓库

  2. 配置密钥仓库

    • 打开项目的 .cnb.yml 文件
    • 修改第三行 imports 为你的密钥仓库链接保存
  3. 选择操作系统并执行

    • 找到对应操作系统的重装按钮并点击
    • 填写必要参数(参考参数获取方法
    • 点击"确认"按钮提交执行请求
  4. 监控执行过程

    • 在流水线页面监控执行过程
    • 执行完成后,云服务器将自动重启并安装新系统

📖 使用指南

详细配置说明

1. 密钥仓库配置

创建一个私有仓库作为密钥仓库,包含以下环境变量:

  • SECRET_ID: 腾讯云 SecretId
  • SECRET_KEY: 腾讯云 SecretKey

2. 参数填写说明

在执行重装操作时,需要填写以下参数:

参数名描述示例
secret_id腾讯云 API 密钥 IDAKIDxxxxxxxx
secret_key腾讯云 API 密钥 Keyxxxxxxxxxxxx
instance_ids实例 ID(多个用逗号分隔)ins-xxxxxxxx,ins-yyyyyyyy
region实例所在地域ap-guangzhou
ssh_public_keySSH 公钥或 GitHub 用户名ssh-rsa AAAA... 或 github:username

🔧 参数获取方法

获取 API 密钥 (secret_id 和 secret_key)

  1. 登录腾讯云控制台,点击右上角头像,选择"访问管理"
  2. 在左侧菜单中选择"访问密钥" > "API 密钥管理"
  3. 点击"新建密钥"创建新的 API 密钥
  4. 保存生成的 SecretId 和 SecretKey,SecretKey 只在创建时显示一次,请妥善保管

获取实例 ID (instance_ids)

  1. 登录腾讯云控制台,进入"云服务器 CVM"或"轻量应用服务器 Lighthouse"产品页面
  2. 在实例列表中找到需要操作的实例
  3. 实例 ID 格式为 ins-xxxxxxxx

获取地域 (region)

  1. 登录腾讯云控制台,在实例列表页面左上角可查看当前地域
  2. 地域格式为 ap-城市代码,如 ap-guangzhou(广州)、ap-beijing(北京)等
  3. 也可以通过 查询地域列表 API 获取完整的地域列表

通过实例元数据获取实例信息

如果已经在实例内部,可以通过实例元数据服务获取实例信息:

# 获取实例 ID curl http://metadata.tencentyun.com/latest/meta-data/instance-id # 获取实例所在地域 curl http://metadata.tencentyun.com/latest/meta-data/placement/region

💡 提示:实例元数据服务只能从实例内部访问

SSH 公钥格式

SSH 公钥格式示例:

  • ssh-rsa ...
  • ssh-ed25519 ...
  • ecdsa-sha2-nistp256/384/521 ...
  • http://path/to/public_key
  • github:your_username
  • gitlab:your_username

⚠️ 安全注意事项

  1. 密钥管理:腾讯云 API 密钥存储在密钥仓库中,确保只有授权人员可以访问
  2. 实例备份:重装系统前,请确保重要数据已备份
  3. 数据丢失:重装系统将导致实例磁盘数据全部丢失,请提前备份重要数据
  4. 权限最小化:API 密钥应只授予必要的权限,避免使用全权限密钥
  5. 定期轮换:建议定期更换 API 密钥,提高安全性

🙏 致谢

特别感谢以下用户,本项目参考或使用了他们的工作:

📄 许可证

本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。


免责声明:本工具用于重装云服务器操作系统,使用前请确保已备份重要数据。使用本工具所造成的任何数据丢失或系统故障,责任由使用者自行承担。