介绍 on Save Any Bot

静默模式

Mon, 01 Jan 0001 00:00:00 +0000

静默模式 (silent) #

使用 /silent 命令可以开关静默模式.

默认情况下不开启静默模式, Bot 会询问你每个文件的保存位置.

开启静默模式后, Bot 会直接保存文件到默认位置, 无需确认.

在开启静默模式之前, 需要使用 /storage 命令设置默认保存位置.

存储规则

Mon, 01 Jan 0001 00:00:00 +0000

存储规则 #

允许你为 Bot 在上传文件到存储时设置一些重定向规则, 用于自动整理所保存的文件.

见: #28

目前支持的规则类型:

FILENAME-REGEX
MESSAGE-REGEX
IS-ALBUM

添加规则的基本语法:

“规则类型规则内容存储名路径”

注意空格的使用, 语法正确 bot 才能解析, 以下是一条合法的添加规则命令:

/rule add FILENAME-REGEX (?i)\.(mp4|mkv|ts|avi|flv)$ MyAlist /视频

此外, 规则中的存储名若使用 “CHOSEN” , 则表示存储到点击按钮选择的存储端的路径下

你也可以使用 /rule switch 来开关规则模式. 关闭规则模式时, 所有文件都将保存到默认存储.

预设规则 #

为常见文件类型手动编写正则规则比较繁琐, 因此 Bot 内置了一组预设分类 (视频、图片、音频、文档、压缩包), 可以通过一条命令批量导入:

/rule preset <存储名> [基础路径]

参数:

存储名: 目标存储名 (必须存在且你有权访问)
基础路径: 可选. 各预设分类的子目录会创建在此路径下; 若不填则直接使用默认分类目录名

示例:

# 导入预设规则到 "MyAlist", 使用默认目录布局
/rule preset MyAlist

# 在自定义基础路径 "downloads/sorted" 下导入预设规则
/rule preset MyAlist downloads/sorted

此命令会为每个分类创建 FILENAME-REGEX 规则, 将匹配的文件路由到 基础路径 下对应的子目录:

监听聊天

Mon, 01 Jan 0001 00:00:00 +0000

监听聊天 #

该功能需开启 UserBot 集成.

监听指定聊天的消息, 并自动保存到默认存储中, 遵从存储规则, 并且可以设置过滤器来只保存匹配的消息.

监听聊天:

/watch <chat_id/username> [filter]

取消监听:

/unwatch <chat_id/username>

过滤器类型:

msgre #

正则匹配消息文本, 例如:

/watch 12345678 msgre:.*hello.*

这将会监听 ID 为 12345678 的聊天, 并且只保存消息文本中包含 “hello” 的消息.

直接下载链接

Mon, 01 Jan 0001 00:00:00 +0000

直接下载链接 #

使用 /dl 命令可以直接下载一个或多个 HTTP/HTTPS 链接的文件到存储中.

/dl <url1> [url2] [url3] ...

示例:

/dl https://example.com/file.zip
/dl https://example.com/file1.zip https://example.com/file2.zip

Bot 会验证链接格式, 然后让你选择目标存储位置.

Aria2 下载

Mon, 01 Jan 0001 00:00:00 +0000

Aria2 下载 #

该功能需要在配置文件中启用 Aria2 并配置 RPC 连接.

使用 /aria2dl 命令可以通过 Aria2 下载管理器下载文件, 支持 HTTP/HTTPS、FTP、BitTorrent 等多种协议.

/aria2dl <uri1> [uri2] [uri3] ...

示例:

# 下载 HTTP 链接
/aria2dl https://example.com/file.zip

# 下载磁力链接
/aria2dl magnet:?xt=urn:btih:...

# 下载种子文件 (需要先上传 .torrent 文件)
/aria2dl https://example.com/file.torrent

配置 Aria2:

在 config.toml 中添加:

