使用Mockoon将Mock API服务部署到Render服务器:免费版完整教程

82 阅读2分钟

预期的效果

  • ✅ 完全免费(每月 750 小时免费运行时间)
  • ✅ 公共 URL(如 https://your-api.onrender.com
  • ✅ 自动部署(Git 提交后自动发布)
  • ✅ 基于您的 Mockoon 配置

完整分步教程

第一步:准备 Mockoon 环境文件

  1. 在 Mockoon 中设计好您的 API。
  2. 点击 ... -> Show data file in explorer/finder
  3. 保存为 mock-api.json(建议用英文文件名)。

image.png

第二步:创建 GitHub 仓库

  1. 访问 github.com 创建新仓库(如 salesforce-mock-api-render)。
  2. 选择 Public(必须公开)。
  3. 将 mock-api.json 文件上传到仓库。

第三步:创建 package.json 文件

在仓库中创建 package.json,这是 Render 识别为 Node.js 项目的关键:

{
  "name": "salesforce-mock-api",
  "version": "1.0.0",
  "description": "Mock API for Salesforce testing",
  "main": "index.js",
  "scripts": {
    "start": "mockoon-cli start --data mock-api.json --port 10000"
  },
  "dependencies": {
    "@mockoon/cli": "^9.2.0"
  },
  "keywords": ["mock", "api", "salesforce"],
  "author": "Lawrence Kuang",
  "license": "MIT"
}

image.png 重要:将 YOUR_GITHUB_USERNAMEYOUR_REPO_NAME 替换为您的实际信息。

第四步:注册并配置 Render

  1. 注册 Render

    • 访问 render.com
    • 点击 Sign Up 并选择 Sign up with GitHub
  2. 创建 Web Service

    • 在 Render 控制台点击 New +  -> Web Service
    • 选择 Connect your repo 并授权访问您的 GitHub 账户
    • 选择您创建的仓库(salesforce-mock-api-render

image.png

  1. 配置部署设置

    # 基本设置
    Name: salesforce-mock-api           # 给服务起个名字
    Region: Singapore (Southeast Asia)  # 选择离你近的区域
    Branch: master                      # 部署的分支
    # 环境设置
    Runtime: Node
    Build Command: npm install
    Start Command: npm start
    # 套餐选择
    Plan: Free                # 一定要选择免费套餐
    

image.png

  1. 高级设置

    • 点击 Advanced
    • 在 Environment Variables 中添加:
    Key: PORT
    Value: 10000
    
    • 因为 Render 会随机分配端口,但我们需要固定端口给 Mockoon。

image.png

  1. 创建服务

    • 点击 Create Web Service
    • 部署会自动开始

第五步:获取您的公共 URL

  1. 部署完成后(约 2-5 分钟),在服务页面顶部可以看到您的公共 URL。

  2. 格式为:https://your-api.onrender.com

  3. 测试您的 API:

    https://your-api.onrender.com/store/products
    https://your-api.onrender.com/customers
    

第六步:解决 Render 免费套餐的"睡眠"问题

Render 免费服务在 15 分钟无活动后会自动休眠,下次访问时需要约 30-50 秒"唤醒"。

解决方案:设置定时唤醒

  1. 使用 UptimeRobot(免费)

    • 访问 uptimerobot.com
    • 注册账户
    • 点击 Add New Monitor
    • 配置如下:
    Monitor Type: HTTP(s)
    Friendly Name: Wake Render API
    URL: https://your-api.onrender.com/health
    Monitoring Interval: 5 minutes
    
    • 这样每 5 分钟访问一次,保持服务一直活跃

image.png

  1. 在 Mockoon 中添加健康检查端点

    • 在 Mockoon 中添加一条新路由:
    Method: GET
    Path: /health
    Response: { "status": "ok" }
    Status: 200
    
    • 重新导出 mock-api.json 并推送到 GitHub

image.png

image.png

项目文件结构参考

您的 GitHub 仓库应该包含以下文件:

salesforce-mock-api-render/
├── mock-api.json          # Mockoon 导出的环境文件
├── package.json           # Node.js 项目配置
└── README.md              # 可选,说明文档

现在您就拥有了一个完全免费的、公开可访问的 Mock API 服务!团队中的任何人都可使用这个统一的 URL 进行测试。