oracle-freetier-instance-creation新手快速开始指南:5步拥有自己的Oracle Cloud免费VPS

原创2026-11-15 14:30:201,227 阅读

oracle-freetier-instance-creation新手快速开始指南:5步拥有自己的Oracle Cloud免费VPS

Oracle Cloud 的 Always-Free 档位可以白拿 2 OCPU / 12 GB RAM 的免费 ARM 服务器,但官方控制台的"Out of host capacity"错误让大多数人望而却步。本项目 oracle-freetier-instance-creation 用 Python 脚本自动轮询创建 OCI 免费实例:每 60 秒尝试一次,直到实例成功创建,并支持邮件 / Discord / Telegram 通知,帮你轻松"抢"到自己的 Oracle Cloud 免费 VPS。

oracle-freetier-instance-creation:通过 Python 自动化创建 Oracle Cloud 免费 VPS 实例

一、它能帮你做什么?

  • ⚡ 自动轮询:遇到容量不足(Out of host capacity)时自动等待重试,无需手动反复刷新控制台
  • 🖥️ 两种免费机型:ARM 版 VM.Standard.A1.Flex(2 OCPU / 12 GB)和 AMD 版 VM.Standard.E2.1.Micro(1 OCPU / 1 GB)
  • 🔑 SSH 密钥自动生成:不指定密钥时会自动生成一对 RSA 密钥
  • ✉️ 多渠道通知:实例创建成功后,通过 Gmail、Discord Webhook 或 Telegram Bot 第一时间提醒你
  • 📝 结果落盘:成功后生成 INSTANCE_CREATED 文件,记录实例 ID、名称、可用域等详情

核心逻辑在 main.py:循环调用 OCI 的 launch_instance 接口,失败则休眠后重试。

二、开始前的准备工作

准备项 说明
Oracle Cloud 免费账户 注册后即可获得 Always-Free 额度
OCI API Key 在控制台 Profile 页 > API Keys > Add API Key 生成,同时会输出一份 config 信息
可用的 Ubuntu 环境 推荐先开一台免费的 VM.Standard.E2.1.Micro(Ubuntu 22.04)作为跳板机;若你已有子网 OCID 也可在本地运行
Gmail App 密码(可选) 开启两步验证的账号需在 Google 后台生成应用专用密码,用于邮件通知

三、5步拥有你的免费实例

第1步:克隆项目

SSH 进入 Ubuntu 跳板机后执行:

git clone https://gitcode.com/gh_mirrors/or/oracle-freetier-instance-creation
cd oracle-freetier-instance-creation

第2步:配置 OCI API 密钥

  1. 创建 oci_api_private_key.pem,粘贴你的 API 私钥内容
  2. 创建 oci_config 文件,粘贴生成 API Key 时复制的 config 信息,格式可参考 sample_oci_config
  3. 将 oci_config 中的 key_file 改为私钥的绝对路径,例如 /home/ubuntu/oracle-freetier-instance-creation/oci_api_private_key.pem

第3步:填写 oci.env 环境配置

可以直接编辑 oci.env,也可以运行交互式脚本自动生成:

./setup_env.sh

setup_env.sh 会引导你选择实例名称、免费机型(VM.Standard.A1.Flex 或 VM.Standard.E2.1.Micro)、子网、镜像、是否开启 Gmail / Discord / Telegram 通知等。若 oci.env 已存在,会自动备份为 oci.env.bak。

常用配置项一览(完整说明见 oci.env):

变量 作用
OCI_CONFIG OCI 配置文件的绝对路径(必填)
OCT_FREE_AD 可用域,如 AD-1,多个用逗号分隔(必填)
DISPLAY_NAME 实例显示名称
REQUEST_WAIT_TIME_SECS 每次重试间隔秒数,默认 60
OCI_COMPUTE_SHAPE 机型,默认 ARM;AMD 容量紧张时可切换
OPERATING_SYSTEM / OS_VERSION 系统名称与版本,如 Canonical Ubuntu + 22.04
ASSIGN_PUBLIC_IP 是否自动分配公网 IP
BOOT_VOLUME_SIZE 引导卷大小(GB),最小 50
NOTIFY_EMAIL / EMAIL / EMAIL_PASSWORD Gmail 通知开关与凭据

💡 在本地(非 Micro 跳板机)运行时,务必填写 OCI_SUBNET_ID;跳板机内运行则留空即可。

第4步:一键启动脚本

./setup_init.sh

setup_init.sh 会自动创建 Python 虚拟环境、安装 requirements.txt 中的依赖(oci、paramiko、python-dotenv、requests),并在后台启动 main.py。看到 "Script is running successfully" 就说明一切正常,接下来只需耐心等待。

第5步:等待成功与接收通知

脚本会持续轮询,直到:

  • ✅ 生成 INSTANCE_CREATED 文件,包含实例 ID、显示名、可用域、机型与状态
  • ✅ 按配置收到 Gmail 邮件(邮件模板见 email_content.html)、Discord 或 Telegram 消息

创建完成后,记得去控制台为实例配置公网 IP(脚本默认不分配),然后就可以 SSH 进你的免费 VPS 啦。

四、常见问题快速排查

  • 生成 ERROR_IN_CONFIG.log:oci_config 格式不对。请对照 sample_oci_config 检查,确保没有多余行或字符(校验逻辑见 main.py)
  • 脚本报错中断:查看 UNHANDLED_ERROR.log,修复后执行 ./setup_init.sh rerun 跳过依赖安装直接重跑(见 setup_init.sh)
  • 想查看运行细节:API 调用日志在 launch_instance.log,参数信息(可用域、子网、镜像 ID 等)在 setup_and_info.log
  • 容量一直抢不到:尝试在 oci.env 中把 OCI_COMPUTE_SHAPE 换成另一个免费机型,或错峰运行

五、写在最后

整个过程只有 5 步:克隆 → 配密钥 → 填配置 → 跑脚本 → 等通知。相比在控制台里反复点"创建",oracle-freetier-instance-creation 把最耗时的等待交给脚本自动完成,还附带多种渠道的成功提醒,是获取 Oracle Cloud 免费 VPS 的省心之选。配置好之后,剩下的就交给时间吧!🚀

登录后查看全文
oracle-freetier-instance-creation