mirror of
https://github.com/RhenCloud/Cloud-Index.git
synced 2025-12-06 15:26:10 +08:00
feat: 更新文档并添加 OneDrive 支持
- 在 overview.md 中添加 OneDrive 到存储后端对比 - 更新导航栏和 plume.config 以包含 OneDrive 链接 - 创建详细的 OneDrive 配置指南 - 从 GitHub 和 S3 文档中删除冗余章节 - 将 .env 和缓存目录添加到 .gitignore
This commit is contained in:
@@ -152,95 +152,6 @@ git push -u origin main
|
||||
cd ../cloud-index
|
||||
```
|
||||
|
||||
## 测试连接
|
||||
|
||||
### 方式一:启动应用测试
|
||||
|
||||
```bash
|
||||
python app.py
|
||||
```
|
||||
|
||||
访问 `http://localhost:5000`,查看是否能正常显示文件列表。
|
||||
|
||||
### 方式二:使用 CLI 测试
|
||||
|
||||
```bash
|
||||
# 测试 Token 是否有效
|
||||
curl -H "Authorization: token ghp_xxx" \
|
||||
https://api.github.com/repos/your-username/my-storage
|
||||
|
||||
# 应该返回仓库信息
|
||||
```
|
||||
|
||||
### 方式三:Python 测试
|
||||
|
||||
```python
|
||||
import requests
|
||||
|
||||
token = "ghp_xxx"
|
||||
repo_owner = "your-username"
|
||||
repo_name = "my-storage"
|
||||
|
||||
headers = {
|
||||
"Authorization": f"token {token}",
|
||||
"Accept": "application/vnd.github.v3+json"
|
||||
}
|
||||
|
||||
url = f"https://api.github.com/repos/{repo_owner}/{repo_name}/contents"
|
||||
response = requests.get(url, headers=headers)
|
||||
|
||||
if response.status_code == 200:
|
||||
print("连接成功!")
|
||||
print("仓库文件:")
|
||||
for item in response.json():
|
||||
print(f" - {item['name']} ({item['type']})")
|
||||
else:
|
||||
print(f"连接失败!错误代码:{response.status_code}")
|
||||
```
|
||||
|
||||
## 管理仓库
|
||||
|
||||
### 通过 Cloud Index 管理
|
||||
|
||||
应用提供完整的文件管理功能:
|
||||
|
||||
- 📁 浏览文件和文件夹
|
||||
- ⬆️ 上传文件
|
||||
- 🗑️ 删除文件
|
||||
- ✏️ 重命名文件
|
||||
- 📂 创建新文件夹
|
||||
|
||||
### 通过 GitHub Web 管理
|
||||
|
||||
1. 访问你的仓库主页
|
||||
2. 点击 "Add file" → "Upload files"
|
||||
3. 选择要上传的文件
|
||||
4. 点击 "Commit changes"
|
||||
|
||||
### 通过 Git 命令行管理
|
||||
|
||||
```bash
|
||||
# 克隆仓库
|
||||
git clone https://github.com/your-username/my-storage.git
|
||||
cd my-storage
|
||||
|
||||
# 添加文件
|
||||
cp /path/to/file .
|
||||
|
||||
# 提交更改
|
||||
git add .
|
||||
git commit -m "Add new files"
|
||||
git push
|
||||
|
||||
# 删除文件
|
||||
git rm filename
|
||||
git commit -m "Remove file"
|
||||
git push
|
||||
|
||||
# 查看历史
|
||||
git log
|
||||
```
|
||||
|
||||
## 启用版本控制特性
|
||||
|
||||
### 查看文件历史
|
||||
@@ -296,37 +207,6 @@ https://raw.ghproxy.com/https://raw.githubusercontent.com/your-username/my-stora
|
||||
2. 选择 "复制链接"
|
||||
3. 分享链接给他人
|
||||
|
||||
## 最佳实践
|
||||
|
||||
### 1. 安全性
|
||||
|
||||
- ✅ 使用 Personal Access Token 而非用户密码
|
||||
- ✅ 定期轮换 Token
|
||||
- ✅ 为 Token 设置过期时间
|
||||
- ✅ 不要分享 Token
|
||||
- ✅ 使用私密仓库存储敏感信息
|
||||
- ✅ 不要在公开仓库存储个人数据
|
||||
|
||||
### 2. 性能优化
|
||||
|
||||
- ✅ 使用国内代理加速(如 ghproxy)
|
||||
- ✅ 定期清理不需要的文件
|
||||
- ✅ 合理组织文件结构
|
||||
- ✅ 使用分支管理大型项目
|
||||
|
||||
### 3. 仓库管理
|
||||
|
||||
- ✅ 保持仓库大小 < 1GB
|
||||
- ✅ 每个文件 < 100MB
|
||||
- ✅ 定期清理历史版本
|
||||
- ✅ 使用 `.gitignore` 排除不需要的文件
|
||||
|
||||
### 4. 备份
|
||||
|
||||
- ✅ 定期备份重要文件
|
||||
- ✅ 使用 Git 本地备份
|
||||
- ✅ 定期推送到其他服务(如 GitLab)
|
||||
|
||||
## 高级配置
|
||||
|
||||
### 使用 GitHub Actions 自动化
|
||||
@@ -401,86 +281,6 @@ git push
|
||||
cat large-file.zip.part_* > large-file.zip
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q: 如何更新 Token?
|
||||
|
||||
**A:**
|
||||
|
||||
1. 生成新 Token
|
||||
2. 更新 `.env` 文件中的 `GITHUB_ACCESS_TOKEN`
|
||||
3. 重启应用
|
||||
|
||||
### Q: Token 过期了怎么办?
|
||||
|
||||
**A:**
|
||||
|
||||
1. 进入 GitHub Settings
|
||||
2. 重新生成 Token
|
||||
3. 更新应用配置
|
||||
|
||||
### Q: 可以在组织中使用吗?
|
||||
|
||||
**A:** 可以,配置仓库的所有者为组织名即可:
|
||||
|
||||
```env
|
||||
GITHUB_REPO_OWNER=my-organization
|
||||
```
|
||||
|
||||
### Q: 仓库大小有限制吗?
|
||||
|
||||
**A:** GitHub 建议仓库不超过 1GB。如果超过:
|
||||
|
||||
1. 清理不需要的历史版本
|
||||
2. 使用 Git LFS
|
||||
3. 分割仓库
|
||||
|
||||
### Q: 可以在多个应用中使用同一仓库吗?
|
||||
|
||||
**A:** 可以,但需要注意并发冲突。建议:
|
||||
|
||||
1. 为每个环境创建不同的仓库
|
||||
2. 使用分支隔离
|
||||
3. 定期同步
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 连接失败
|
||||
|
||||
检查:
|
||||
|
||||
1. Token 是否正确
|
||||
2. 仓库名称是否正确
|
||||
3. 用户名是否正确
|
||||
4. 网络连接是否正常
|
||||
5. Token 是否过期
|
||||
|
||||
### Token 无效
|
||||
|
||||
解决方案:
|
||||
|
||||
1. 重新生成 Token
|
||||
2. 确保有 `repo` 权限
|
||||
3. 检查 Token 是否过期
|
||||
|
||||
### 文件无法访问
|
||||
|
||||
检查:
|
||||
|
||||
1. 仓库是否存在
|
||||
2. 文件是否已提交
|
||||
3. 是否使用了正确的分支
|
||||
4. 代理 URL 是否正确
|
||||
|
||||
### 上传缓慢
|
||||
|
||||
优化方案:
|
||||
|
||||
1. 配置国内代理
|
||||
2. 分割大文件
|
||||
3. 检查网络连接
|
||||
4. 考虑使用其他存储后端
|
||||
|
||||
## 与其他存储的对比
|
||||
|
||||
| 特性 | GitHub | R2 | S3 |
|
||||
|
||||
Reference in New Issue
Block a user