oracle-freetier-instance-creation新手快速开始指南:5步拥有自己的Oracle Cloud免费VPS
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。
一、它能帮你做什么?
- ⚡ 自动轮询:遇到容量不足(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 密钥
- 创建
oci_api_private_key.pem,粘贴你的 API 私钥内容 - 创建
oci_config文件,粘贴生成 API Key 时复制的 config 信息,格式可参考 sample_oci_config - 将
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 的省心之选。配置好之后,剩下的就交给时间吧!🚀
