小奏随机图片 API - 一套简洁高效的随机图床系统

前言

搭建一个随机图片 API 有什么用？你可以用它来做网页背景图随机切换、博客文章随机配图、头像随机展示等各种有趣的场景。今天给大家分享一套我自己开发的随机图片 API 系统 —— 小奏随机图片 API，功能完善，部署简单，现已更新至 v2.0.0 重大版本。

📌 在线体验：https://api.uelogin.cn/

📖 安装文档：https://docs.uelogin.cn/

✨ 核心功能介绍

🖼️ 随机图片 API

系统的核心功能，访问 API 地址即可获取一张随机图片，支持 302 重定向和 JSON 返回两种模式。 v2.0 新增 PC / 移动端分离 API，自适应检测设备类型返回对应图片。

// 自适应 （自动检测设备）
https://api.uelogin.cn/api

// PC 端专用
https://api.uelogin.cn/api_pc.php

// 移动端专用
https://api.uelogin.cn/api_mobile.php

// HTML 直接引用
<img src="https://api.uelogin.cn/api" alt="随机图片">

一行代码即可调用，适配各种应用场景。

🎨 模板系统 （v2.0 新增）

v2.0 全新引入前端模板系统，支持上传切换不同风格的模板包 （ZIP 自动解压），安全的变量提取机制。你可以轻松自定义首页外观，打造专属的随机图片站点风格。

📥 自动化采集

无需手动上传图片，支持从网络自动采集图片到图床。 v2.0 支持 PC 端 / 移动端独立配置采集源，分别管理不同尺寸的图片库，定时运行采集脚本即可自动扩充图库。

🔄 格式转换

自动将图片转换为 WebP 格式，大幅减小图片体积，提升加载速度，节省带宽资源。支持主流图片格式转换。

🛡️ 安全审核

集成 NSFWJS 图片审核系统，自动识别违规图片并隔离，保障图床内容安全合规。支持手动审核和自动批量审核。

📊 后台管理

v2.0 全新后台管理系统：

• 现代化仪表盘设计 （类 WordPress 风格）
• 网站基本信息与 SEO 配置
• 图片数量统计 （PC / 移动端分别统计）
• 访问日志查看 （v2.0 新增 IP 地理位置显示）
• 采集任务监控 （PC / 移动端分离控制）
• 模板管理与切换
• 审核记录管理

🌙 精美首页

二次元风格首页，动态效果丰富。基于模板系统可自由切换不同风格主题，响应式设计完美适配各种设备。

📁 图片存放说明

支持的格式：JPG 、 JPEG 、 PNG 、 GIF 、 WebP 、 BMP 、 AVIF 、 HEIC 、 HEIF

⚙️ 部署要求

• PHP >= 7.4（推荐 PHP 8.0+）
• MySQL 5.7+ 或 SQLite3
• PDO 扩展 + cURL 扩展
• GD 或 Imagick 图像处理扩展

💾 数据库支持

🚀 安装方法

1. 下载源码上传到服务器
2. 访问 https://你的域名/install.php
3. 按提示完成安装 （推荐选择 SQLite，无需配置数据库账号密码）
4. 登录后台开始使用
5. 安装完成后请删除 install.php

👉 详细图文教程请查看：安装文档

v2.0 更新亮点

• ✅ 全新后台管理系统重构 （现代化 UI）
• ✅ 前端模板系统 （支持上传切换）
• ✅ PC / 移动端独立 API 和采集源
• ✅ 访问日志新增 IP 地理位置显示 （兼容 SQLite）
• ✅ 全方位安全加固 （SSRF / CSRF / SQL 注入防护）
• ✅ 数据库自动迁移 （旧版用户无缝升级）

📋 完整更新日志：CHANGELOG.md

写在最后

这套系统是我根据自己的需求开发的，经过多次迭代优化，现已发布 v2.0.0 重大版本。代码开源免费 （MIT 协议），欢迎下载使用，有问题可以在仓库提 Issue 反馈。如果觉得不错，欢迎点个 Star ⭐ 支持一下～