Admini
发布于 2026-03-21 / 14 阅读
1
0

Openlist挂载Teldrive

OpenList 中挂载 Teldrive,本质上就是把 Teldrive 作为一个“存储后端”接入。下面我给你一步一步讲清楚(含常见坑)👇


一、前提条件

你需要先确认:

  1. Teldrive 已经能正常访问

    • 比如:http://127.0.0.1:8080

    • 或局域网:http://192.168.5.1:8080

  2. 已拿到:

    • Teldrive的 Token(下面有获取教程)


二、OpenList 挂载步骤

1️⃣ 打开后台

进入 OpenList 管理界面:

http://你的OpenList地址:端口

2️⃣ 添加存储

路径:

设置 → 存储 → 添加

3️⃣ 选择存储类型

👉 选择:

Teldrive

4️⃣ 填写关键参数

基本配置

  • 挂载驱动名称

    teldrive
    
  • 挂载路径

    /teldrive
    

🔑 核心配置(最关键)

  • URL(必须用局域网或http://192.168.5.1:8080

    http://192.168.5.1:8080
    

    ⚠️ 注意:

    • 不要写 https(除非你自己配了证书)

    • 不要写公网域名(除非你确定能通)

    • 要带上不能只写IP地址,完整的的http或者https地址


  • 填写Teldrive Token

1.获取token方式(推荐):

  1. 访问Teldrive前端页面,例如: http://192.168.5.1:8080

  2. 步骤: 登陆后-检查(F12)-应用(Application)-左侧 Cookies 点开-选择下一级的地址Cookies(如 http://192.168.5.1:8080)-选择 Value的值就是token

Token: eyJhbGciOjfdsafewagfdsagdfsagewrew

2填写token:

将上面获取的token复制,粘贴到Openlist的Cookies框中,注意⚠️要在token前加上 access_token= ,如下图
例如: access_token=fdsafewqagfds


5️⃣ 保存

点击保存后:

👉 成功的话你会看到目录列表


三、常见问题(重点)

❗1. 你遇到的“登录状态不共享”问题

你之前说:

127.0.0.1 登录了,但 192.168 访问没登录

👉 原因:

  • Teldrive 的 session 是按 host 区分的

  • 127.0.0.1192.168.x.x

👉 解决:
✔ OpenList 里统一用一个地址(建议):

http://192.168.5.1:8080

❗2. 无法连接 / 超时

检查:

  • Docker 是否暴露端口

  • Teldrive 是否监听 0.0.0.0

  • 防火墙是否拦截


❗3. Token 失效

Teldrive 有时会:

  • Token 过期

  • 需要重新登录

👉 解决:
重新获取 Token


❗4. 文件列表为空

可能原因:

  • 权限不足

  • API 路径错误

  • Teldrive 版本不兼容


四、Docker 场景特别提醒

如果你是:

👉 OpenList + Teldrive 都在 Docker

❗不能用 127.0.0.1

因为容器内不是同一台机器

👉 应该用:

http://容器名物理机ip:8080

比如:

http://192.168.5.1:8080

好了,这就是详细安装步骤,有问题留言反馈,看到了一般都会回复的


评论