LRCLIB项目安装与配置指南

1. 项目基础介绍

LRCLIB 是一个使用 Rust 语言编写的开源项目，它基于 Axum 框架和 SQLite3 数据库构建。该项目旨在提供一个同步歌词的免费服务，具备简单易用且对机器友好的 API 接口。

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

• Rust：一种系统编程语言，注重安全、性能和并发。
• Axum：一个基于 Tower 的异步 Web 框架，用于构建 Web 应用程序。
• SQLite3：一个轻量级的数据库引擎，适用于嵌入式设备和移动应用。

3. 项目安装和配置的准备工作

在开始安装 LRCLIB 项目之前，您需要确保您的系统中已经安装了以下软件：

• Rust 编译器
• Docker（推荐，用于简化部署）

安装步骤

步骤 1：安装 Rust 编译器

首先，您需要通过 Rust 官方安装脚本 来安装 Rust。由于要求不使用链接，这里简单描述步骤：

• 打开终端或命令提示符。
• 输入 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 并按回车。
• 脚本将引导您完成安装过程。

步骤 2：克隆项目仓库

在安装了 Rust 之后，克隆 LRCLIB 项目到本地：

git clone https://github.com/tranxuanthang/lrclib.git
cd lrclib

步骤 3：构建项目

在项目目录中，使用以下命令构建项目：

cargo build --release

步骤 4：运行服务

构建完成后，运行以下命令来启动 LRCLIB 服务：

LRCLIB_LOG=info cargo run --release -- serve --database db.sqlite3

此时，服务将启动并在 http://0.0.0.0:3300 上监听。

步骤 5：（可选）使用 Docker 容器运行

如果您选择使用 Docker，可以构建镜像并运行容器：

• 构建镜像：

podman build -t lrclib-rs:latest -f Dockerfile .

• 运行容器：

podman run --rm -it -d -v lrclib-data:/data -p 3300:3300 -e LRCLIB_LOG=info --name lrclib-rs lrclib-rs:latest

容器运行后，服务将在 http://0.0.0.0:3300 上可用。

以上步骤即为 LRCLIB 项目的详细安装和配置指南。遵循这些步骤，即使是编程新手也可以成功安装并运行此项目。