Gitee搭建图床

简介

Gitee图床是一种利用Gitee代码托管平台作为图片存储服务的解决方案。通过结合PicGo等图片上传工具，可以实现图片的自动上传和URL获取，非常适合个人博客、文档写作等场景。

优势

• 免费使用（Gitee提供免费仓库）
• 稳定可靠（基于Gitee平台）
• 易于配置（通过PicGo工具）
• 支持多种编辑器（Typora、Obsidian等）

局限性

• 需要公开仓库（私有仓库可能无法直接访问图片）
• 有存储和带宽限制
• 访问速度可能受网络影响

所需工具

• Gitee账号
• PicGo（图片上传工具）
• 支持PicGo的编辑器（如Typora、Obsidian等）

准备工作

注册Gitee账号

如果还没有Gitee账号，需要先注册一个账号。访问Gitee官网进行注册。

安装Node.js

PicGo及其Gitee插件依赖Node.js环境，需要先安装Node.js。

1. 访问Node.js官网
2. 下载LTS版本（推荐稳定版）
3. 运行安装程序，按默认设置安装即可
4. 安装完成后，在命令行中验证安装：

   1 2	node -v npm -v

安装PicGo

PicGo是图片上传工具，支持多种图床。

1. 官方文档：https://picgo.github.io/PicGo-Doc/
2. 可以在山东大学镜像站下载安装包：https://mirrors.sdu.edu.cn/github-release/1765364126/github-release/Molunerfinn_PicGo/
3. 下载适合你系统的安装包并安装

Gitee配置

创建仓库

1. 打开链接：https://gitee.com/projects/new
2. 创建一个新的仓库，用于存储图片。

配置说明：

• 仓库名称：随意（建议命名为如”images”或”imgbed”便于识别）
• 仓库归属：选择自己的账号（对应后面PicGo插件的owner）
• 仓库路径：随意（对应后面PicGo插件的repo）
• 仓库描述：随意
• 仓库类型：公开仓库（必须为公开，否则图片无法直接访问）
• 初始化仓库：建议初始化README文件
• 点击创建仓库按钮

获取私人令牌

为了安全起见，需要获取一个私人令牌（Personal Access Token），用于PicGo插件的配置。

1. 打开私人令牌设置页面：https://gitee.com/profile/personal_access_tokens
2. 点击生成新令牌按钮

配置说明：

• 输入令牌描述（例如：PicGo）
• 勾选user_info、project权限
• 点击提交按钮
• 复制生成的令牌（对应PicGo插件配置的token）

PicGo配置

安装Gitee插件

1. 打开PicGo客户端
2. 在软件的插件设置中，搜索Gitee插件
3. 安装gitee 2.0.7插件即可

配置Gitee插件

1. 找到插件配置入口：

2. 在插件内填入上述的参数：

参数说明：

• owner：你的Gitee用户名
• repo：你创建的仓库名称
• token：前面获取的私人令牌
• path：填写后，图片会上传到Gitee仓库中的对应目录下（可选，如images/）
• customUrl：自定义域名（可选，如使用CDN加速）
• 点击确定按钮保存配置

3. 在上传区选择Gitee图床即可开始使用

编辑器集成

Typora配置

1. 打开Typora
2. 进入偏好设置 -> 图像
3. 选择上传服务为PicGo(app)
4. 配置PicGo路径（通常会自动检测）
5. 点击验证图片上传选项测试配置

Obsidian配置

1. 安装Obsidian插件：obsidian-image-auto-upload-plugin
2. 在插件设置中配置PicGo路径
3. 启用插件后即可自动上传粘贴的图片

使用方法

配置完成后，就可以在支持的编辑器中直接粘贴图片，图片会自动上传到Gitee仓库，并生成对应的URL链接。

注意事项

1. 仓库必须设置为公开，否则图片无法正常访问
2. 私人令牌具有较高权限，请妥善保管
3. Gitee对单个文件大小有限制（通常为50MB）
4. 注意遵守Gitee的使用条款，避免滥用
5. 建议定期备份重要图片

常见问题

图片无法显示

• 检查仓库是否为公开状态
• 检查图片URL是否正确
• 检查网络连接情况

上传失败

• 检查私人令牌是否正确
• 检查网络连接
• 检查PicGo插件配置
• 确认文件大小未超出限制

插件无法安装

• 检查Node.js是否正确安装
• 检查网络连接（可能需要科学上网）
• 尝试重启PicGo客户端