如何在Rails应用布局中渲染Sidekiq/Web UI面板

安全阿岳

2026-9-29

Sidekiq仪表盘嵌入Rails应用布局的实现方案

Sidekiq Web本质是独立的Rack应用，支持自定义布局、重载视图，无需跳转独立页面，以下是可行的实现方法：

方案1：直接指定使用应用全局布局（最简单，适配绝大多数场景）

你只需修改路由文件中Sidekiq的挂载配置，指定用你应用的布局即可：

# config/routes.rb
require 'sidekiq/web'
# 新增这一行，指定使用application布局，需要自定义布局可以替换为对应布局文件名
Sidekiq::Web.layout = 'application'
mount Sidekiq::Web => '/sidekiq'

如果出现Sidekiq自带导航和应用导航重复的问题，可在应用全局CSS中添加样式隐藏Sidekiq自带的头尾：

/* app/assets/stylesheets/application.css */
.sidekiq-header, .sidekiq-footer {
  display: none !important;
}

配置完成后删除link_to中的target: :_blank属性，点击链接就会在当前应用布局内加载Sidekiq仪表盘。

方案2：重载Sidekiq视图/控制器（类似Devise自定义逻辑）

如果需要深度修改页面内容、增加自定义逻辑，可以直接重载Sidekiq的视图和配置：

重载视图：找到本地Sidekiq gem安装目录下的web/views文件夹，将需要修改的模板拷贝到你应用的app/views/sidekiq/web/目录下，Rails会优先加载应用内的模板，完全自定义页面内容
权限/逻辑扩展：可以在挂载路由前添加校验逻辑，比如用Devise做权限控制：
```
# config/routes.rb
authenticate :user, ->(user) { user.admin? } do
  mount Sidekiq::Web => '/sidekiq'
end
```
也可以通过Sidekiq::Web.use注入自定义Rack中间件，实现复杂的请求拦截、逻辑扩展需求。