搭建使用Telegram作为存储的文件外链系统TgState

上级项目

type

status

date

slug

summary

password

子级项目

参数

必填参数

target

token

可选参数

pass

mode

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 一键脚本：

bash -c "$(curl -fsSL https://raw.githubusercontent.com/csznet/tgState/main/get.sh)"

使用方法

./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获取文件路径

点我传送至Vercel配置页面

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://github.com/csznet/tgState

参数

目标Target

令牌Token

密码Pass

模式Mode

链接Url

端口Port

管理

部署

二进制

Docker

Vercel

API说明

进阶指南

Vercel

CloudFlare

欢迎来到我的博客