active_storage_dashboard 的安装和配置教程

1. 项目的基础介绍和主要的编程语言

active_storage_dashboard 是一个开源项目，它提供了一个用于监控和检查 Rails 应用程序中 Active Storage 数据的优雅、现代的仪表盘。该项目使用 Ruby 作为主要的后端编程语言，同时使用了 HTML 来构建用户界面。

2. 项目使用的关键技术和框架

该项目使用了以下关键技术和框架：

• Ruby on Rails：后端框架，用于构建 Web 应用程序。
• Active Storage：Rails 内置的文件上传和存储功能。
• HTML/CSS/JavaScript：前端技术栈，用于构建用户界面。
• MIT License：开源协议，允许用户自由使用、修改和分享代码。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您已经满足以下要求：

• Ruby 和 Rails 环境已经安装并配置好。
• 您的机器上有一个可以使用的数据库，如 PostgreSQL、MySQL 或 SQLite。
• 您已经安装了 Node.js 和 Yarn，用于管理前端依赖。

安装步骤

步骤 1：创建新的 Rails 项目

首先，创建一个新的 Rails 项目，如果您还没有一个项目的话：

rails new myapp --skip-active-storage
cd myapp

这里我们使用了 --skip-active-storage 选项来跳过内置的 Active Storage 安装，因为我们将会使用 active_storage_dashboard。

步骤 2：添加 active_storage_dashboard 依赖

在您的项目 Gemfile 中添加以下行：

gem 'active_storage_dashboard'

然后执行以下命令来安装 gem：

bundle install

步骤 3：配置路由

打开 config/routes.rb 文件，并添加以下路由：

# config/routes.rb
Rails.application.routes.draw do
  # 确保挂载路径不包含任何特殊字符
  # 使用简单路径，如 '/active-storage-dashboard' 或 '/storage-dashboard'
  # 这对于正确的 URL 生成至关重要
  mount ActiveStorageDashboard::Engine, at: '/active-storage-dashboard'
end

步骤 4：配置 Active Storage

如果您还没有配置 Active Storage，您需要添加相应的配置到 config/storage.yml 文件中。以下是 PostgreSQL 的示例配置：

# config/storage.yml
amazon:
  service: S3
  access_key_id: <%= ENV['AWS_ACCESS_KEY_ID'] %>
  secret_access_key: <%= ENV['AWS_SECRET_ACCESS_KEY'] %>
  bucket: <%= ENV['AWS_BUCKET'] %>
  region: <%= ENV['AWS_REGION'] %>

# 默认配置
local:
  service: Disk
  root: <%= Rails.root.join('storage') %>

记得设置相应的环境变量。

步骤 5：启动 Rails 服务器

安装和配置完成后，您可以启动 Rails 服务器：

rails server

现在，您可以在浏览器中访问 /active-storage-dashboard 来查看仪表盘。

注意事项

• 在生产环境中使用该仪表盘之前，请考虑添加认证机制，以保护您的数据安全。
• 根据您的具体需求，您可能需要调整数据库和存储配置。

以上就是 active_storage_dashboard 的安装和配置教程，祝您使用愉快！