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.78.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.78.1
File	Size	Uploaded
telepost_bot-2.78.1.tar.gz	925.4 kB	Oct 3, 2026	Details

Built distribution (wheel)

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

Total release size: 1.6 MB

Release files / telepost_bot-2.78.1.tar.gz

Download URL	telepost_bot-2.78.1.tar.gz
Size	925.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`4af48883ad4ec7ebdbb01537f699bbd2b276ef8524d95d632ef84644daf4506d`
BLAKE2b-256 checksum How to use checksums	`5db3fde98e8fece1622aa4f172b5b4d84e1b330907ef32e3347943c081b05aa8`
Upload date	Oct 3, 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/77c0bbbe71b1a2033aa66bf9586e0de4984a6139

Workflow

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

Artifact

Subject: telepost_bot-2.78.1.tar.gz
SHA-256 checksum: 4af48883ad4ec7ebdbb01537f699bbd2b276ef8524d95d632ef84644daf4506d Verifying attestations

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

Download URL	telepost_bot-2.78.1-py3-none-any.whl
Size	706.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7a3282124dd270794af25d31f038d1838edf274739e360595e07a91a7e955600`
BLAKE2b-256 checksum How to use checksums	`6361680ae90cd191715ce46b5b76dbc0899c6f81754296d45ea138063478a256`
Upload date	Oct 3, 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/77c0bbbe71b1a2033aa66bf9586e0de4984a6139

Workflow

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

Artifact

Subject: telepost_bot-2.78.1-py3-none-any.whl
SHA-256 checksum: 7a3282124dd270794af25d31f038d1838edf274739e360595e07a91a7e955600 Verifying attestations