SP Cloud Blacklist

搭建你的个人云端黑名单来维护你的社区

查看 Demo · 报告 Bug

喜欢这个项目？请考虑捐赠来帮助它完善！

准备开始

Warning

本项目基于 Node v18.20.0 + MySQL v5.7.26 开发
其余版本请自行测试
本文档版本 v1.2.2 所对应代码版本 v1.0.2_7.23

准备好所需的运行环境后，您可以通过以下步骤来开始使用本项目：

1. 克隆或下载本项目到本地
2. 进入项目目录，运行 npm install 安装依赖
   ( 根据您的包管理器自行选择安装方式 )
3. 运行 npm run start 启动项目
   ( 根据您的包管理器自行选择启动方式 )
4. 访问 http://localhost:3000/install 进行系统安装后即可使用
5. 推荐您在安装完成后重新启动一次本项目获取更加优质的体验

系统自定义

• 数据库配置：在 install.lock 中修改数据库配置
• 端口配置：在 settings/port.json 中修改端口配置
• 样式配置：在 public/css/style.css 中修改您的样式

系统更新

• 在 http://localhost:端口号/admin/update 查看最新的更新内容
• 除有关于数据库声明外 您可以备份您的数据库数据然后下载最新版本覆盖当前版本 需重新设置数据库连接配置
• 注意：在更新前请确保您已经备份了您的数据库数据 出现数据丢失等问题请自行承担后果
• 更新是非必要的 如果您已修改过源代码 请自行对比最新版本进行修改 出现问题请自行承担后果 可选择有偿更新
• 注意：如果您在更新过程中遇到任何问题 请及时联系作者

Todo:

更新项目	内容	完成	日期	状态
图片管理	添加快捷图片上传导入功能	✅	2025.07.08	已上线
安装系统	添加一键快速迅捷安装系统	✅	2025.07.09	已上线
接口重构	重构接口使其更加简洁快速	✅	2025.07.20	已上线
逻辑优化	优化部分逻辑使其更加高效	✅	2025.07.20	已上线
自定端口	自定义端口使其更加的安全	✅	2025.07.23	已上线
更改密码	更改后台管理密码保证安全	❌	NULL	待排期
日志管理	日志系统使系统运作透明化	❌	NULL	待排期
系统管理	快捷管理系统设置优化整站	❌	NULL	待排期
使用文档	可使系统更方便且快速上手	❌	NULL	待排期

License

本项目根据 GNU通用公共许可证v3.0(GPL-3.0) 获得许可 有关完整的许可证文本，请参阅 LICENSE

关键要求：

• 您必须披露任何衍生作品的源代码
• 您必须保留本许可和版权声明 的所有副本
• 衍生作品也必须根据GPL-3.0 获得许可