Railway 部署

Railway 为 Kora 节点提供了便捷的部署体验，具备自动 SSL、域名管理和内置监控功能。本指南将介绍如何使用简单的 Docker 镜像和 Railway CLI 在 Railway 上设置 Kora 节点。

前置条件

• Railway 账户
• 已安装 Railway CLI
• 用于创建私钥的 Solana CLI
• Solana RPC 端点

步骤 1：准备部署文件

为您的 Kora 节点创建一个新目录：

mkdir my-kora-node
cd my-kora-node

将示例文件添加到您的目录：

• kora.toml
• signers.toml
• Dockerfile

您的目录现在应该如下所示：

my-kora-node/
├── kora.toml
├── signers.toml
└── Dockerfile

步骤 2：部署到 Railway

在您的项目目录中，登录 Railway

# Login to Railway
railway login

按照屏幕上的说明使用您的账户登录。

在您的目录中初始化 Railway 项目。

railway init

Railway 将提示您：

1. 创建新项目或选择现有项目
2. 选择项目名称（例如"my-kora-node"）

部署您的应用程序

# Deploy the application
railway up

这将：

• 将您的文件上传到 Railway
• 构建 Docker 镜像
• 部署您的应用程序

预期输出：

Build time: 121.81 seconds
Deploy complete
Starting Container

太棒了！我们已经全部设置完成！你可能会在日志中注意到一个错误（"error: a value is required for --rpc-url <RPC_URL> but none was supplied "）。这是因为我们还没有配置环境变量 —— 所以下一步我们就来配置它。

步骤 3：配置环境变量

打开你的 Railway 仪表盘 railway.app，进入你的项目。在项目中，点击 "Settings" > "Variables"

Kora 的 Railway 环境变量

添加如下环境变量：

安全提示：你的私钥可以访问用于支付费用的 SOL。请为你的 Kora 节点使用专用的 keypair，并且只往里面充值你愿意用于交易手续费的 SOL。关于签名者的更多信息，请参见 签名者指南。

获取你的私钥

如果你需要创建一个新的 keypair：

# Generate new keypair
solana-keygen new --outfile ~/.config/solana/kora-keypair.json

请确保为你的节点充值足够的 SOL 以便测试/运行。

步骤 4：重新部署

保存变量后，系统会提示你重新部署服务器 —— 请执行该操作。

步骤 5：测试你的部署

生成公共端点

要向你的端点发送请求，你需要生成一个公共域名。在你的部署内，进入 "Settings" > "Generate domain"。

Railway 域名设置

请使用默认端口 "8080"，并点击 "Generate Domain"。

您应该获取一个类似 https://my-kora-node.railway.app/ 的域名

测试配置端点

curl -X POST https://my-kora-node.railway.app \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getConfig","params":[]}' | jq

预期响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "fee_payer": "YourPublicKeyHere...",
    "validation_config": {
      "max_allowed_lamports": 1000000,
      "allowed_programs": [...],
      "allowed_spl_paid_tokens": [...]
      // ...
    }
  }
}

做得好！您的 Kora 节点现已上线。

需要帮助？

• Kora 节点运营者指南 - 常见问题与解决方案
• Railway 文档 - 平台特定帮助
• GitHub Issues - 报告错误或获取支持
• Solana Stack Exchange - 提问/分享学习心得（请务必使用 kora 标签）