PicUI 图床服务

PicUI是一个基于FastAPI的简单高效图床服务，支持图片上传、存储、访问和分享。通过简洁的界面和强大的API，让图片管理变得轻松便捷。本项目已移除用户系统，使用更加简洁直观。

🔗 在线体验: 测试地址（服务器配置较低，访问可能较慢，请见谅）
📦 仓库地址: GitHub - laozig/picui

• 便捷上传：支持拖拽上传和API上传
• 多格式支持：兼容JPG、PNG、GIF、WEBP、BMP、TIFF、SVG、ICO、HEIC等多种图片格式
• 图像处理：自动优化图片尺寸、添加自定义水印
• 安全可控：内容安全检测、频率限制
• 分享功能：自动生成短链接、临时外链、HTML/Markdown代码生成
• 多色主题：支持深色、浅色、蓝色、绿色、紫色等多种主题
• 监控统计：Prometheus指标支持、上传日志记录
• 高性能设计：多线程处理、异步IO、并发控制
• 部署灵活：支持Docker、Railway、Render等多种部署方式

• 使用指南 - 详细介绍如何使用PicUI图床
• API文档 - 完整API接口说明和示例
• 服务器部署指南 - 各种环境下的部署方法
• 环境变量配置 - 所有可配置项说明
• 页面访问权限 - 详细的页面访问路径和权限控制说明

# 创建虚拟环境（可选但推荐）
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# 或
.venv\Scripts\activate     # Windows

# 安装依赖
pip install -r requirements.txt

# 方法1：直接运行（开发模式）
python main.py

# 方法2：使用uvicorn（生产环境）
uvicorn src.app:app --host 0.0.0.0 --port 8000 --workers 4

访问 http://localhost:8000 打开图床主页。

# 使用curl上传图片
curl -X POST "http://localhost:8000/upload" -F "file=@/path/to/image.jpg"

Python示例:

import requests

url = "http://localhost:8000/upload"
files = {"file": open("image.jpg", "rb")}

response = requests.post(url, files=files)
print(response.json())

所有配置可通过环境变量或.env文件设置:

更多配置选项请查看环境变量配置文档。

当前支持以下图片格式:

• JPG/JPEG
• PNG
• GIF
• WEBP
• BMP
• TIFF/TIF
• SVG
• ICO
• HEIC/HEIF
• AVIF
• JFIF

PicUI提供便捷的短链接功能，使图片分享更加简单:

• 每次上传图片成功后，系统会自动生成一个永久有效的短链接
• 短链接格式为/s/{code}，例如/s/a1b2c3
• 短链接会包含在上传响应中的short_url字段

通过API可以手动创建临时外链:

POST /create-temp-link/{image_id}?expire_minutes=1440

参数说明:

• image_id: 图片ID
• expire_minutes: 链接有效时间(分钟)，最长7天(10080分钟)

访问/admin/short-links可以管理所有您创建的短链接，包括:

• 查看所有短链接
• 监控短链接访问次数
• 删除不需要的短链接
• 查看过期状态

PicUI支持为图片添加文字水印。有两种方式使用水印功能：

在图片上传成功后，您可以在结果页面看到"添加水印"选项。您可以：

1. 自定义水印文字
2. 选择水印位置（右下角、左下角、右上角、左上角或中心）
3. 调整水印不透明度
4. 点击"应用水印"按钮预览带水印的图片
5. 点击"下载水印图片"按钮直接下载带水印的图片

/images/{filename}/watermark?text=水印文字&position=bottom-right&opacity=0.5

参数说明:

• text: 水印文字
• position: 位置(center/bottom-right/bottom-left/top-right/top-left)
• opacity: 不透明度(0.1-1.0)
• download: 是否下载(true/false)

示例：为图片添加居中显示的半透明水印

/images/e12a45b7-890c-4d2f-a3b5-6c78d9e0f123.jpg/watermark?text=版权所有&position=center&opacity=0.5

PicUI采用多线程和异步设计:

• 使用ThreadPoolExecutor处理CPU密集型任务(图片处理、水印等)
• 使用异步IO处理文件上传和网络请求
• 使用信号量控制并发上传数量
• 使用多进程处理HTTP请求(uvicorn workers)

# 构建镜像
docker build -t picui:latest .

# 运行容器
docker run -d -p 8000:8000 -v ./uploads:/app/uploads --name picui picui:latest

详细部署步骤请参考服务器部署指南。

• 图片文件存储在 uploads/ 目录
• 元数据存储在SQLite数据库 picui.db

欢迎提交Issue和Pull Request!

MIT

PicUI使用会话Cookie进行用户身份识别，主要特点：

• 基于安全随机令牌生成唯一会话ID
• 会话有效期为30天
• 定期清理过期会话
• 用户仅能查看和管理自己上传的内容
• 无需注册登录即可使用系统

会话相关环境变量：

系统现在能够自动处理数据库表结构变更：

1. 启动时会自动检测并尝试添加缺失的数据库列
2. 即使数据库结构与模型定义不完全匹配，应用也能正常工作
3. 上传图片、创建短链接等功能都有完善的错误处理机制
4. 在迁移到新版本时不需要手动修改数据库结构

• images表缺少file_size、upload_ip、width、height和description列，现已自动添加
• upload_logs表缺少saved_filename和file_size列，现已自动添加
• short_links表缺少is_enabled列，现已自动添加
• 所有表（images、upload_logs、short_links）的user_id列类型已从INTEGER改为TEXT
• 为所有表的user_id列添加了索引，提高查询性能

如果应用启动时仍有数据库结构警告，可以执行以下命令手动修复：

python -c "from src.database import upgrade_database; upgrade_database()"

最近的优化更新：

1. 移除了冗余的静态HTML文件：

   • 删除了static/index.html和static/admin.html，使用templates目录下的模板文件作为唯一来源
   • 保留了static/forbidden.html作为403错误页面

2. 项目文件结构更加清晰：

   • templates/目录：包含所有Jinja2模板文件（index.html, admin.html, logs.html, short_links.html）
   • static/目录：包含静态资源和错误页面
   • src/目录：包含所有Python源代码
   • uploads/目录：存储上传的图片文件

这些优化使项目结构更加清晰，减少了维护的复杂性。

项目已进行以下优化：

• 删除了临时修复脚本 (fix_db.py, fix_type.py, fix_width_height.py)
• 删除了数据库检查脚本 (check_db.py)
• 删除了测试文件 (test_db_upgrade.py)
• 合并了重复的运行脚本，统一使用 main.py
• 移除了多余的日志文件
• 增强了日志系统，添加了过滤器防止重复警告
• 优化了图片上传流程，自动生成短链接
• 改进了日志级别设置，默认使用info级别以提供更多调试信息

• 2023.12.15:

  • 修复了所有表的user_id字段类型不匹配问题
  • 完善了数据库自动升级功能

• 2024.01.10:

  • 优化了日志输出，改进了过滤器降低重复警告
  • 修复了图片上传时宽高信息采集错误

• 2024.05.15:

  • 修复了短链接功能无法生成的问题
  • 图片上传现在自动生成短链接，永久有效
  • 清理了项目代码，移除了未使用的修复脚本和测试文件
  • 更新了.gitignore文件，更好地忽略临时文件和数据库备份

• 2024.05.20:

  • 删除了冗余的静态HTML文件，减少了代码重复
  • 优化了项目文件结构，提高了维护性

详细API文档请访问运行实例的 /docs 或 /redoc 路径，或查看API文档。