Random API Go

一个基于Go的随机API服务，支持多种数据源和管理后台。

功能特性

• 🎯 支持多种数据源：兰空图床API、手动配置、通用API接口
• 🔐 OAuth2.0 管理后台登录（CZL Connect）
• 💾 SQLite数据库存储
• ⚡ 内存缓存机制
• 🔄 URL替换规则
• 📝 可配置首页内容
• 🎨 现代化Web管理界面

环境变量配置

复制 env.example 为 .env 并配置以下环境变量：

# 服务器配置
PORT=:5003                    # 服务端口
READ_TIMEOUT=30s             # 读取超时
WRITE_TIMEOUT=30s            # 写入超时
MAX_HEADER_BYTES=1048576     # 最大请求头大小

# 数据存储目录
DATA_DIR=./data              # 数据存储目录

# OAuth2.0 配置 (必需)
OAUTH_CLIENT_ID=your-oauth-client-id        # CZL Connect 客户端ID
OAUTH_CLIENT_SECRET=your-oauth-client-secret # CZL Connect 客户端密钥

快速开始

1. 克隆项目

git clone <repository-url>
cd random-api-go

2. 配置环境变量

cp env.example .env
# 编辑 .env 文件，填入正确的 OAuth 配置

3. 运行服务

go run main.go

4. 访问服务

• 首页: http://localhost:5003
• 管理后台: http://localhost:5003/admin

OAuth2.0 配置

本项目使用 CZL Connect 作为 OAuth2.0 提供商：

• 授权端点: https://connect.czl.net/oauth2/authorize
• 令牌端点: https://connect.czl.net/api/oauth2/token
• 用户信息端点: https://connect.czl.net/api/oauth2/userinfo

请在 CZL Connect 中注册应用并获取 client_id 和 client_secret。

API 端点

公开API

• GET / - 首页
• GET /{endpoint} - 随机API端点

管理API

• GET /admin/api/oauth-config - 获取OAuth配置
• POST /admin/api/oauth-verify - 验证OAuth授权码
• GET /admin/api/endpoints - 列出所有端点
• POST /admin/api/endpoints/ - 创建端点
• GET /admin/api/endpoints/{id} - 获取端点详情
• PUT /admin/api/endpoints/{id} - 更新端点
• DELETE /admin/api/endpoints/{id} - 删除端点
• POST /admin/api/data-sources - 创建数据源
• GET /admin/api/url-replace-rules - 列出URL替换规则
• POST /admin/api/url-replace-rules/ - 创建URL替换规则
• GET /admin/api/home-config - 获取首页配置
• PUT /admin/api/home-config/ - 更新首页配置

数据源类型

1. 兰空图床 (lankong): 从兰空图床API获取图片
2. 手动配置 (manual): 手动配置的URL列表
3. API GET (api_get): 从GET接口获取数据
4. API POST (api_post): 从POST接口获取数据

部署

Docker 部署

FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o random-api-server main.go

FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=builder /app/random-api-server .
COPY --from=builder /app/web ./web
EXPOSE 5003
CMD ["./random-api-server"]

环境变量部署

确保在生产环境中正确设置所有必需的环境变量，特别是OAuth配置。

许可证

MIT License