Scuttle 项目下载及安装教程

1. 项目介绍

Scuttle 是一个基于 Web 的社交书签系统，允许多个用户在线存储、分享和标记他们喜欢的链接。该项目是一个开源项目，旨在为用户提供一个简单易用的书签管理工具，支持多用户协作和标签分类。

2. 项目下载位置

Scuttle 项目的源代码托管在 GitHub 上，可以通过以下命令进行下载：

git clone https://github.com/scronide/scuttle.git

3. 项目安装环境配置

3.1 环境要求

• Web 服务器：Apache 或 Nginx
• 数据库：MySQL
• PHP：版本 5.6 或更高

3.2 环境配置示例

3.2.1 安装 Apache 和 MySQL

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

sudo apt-get update
sudo apt-get install apache2 mysql-server php libapache2-mod-php php-mysql

3.2.2 配置 MySQL

启动 MySQL 服务并创建数据库：

sudo systemctl start mysql
sudo mysql -u root -p

在 MySQL 命令行中创建数据库：

CREATE DATABASE scuttle;
CREATE USER 'scuttle_user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON scuttle.* TO 'scuttle_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3.2.3 配置 Apache

将 Scuttle 项目文件放置在 Apache 的根目录下（通常是 /var/www/html/）：

sudo mv scuttle /var/www/html/

配置 Apache 以支持 PHP：

sudo nano /etc/apache2/mods-enabled/dir.conf

将 index.php 添加到 DirectoryIndex 列表中：

<IfModule mod_dir.c>
    DirectoryIndex index.php index.html index.cgi index.pl index.xhtml index.htm
</IfModule>

重启 Apache 服务：

sudo systemctl restart apache2

4. 项目安装方式

4.1 数据库表创建

在项目目录中找到 tables.sql 文件，并使用以下命令将其导入到 MySQL 数据库中：

mysql -u scuttle_user -p scuttle < /var/www/html/scuttle/tables.sql

4.2 配置文件修改

复制项目中的 config.inc.php.example 文件并重命名为 config.inc.php：

cp /var/www/html/scuttle/config.inc.php.example /var/www/html/scuttle/config.inc.php

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

$dbuser = 'scuttle_user';
$dbpass = 'password';
$dbname = 'scuttle';
$dbhost = 'localhost';

4.3 设置缓存目录权限

确保 cache 目录具有写权限：

sudo chmod -R 777 /var/www/html/scuttle/cache

5. 项目处理脚本

Scuttle 项目包含多个 PHP 脚本，用于处理不同的功能，如用户登录、书签管理、标签管理等。以下是一些常用的脚本：

• index.php：项目主页
• login.php：用户登录页面
• bookmarks.php：书签管理页面
• tags.php：标签管理页面

通过这些脚本，用户可以进行书签的添加、删除、编辑以及标签的管理操作。

总结

通过以上步骤，您可以成功下载并安装 Scuttle 项目。该项目提供了一个简单易用的社交书签管理系统，适合多用户协作和标签分类的需求。