00:00:00
img-server
图片服务器 img-server
一个简单的Go图片服务器，提供图片展示和随机图片API。
需求
壁纸/文章封面 api模块
使用场景：
需求：
📌需求：给宇宙最美博客-Teek 接入一个壁纸api
具体描述：
目前，宇宙最美博客-Teek的壁纸 已具备 每隔8s随机从壁纸库 显示一张新壁纸功能了，且壁纸有动态放大缩小效果，很美观👏。
此时，我想实现一个 壁纸api 的需求：
我们对用户只需要暴漏一个域名地址，例如imgapi.onedayxyy.cn，然后在浏览器打开这个域名后，就会出现一张壁纸，每刷新一次，就会随机出现一张新壁纸。
那么该如何接入Teek使用呢？
方案1：Teek修改代码，让自己适配这个壁纸api，博客自己 每隔8s就会 强制 请求壁纸api ，让其显示一张新壁纸
方案2：壁纸api 自己实现“每隔8s随机从 壁纸api 显示一张新壁纸”功能，但teek接入后，也需要能正常每隔8s随机从 壁纸api 显示一张新壁纸才行；
这样做的好处就是：
- 我们后期只需要 在
壁纸api源源不断地新增漂亮的风景照/好看的妹纸照片。我们无需修改teek的代码，而我们的网站就可以出现新增的漂亮照片； - 其它Teek道友或者类型的博客也可以使用我们的壁纸api；
说明：
bash
不管怎么实现，越简单越好，能实现就好。
首先，壁纸api自身的2个功能不能变:
例如壁纸api
1. imgapi.onedayxyy.cn在自己浏览器打开，会显示一张图片，刷新一次，会切换到另一张图片
2.间隔数s后，会随机切换到下一张图片
然后在次基础上，不管是改teek的代码来适配壁纸api，还是改壁纸api的代码来适配teek，或者两个都改，由开发者自己选择最优解。源仓库
这个项目是 XGQ GO大佬 开发的哦。❤️❤️❤️
yuwen-gueen/img-server · Cloud Native Build
功能
- 自动扫描
images目录下的图片文件 - 网页展示所有图片
- 随机图片API
- 图片列表API
- 支持跨域访问
使用方法
启动服务器
bash
# 使用默认端口 9999
./main
# 指定端口
./main -port 8080
# 查看帮助
./main --help
##实际部署方法（推荐）
nohup ./main -port 8082 >> goimgapi_stdout.log 2>> goimgapi_stderr.log &目录结构
img_server/
├── main # 可执行文件
├── images/ # 图片目录（会自动创建）
└── templates/ # HTML模板目录API接口
| 接口 | 说明 |
|---|---|
GET / | 主页，显示所有图片 |
GET /random-image | 随机返回一张图片 |
GET /api/images | 返回所有图片列表的JSON |
GET /images/xxx.jpg | 直接访问图片文件 |
支持的图片格式
- JPG/JPEG
- PNG
- GIF
- BMP
- WebP
版本
v1-XGQ大佬源仓库-2025.10.20下载
此版本为XGQ大佬，可正常接入Teek使用；
yuwen-gueen/img-server · Cloud Native Build
位置：v1-XGQ大佬源仓库-2025.10.20下载
v2-人像优化版本-我豆包后更新的-2025.10.20下载
此版本为人像优化版本，解决如下问题：
之前虽然把照片的两边边框给处理掉了，但是像手机拍的照片，被轮播时，拍的人头直接看不到了。
--次问题已被解决。
仓库地址：
onedayxyy/img-server · Cloud Native Build 2708f61f版本。
云盘地址：v2-人像优化版本-我豆包后更新的-2025.10.20下载
其它壁纸api
https://rpic.cxcare.top/api 时光 壁纸api
https://random.dl-web.top/ 威威 壁纸api
https://imgapi.onedayxyy.cn/ One 壁纸api （Teeker壁纸）