Files
appstore/apps/teldrive
okxlin caa8b9cd96 Remove adaptation evidence from app packages
Keep source-evidence.json as local workflow material by ignoring it repository-wide and remove previously committed evidence files from application trees.
2026-07-16 16:03:11 +08:00
..
2026-06-27 21:49:17 +08:00
2026-06-27 21:49:17 +08:00

Teldrive

产品介绍

Teldrive 是一个自托管 Telegram 文件管理工具,可以通过网页界面整理 Telegram 文件,并支持与 Rclone 等工作流配合使用。

主要功能

  • 管理 Telegram 频道中的文件
  • 提供网页界面进行浏览和操作
  • 支持加密上传数据和限制允许登录的 Telegram 用户

访问说明

安装后通过 http://<服务器 IP>:18080 访问,实际端口以安装表单中的 PANEL_APP_PORT_HTTP 为准。

Introduction

Teldrive is a self-hosted tool for organizing Telegram files through a web interface.

Features

  • Manage files stored in Telegram channels
  • Provide a browser-based management interface
  • Support upload encryption and allowed Telegram user restrictions

部署说明

  • 本应用使用官方容器镜像 ghcr.io/tgdrive/teldrive 部署。
  • PostgreSQL 使用 Teldrive 官方 compose 中的 ghcr.io/tgdrive/postgres:17-alpine 镜像。
  • 应用分类:存储。
  • 支持架构:amd64、arm64。
  • 可选版本:latest

端口

变量 说明 默认值 必填
PANEL_APP_PORT_HTTP HTTP 访问端口 18080

数据持久化

变量 说明 默认值 必填
APP_DATA_DIR Teldrive 数据目录,包含 PostgreSQL 数据和本地 storage.db 文件 ./data

升级或迁移前,请先在 1Panel 中备份上述数据目录。

参数说明

变量 说明 默认值 必填
TZ 容器时区 Asia/Shanghai
POSTGRES_PASSWORD PostgreSQL 数据库密码 随机生成
JWT_SECRET JWT 登录密钥 随机生成
UPLOADS_ENCRYPTION_KEY 上传数据加密密钥 随机生成
ALLOWED_USERS 允许登录的 Telegram 用户名,多个用户按上游支持格式填写
TG_NTP 启用 Telegram NTP 时间同步 false

使用说明

  • 首次访问后需要使用 Telegram 账号登录,并在界面设置中同步频道和默认频道。
  • 如登录停留在登录页,请检查服务器时间同步;也可以在安装参数中启用 TG_NTP
  • ALLOWED_USERS 用于限制可登录的 Telegram 用户名,不需要填写 @
  • 已对“复用 1Panel 商店 PostgreSQL runtime”做过真实联动复核,但 Teldrive 当前数据库迁移依赖 pgroonga 扩展;标准 postgresql 运行时不提供该扩展,启动时会在 20240711163538_search.sql 迁移阶段失败。
  • 也额外验证了“补 local app 数据库 runtime 再联动”的路径:一次独立 localmysql smoke 中,本地数据库 app 虽然能成功安装并运行,但 /apps/services/mysql 返回空,databases 资源表也没有生成可复用记录。结合当前 1Panel local app 同步会把数据库 app key 变成 local...、而数据库资源登记仍走未加前缀常量的实现路径,这里可以合理推断 local PostgreSQL runtime 目前也不能直接作为 Teldrive 的可选数据库服务。因此当前继续保留上游自带的 ghcr.io/tgdrive/postgres:17-alpine 拓扑,而不是切换到商店或 local app PostgreSQL。

参考资料