go壁纸api

最后更新于: 2025-12-06 10:36:40

图片服务器 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；

说明：

1不管怎么实现，越简单越好，能实现就好。
2
3首先，壁纸api自身的2个功能不能变:
4
5例如壁纸api
61. imgapi.onedayxyy.cn在自己浏览器打开，会显示一张图片，刷新一次，会切换到另一张图片
72.间隔数s后，会随机切换到下一张图片
8
9然后在次基础上，不管是改teek的代码来适配壁纸api，还是改壁纸api的代码来适配teek，或者两个都改，由开发者自己选择最优解。

源仓库

这个项目是 XGQ GO大佬开发的哦。❤️❤️❤️

yuwen-gueen/img-server · Cloud Native Build

自己fork后出仓库：

https://cnb.cool/onedayxyy/img-server

功能

自动扫描 images 目录下的图片文件
网页展示所有图片
随机图片API
图片列表API
支持跨域访问

使用方法

启动服务器

 1# 使用默认端口 9999
 2./main
 3
 4# 指定端口
 5./main -port 8080
 6
 7# 查看帮助
 8./main --help
 9
10
11##实际部署方法（推荐）
12nohup ./main -port 8082 >> goimgapi_stdout.log 2>> goimgapi_stderr.log &

目录结构

1img_server/
2├── main           # 可执行文件
3├── images/        # 图片目录（会自动创建）
4└── templates/     # HTML模板目录

API接口

接口	说明
`GET /`	主页，显示所有图片
`GET /random-image`	随机返回一张图片
`GET /api/images`	返回所有图片列表的JSON
`GET /images/xxx.jpg`	直接访问图片文件