Go Blog API

基于 Go 语言的博客 API 服务，提供图片存储、Steam 状态查询、系统信息获取等功能。

功能特性

• 图片上传和管理（支持 WebP 格式）
• Steam 游戏状态查询
• IP 信息查询
• 系统信息获取（使用 fastfetch）
• API 调用统计
• 心跳检测

环境要求

• Go 1.20 或更高版本
• MongoDB
• libvips（用于图片处理）
• fastfetch（用于系统信息获取）

安装

1. 克隆仓库

git clone https://github.com/yourusername/Go-Blog-Api.git
cd Go-Blog-Api

2. 安装依赖

go mod download

3. 配置环境变量

cp .env.example .env
# 编辑 .env 文件，填写必要的配置信息

4. 运行服务

go run main.go

Docker 部署

docker build -t blog-api .
docker run -p 5000:5000 blog-api

API 接口

基础接口

• GET / - 主页
• GET /fastfetch - 获取系统信息
• POST /heartbeat - 心跳检测

  # 请求示例
  curl -X POST http://api.example.com/heartbeat \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -d "application=MyApp" \
    -d "introduce=My Application Description" \
    -d "rgba=233,30,99,0.17" \
    -d "applicationOnline=true"
  
  # 响应示例
  {
    "message": "Heartbeat received",
    "application": "MyApp",
    "introduce": "My Application Description",
    "rgba": "233,30,99,0.17",
    "applicationOnline": true
  }

• GET /check - 检查服务状态

  # 请求示例
  curl http://api.example.com/check
  
  # 响应示例（当应用在线时）
  {
    "alive": true,
    "last_heartbeat": 1698314159,
    "application": "MyApp",
    "introduce": "My Application Description",
    "rgba": "233,30,99,0.17",
    "applicationOnline": true
  }
  
  # 响应示例（当应用离线时）
  {
    "alive": true,
    "last_heartbeat": 1698314159,
    "applicationOnline": false
  }
  
  # 响应示例（从未收到心跳时）
  {
    "alive": false,
    "last_heartbeat": null,
    "applicationOnline": false
  }

• GET /check - 检查服务状态

图片相关

• GET /random_image - 随机获取图片
• GET /images/count - 获取图片总数
• GET /images/list - 获取图片列表
• POST /images/add - 添加新图片
• DELETE /images/:hash - 删除图片
• GET /images/:hash - 获取指定图片
• GET /i/:hash - 通过 hash 直接访问图片

其他功能

• GET /steam_status - 获取 Steam 状态
• GET /ipcheck - IP 信息查询
• GET /api_stats - 获取 API 调用统计
• GET /api_stats/:key - 获取特定接口调用次数

Git 仓库代理

• 支持通过 API 服务器代理访问 GitHub 和 GitLab 仓库
• 格式：

  # GitHub 仓库
  git clone http://api.example.com/github/https://github.com/username/repo.git
  
  # GitLab 仓库
  git clone http://api.example.com/gitlab/https://gitlab.com/username/repo.git

许可证

AGPLv3 License

环境变量

除了现有的环境变量外，还需要配置以下变量来启用 Minio S3 存储：

• USE_MINIO_STORAGE: 设置为 "true" 启用 Minio 存储

• MINIO_ENDPOINT: Minio 服务器地址（例如：minio.example.com:9000）

• MINIO_ACCESS_KEY: Minio Access Key

• MINIO_SECRET_KEY: Minio Secret Key

• MINIO_BUCKET: Minio 存储桶名称

• MINIO_REGION: Minio 区域设置

• MINIO_USE_SSL: 是否使用 SSL 连接（true/false）

• CLOUDFLARE_API_TOKEN: Cloudflare API 鉴权 Token

• CLOUDFLARE_ACCOUNT_ID: Cloudflare 账户 ID

• GITHUB_TOKEN: GitHub 个人访问令牌，用于 Git 代理功能

  • 创建地址：https://github.com/settings/tokens
  • 需要的权限：repo (private repo access)