Triển khai trên Railway

Railway cung cấp trải nghiệm triển khai dễ dàng cho các node Kora với SSL tự động, quản lý tên miền và giám sát tích hợp. Hướng dẫn này sẽ hướng dẫn bạn thiết lập một node Kora trên Railway bằng Docker image đơn giản và Railway CLI.

Yêu cầu trước

• Tài khoản Railway
• Railway CLI đã cài đặt
• Solana CLI để tạo khóa riêng tư
• Điểm cuối RPC Solana

Bước 1: Chuẩn bị các tệp triển khai

Tạo một thư mục mới cho node Kora của bạn:

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

Thêm các tệp mẫu vào thư mục của bạn:

• kora.toml
• signers.toml
• Dockerfile

Thư mục của bạn bây giờ sẽ trông như sau:

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

Bước 2: Triển khai lên Railway

Từ thư mục dự án của bạn, đăng nhập vào Railway

# Login to Railway
railway login

Làm theo hướng dẫn trên màn hình để đăng nhập bằng tài khoản của bạn.

Khởi tạo dự án Railway trong thư mục của bạn.

railway init

Railway sẽ yêu cầu bạn:

1. Tạo dự án mới hoặc chọn dự án hiện có
2. Chọn tên dự án (ví dụ: "my-kora-node")

Triển khai ứng dụng của bạn

# Deploy the application
railway up

Lệnh này sẽ:

• Tải các tệp của bạn lên Railway
• Xây dựng Docker image
• Triển khai ứng dụng của bạn

Kết quả mong đợi:

Build time: 121.81 seconds
Deploy complete
Starting Container

Tuyệt vời! Chúng ta đã thiết lập xong! Bạn có thể sẽ thấy một lỗi trong nhật ký ("error: a value is required for --rpc-url <RPC_URL> but none was supplied "). Đây là do chúng ta chưa cấu hình các biến môi trường--vậy nên hãy thực hiện việc đó tiếp theo.

Bước 3: Cấu Hình Biến Môi Trường

Mở bảng điều khiển Railway của bạn tại railway.app và điều hướng đến dự án của bạn. Trong dự án, nhấp vào "Settings" > "Variables"

Railway Environment Variables for Kora

Thêm các biến môi trường sau:

Cảnh Báo Bảo Mật: Khóa riêng của bạn có quyền truy cập vào SOL để thanh toán phí. Sử dụng một keypair chuyên dụng cho nút Kora của bạn và chỉ nạp vào đó số lượng SOL mà bạn sẵn sàng chi cho phí giao dịch. Để biết thêm thông tin về người ký, xem Hướng Dẫn Người Ký.

Lấy Khóa Riêng Của Bạn

Nếu bạn cần tạo một keypair mới:

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

Hãy đảm bảo nạp đủ SOL để kiểm tra/vận hành nút của bạn.

Bước 4: Triển Khai Lại

Sau khi lưu các biến, bạn sẽ được nhắc triển khai lại máy chủ--hãy thực hiện việc đó.

Bước 5: Kiểm Tra Triển Khai Của Bạn

Tạo Điểm Cuối Công Khai

Để gửi yêu cầu đến điểm cuối của bạn, bạn sẽ cần tạo một Tên Miền công khai. Từ triển khai của bạn, đi đến "Settings" > "Generate domain".

Railway Domain Setup

Sử dụng cổng mặc định, "8080" và nhấp "Generate Domain".

Bạn nên có một tên miền như https://my-kora-node.railway.app/

Kiểm Tra Endpoint Cấu Hình

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

Phản hồi mong đợi:

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

Làm tốt lắm! Node Kora của bạn đã hoạt động.

Cần Trợ Giúp?

• Hướng Dẫn Vận Hành Node Kora - Các vấn đề thường gặp và giải pháp
• Tài Liệu Railway - Trợ giúp cụ thể về nền tảng
• GitHub Issues - Báo cáo lỗi hoặc nhận hỗ trợ
• Solana Stack Exchange - Đặt câu hỏi/chia sẻ kiến thức (đảm bảo sử dụng thẻ kora)