Railway 的新功能特性让部署单文件微服务变得轻而易举，无需管理基础设施或代码库。本文将演示如何使用 Hono、Redis 和 Bun 运行时，在一个文件中构建一个许可证 API。准备开始构建吧！
注意: Railway 功能非常适合处理小型任务，例如网络钩子、cron 作业或简单的 API。它们与 Railway 生态系统的无缝集成更是锦上添花。
自定义前缀
在开始之前，请务必修改代码中的前缀值以匹配您的项目。默认前缀（例如 wthseismic_）只是一个占位符，应该替换为与您的项目相关的唯一值，以避免冲突。
前提条件
- Railway 账户
- TypeScript 基础知识
- 对无服务器概念的了解
步骤 1：创建新项目
- 前往您的 Railway 仪表盘，创建一个新项目。
- 选择“函数”服务作为启动服务。
- Railway 将自动使用 Bun 运行时为您的函数设置环境，无需额外配置。
步骤 2：配置 Redis
- 在您的 Railway 项目中添加 Redis 服务。这将用于存储许可证数据。
- 配置完成后，点击 Redis 服务，然后进入“变量”选项卡。
- 使用“共享变量”功能将以下环境变量暴露给您的函数：
REDIS_HOSTREDIS_PORTREDIS_USERREDIS_PASSWORD- （可选）
REDIS_TLS如果您的 Redis 需要 TLS。
步骤 3：创建函数
- 在 Railway 仪表盘中，点击“新建函数”。
- 这将打开内置编辑器，支持 Bun 运行时。
- 添加 API 所需的其他环境变量：
ADMIN_KEYHMAC_SECRETPAYMENT_SECRET- （可选）端口（默认为 3000）。
步骤 4：粘贴并保存代码
将以下完整代码复制并粘贴到 Railway 函数的“源代码”选项卡中。使用 ⌘S (macOS) 或 Ctrl+S (Windows) 保存更改。Railway 将自动部署您的更改！
<code class="typescript">// 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";
... (完整代码)</code>
步骤 5：测试部署
部署完成后，Railway 会为您的函数提供一个 URL。使用以下 cURL 命令测试每个端点：
5.1：测试根端点 返回当前时间戳。
<code class="bash">curl -X GET https://<your-function-url>/</code>
5.2：创建新许可证 为用户创建一个新的许可证密钥。
<code class="bash">curl -X POST https://<your-function-url>/api/licenses \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "tier": "pro", "durationdays": 90}'</code>
5.3：验证许可证 验证现有的许可证密钥。
<code class="bash">curl -X GET https://<your-function-url>/api/licenses/wthseismic_xxx</code>
5.4：处理支付 Webhook 模拟支付 Webhook 以延长许可证期限。
<code class="bash">curl -X POST https://<your-function-url>/webhooks/payment \
-H "Content-Type: text/plain" \
-H "X-Payment-Signature: <signature>" \
-d '{"licensekey": "wthseismic_xxx", "durationdays": 30}'</code>
5.5：使用管理端点延长许可证 使用管理员密钥延长许可证期限。
<code class="bash">curl -X POST https://<your-function-url>/admin/licenses/WTHSEISMIC_xxx/extend \
-H "Content-Type: application/json" \
-H "X-Admin-Key: your-secret-key" \
-d '{"durationDays": 30}'</code>
使用这些示例来验证您的函数是否按预期工作。
因此，不到两分钟，我们就使用 Redis、Hono 和 Bun 在 Railway 上构建了一个许可证密钥服务器，展示了这个过程的便捷性，以及如何在几分钟内将代码部署到 Railway 生态系统中。 功能强大，平台出色！
