zhuchaowe/fileshare
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

readme

Browse Source
This commit is contained in:
朱潮 2025-08-10 14:07:14 +08:00
parent 989b9484a7
commit 75ec42768e
2 changed files with 40 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
README.md
View File

@ -138,28 +138,33 @@ curl -O "http://localhost:8000/api/download/ABCD1234"
curl "http://localhost:8000/api/info/ABCD1234" curl "http://localhost:8000/api/info/ABCD1234"
``` ```
### 🐍 Python命令行工具（可选） ### @fileshare/fileshare_functions.sh
如果需要更丰富的功能，可以使用Python CLI工具： 便捷的Shell函数库，提供更丰富的功能：
```bash ```bash
# 安装依赖 # 加载便捷函数
pip install -r requirements.txt source fileshare_functions.sh
# 上传文件 # 现在可以使用超级简单的命令
python cli.py upload example.txt upload photo.jpg # 上传文件
share_text "Hello World!" # 分享文本
download AB12CD34 # 下载文件
info AB12CD34 # 查看信息
list_shares # 列出分享
# 分享文本 # 高级功能
python cli.py share-text -t "Hello World!" batch_upload *.jpg # 批量上传
share_file config.txt # 分享文件内容
# 下载文件 set_server https://domain.com # 设置服务器
python cli.py download ABCD1234
# 查看信息
python cli.py info ABCD1234
``` ```
**注意**: 对于简单使用，推荐使用curl命令，无需安装Python依赖。 **便捷功能**：
- ✅ 自动提取分享码
- ✅ 彩色输出和错误提示
- ✅ 支持批量操作
- ✅ 自动服务器检测
- ✅ 无需安装依赖
### 环境变量配置 ### 环境变量配置
@ -216,7 +221,6 @@ python cli.py info ABCD1234
``` ```
fileshare/ fileshare/
├── app.py # 主应用程序 ├── app.py # 主应用程序
├── cli.py # 命令行工具
├── requirements.txt # Python依赖 ├── requirements.txt # Python依赖
├── Dockerfile # Docker镜像 (标准版) ├── Dockerfile # Docker镜像 (标准版)
├── Dockerfile.multi # Docker镜像 (多阶段构建优化版) ├── Dockerfile.multi # Docker镜像 (多阶段构建优化版)
@ -233,12 +237,10 @@ fileshare/
│ ├── app.js # 前端逻辑 │ ├── app.js # 前端逻辑
│ └── curl-guide.html # curl命令教程页面 │ └── curl-guide.html # curl命令教程页面
├── uploads/ # 上传文件目录 ├── uploads/ # 上传文件目录
├── test_server.py # 服务测试脚本
├── fix_paths.py # 路径修复工具
├── verify_setup.sh # 环境验证脚本
├── curl_examples.sh # curl使用示例
├── fileshare_functions.sh # Shell便捷函数 ├── fileshare_functions.sh # Shell便捷函数
└── demo.sh # 功能演示脚本 └── data/ # 数据目录
├── uploads/ # 持久化上传目录
└── logs/ # 日志目录
``` ```
### 开发模式 ### 开发模式
@ -255,9 +257,10 @@ python app.py
uvicorn app:app --reload --host 0.0.0.0 --port 8000 uvicorn app:app --reload --host 0.0.0.0 --port 8000
``` ```
3. 测试CLI工具： 3. 测试便捷函数：
```bash ```bash
python cli.py --help source fileshare_functions.sh
fileshare_help
``` ```
### 国内加速部署 ### 国内加速部署
@ -284,17 +287,17 @@ docker-compose -f docker-compose.aliyun.yml up -d
### 🔧 快速诊断 ### 🔧 快速诊断
遇到问题时，首先运行验证脚本： 遇到问题时，可以检查服务状态：
```bash ```bash
./verify_setup.sh docker-compose ps
docker-compose logs -f
``` ```
### 常见问题 ### 常见问题
1. **CSS/JS文件404错误** 1. **CSS/JS文件404错误**
```bash - 检查static目录是否存在
python fix_paths.py # 修复静态资源路径 - 确认静态文件路径正确
```
2. **文件上传失败** 2. **文件上传失败**
- 检查文件大小是否超过限制 - 检查文件大小是否超过限制
@ -317,19 +320,11 @@ docker-compose -f docker-compose.aliyun.yml up -d
```bash ```bash
# 服务验证 # 服务验证
./verify_setup.sh curl http://localhost:8000/api
# 功能演示（推荐） # 功能测试
./demo.sh source fileshare_functions.sh
fileshare_help
# 运行时测试
python test_server.py
# 查看示例
./curl_examples.sh
# 路径修复
python fix_paths.py
``` ```
### 日志查看 ### 日志查看

10
start.sh
View File

@ -51,11 +51,11 @@ if docker-compose ps | grep -q "Up"; then
echo " - 停止服务: docker-compose down" echo " - 停止服务: docker-compose down"
echo " - 重启服务: docker-compose restart" echo " - 重启服务: docker-compose restart"
echo echo
echo "💻 CLI工具使用:" echo "💻 便捷函数使用:"
echo " - 安装依赖: pip install -r requirements.txt" echo " - 加载函数: source fileshare_functions.sh"
echo " - 上传文件: python cli.py upload <文件路径>" echo " - 上传文件: upload <文件路径>"
echo " - 分享文本: python cli.py share-text -t '内容'" echo " - 分享文本: share_text '内容'"
echo " - 下载文件: python cli.py download <分享码>" echo " - 下载文件: download <分享码>"
else else
echo "❌ 服务启动失败，请检查日志:" echo "❌ 服务启动失败，请检查日志:"
docker-compose logs docker-compose logs