TelePost

语言 / Language: 中文 · English

Telegram 频道投稿、审核与发布服务。

TelePost 是一个自托管服务，用于 Telegram 频道的投稿、审核和发布。用户可以通过 Telegram Bot 或 Mini App 投稿，其他程序可以通过 HTTP API 提交内容；所有入口最终进入同一套投稿、审核和发布流程。

Telegram Bot ─────┐
Telegram Mini App ├──→ TelePost ──→ Telegram Channel
HTTP API ─────────┘

功能

Bot 投稿：图片、视频、音频和文件
审核队列：审核、修改后发布、剧透控制、审核历史
Mini App：投稿、内容浏览、我的投稿、审核和管理
HTTP API：文件上传、Bearer Token、幂等提交
频道搜索：历史内容、标签和投稿记录
小说 / 长文：TXT 可生成 Telegraph 在线阅读页
多 Bot：一个进程运行多个相互隔离的 Bot
SQLite：持久化存储，重启后恢复

快速开始

pip install telepost-bot
telepost --setup
telepost

需要 Python 3.10+；图片处理依赖系统级 libvips。

开始前：用 @BotFather 创建一个 Bot，把它加入目标频道并授予发帖权限。

首次运行 telepost 会进入配置向导，填入 Bot Token、Channel ID、Owner ID；之后直接运行 telepost 即以前次配置启动。启动后向 Bot 发送 /start，再用 /submit 发布第一条投稿。

名称	值
PyPI 项目名	`telepost-bot`
命令行	`telepost`
Python 导入	`telepost`
Python	3.10+

安装

方式	用法	适合
PyPI	`pip install telepost-bot`	普通安装、服务器、脚本
Release	下载	不想安装 Python
Docker	`ghcr.io/redtidev1918/telepost:<version>`	容器部署
源码	`git clone`	开发、自建环境

生产环境固定 Release 版本，不要使用 latest。完整安装、升级和卸载见安装与部署。

HTTP API

先在 Bot 中用 /gen_token 生成 Token，再提交内容：

curl -X POST 'https://example.com/api/v1/submissions' \
  -H 'Authorization: Bearer tp_xxxx' \
  -F 'files=@image.jpg' \
  -F 'title=Example' \
  -F 'tags=illustration' \
  -F 'idempotency_key=example:123'

适合 RSS、爬虫、CI、定时任务、自有脚本以及 PixivFlow 等自动化工具。

完整接口与字段见 HTTP API。

Mini App

Mini App 是 TelePost 的可选 Web 前端。

普通用户可以投稿、浏览公开内容和查看自己的投稿；reviewer / admin 可以使用审核和管理功能。

Mini App 与 Bot 共用同一套后端、权限和投稿状态。配置见 Mini App。

多 Bot 与部署

TelePost 支持在一个进程中运行多个相互隔离的 Bot，各自拥有独立的配置、数据目录与 Telegram 入口。

可以部署在本地服务器、VPS、Docker / Compose 或 Fly.io。没有公网 HTTPS 时使用 Polling；需要接收 Telegram Webhook 时使用 Webhook。

安装与部署 · 配置 · 运行模式 · Fly.io

正式发版和生产部署见运维手册。

文档

完整文档站：https://redtidev1918.github.io/TelePost/

内容	文档
安装、升级、卸载	安装与部署
配置	配置参考
Telegram 命令	命令参考
HTTP API	API
Mini App	Mini App
Webhook / Polling	运行模式
Fly.io	Fly.io 部署
运维	运维手册
故障排查	故障排查
开发	测试指南

许可证

MIT License

Metadata

Release files for telepost-bot 2.81.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for telepost-bot 2.81.1
File	Size	Uploaded
telepost_bot-2.81.1.tar.gz	936.7 kB	Oct 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for telepost-bot 2.81.1
File	Interpreter	ABI	Platform	Reset
telepost_bot-2.81.1-py3-none-any.whl 712.7 kB Oct 5, 2026	Python 3	none	any	Details

Total release size: 1.6 MB

Release files / telepost_bot-2.81.1.tar.gz

Download URL	telepost_bot-2.81.1.tar.gz
Size	936.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`e7caa13cd9e6d838578a5fe948c791dbaa65a56c96d3af851474e98fd3d0dace`
BLAKE2b-256 checksum How to use checksums	`efd8f021d1f379c94e4f44dc50ebf933342079e5c92dc58e9bfed252b3f99033`
Upload date	Oct 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/redtidev1918/TelePost
Publishing commit: github.com/redtidev1918/TelePost/tree/aaa586920ac1c35006ebf671bcab9d0a1dba8a19

Workflow

Publishing configuration: github.com/redtidev1918/TelePost/blob/aaa586920ac1c35006ebf671bcab9d0a1dba8a19/.github/workflows/pypi-publish.yml
Publishing logs: github.com/redtidev1918/TelePost/actions/runs/37258422646/attempts/1

Artifact

Subject: telepost_bot-2.81.1.tar.gz
SHA-256 checksum: e7caa13cd9e6d838578a5fe948c791dbaa65a56c96d3af851474e98fd3d0dace Verifying attestations

Release files / telepost_bot-2.81.1-py3-none-any.whl

Download URL	telepost_bot-2.81.1-py3-none-any.whl
Size	712.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2d0b495329068970b457e44073ec41c608cfcb83c0af1a5db1c5905bad8ee9ec`
BLAKE2b-256 checksum How to use checksums	`6cabd0663c5b28083a56b099cb4d7338340d592227903b16f55e5e8ce32ecf9a`
Upload date	Oct 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/redtidev1918/TelePost
Publishing commit: github.com/redtidev1918/TelePost/tree/aaa586920ac1c35006ebf671bcab9d0a1dba8a19

Workflow

Publishing configuration: github.com/redtidev1918/TelePost/blob/aaa586920ac1c35006ebf671bcab9d0a1dba8a19/.github/workflows/pypi-publish.yml
Publishing logs: github.com/redtidev1918/TelePost/actions/runs/37258422646/attempts/1

Artifact

Subject: telepost_bot-2.81.1-py3-none-any.whl
SHA-256 checksum: 2d0b495329068970b457e44073ec41c608cfcb83c0af1a5db1c5905bad8ee9ec Verifying attestations