Skip to content

csznet/tgState

Repository files navigation

tgState

English

一款以Telegram作为储存的文件外链系统

不限制文件大小和格式

可以作为telegram图床,也可以作为telegram网盘使用。

支持web上传文件和telegram直接上传

搭配CLoudFlare使用:https://github.com/csznet/tgState/blob/main/CloudFlare.md

如有疑惑,可以咨询TG @tgstate123

演示

https://tgstate.vercel.app / https://tgstate.ikun123.com/

搭建在vercel,资源限制,大于5MB的文件不支持

不限制大小demo(临时) http://tgstate-cdn.ikun123.com/

演示图片:

tgState

参数说明

必填参数

  • 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参数,会直接返回完整的地址

image

部署

二进制

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

image