挂壁TG图床

适合没钱买OSS，但是又想有个图床的挂壁朋友。 一个基于 Telegram 的图片托管服务，支持拖拽上传、密码保护和自动生成多种格式的图片链接。 这个项目依赖tg公开频道，建立的图床是无限大的。 交流群 https/t.me/TGIMGHub

特性

• 🚀 快速上传：支持拖拽和点击上传
• 🔒 密码保护：可配置上传密码
• 📋 多格式链接：自动生成直链、HTML 和 Markdown 格式
• 🔄 实时预览：上传后即时显示图片
• 💾 永久存储：基于 Telegram 的可靠存储
• 🌐 跨平台支持：支持各种图片格式

部署指南

前提

• 一个tg账号
• 一个海外vps

申请机器人token寄创建公开频道

开通Telegram Bot渠道必须：Telegram的TG_BOT_TOKEN和TG_CHAT_ID

首先需要拥有一个Telegram账户，然后按照以下步骤获取TG_BOT_TOKEN和TG_CHAT_ID。

向@BotFather发送/newbot，按照提示输入bot的备注、用户名等信息。成功创建后获得TG_BOT_TOKEN。

创建一个新的频道（Channel），进入新建的频道，选择频道管理，将刚才创建的机器人设为频道管理员。

频道设置为公开并记录一下频道链接末尾的名字，如https://t.me/nzjksks 中的nzjksks

环境要求

• Python 3.7+
• FastAPI
• python-telegram-bot
• 一个 Telegram Bot Token

安装步骤

1. 克隆仓库

git clone https://github.com/DarkSniperGun/TgImgHub.git
cd TgImgHub

2. 安装依赖

pip install -r requirements.txt --break-system-packages

3. 配置服务

复制config.example.py为config.py并修改配置

cp config.example.py config.py
nano config.py

4. 设置系统服务 修改里面的ExecStart那行中 main.py到你项目的路径，可使用pwd查看当前路径 WorkingDirectory填你项目的路径 user填你当前的用户名

nano tgimghub.service

sudo cp tgimghub.service /etc/systemd/system/
sudo systemctl enable tgimghub
sudo systemctl start tgimghub

5. 访问主页 http://your-Ip::21351

配置说明

在 config.py 中设置以下参数：

• BOT_TOKEN: 你的 Telegram Bot Token
• CHANNEL_ID: 你的公开频道关键字 如@nzjksks
• BASE_URL: 你的图片服务URL，如https://guabige.com
• UPLOAD_PASSWORD: 上传密码

Caddy 配置

your.domain.com {
reverse_proxy localhost:21351
}

使用方法

1. 访问你的域名
2. 如果设置了密码，输入上传密码
3. 拖拽或点击上传图片
4. 获取生成的图片链接

API 文档

API 文档

使用 curl 上传图片

1. 无密码上传：

curl -X POST http://your.domain.com/upload/ -F "file=@path_to/image.jpg"

2. 有密码上传：

curl -X POST http://your.domain.com/upload/ -F "file=@path_to/image.jpg" -H "Authorization: your_password"   

参数： file: 图片文件 响应

{
"success": true,
"url": "http://your.domain.com/image/file_id.jpg",
"file_id": "xxx",
"extension": ".jpg"
}

获取图片

http://your.domain.com/file/{file_id}{extension} GET 链接/file/{file_id}{extension}

交流群

• Telegram 群组：@TGIMGHub

贡献指南

欢迎提交 Issue 和 Pull Request！

许可证

MIT License

鸣谢

• FastAPI
• python-telegram-bot
• Caddy