English | 简体中文
轻量级、高效的 HTTP 文件传输服务，配备现代化 Web 界面和 AI 集成。
HttpCat 是一个基于 HTTP 的文件传输服务，旨在提供简单、高效、稳定的文件上传和下载功能。无论是临时分享还是批量传输文件，HttpCat 都将是你的优秀助手。
- 🚀 简单高效 - 易于部署，无需外部依赖
- 🎨 现代化界面 - 基于 React 的美观管理界面
- 🤖 MCP 支持 - AI 助手（Claude、Cursor、CodeBuddy）可直接管理你的文件
- 🐳 Docker 就绪 - 一键 Docker 部署
- 🔐 安全可靠 - 基于 Token 的上传认证
- 📊 统计功能 - 详细的上传下载历史记录
httpcat/
├── server-go/ # 🔧 Go 后端
│ ├── cmd/ # 应用入口
│ │ └── httpcat.go
│ ├── internal/ # 内部包
│ │ ├── common/ # 公共工具
│ │ ├── handler/ # HTTP 处理器
│ │ ├── mcp/ # MCP 服务实现
│ │ ├── midware/ # 中间件（认证、指标）
│ │ ├── models/ # 数据模型
│ │ ├── p2p/ # P2P 功能
│ │ ├── server/ # 服务器核心
│ │ ├── storage/ # 存储层
│ │ └── conf/ # 配置文件
│ ├── go.mod
│ └── go.sum
│
├── web/ # 🎨 React 前端
│ ├── src/ # 源代码
│ ├── config/ # UmiJS 配置
│ ├── mock/ # Mock 数据（仅开发环境）
│ └── package.json
│
├── scripts/ # 🛠️ 脚本目录
│ ├── build.sh # 多平台构建脚本
│ ├── install.sh # Linux/macOS 安装脚本
│ ├── uninstall.sh # 卸载脚本
│ └── translations.sh # i18n 翻译脚本
│
├── docs/ # 📚 文档目录
│ ├── README-en.md # English README
│ ├── BUILD.md # 编译构建指南
│ ├── INSTALL.md # 安装部署指南
│ ├── ReleaseNote.md # 版本发布记录
│ ├── MCP_USAGE.md # MCP 集成指南
│ └── ... # 其他设计文档
│
├── static/ # 📦 前端构建产物
├── release/ # 📤 构建输出目录（已忽略）
│
├── Dockerfile # Docker 配置
├── docker-compose.yml # Docker Compose 配置
└── httpcat.service # systemd 服务文件
# 使用 Docker Compose
docker-compose up -d
# 或直接使用 Docker
docker run -d --name httpcat \
-p 8888:8888 \
-v $(pwd)/data:/app/data \
-v $(pwd)/upload:/app/upload \
httpcat:latest# 完整构建（后端 + 前端）
./scripts/build.sh -a -f
# 或分别构建：
# 仅后端
cd server-go && go build -o httpcat ./cmd/httpcat.go
# 仅前端
cd web && npm install && npm run build# 终端 1：启动后端
cd server-go
go build -o httpcat ./cmd/httpcat.go
./httpcat -C ./internal/conf/svr.yml --static=../static/
# 终端 2：启动前端开发服务器
cd web
npm install --registry=https://registry.npmmirror.com
NODE_OPTIONS=--openssl-legacy-provider npm run start:dev访问地址：
| 字段 | 值 |
|---|---|
| 用户名 | admin |
| 密码 | admin |
⚠️ 安全提示: 首次登录后请立即修改默认密码！
# 下载并解压
httpcat_version="v0.2.0"
tar -zxvf httpcat_${httpcat_version}_linux-amd64.tar.gz
cd httpcat_${httpcat_version}_linux-amd64
# 安装（交互式）
sudo ./install.sh
# 或指定端口安装
sudo ./install.sh -p 9000
# 管理服务
sudo systemctl start httpcat
sudo systemctl status httpcat使用 install.sh 安装后，文件按照 Linux FHS 标准分布：
/usr/local/bin/
└── httpcat # 可执行文件
/etc/httpcat/
└── svr.yml # 配置文件
/var/log/httpcat/
└── httpcat.log # 日志文件
/var/lib/httpcat/
├── static/ # Web 界面静态资源
├── upload/ # 上传文件存储
├── download/ # 下载文件缓存
└── data/
└── httpcat_sqlite.db # SQLite 数据库
# 启动/停止/重启
sudo systemctl start httpcat
sudo systemctl stop httpcat
sudo systemctl restart httpcat
# 查看状态和日志
sudo systemctl status httpcat
sudo journalctl -u httpcat -f# 标准卸载（保留配置和数据）
sudo ./uninstall.sh
# 完全卸载（删除所有配置和数据）
sudo ./uninstall.sh --purge
# 完全卸载但保留用户上传的文件
sudo ./uninstall.sh --purge --keep-dataHttpCat 支持 MCP 协议，让 AI 助手可以直接管理你的文件服务器。
在你的 MCP 客户端配置（Claude Desktop、Cursor、CodeBuddy 等）中添加：
{
"mcpServers": {
"httpcat": {
"type": "sse",
"url": "http://your-server:8888/mcp/sse"
}
}
}| 工具 | 功能说明 |
|---|---|
list_files |
列出上传目录中的文件 |
get_file_info |
获取文件详情（大小、MD5 等） |
upload_file |
通过 MCP 上传文件（需要 Token） |
get_disk_usage |
获取磁盘使用情况 |
get_upload_history |
查询上传历史记录 |
request_delete_file |
请求删除文件（第一步） |
confirm_delete_file |
确认删除文件（第二步） |
get_statistics |
获取上传/下载统计 |
verify_file_md5 |
验证文件 MD5 完整性 |
📖 详细 MCP 使用指南请查看 docs/MCP_USAGE.md
curl -v -F "f1=@/path/to/file" \
-H "UploadToken: your-token" \
http://localhost:8888/api/v1/file/uploadwget -O filename.jpg http://localhost:8888/api/v1/file/download?filename=filename.jpgcurl http://localhost:8888/api/v1/file/listFiles?dir=/配置文件：svr.yml
# 服务器设置
port: 8888
upload_dir: "./upload"
download_dir: "./upload"
static_dir: "./static"
# 认证配置
app_key: "httpcat"
app_secret: "httpcat_app_secret"
enable_upload_token: true
# 数据库配置
enable_sqlite: true
sqlite_db_path: "./data/sqlite.db"
# 通知配置（企业微信 Webhook）
persistent_notify_url: ""删除 SQLite 数据库并重启：
sudo find /var/lib/httpcat -name "*.db"
sudo rm /var/lib/httpcat/data/httpcat_sqlite.db
sudo systemctl restart httpcat重启后会自动创建默认管理员账号。
Node.js 17+ 需要使用旧版 OpenSSL provider：
NODE_OPTIONS=--openssl-legacy-provider npm run start:dev推荐使用 Node.js v16.x 以获得最佳兼容性。
- Go 1.23+ - 后端编译
- Node.js 20+ - 前端构建（推荐 v20.x LTS）
- npm - 包管理器（随 Node.js 安装）
💡 提示: 使用 nvm 的用户可在
web/目录运行nvm use自动切换到项目指定版本
# 交互式构建
./scripts/build.sh
# 构建所有平台（含前端）
./scripts/build.sh -a -f
# 构建指定平台
./scripts/build.sh -p linux_amd64 -f
# 使用 Docker 构建（完整 CGO 支持）
./scripts/build.sh -d -f
# 显示帮助
./scripts/build.sh -h本软件仅供个人使用，禁止用于商业目的。
- 禁止用于商业目的
- 必须保留版权和许可声明
- 本软件按 "原样" 提供，不承担任何保证
欢迎关注我们的 GitHub 项目！⭐ 点亮 star 了解我们的实时动态。
欢迎提出 issue 或提交 pull request。Good luck! 🍀