type
Post
status
Published
date
Feb 19, 2026
slug
Teledrive
summary
Teledrive (个人云备份 App)
tags
教程
开发
建站
工具
category
技术分享
password
icon
文章来源网络，AI总结
Teledrive 开源版的部署非常灵活，主要取决于你的使用场景。它通常支持 Docker 容器化部署（最推荐，简单快捷）和 直接运行二进制文件（适合没有 Docker 的环境）。
以下是基于开源项目特性的详细部署指南：
🐳 Docker 部署（推荐方式）
这是最简单、最干净的部署方式，能避免大部分环境依赖问题[[source_group_web_1]]。
1. 准备工作
确保你的服务器或 NAS 已经安装了 Docker 和 Docker Compose。
2. 使用 Docker Compose 部署
创建一个
docker-compose.yml 文件，内容如下：3. 启动服务
在
docker-compose.yml 所在目录执行以下命令：4. 访问界面
启动成功后，在浏览器中访问
http://你的服务器IP:8080 即可进入 Teledrive 的 Web 界面。💻 二进制文件部署（Linux/Windows）
如果你的设备不支持 Docker（例如某些低配 ARM 设备或 Windows 电脑），可以直接下载可执行文件。
1. 下载程序
前往项目的 GitHub Releases 页面（通常在 GitHub 搜索
Teledrive 找到官方仓库），下载对应你系统架构的压缩包（如 teledrive-linux-amd64.tar.gz 或 teledrive-windows.zip）。2. 解压与配置
3. 运行程序
📱 核心配置步骤（首次使用必看）
无论用哪种方式部署，首次运行都需要进行初始化配置：
- 获取 Telegram API 参数：Teledrive 需要连接 Telegram 的 API。你需要去 Telegram 官网注册一个应用，获取
API_ID和API_HASH。
- 登录账号：在 Web 界面中输入你获取到的
API_ID和API_HASH，然后输入你的手机号码接收验证码。
- 设置存储路径：登录成功后，你可以选择将文件备份到哪个文件夹，或者直接通过 Web 界面上传/下载 Telegram 云端的文件。
💡 常见问题提示
- 端口冲突：如果提示端口被占用，请修改 Docker 映射的端口（例如改为
8081:8080）。
- 数据持久化：一定要记得挂载
volumes（卷），否则容器重启后你的配置和文件索引会丢失[[source_group_web_2]]。
- 反向代理：如果你希望通过域名访问，可以在 Nginx 或 Caddy 中配置反向代理，将域名指向
http://127.0.0.1:8080。
致谢：
有关Notion安装或者使用上的问题，欢迎您在底部评论区留言，一起交流~
- 作者:RipnCN
- 链接:https://blog.lovou.pw/article/Teledrive
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
