如何在VPS上安装OneIndex来搭建个人云盘？

项目	数据
系统要求	Linux系统（推荐Ubuntu 20.04+、CentOS 7+）
PHP版本	PHP 7.4及以上
Web服务器	Nginx或Apache
数据库	无需数据库
存储需求	至少100MB可用空间
网络要求	稳定的网络连接
安装时间	约15-30分钟

VPS如何安装OneIndex？搭建个人云盘的完整教程

OneIndex是一款优秀的开源程序，可以将OneDrive转换为个人云盘，让你在VPS上快速搭建私有文件存储服务。下面将详细介绍安装步骤和常见问题解决方案。

安装前准备工作

在开始安装之前，需要确保你的VPS满足以下基本要求：

项目	要求
操作系统	Linux（Ubuntu/Debian/CentOS）
PHP版本	7.4或更高版本
Web服务器	Nginx或Apache
扩展要求	curl、fileinfo、gd、mbstring、openssl
权限要求	对网站目录有读写权限

步骤1：环境配置检查

操作说明：首先登录你的VPS服务器，检查PHP和Web服务器环境是否满足要求。 使用工具提示：使用SSH客户端连接VPS，推荐使用PuTTY或Termius。

# 检查PHP版本
php -v
检查PHP扩展
php -m | grep -E "curl|fileinfo|gd|mbstring|openssl"
检查Web服务器状态
systemctl status nginx   # 对于Nginx
systemctl status apache2 # 对于Apache

主要安装步骤

步骤	操作内容	预计时间
1	环境准备与检查	5分钟
2	下载OneIndex程序	2分钟
3	配置Web服务器	5分钟
4	申请OneDrive API	5分钟
5	完成安装配置	3分钟

步骤2：下载OneIndex程序

操作说明：通过Git克隆或直接下载OneIndex程序到网站目录。 使用工具提示：确保已安装Git，或使用wget下载压缩包。

# 方法一：使用Git克隆
cd /var/www/html
git clone https://github.com/donwa/oneindex.git
chown -R www-data:www-data oneindex
chmod -R 755 oneindex
方法二：使用wget下载
wget https://github.com/donwa/oneindex/archive/refs/heads/master.zip
unzip master.zip
mv oneindex-master oneindex

步骤3：配置Web服务器

操作说明：为OneIndex配置虚拟主机或站点配置。 使用工具提示：根据使用的Web服务器选择相应的配置方式。

# Nginx配置示例（/etc/nginx/sites-available/oneindex）
server {
    listen 80;
    servername your-domain.com;
    root /var/www/html/oneindex;
    index index.php index.html;
    
    location / {
        tryfiles $uri $uri/ /index.php?$querystring;
    }
    
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgipass unix:/var/run/php/php7.4-fpm.sock;
    }
}
启用站点
ln -s /etc/nginx/sites-available/oneindex /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx

步骤4：申请OneDrive API

操作说明：在微软Azure门户申请应用程序ID和密钥。 使用工具提示：需要微软账户，访问Azure门户进行配置。

1. 访问 https://portal.azure.com

进入 Azure Active Directory
选择"应用注册" → "新注册"
设置应用名称，选择任何组织目录中的账户
在重定向URI中添加：https://your-domain.com/?/login
记录应用程序(客户端)ID和客户端密码值

步骤5：完成安装配置

操作说明：通过浏览器访问你的域名，按照向导完成最终配置。 使用工具提示：确保域名已解析到VPS IP地址。

访问：http://your-domain.com
操作流程：

点击"绑定OneDrive账号"
输入应用程序ID和密钥
登录微软账户授权
等待绑定成功提示

常见问题与解决方案

问题	原因	解决方案
提示”无法创建缓存目录”	目录权限不足	执行：chmod 777 -R config cache
OneDrive授权失败	API配置错误或网络问题	检查应用ID和密钥，确保重定向URI正确
文件列表空白	OneDrive API调用限制	等待一段时间或检查API调用频率
上传文件失败	文件大小限制或权限问题	检查PHP上传限制和目录写入权限
页面显示404错误	Web服务器配置错误	检查伪静态规则和根目录设置

安装完成后，你可以通过访问你的域名来管理OneDrive中的文件，实现个人云盘的功能。记得定期备份配置文件，并保持程序更新以获得最新功能和安全修复。