作者： amiao

全栈式智能图床与资源管理平台，让图片管理从繁琐到简单，让文件分享从等待到极速，集成OpenAI API的全自动智能处理管道，支持图像分类、智能打标、NSFW内容审核，让您的图片管理更智能

自动分类

AI自动识别图片内容，智能分类为景物、人物、动物、抽象艺术等类别

智能打标

基于图像内容自动提取关键词标签，支持任务队列和批量处理

内容审核

自动检测NSFW内容，支持自动隐藏、用户提示、拒绝上传三种策略

安全保护

处理管道控制

动态调整并发数(1-100)，支持暂停/恢复/重试，实时WebSocket推送进度

项目截图

功能特性

📸 多格式上传✅ 支持 10+ 格式上传✅ 自定义水印✅ 有效期限时保存✅ 自定义上传文件夹✅ 自定义文件权限	📁 文件管理✅ 无限层级嵌套文件夹✅ 标签与分类系统✅ 批量操作✅ 拖拽操作✅ 自定义右键菜单✅ 收藏夹快速访问	🔍 强大搜索✅ 自然语言搜索✅ 标签搜索✅ 分类搜索✅ 混合搜索✅ 管理端渠道搜索
🤖 AI 自动化处理✅ 自动分类图片✅ 自动打标图片✅ 自动语义化解析图片✅ 自动 NSFW 审核图片	🧠 向量搜索✅ 以图搜图✅ 语义相似度搜索✅ 智能推荐关联图片✅ 基于 Qdrant 向量引擎	🔗 灵活分享✅ 文件夹/图片/混合分享✅ 密码保护与有效期✅ 相册与打包下载✅ 访问邮件通知
🔐 权限控制✅ 防盗链✅ IP 黑白名单✅ 域名黑白名单✅ 流量控制✅ 带宽控制✅ 访问统计分析	🎨 多样主题✅ 12+ 精选主题✅ 赛博朋克、清新、可爱等风格✅ 亮色/暗色自适应✅ 动态主题切换	🌍 国际化✅ 🇨🇳 简体中文✅ 🇺🇸 English✅ 🇯🇵 日本語✅ 双风格主题✅ 更多语言支持中
👥 权限管理✅ 管理员/普通用户角色✅ 精细化权限控制✅ 用户组管理✅ 操作日志审计	💾 配额管理✅ 流量控制✅ 带宽控制✅ 次数控制✅ 动态调整	🔧 开放 API✅ 上传与随机图片接口✅ 文件夹绑定与素材固定✅ 权限验证与访问统计✅ 次数/类型/尺寸限制
🚀 易于部署✅ 单文件二进制✅ Docker 容器化✅ 跨平台支持✅ 一键安装包	📊 数据统计✅ 上传统计图表✅ 存储空间分析✅ 访问量统计✅ 用户行为分析	🎛️ 管理系统✅ 可视化管理界面✅ 实时系统监控✅ 一键配置管理✅ 操作便捷直观

💻 系统要求

最低配置

• 操作系统: Linux (x86_64/ARM64) / macOS (Intel/Apple Silicon) / Windows (WSL2)
• CPU: 2 核心
• 内存: 2GB RAM
• 磁盘: 10GB 可用空间
• 网络: 互联网连接（AI 功能需要）

推荐配置（生产环境）

• CPU: 4 核心及以上
• 内存: 4GB RAM 及以上
• 磁盘: 50GB SSD 及以上
• 网络: 稳定的互联网连接，带宽 100Mbps+

依赖服务（Docker 模式自动安装）

• 数据库: MySQL 5.7+ / SQLite 3.x
• 缓存: Redis 6.0+
• 向量数据库: Qdrant 1.11+（可选，用于 AI 搜索功能）
• AI 服务: OpenAI API 或兼容接口（可选，用于 AI 功能）

---

🚀 快速开始

方式一：一键安装

curl -fsSL http://download.pixelpunk.cc/shell/setup.sh | bash

支持平台：Linux (x86_64/ARM64)、macOS (Intel/Apple Silicon)

安装脚本会自动：

• ✅ 检测系统平台
• ✅ 下载对应安装包
• ✅ 解压并配置环境
• ✅ 启动 PixelPunk 服务

安装完成后，访问 http://localhost:9520 开始使用。

方式二：Docker 部署

# 拉取镜像
docker pull snine98/pixelpunk:latest

# 下载 docker-compose.yml
curl -O https://download.pixelpunk.cc/docker/docker-compose.yml

# 启动所有服务（包含 MySQL + Qdrant + Redis）
docker-compose up -d

访问 http://localhost:9520 开始使用。

---

🎯 首次使用指南

1. 访问系统

部署完成后，打开浏览器访问：

• 一键安装: http://localhost:9520
• Docker 部署: http://localhost:9520
• 自定义端口: 检查您的配置文件

2. 初始化设置

首次访问会自动跳转到安装页面，需要完成以下配置：

数据库配置

• SQLite 模式（推荐个人使用）: 自动创建本地数据库，无需额外配置
• MySQL 模式（推荐生产环境）: 填写数据库连接信息
  • 主机: localhost:3306（Docker 模式自动配置）
  • 数据库名: pixelpunk
  • 用户名: root
  • 密码: 您设置的密码

管理员账号

设置初始管理员信息：

• 用户名: 推荐使用 admin 或您的常用用户名
• 密码: 至少 8 位，建议包含字母和数字
• 邮箱: 用于接收通知（可选）

3. 登录系统

初始化完成后，使用您设置的管理员账号登录：

1. 点击右上角「登录/注册」
2. 输入用户名和密码
3. 登录成功后自动跳转到控制面板

4. 开始使用

登录后，您可以：

• 📤 上传图片: 点击「开始上传」或直接拖拽文件
• 📁 管理文件: 在「文件管理」中查看、编辑、删除文件
• 🔗 创建分享: 右键文件或文件夹，选择「创建分享」
• 🎨 切换主题: 点击右上角主题图标，选择喜欢的风格
• 🌍 切换语言: 点击语言切换按钮（中文/English/日本語）

项目地址

GitHub地址：https://github.com/CooperJiang/PixelPunk

官网地址：https://pixelpunk.cc

demo演示：https://v1.pixelpunk.cc/