【亲测免费】 Imgurl：一个轻量级的图床服务搭建指南

1. 项目介绍

Imgurl 是一个简单易用的个人图床服务器程序，基于 Python 开发，能够帮助用户在本地或自托管环境中便捷地上传和管理图片。该项目提供了命令行工具和 API 接口，支持通过 HTTP/HTTPS 协议上传图片，并可以生成 Markdown 或其他格式的图片链接。

GitHub 地址：https://github.com/helloxz/imgurl.git

2. 项目快速启动

环境准备

确保已安装 Python 3.6 及以上版本以及 pip。

安装 Imgurl

使用 pip 安装 Imgurl：

pip install imgurl

配置 Imgurl

创建配置文件 .env：

IMGURL_HOST=0.0.0.0
IMGURL_PORT=8080
IMGURL_SECRET_KEY=<your_secret_key>
IMGURL_DB_PATH=./data.db

将 <your_secret_key> 替换为你自己的密钥。

启动服务

运行以下命令以启动 Imgurl 服务：

imgurl run

现在，服务应该已经在 http://localhost:8080 上运行。

上传图片

使用提供的 CLI 工具上传图片：

imgurl upload example.jpg

这将返回一个类似于 ![](http://localhost:8080/images/xxxxx.png) 的 Markdown 图片链接。

3. 应用案例和最佳实践

使用 Markdown 编辑器

在 Markdown 文档中，你可以方便地插入由 Imgurl 提供的图片链接。

在你的博客或者笔记中，使用如下格式：
![](http://localhost:8080/images/xxxxx.png)

自定义域名

若要使用自定义域名，只需将配置中的 IMGURL_HOST 设置为您想使用的域名，并确保 DNS 解析正确。

多用户环境

在多用户环境下，可以实现基本的身份验证和权限控制。设置不同用户的密钥，控制他们的上传权限。

4. 典型生态项目

• Markdown 编辑器插件：开发者可以创建 Markdown 编辑器的插件，如 Typora 或 VSCode 扩展，集成 Imgurl 的上传功能。
• Web 应用集成：论坛、博客等 Web 应用可以通过 API 调用 Imgurl 实现图片上传功能。
• 移动应用集成：可以集成到 Android 或 iOS 应用来提供本地图片上传至自托管的 Imgurl 服务。

本指南覆盖了 Imgurl 的基础操作和应用场景，更多详细信息请参考项目官方文档和 GitHub 仓库中的示例。祝您使用愉快！