docs: update readme

This commit is contained in:
krau
2025-12-19 20:57:28 +08:00
parent 0b97d15b2a
commit 5b8249060d
2 changed files with 115 additions and 71 deletions

View File

@@ -2,9 +2,9 @@
# <img src="docs/static/logo.png" width="45" align="center"> Save Any Bot # <img src="docs/static/logo.png" width="45" align="center"> Save Any Bot
**简体中文** | [English](https://sabot.unv.app/en/) **English** | [简体中文](./README_zh.md)
> ** Telegram 上的文件转存到多种存储端.** > **Save Any Telegram File to Anywhere 📂. Support restrict saving content and beyond telegram.**
[![Release Date](https://img.shields.io/github/release-date/krau/saveany-bot?label=release)](https://github.com/krau/saveany-bot/releases) [![Release Date](https://img.shields.io/github/release-date/krau/saveany-bot?label=release)](https://github.com/krau/saveany-bot/releases)
[![tag](https://img.shields.io/github/v/tag/krau/saveany-bot.svg)](https://github.com/krau/saveany-bot/releases) [![tag](https://img.shields.io/github/v/tag/krau/saveany-bot.svg)](https://github.com/krau/saveany-bot/releases)
@@ -19,46 +19,46 @@
## 🎯 Features ## 🎯 Features
- 支持文档/视频/图片/贴纸…甚至还有 [Telegraph](https://telegra.ph/) - Support documents / videos / photos / stickers… and even [Telegraph](https://telegra.ph/)
- 破解禁止保存的文件 - Bypass "restrict saving content" media
- 批量下载 - Batch download
- 流式传输 - Streaming transfer
- 多用户使用 - Multi-user support
- 基于存储规则的自动整理 - Auto organize files based on storage rules
- 监听并自动转存指定聊天的消息, 支持过滤 - Watch specified chats and auto-save messages, with filters
- 使用 js 编写解析器插件以转存任意网站的文件 - Write JS parser plugins to save files from almost any website
- 存储端支持: - Storage backends:
- Alist - Alist
- S3 - S3
- WebDAV - WebDAV
- 本地磁盘 - Local filesystem
- Telegram (重传回指定聊天) - Telegram (re-upload to specified chats)
## 📦 Quick Start ## 📦 Quick Start
创建文件 `config.toml` 并填入以下内容: Create a `config.toml` file with the following content:
```toml ```toml
[telegram] [telegram]
token = "" # 你的 Bot Token, @BotFather 获取 token = "" # Your bot token, obtained from @BotFather
[telegram.proxy] [telegram.proxy]
# 启用代理连接 telegram, 当前只支持 socks5 # Enable proxy for Telegram, currently only SOCKS5 is supported
enable = false enable = false
url = "socks5://127.0.0.1:7890" url = "socks5://127.0.0.1:7890"
[[storages]] [[storages]]
name = "本地磁盘" name = "Local Disk"
type = "local" type = "local"
enable = true enable = true
base_path = "./downloads" base_path = "./downloads"
[[users]] [[users]]
id = 114514 # 你的 Telegram 账号 id id = 114514 # Your Telegram account id
storages = [] storages = []
blacklist = true blacklist = true
``` ```
使用 Docker 运行 Save Any Bot: Run Save Any Bot with Docker:
```bash ```bash
docker run -d --name saveany-bot \ docker run -d --name saveany-bot \
@@ -67,69 +67,23 @@ docker run -d --name saveany-bot \
ghcr.io/krau/saveany-bot:latest ghcr.io/krau/saveany-bot:latest
``` ```
请 [**查看文档**](https://sabot.unv.app/) 以获取更多配置选项和使用方法. Please [**read the docs**](https://sabot.unv.app/en/) for more configuration options and usage.
## Sponsors ## Sponsors
本项目受到 [YxVM](https://yxvm.com/) [NodeSupport](https://github.com/NodeSeekDev/NodeSupport) 的支持. This project is supported by [YxVM](https://yxvm.com/) and [NodeSupport](https://github.com/NodeSeekDev/NodeSupport).
如果这个项目对你有帮助, 你可以考虑通过以下方式赞助我: If this project is helpful to you, consider sponsoring me via:
- [爱发电](https://afdian.com/a/unvapp) - [Afdian](https://afdian.com/a/unvapp)
## Contributors ## Thanks To
<!-- readme: contributors -start -->
<table>
<tbody>
<tr>
<td align="center">
<a href="https://github.com/krau">
<img src="https://avatars.githubusercontent.com/u/71133316?v=4" width="100;" alt="krau"/>
<br />
<sub><b>Krau</b></sub>
</a>
</td>
<td align="center">
<a href="https://github.com/Silentely">
<img src="https://avatars.githubusercontent.com/u/22141172?v=4" width="100;" alt="Silentely"/>
<br />
<sub><b>Abner</b></sub>
</a>
</td>
<td align="center">
<a href="https://github.com/TG-Twilight">
<img src="https://avatars.githubusercontent.com/u/121682528?v=4" width="100;" alt="TG-Twilight"/>
<br />
<sub><b>Simon Twilight</b></sub>
</a>
</td>
<td align="center">
<a href="https://github.com/ysicing">
<img src="https://avatars.githubusercontent.com/u/8605565?v=4" width="100;" alt="ysicing"/>
<br />
<sub><b>缘生</b></sub>
</a>
</td>
<td align="center">
<a href="https://github.com/AHCorn">
<img src="https://avatars.githubusercontent.com/u/42889600?v=4" width="100;" alt="AHCorn"/>
<br />
<sub><b>安和</b></sub>
</a>
</td>
</tr>
<tbody>
</table>
<!-- readme: contributors -end -->
## Thanks
- [gotd](https://github.com/gotd/td) - [gotd](https://github.com/gotd/td)
- [TG-FileStreamBot](https://github.com/EverythingSuckz/TG-FileStreamBot) - [TG-FileStreamBot](https://github.com/EverythingSuckz/TG-FileStreamBot)
- [gotgproto](https://github.com/celestix/gotgproto) - [gotgproto](https://github.com/celestix/gotgproto)
- [tdl](https://github.com/iyear/tdl) - [tdl](https://github.com/iyear/tdl)
- All the dependencies - All the dependencies, contributors, sponsors and users.
## Contact ## Contact

90
README_zh.md Normal file
View File

@@ -0,0 +1,90 @@
<div align="center">
# <img src="docs/static/logo.png" width="45" align="center"> Save Any Bot
> **把 Telegram 上的文件转存到多种存储端**
[![Release Date](https://img.shields.io/github/release-date/krau/saveany-bot?label=release)](https://github.com/krau/saveany-bot/releases)
[![tag](https://img.shields.io/github/v/tag/krau/saveany-bot.svg)](https://github.com/krau/saveany-bot/releases)
[![Build Status](https://img.shields.io/github/actions/workflow/status/krau/saveany-bot/build-release.yml)](https://github.com/krau/saveany-bot/actions/workflows/build-release.yml)
[![Stars](https://img.shields.io/github/stars/krau/saveany-bot?style=flat)](https://github.com/krau/saveany-bot/stargazers)
[![Downloads](https://img.shields.io/github/downloads/krau/saveany-bot/total)](https://github.com/krau/saveany-bot/releases)
[![Issues](https://img.shields.io/github/issues/krau/saveany-bot)](https://github.com/krau/saveany-bot/issues)
[![Pull Requests](https://img.shields.io/github/issues-pr/krau/saveany-bot?label=pr)](https://github.com/krau/saveany-bot/pulls)
[![License](https://img.shields.io/github/license/krau/saveany-bot)](./LICENSE)
</div>
## 🎯 特性
- 支持文档/视频/图片/贴纸…甚至还有 [Telegraph](https://telegra.ph/)
- 破解禁止保存的文件
- 批量下载
- 流式传输
- 多用户使用
- 基于存储规则的自动整理
- 监听并自动转存指定聊天的消息, 支持过滤
- 使用 js 编写解析器插件以转存任意网站的文件
- 存储端支持:
- Alist
- S3
- WebDAV
- 本地磁盘
- Telegram (重传回指定聊天)
## 快速开始
创建文件 `config.toml` 并填入以下内容:
```toml
[telegram]
token = "" # 你的 Bot Token, 在 @BotFather 获取
[telegram.proxy]
# 启用代理连接 telegram, 当前只支持 socks5
enable = false
url = "socks5://127.0.0.1:7890"
[[storages]]
name = "本地磁盘"
type = "local"
enable = true
base_path = "./downloads"
[[users]]
id = 114514 # 你的 Telegram 账号 id
storages = []
blacklist = true
```
使用 Docker 运行 Save Any Bot:
```bash
docker run -d --name saveany-bot \
-v ./config.toml:/app/config.toml \
-v ./downloads:/app/downloads \
ghcr.io/krau/saveany-bot:latest
```
请 [**查看文档**](https://sabot.unv.app/) 以获取更多配置选项和使用方法.
## 赞助
本项目受到 [YxVM](https://yxvm.com/) 与 [NodeSupport](https://github.com/NodeSeekDev/NodeSupport) 的支持.
如果这个项目对你有帮助, 你可以考虑通过以下方式赞助我:
- [爱发电](https://afdian.com/a/unvapp)
## 鸣谢
- [gotd](https://github.com/gotd/td)
- [TG-FileStreamBot](https://github.com/EverythingSuckz/TG-FileStreamBot)
- [gotgproto](https://github.com/celestix/gotgproto)
- [tdl](https://github.com/iyear/tdl)
- All the dependencies, contributors, sponsors and users.
## 社区和关于作者
- [![通知群组](https://img.shields.io/badge/ProjectSaveAny-Group-blue)](https://t.me/ProjectSaveAny)
- [![讨论区](https://img.shields.io/badge/Github-Discussion-white)](https://github.com/krau/saveany-bot/discussions)
- [![个人频道](https://img.shields.io/badge/Krau-PersonalChannel-cyan)](https://t.me/acherkrau)