Filetas

功能特性

快速开始

先决条件

# Ubuntu/Debian
sudo apt update -y
sudo apt install -y pkg-config libssl-dev
# CentOS/RHEL
sudo yum install -y pkgconfig openssl-devel
# macOS
brew install pkg-config openssl

安装运行

git clone https://github.com/idevsig/filetas.git
cd filetas

cargo run

cargo build --release
./target/release/filetas

使用方法

命令行参数

filetas [OPTIONS]
选项:
 -H, --host <HOST> 服务器监听地址 [默认: 0.0.0.0] [环境变量: HOST]
 -p, --port <PORT> 服务器端口 [默认: 8000] [环境变量: PORT]
 -t, --title <TITLE> 页面标题 [默认: 文件加速下载] [环境变量: TITLE]
 --template-dir <DIR> 模板目录路径 [默认: templates] [环境变量: TEMPLATE_DIR]
 --user-agent <USER_AGENT> 请求用户代理 [环境变量: USER_AGENT]
 -v, --verbose 启用详细日志 (等同于 RUST_LOG=debug)
 -q, --quiet 启用安静模式 (等同于 RUST_LOG=warn)
 -h, --help 显示帮助信息
 -V, --version 显示版本信息

使用示例

# 基本使用
filetas
# 自定义端口和主机
filetas --host 127.0.0.1 --port 3000
# 自定义页面标题
filetas --title "我的文件服务器"
# 启用详细日志
filetas --verbose
# 使用环境变量
HOST=0.0.0.0 PORT=8080 TITLE="File Server" GITHUB_TOKEN=your_token filetas
# 组合使用
RUST_LOG=debug filetas --port 8080 --title "开发服务器"

环境变量

日志配置

# 默认日志级别 (INFO)
filetas
# 详细调试日志
filetas --verbose
# 或
RUST_LOG=debug filetas
# 只显示警告和错误
filetas --quiet
# 或
RUST_LOG=warn filetas
# 自定义日志级别
RUST_LOG=filetas=trace,tower_http=debug filetas

支持的 URL 格式

GitHub 文件加速

多种请求方式示例

通用文件下载

Web 界面使用

Docker 部署

使用预构建镜像

可用镜像仓库

运行示例

# Docker Hub
docker run -p 8000:8000 -d idevsig/filetas:latest
# GitHub Registry
docker run -p 8000:8000 -d ghcr.io/idevsig/filetas:latest
# 阿里云镜像(国内用户推荐)
docker run -p 8000:8000 -d registry.cn-guangzhou.aliyuncs.com/idevsig/filetas:latest
# 腾讯云镜像
docker run -p 8000:8000 -d sgccr.ccs.tencentyun.com/idevsig/filetas:latest
# 使用 GITHUB_TOKEN
docker run -p 8000:8000 -e GITHUB_TOKEN=your_token -d idevsig/filetas:latest

Docker Compose

services:
 filetas:
 image: idevsig/filetas:latest
 container_name: filetas
 restart: unless-stopped
 ports:
 - "8000:8000"
 environment:
 - HOST=0.0.0.0
 - PORT=8000
 - TITLE=文件加速下载
 - GITHUB_TOKEN=your_token_here
 - RUST_LOG=filetas=info
 volumes:
 - ./templates:/app/templates # 可选:自定义模板

构建自定义镜像

# 构建镜像
docker build -f docker/Dockerfile -t my-filetas .
# 运行
docker run -p 8000:8000 -d my-filetas

API 使用

直接下载

# 通过服务下载文件
curl -L "http://localhost:8000/https://example.com/file.zip" -o file.zip
# GitHub 文件加速
curl -L "http://localhost:8000/https://github.com/user/repo/releases/download/v1.0.0/file.zip" -o file.zip

CORS 支持

// 获取文件
fetch("http://localhost:8000/https://example.com/file.json")
 .then((response) => response.json())
 .then((data) => console.log(data));
// 下载文件
const downloadUrl =
 "http://localhost:8000/" + encodeURIComponent("https://example.com/file.zip");
window.open(downloadUrl);

开发

项目结构

filetas/
├── docker/
│ ├── Dockerfile # Docker 构建文件
│ └── docker-bake.hcl # Docker Bake 构建配置
├── src/
│ └── main.rs # 主程序
├── templates/
│ └── index.html # Web 界面模板
├── Cargo.toml # 项目配置
├── Cargo.lock # 依赖锁定文件
└── README.md

本地开发

# 克隆项目
git clone https://github.com/idevsig/filetas.git
cd filetas
# 安装依赖并运行
cargo run
# 开启详细日志的开发模式
RUST_LOG=debug cargo run -- --verbose
# 运行测试
cargo test
# 代码格式化
cargo fmt
# 代码检查
cargo clippy

性能优化

故障排除

常见问题

贡献

许可证

仓库镜像