InstaBox 平台使用与端口映射运维笔记

一、 平台概述

• 定位：专为 AI Agent 与开发者设计的云端独立 Linux 虚拟机环境（Cloud Computer）。
• 公网访问机制：虚拟机不分配独立的公网 IP，但支持通过 HTTPS 域名映射 动态暴露最多 16 个公网端口。

二、 核心操作与运维方案

1. 实例状态与信息查看

• 获取当前机器名称/主机名：

  hostname
  

• 查看名下所有虚拟机列表（需配置 API Key）：

  instabox list
  

2. 后台常驻服务与保活

• 启动后台非特权 HTTP 服务（端口 8080）：

  python3 -m http.server 8080 &
  

• 验证服务监听状态：

  curl http://127.0.0.1:8080
  

3. CLI 认证与环境变量配置

• 获取 API Key：在 InstaBox Dashboard 后台生成 ibk_... 格式的密钥。

• 配置环境变量（临时生效）：

  export INSTABOX_API_KEY="ibk_你的实际密钥"
  

• 配置环境变量（持久化写入 ~/.bashrc）：
  通过 vi ~/.bashrc 在文件末尾追加：

  export INSTABOX_API_KEY="ibk_你的实际密钥"
  

保存退出后执行使其生效：

source ~/.bashrc

4. 端口公网映射发布

• 将容器内指定端口发布至公网：

  instabox port publish <机器名称> <端口号>
  

(示例：instabox port publish myinstabox68 8080)

• 查看已发布的端口列表：

  instabox port ls <机器名称>
  

• 取消端口公网映射：

  instabox port unpublish <机器名称> <端口号>