Shimmie2 项目下载及安装教程

1. 项目介绍

Shimmie2 是一个易于安装的社区图像画廊，也被称为“booru”。它允许用户上传、浏览和管理图像，并提供了丰富的功能来定制和管理图像库。Shimmie2 是一个开源项目，基于 PHP 开发，适合用于构建个人或小型社区的图像分享平台。

2. 项目下载位置

Shimmie2 的项目代码托管在 GitHub 上。你可以通过以下命令从 GitHub 仓库中下载项目：

git clone https://github.com/shish/shimmie2.git

3. 项目安装环境配置

3.1 环境要求

• PHP：版本 7.2 或更高
• MySQL：版本 5.6 或更高
• Web 服务器：如 Apache 或 Nginx
• Composer：用于管理 PHP 依赖

3.2 环境配置示例

3.2.1 安装 PHP

在 Ubuntu 系统上，可以使用以下命令安装 PHP：

sudo apt update
sudo apt install php php-mysql

3.2.2 安装 MySQL

在 Ubuntu 系统上，可以使用以下命令安装 MySQL：

sudo apt update
sudo apt install mysql-server

3.2.3 安装 Composer

在 Ubuntu 系统上，可以使用以下命令安装 Composer：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer

3.3 配置 Web 服务器

3.3.1 配置 Apache

编辑 Apache 配置文件 /etc/apache2/sites-available/shimmie2.conf，添加以下内容：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/shimmie2
    <Directory /var/www/shimmie2>
        AllowOverride All
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

启用站点并重启 Apache：

sudo a2ensite shimmie2
sudo systemctl restart apache2

3.3.2 配置 Nginx

编辑 Nginx 配置文件 /etc/nginx/sites-available/shimmie2，添加以下内容：

server {
    listen 80;
    server_name yourdomain.com;

    root /var/www/shimmie2;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

启用站点并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/shimmie2 /etc/nginx/sites-enabled/
sudo systemctl restart nginx

4. 项目安装方式

4.1 下载项目

git clone https://github.com/shish/shimmie2.git /var/www/shimmie2

4.2 安装依赖

进入项目目录并安装 PHP 依赖：

cd /var/www/shimmie2
composer install

4.3 配置数据库

创建一个新的 MySQL 数据库和用户：

CREATE DATABASE shimmie2;
CREATE USER 'shimmie2user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON shimmie2.* TO 'shimmie2user'@'localhost';
FLUSH PRIVILEGES;

4.4 配置 Shimmie2

复制配置文件并进行编辑：

cp conf_default.php conf.php

编辑 conf.php 文件，配置数据库连接信息：

$database_type = "mysql";
$database_user = "shimmie2user";
$database_pass = "password";
$database_host = "localhost";
$database_name = "shimmie2";

4.5 完成安装

访问你的网站地址，按照安装向导完成安装。

5. 项目处理脚本

Shimmie2 提供了一些处理脚本来管理图像和用户数据。你可以通过命令行运行这些脚本。

5.1 清理缓存

php shimmie.php cache flush

5.2 更新数据库

php shimmie.php db update

5.3 管理用户

php shimmie.php user list
php shimmie.php user add username password

通过以上步骤，你可以成功下载、安装并配置 Shimmie2 项目。