Szurubooru开源项目安装与配置指南

Szurubooru开源项目安装与配置指南

szurubooru Image board engine, Danbooru-style. 项目地址: https://gitcode.com/gh_mirrors/szu/szurubooru

一、项目基础介绍

Szurubooru 是一个图像版面引擎，灵感来源于 Danbooru、Gelbooru 和 Moebooru 等服务，专为小型和中型社区设计。它的名称源自波兰语，具有刮擦或擦洗的拟声词含义，发音为 "shoorubooru"。该项目提供了丰富的功能，包括支持多种格式的内容发布、评论、注释、REST API、基于令牌的客户端认证、丰富的搜索系统和权限系统等。

二、主要编程语言

该项目主要使用以下编程语言开发：

• Python：后端逻辑和API实现
• JavaScript：前端用户界面和交互逻辑
• Smarty：模板引擎，用于生成网页
• Stylus：CSS预处理器

三、关键技术与框架

• 后端：使用 Flask 框架构建 RESTful API。
• 前端：采用 Vue.js 或 React 等现代前端框架。
• 数据库：使用 PostgreSQL 作为数据存储。
• 视频处理：使用 yt-dlp 获取网络视频内容。
• 搜索：整合 Elasticsearch 提供强大的搜索功能。
• 安全：实现用户认证和权限控制。

四、安装与配置准备工作

在开始安装之前，请确保您的系统中已经安装以下依赖：

• Docker：用于简化部署过程。
• PostgreSQL：作为数据库系统。
• Elasticsearch：用于搜索服务。
• Python 3.x：后端开发语言。
• Node.js：前端开发工具链。

五、详细的安装步骤

1. 克隆项目仓库

首先，您需要从 GitHub 上克隆 Szurubooru 项目仓库：

git clone https://github.com/rr-/szurubooru.git
cd szurubooru

2. 配置数据库

使用 PostgreSQL 数据库，运行以下命令创建数据库和用户：

sudo su - postgres
createuser -d -P szurubooru_user
createdb -O szurubooru_user szurubooru_db
exit

3. 配置 Elasticsearch

确保 Elasticsearch 服务已启动，并且索引已经创建。

4. 构建项目

构建项目的前端和后端部分：

# 构建后端
docker-compose build server

# 构建前端
docker-compose build client

5. 运行项目

启动服务：

docker-compose up

6. 访问项目

在浏览器中输入 http://localhost:5000 访问项目的后台，输入 http://localhost:8080 访问前端界面。

按照以上步骤操作，您应该能够成功安装和配置 Szurubooru 开源项目。如果在安装过程中遇到问题，可以参考项目 Wiki 页面或社区讨论以获得帮助。

szurubooru Image board engine, Danbooru-style. 项目地址: https://gitcode.com/gh_mirrors/szu/szurubooru