上级 项目
type
status
date
slug
summary
password
子级 项目
tags
category
使用Telegram作为存储的文件外链系统,不限制文件大小和格式。
- 一款以Telegram作为储存的文件外链系统
- 不限制文件大小和格式
- 可以作为telegram图床,也可以作为telegram网盘使用。
- 支持web上传文件和telegram直接上传
搭建在vercel,资源限制,大于5MB的文件不支持
参数
必填参数
- target
- token
可选参数
- pass
- mode
- url
- port
目标Target
目标可为频道、群组、个人
- 当目标为频道时,需要将Bot拉入频道作为管理员,公开频道并自定义频道Link,target值填写Link,如@xxxx
- 当目标为群组时,需要将Bot拉入群组,公开群组并自定义群组Link,target值填写Link,如@xxxx
- 当目标为个人时,则为telegram id(@getmyid_bot获取)
令牌Token
填写你的
bot token
密码Pass
填写访问密码,如不需要,直接填写
none
即可模式Mode
p
代表网盘模式运行,不限制上传后缀
m
在p模式的基础上关闭网页上传,可私聊进行上传(如果target是个人,则只支持指定用户进行私聊上传
链接Url
bot获取FileID的前置域名地址自动补充及api返回完整url的补充
端口Port
自定义运行端口
管理
获取FIleID
对bot聊天中的文件引用并回复
get
可以获取FileID,搭建地址+获取的path即可访问资源如果配置了
url
参数,会直接返回完整的地址部署
二进制
Linux amd64下载:
wget
https://github.com/csznet/tgState/releases/latest/download/tgState.zip
&& unzip tgState.zip && rm tgState.zip
Linux arm64下载:
wget
https://github.com/csznet/tgState/releases/latest/download/tgState_arm64.zip
&& unzip tgState_arm64.zip && rm tgState_arm64.zip
Linux 一键脚本:
使用方法
./tgState 参数
例子
./tgState -token xxxx -target @xxxx
后台运行
nohup ./tgState 参数 &
Docker
pull镜像
docker pull csznet/tgstate:latest
启动
docker run -d -p 8088:8088 --name tgstate 参数 --net=host csznet/tgstate:latest
其中docker的参数需要设置为环境变量
开机自启需要加上
--restart always
例子
docker run -d -p 8088:8088 --name tgstate -e token=token -e target=@target -e mode=p --net=host csznet/tgstate:latest
Vercel
不支持大于5mb文件,不支持tg获取文件路径
API说明
POST方法到路径
/api
表单传输,字段名为image,内容为二进制数据
当设置访问密码时,直接将密码加入url参数pass中,如密码为123:
/api?pass=123
返回示例:
{"code": 1, "message": "/d/xxx","url":"xxx"}
json格式的
url
默认返回tgState的url
参数+访问路径,如果只得到了路径则需要自行设置url
参数picgo-plugin-web-uploader填写说明:
POST参数名:
image
JSON路径:
url
进阶指南
Vercel
vercel默认域名部分地区会有阻断,建议添加自定义域名
使用cname解析到
CloudFlare
SSL证书访问
目的:解决开启SSL&Cloudflare CDN后重定向过多问题
设置路径:域名->SSL/TLS->Overview
设置为Full(strict)
完全缓存图片
目的:加快访问速度,减少api请求次数
设置路径:域名->Rules->Page Rules->Create Page Rule
给
/d/*
设置缓存所有控制请求速率
目的:防止刷上传
设置路径:域名->Security->WAF->Rate limiting rules
建议给
/api
限制在10s不超过2次请求开启Always Online
目的:当服务宕机后,图片正常访问
设置路径:域名->Caching->Configuration->Always Online
- 作者:团子
- 链接:https://ikun.su//article/tgstate
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。
相关文章