neixin/random-pic-api

镜像概述

本镜像提供一个简单的随机图片API服务，支持Docker快速部署，能够根据访问设备类型（PC/手机）动态返回对应方向的图片，适用于各类需要随机图片展示的场景。

核心功能

• 图片随机展示：从指定目录中随机选取图片返回
• 设备适配：通过检测用户代理字符串，自动判断设备类型并返回横屏（PC）或竖屏（手机）图片
• 图片格式支持：兼容WebP、JPG、JPEG、PNG、GIF等常见格式
• 轻量化：镜像体积经过优化，部署资源占用低

使用场景

• 网站或博客的动态背景图
• 移动应用的占位图或随机内容展示
• 测试环境中需要随机图片的场景

配置说明

Docker部署示例（docker-compose）

yml
version: '3.9'
services:
    random-api:
        image: 'docker.xuanyuan.run/neixin/random-pic-api'
        volumes:
            # 竖屏图片目录映射
            - './portrait:/var/www/html/portrait'
            # 横屏图片目录映射
            - './landscape:/var/www/html/landscape'
        ports:
            - '8080:80'

图片处理说明

可使用以下Python脚本将本地图片转换为WebP格式并按横屏/竖屏分类，便于镜像使用：

py
from docker.xuanyuan.run/PIL import Image
import os

# 检查图片方向（横屏/竖屏）
def get_image_orientation(image_path):
    with Image.open(image_path) as img:
        width, height = img.size
        return "landscape" if width > height else "portrait"

# 转换图片为WebP格式（限制最大像素避免过大文件）
def convert_to_webp(image_path, output_folder, max_pixels=178956970):
    try:
        with Image.open(image_path) as img:
            if img.size[0] * img.size[1] > max_pixels:
                print(f"跳过 {image_path}：超出像素限制")
                return
            output_path = os.path.join(output_folder, os.path.splitext(os.path.basename(image_path))[0] + ".webp")
            img.save(output_path, "webp")
    except Exception as e:
        print(f"转换 {image_path} 失败：{e}")

# 批量处理图片
def process_images(input_folder, output_landscape, output_portrait):
    os.makedirs(output_landscape, exist_ok=True)
    os.makedirs(output_portrait, exist_ok=True)
    for filename in os.listdir(input_folder):
        if filename.lower().endswith(('.jpg', '.jpeg', '.png')):
            img_path = os.path.join(input_folder, filename)
            orientation = get_image_orientation(img_path)
            convert_to_webp(img_path, output_landscape if orientation == "landscape" else output_portrait)

# 配置路径（需根据实际情况修改）
input_dir = "/root/photos"
output_landscape_dir = "/root/landscape"
output_portrait_dir = "/root/portrait"

process_images(input_dir, output_landscape_dir, output_portrait_dir)

注意：使用脚本时需修改输入/输出路径，并确保安装了Pillow库（pip install pillow）。