[aria2]
enable = true
url = "http://localhost:6800/jsonrpc"
secret = "your-rpc-secret" # 如果配置了 rpc-secret
remove_after_transfer = true # 转存完成后删除本地文件

yt-dlp 视频下载

Mon, 01 Jan 0001 00:00:00 +0000

yt-dlp 视频下载 #

该功能需要在系统中安装 yt-dlp 命令行工具.

使用 /ytdlp 命令可以下载支持的视频网站的视频和音频, 支持 YouTube、Bilibili、Twitter 等 1000+ 个网站.

/ytdlp <url1> [url2] [flags...]

示例:

# 基本下载
/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ

# 下载多个视频
/ytdlp https://www.youtube.com/watch?v=video1 https://www.youtube.com/watch?v=video2

# 使用自定义参数
/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ -f best
/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ --extract-audio --audio-format mp3

常用参数:

-f <format>: 指定下载格式 (如 best, worst, bestvideo+bestaudio)
--extract-audio: 提取音频
--audio-format <format>: 音频格式 (如 mp3, m4a, wav)
--write-sub: 下载字幕
--write-thumbnail: 下载缩略图

更多参数请参考 yt-dlp 文档.

存储间传输

Mon, 01 Jan 0001 00:00:00 +0000

存储间传输 #

使用 /transfer 命令可以在不同存储之间直接传输文件, 无需经过 Telegram.

/transfer <source_storage>:/<source_path> [filter]

参数说明:

source_storage: 源存储名称
source_path: 源路径
filter: 可选的正则表达式过滤器, 只传输匹配的文件

示例:

# 传输整个目录
/transfer local1:/downloads

# 传输指定路径的文件
/transfer alist1:/media/photos

# 只传输 mp4 文件
/transfer webdav1:/videos ".*\.mp4$"

# 传输图片文件
/transfer local1:/pictures "(?i)\.(jpg|png|gif)$"

Bot 会:

列出源路径下的所有文件
应用过滤器 (如果提供)
显示文件数量和总大小
让你选择目标存储
让你选择目标目录 (如果该存储配置了目录)
开始传输任务

注意:

源存储必须支持列举和读取功能
目标存储必须支持写入功能
传输过程显示实时进度
支持取消正在进行的传输任务

转存 Telegram 之外的文件

Mon, 01 Jan 0001 00:00:00 +0000

转存 Telegram 之外的文件 #

除了 Telegram 上的文件, Bot 还可通过 JavaScript 插件或内置解析器来支持转存其他网站的文件.

查看贡献解析器文档了解详情

只需向 Bot 发送符合解析器要求的链接即可使用, 当前内置的解析器:

Twitter
Kemono

文件命名与重名策略

Mon, 01 Jan 0001 00:00:00 +0000

文件命名与重名策略 #

SaveAny-Bot 支持在 Telegram 中通过 /config 和 /fnametmpl 命令自定义保存文件的命名方式, 以及处理与已存在文件重名时的冲突策略.

`/config` — 用户配置 #

/config 命令会弹出一个内联菜单, 你可以在其中修改以下两项用户级设置:

文件名策略 — 保存文件的命名方式
重名文件保存策略 — 目标存储中已存在同名文件时的处理方式

设置按用户分别保存, 对该用户后续所有的保存/转存任务生效.

文件名策略 #

选项	行为
`默认`	使用媒体原始文件名, 没有原始文件名时使用生成名
`优先从消息生成`	优先根据消息内容 (如 caption、文本) 生成文件名, 而非原始文件名
`自定义模板`	使用 `/fnametmpl` 设置的自定义模板渲染文件名

重名文件保存策略 #

选项	行为
`始终重命名` (默认)	保留已有文件, 将新文件以另一个名字保存
`每次询问`	每次遇到重名时通过内联按钮提示你选择
`始终覆盖`	用新文件替换已有文件
`始终跳过`	对重名文件不做处理

