yinaoxiong/oneindex

oneindex

Onedrive目录索引工具

镜像概述

oneindex是一款无需占用服务器空间和流量的Onedrive目录索引工具，可直接列出Onedrive目录结构，并提供文件直链下载、在线预览等功能，适用于个人或团队的文件共享与管理。

核心功能

• 直链下载：文件通过Onedrive链接直接下载，不走服务器流量
• 在线预览：支持图片、视频（mp4/webm等格式）、音频、代码（js/css等）在线查看
• 文档解析：自动解析目录下的README.md（底部展示）和HEAD.md（头部展示）
• 文件夹加密：添加.password文件实现文件夹密码保护
• 网页输出：目录存在index.html时直接输出网页，替代目录列表
• 管理后台：支持文件上传管理、展示设置等（默认地址：?/admin，密码：oneindex）
• CLI功能：提供缓存刷新、令牌更新、文件/文件夹上传等命令行操作

使用场景

• 个人文件共享：将Onedrive文件以网页形式分享给他人
• 团队文档管理：集中管理团队Onedrive文档，支持加密访问
• 图床服务：利用图片预览功能搭建个人图床
• 代码展示：在线查看代码文件，方便分享协作

配置说明

Docker部署

拉取镜像

sh
docker pull yinaoxiong/oneindex  

运行容器

sh
docker run -d -p {开放端口}:80 --name {容器名称} --restart=always yinaoxiong/oneindex  

替换{开放端口}为本地端口（如8080），{容器名称}为自定义名称

停止与删除容器

sh
docker stop {容器名称}  
docker rm -v {容器名称}  

计划任务（推荐）

定时刷新缓存与令牌提升访问速度：

# 每小时刷新令牌  
0 * * * * /path/to/php /path/to/one.php token:refresh  

# 每10分钟刷新缓存  
*/10 * * * * /path/to/php /path/to/one.php cache:refresh  

特殊文件功能

• 底部说明：目录添加README.md（Markdown格式）
• 头部说明：添加HEAD.md（Markdown格式）
• 加密文件夹：添加.password文件填入密码
• 网页输出：添加index.html直接输出网页

命令行功能（PHP CLI环境）

• 清除缓存：php one.php cache:clear
• 刷新缓存：php one.php cache:refresh
• 刷新令牌：php one.php token:refresh
• 上传文件：php one.php upload:file 本地文件 [Onedrive路径]
• 上传文件夹：php one.php upload:folder 本地文件夹 [Onedrive路径]

示例：

sh
# 上传demo.zip到Onedrive根目录  
php one.php upload:file demo.zip  

# 上传up文件夹到Onedrive/test目录  
php one.php upload:folder up/ /test/