官方包 · 框架

无需 Action Cable 的 Hotwire Turbo Streams

Rails 应用现有的每条 Turbo Stream 广播都改由 Hibira 发送,无需再运维 Action Cable 服务器、Redis 或 Solid Cable。Model 和 View 都不用改。

  • broadcasts_to、broadcast_append_to 和 turbo_stream_from 照常工作,无论来自请求还是 Active Job。
  • 还能为您自己的私有和 presence 频道签名、验证 Webhook,并签发推送通知令牌。
  • 支持 Rails 7.0 至 8.1、turbo-rails 1.5 至 2。

登录后,示例代码会自动填入您的集群主机。 登录

  1. 安装

    bundle add hibira-rails
    bin/rails generate hibira:install
  2. 配置

    HIBIRA_APP_ID=YOUR_APP_ID
    HIBIRA_APP_KEY=YOUR_APP_KEY
    HIBIRA_APP_SECRET=YOUR_APP_SECRET
    
    bin/rails hibira:check
  3. 使用

    class Message < ApplicationRecord
      belongs_to :room
      broadcasts_to :room
    end
    
    # app/views/rooms/show.html.erb
    # <%= turbo_stream_from @room %>

开始之前

  • 应用密钥只会在创建应用或轮换密钥时显示一次。请只放在服务器上,不要放进浏览器或游戏的构建包。
  • Free 套餐需要把页面加载的每个来源都加入应用的“允许的来源”(开发时是 http://localhost:3000,之后是您的域名)。"*" 需要付费套餐。

请使用控制台中应用的 Key;Secret 只放在你的服务器上。频道、事件与授权端点的用法与 Pusher 完全相同。 免费创建账号 →