重名策略仅在能够检测文件是否已存在的存储后端生效. 不支持检测文件是否存在的存储后端会退化为覆盖行为.

`/fnametmpl` — 自定义文件名模板 #

当文件名策略设置为 自定义模板 时, SaveAny-Bot 会用 /fnametmpl 配置的模板来渲染所保存文件的文件名.

HTTP API

Mon, 01 Jan 0001 00:00:00 +0000

HTTP API #

SaveAny-Bot 提供了一套 HTTP API，允许你通过程序化方式创建下载/转存任务、查询任务状态、取消任务等，无需通过 Telegram 操作。

启用 API #

在 config.toml 中添加或修改以下配置：

[api]
enable = true
host = "0.0.0.0" # 监听地址，默认 0.0.0.0
port = 8080 # 监听端口，默认 8080
token = "your-token" # 鉴权 Token，强烈建议设置

也可通过环境变量覆盖（前缀 SAVEANY_）：

环境变量	对应配置项
`SAVEANY_API_ENABLE`	`api.enable`
`SAVEANY_API_HOST`	`api.host`
`SAVEANY_API_PORT`	`api.port`
`SAVEANY_API_TOKEN`	`api.token`

若 `token` 为空，API 服务将**不进行任何鉴权**即可访问，存在安全风险。

鉴权 #

当配置了 token 时，所有 API 请求均需在 HTTP 请求头中携带 Bearer Token：

Authorization: Bearer <your-token>

鉴权失败时返回 401：

{ "error": "unauthorized", "message": "invalid token" }

错误响应格式 #

所有错误均使用统一的 JSON 格式：

命令行子命令

Mon, 01 Jan 0001 00:00:00 +0000

命令行子命令 #

除了直接运行 ./saveany-bot (不带子命令) 启动 Telegram Bot 外, 这个二进制文件还提供两个把本地文件上传到存储后端的辅助子命令: upload (一次性) 和 watch (持续监听).

这些子命令会读取与 Bot 相同的 config.toml, 初始化数据库和缓存, 然后执行任务. 它们不会启动 Telegram Bot 本身, 但 telegram 类型的存储会在需要上传时临时启动 Bot 客户端来执行上传.

`upload` — 上传单个文件 #

saveany-bot upload -f <文件> -s <存储名> [-d <目录>] [--no-progress]

参数:

参数	必填	说明
`-f, --file`	是	待上传的本地文件路径
`-s, --storage`	是	目标存储名 (必须存在于 `config.toml`)
`-d, --dir`	否	存储中的目标目录, 默认使用存储的 `base_path`
`--no-progress`	否	关闭终端进度条

示例:

# 上传文件到 "MyAlist" 的默认目录
./saveany-bot upload -f ./movie.mp4 -s MyAlist

# 上传到指定子目录
./saveany-bot upload -f ./movie.mp4 -s MyAlist -d movies/2026

# 通过 Telegram 存储上传并关闭进度条
./saveany-bot upload -f ./photo.jpg -s MyChannel --no-progress

`watch` — 监听目录并自动上传 #

watch 子命令持续监听一个本地目录, 将新建或修改的文件上传到存储后端, 并保留相对监听根目录的子目录结构.

安装与更新

Mon, 01 Jan 0001 00:00:00 +0000

安装与更新 #

从预编译文件部署(推荐) #

在 Release 页面下载对应平台的二进制文件.

在解压后目录新建 config.toml 文件, 参考配置说明编辑配置文件

运行:

chmod +x saveany-bot
./saveany-bot

进程守护 #

systemd (常规 Linux)

创建文件 /etc/systemd/system/saveany-bot.service 并写入以下内容:

[Unit]
Description=SaveAnyBot
After=systemd-user-sessions.service

[Service]
Type=simple
WorkingDirectory=/yourpath/
ExecStart=/yourpath/saveany-bot
Restart=always

[Install]
WantedBy=multi-user.target

