在不到两分钟的时间内旋转新铁路上的许可证密钥API！

Railway 的新功能特性让部署单文件微服务变得轻而易举，无需管理基础设施或代码库。本文将演示如何使用 Hono、Redis 和 Bun 运行时，在一个文件中构建一个许可证 API。准备开始构建吧！

注意: Railway 功能非常适合处理小型任务，例如网络钩子、cron 作业或简单的 API。它们与 Railway 生态系统的无缝集成更是锦上添花。

自定义前缀

在开始之前，请务必修改代码中的前缀值以匹配您的项目。默认前缀（例如 wthseismic_）只是一个占位符，应该替换为与您的项目相关的唯一值，以避免冲突。

前提条件

• Railway 账户
• TypeScript 基础知识
• 对无服务器概念的了解

步骤 1：创建新项目

1. 前往您的 Railway 仪表盘，创建一个新项目。
2. 选择“函数”服务作为启动服务。
3. Railway 将自动使用 Bun 运行时为您的函数设置环境，无需额外配置。

步骤 2：配置 Redis

1. 在您的 Railway 项目中添加 Redis 服务。这将用于存储许可证数据。
2. 配置完成后，点击 Redis 服务，然后进入“变量”选项卡。
3. 使用“共享变量”功能将以下环境变量暴露给您的函数：
   • REDIS_HOST
   • REDIS_PORT
   • REDIS_USER
   • REDIS_PASSWORD
   • （可选）REDIS_TLS 如果您的 Redis 需要 TLS。

步骤 3：创建函数

1. 在 Railway 仪表盘中，点击“新建函数”。
2. 这将打开内置编辑器，支持 Bun 运行时。
3. 添加 API 所需的其他环境变量：
   • ADMIN_KEY
   • HMAC_SECRET
   • PAYMENT_SECRET
   • （可选）端口（默认为 3000）。

步骤 4：粘贴并保存代码

将以下完整代码复制并粘贴到 Railway 函数的“源代码”选项卡中。使用 ⌘S (macOS) 或 Ctrl+S (Windows) 保存更改。Railway 将自动部署您的更改！

// index.ts
import { hono } from "hono";
import { cors } from "hono/cors";
import { ratelimiter } from "hono-rate-limiter";
import redis from "ioredis";
import crypto from "node:crypto";

// custom prefix configuration
const license_prefix = "wthseismic_";
const license_set = "wthseismic_licenses";
const webhook_set = "wthseismic_webhooks";

// updated licensetier type to include "unlimited"
type licensetier = "basic" | "pro" | "enterprise" | "unlimited";

... (完整代码)

步骤 5：测试部署

部署完成后，Railway 会为您的函数提供一个 URL。使用以下 cURL 命令测试每个端点：

5.1：测试根端点 返回当前时间戳。

curl -X GET https:///

5.2：创建新许可证 为用户创建一个新的许可证密钥。

curl -X POST https:///api/licenses 
  -H "Content-Type: application/json" 
  -d '{"email": "user@example.com", "tier": "pro", "durationdays": 90}'

5.3：验证许可证 验证现有的许可证密钥。

curl -X GET https:///api/licenses/wthseismic_xxx

5.4：处理支付 Webhook 模拟支付 Webhook 以延长许可证期限。

curl -X POST https:///webhooks/payment 
  -H "Content-Type: text/plain" 
  -H "X-Payment-Signature: " 
  -d '{"licensekey": "wthseismic_xxx", "durationdays": 30}'

5.5：使用管理端点延长许可证 使用管理员密钥延长许可证期限。

curl -X POST https:///admin/licenses/WTHSEISMIC_xxx/extend 
  -H "Content-Type: application/json" 
  -H "X-Admin-Key: your-secret-key" 
  -d '{"durationDays": 30}'

使用这些示例来验证您的函数是否按预期工作。

因此，不到两分钟，我们就使用 Redis、Hono 和 Bun 在 Railway 上构建了一个许可证密钥服务器，展示了这个过程的便捷性，以及如何在几分钟内将代码部署到 Railway 生态系统中。 功能强大，平台出色！