⭐基于Github搭建简易图床，让本地图片轻松转外链UrPicLink工具开箱即用！

CodeCodeBond
113 阅读4分钟

​

最近在整理以前的项目，之前为了不使用付费的云存储服务想到了两种方案：

  • 服务器内部存储，nginx做转发得外链形式
  • 利用Github或Gitee等，搭建图床

这里正是我之前项目用到的思路，现如今我把它抽出成为一个外链工具开源出来，希望对大家也有所帮助。

代码实现思路在仓库里`~

如果你支持我 可以帮我点一个star或者follow！感恩Thanks!!

⭐Github Repo: 仓库地址详情

UrPicBed - GitHub图床服务

UrPicBed是一个基于Golang开发的图片上传服务，支持将图片上传到GitHub仓库并返回外链链接。通过这种方式，你可以轻松地将本地图片转换为可分享的网络链接。

功能特性

  • 🖼️ 支持上传图片文件（JPG、PNG、GIF、WebP、BMP）

  • 📝 支持上传Base64编码的图片

  • 🔄 自动负载均衡到多个GitHub仓库

  • 🐳 Docker一键部署

  • 🔧 灵活的配置文件

  • 🌐 跨域支持

  • 📊 健康检查接口

快速开始

使用Docker Compose（推荐）

  1. 克隆项目并进入目录：

cd UrPicBed

  1. 修改配置文件 config/config.yaml：

server: port: 8080 host: "0.0.0.0" github: commit-url-list: - "https://api.github.com/repos/你的用户名/仓库名1/contents/" - "https://api.github.com/repos/你的用户名/仓库名2/contents/" authorization: "Bearer 你的GitHub_TOKEN" accept: "application/vnd.github+json" api-version: "2022-11-28"

  1. 启动服务：

docker-compose up -d

  1. 访问健康检查：

curl http://localhost:8080/health

手动构建

  1. 安装Go 1.21+
  2. 下载依赖：

go mod download

  1. 构建项目：

go build -o urpicbed .

  1. 运行服务：

./urpicbed

API文档

健康检查

GET /health

检查服务状态

响应示例：

{ "success": true, "message": "服务运行正常" }

上传Base64图片

POST /api/v1/upload/base64

请求体：

{ "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==", "mime": "image/png" }

响应示例：

{ "success": true, "message": "上传成功", "data": "https://raw.githubusercontent.com/用户名/仓库名/main/1703123456.png" }

上传图片文件

POST /api/v1/upload/file

请求体： multipart/form-data

  • file: 图片文件（支持JPG、PNG、GIF、WebP、BMP，最大10MB）

响应示例：

{ "success": true, "message": "上传成功", "data": "https://raw.githubusercontent.com/用户名/仓库名/main/1703123456.jpg" }

配置说明

GitHub配置

  • commit-url-list: GitHub仓库的API URL列表，支持多个仓库实现负载均衡

  • authorization: GitHub个人访问令牌（Personal Access Token）

  • accept: GitHub API的Accept头

  • api-version: GitHub API版本

服务器配置

  • port: 服务端口

  • host: 服务主机地址

获取GitHub Token

  1. 访问 GitHub Settings > Developer settings > Personal access tokens

  2. 点击 "Generate new token (classic)"

  3. 选择权限：

    1. repo (完整的仓库访问权限)

  4. 生成并复制Token

  5. 在配置文件中使用：Bearer YOUR_TOKEN

创建GitHub仓库

  1. 在GitHub上创建新的公开仓库

  2. 仓库名称建议格式：picbed-01, picbed-02 等

  3. 将仓库URL添加到配置文件的 commit-url-list 中

使用示例

使用curl上传Base64图片

curl -X POST http://localhost:8080/api/v1/upload/base64 \ -H "Content-Type: application/json" \ -d '{ "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==", "mime": "image/png" }'

使用curl上传图片文件

curl -X POST http://localhost:8080/api/v1/upload/file \ -F "file=@/path/to/your/image.jpg"

使用JavaScript上传

// 上传Base64图片 async function uploadBase64(base64Data, mimeType) { const response = await fetch('http://localhost:8080/api/v1/upload/base64', { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ base64: base64Data, mime: mimeType }) }); return await response.json(); } // 上传文件 async function uploadFile(file) { const formData = new FormData(); formData.append('file', file); const response = await fetch('http://localhost:8080/api/v1/upload/file', { method: 'POST', body: formData }); return await response.json(); }

注意事项

  1. GitHub Token安全: 请妥善保管你的GitHub Token，不要提交到代码仓库

  2. 仓库权限: 确保GitHub Token有对应仓库的写入权限

  3. 文件大小: 单个文件最大支持10MB

  4. 文件类型: 只支持图片文件格式

  5. 负载均衡: 系统会随机选择仓库进行上传，实现负载均衡

故障排除

常见错误

  1. 401 Unauthorized: GitHub Token无效或过期

  2. 403 Forbidden: Token权限不足

  3. 404 Not Found: 仓库URL错误或仓库不存在

  4. 413 Payload Too Large: 文件超过10MB限制

日志查看

# 查看Docker容器日志 docker-compose logs -f urpicbed # 查看应用日志 docker logs -f urpicbed

许可证

MIT License

​

avatar
文章
阅读
粉丝