设为开机启动并启动服务:

systemctl enable --now saveany-bot

procd (OpenWrt)

添加开机自启动服务

创建文件 /etc/init.d/saveanybot ，参考 wrt_init 并自行修改:

#!/bin/sh /etc/rc.common

#This is the OpenWRT init.d script for SaveAnyBot

START=99 
STOP=10
description=&#34;SaveAnyBot&#34;

WORKING_DIR=&#34;/mnt/mmc1-1/SaveAnyBot&#34;
EXEC_PATH=&#34;$WORKING_DIR/saveany-bot&#34;
start() {
 echo &#34;Starting SaveAnyBot...&#34;
 cd $WORKING_DIR
 $EXEC_PATH &amp;
}
stop() {
 echo &#34;Stopping SaveAnyBot...&#34;
 killall saveany-bot
}
reload() {
 stop
 start
}

赋予权限:

chmod +x /etc/init.d/saveanybot

然后将文件复制到 /etc/rc.d 并重命名为 S99saveanybot, 同样赋予权限:

chmod +x /etc/rc.d/S99saveanybot

添加快捷指令

创建文件 /usr/bin/sabot ，参考 wrt_bin 并自行修改，注意此处文件编码仅支持 ANSI 936 . 随后赋予权限:

chmod +x /usr/bin/sabot

使用 Docker 部署 #

Docker Compose #

下载 docker-compose.yml 文件, 在同目录下新建 config.toml 文件, 参考 config.example.toml 编辑配置文件.

存储端配置

Mon, 01 Jan 0001 00:00:00 +0000

存储端配置 #

请先阅读配置说明了解配置文件的基本格式.

Alist #

type=alist

不支持 Stream 模式.

url = "https://alist.example.com" # Alist 的 URL
username = "your_username" # Alist 的用户名
password = "your_password" # Alist 的密码
base_path = "/path/saveanybot" # Alist 中的基础路径, 所有文件将存储在此路径下
token_exp = 3600 # Alist 访问令牌的自动刷新时间, 单位秒
token = "your_token" 
# Alist 的访问令牌, 可选, 如果不设置则使用用户名和密码进行身份验证. 
# 使用 token 验证时无法自动刷新 token

本地磁盘 #

type=local

base_path = "./downloads" # 本地存储的基础路径, 所有文件将存储在此路径下

WebDAV #

type=webdav

url = "https://webdav.example.com" # WebDAV 的 URL
username = "your_username" # WebDAV
password = "your_password" # WebDAV 的密码
base_path = "/path/to/webdav" # WebDAV 中的基础路径, 所有文件将存储在此路径下

S3 #

type=s3

介绍 on Save Any Bot

静默模式

静默模式 (silent) #

存储规则

存储规则 #

预设规则 #

监听聊天

监听聊天 #

msgre #

直接下载链接

直接下载链接 #

Aria2 下载

Aria2 下载 #

yt-dlp 视频下载

yt-dlp 视频下载 #

存储间传输

存储间传输 #

转存 Telegram 之外的文件

转存 Telegram 之外的文件 #

文件命名与重名策略

文件命名与重名策略 #

/config — 用户配置 #

文件名策略 #

重名文件保存策略 #

/fnametmpl — 自定义文件名模板 #

HTTP API

HTTP API #

启用 API #

鉴权 #

错误响应格式 #

命令行子命令

命令行子命令 #

upload — 上传单个文件 #

watch — 监听目录并自动上传 #

安装与更新

安装与更新 #

从预编译文件部署(推荐) #

进程守护 #

添加开机自启动服务

添加快捷指令

使用 Docker 部署 #

Docker Compose #

存储端配置

存储端配置 #

Alist #

本地磁盘 #

WebDAV #

S3 #

`/config` — 用户配置 #

`/fnametmpl` — 自定义文件名模板 #

`upload` — 上传单个文件 #

`watch` — 监听目录并自动上传 #