upftp

一个现代化的跨平台多协议文件共享服务器 | A modern cross-platform multi-protocol file sharing server

支持 HTTP、FTP、WebDAV、NFS 和 MCP 协议，提供现代化 Web 界面和丰富的文件预览功能

Supports HTTP, FTP, WebDAV, NFS and MCP protocols, with modern web interface and rich file preview capabilities

特性 • 截图 • 安装 • 使用 • FAQ • 贡献

English | 中文

中文

📸 截图展示

Web界面预览

命令行界面预览

✨ 主要特性

🌐 现代化Web界面

响应式设计，支持移动设备
实时文件搜索功能
直观的文件类型图标
优雅的预览模态框
🌍 多语言支持: 自动检测浏览器语言，支持中英文切换
🎨 新界面设计: 页面标题更新为 "AI-First File Server"，添加版本徽章和功能展示栏
📱 移动优化: 改进的移动端响应式设计，添加用于移动访问的 QR 码按钮
📤 上传界面: 改进的上传部分 UI

🎨 智能语言体验

自动语言检测: 根据浏览器语言自动选择中文或英文界面
手动语言切换: 一键切换中英文，实时生效无需刷新
语言偏好记忆: 自动保存用户语言选择，下次访问时自动应用
完整界面翻译: 所有文本元素均支持中英文显示

🎥 丰富的文件预览

图片: JPG, PNG, GIF, SVG, WebP, BMP, ICO, HEIC, HEIF, AVIF, TIFF 等
视频: MP4, AVI, MOV, WebM, MKV, M4V, MPEG, 3GP, OGV 等
音频: MP3, WAV, FLAC, AAC, OGG, M4A, WMA, OPUS, AIFF, APE 等
文本/代码: 支持语法高亮的多种编程语言，包括 Vue, Svelte, Dart, Kotlin 等
文档: PDF可在浏览器预览，Office文档提供下载
容器格式: Dockerfile, Makefile 等

🚀 多协议支持

HTTP服务器: 现代Web界面，支持浏览器访问
FTP服务器: 传统FTP协议，支持各种FTP客户端
MCP服务器: Model Context Protocol，支持AI集成
WebDAV服务器: 支持WebDAV协议
NFS服务器: 支持NFS协议
独立端口配置，可单独启用

🔧 便捷的管理

交互式命令行界面: 带有 ASCII 艺术标志横幅和 emoji 图标的改进命令菜单
文件搜索和列表管理: 改进的文件列表，带有分页（最多 20 项）
下载链接生成: 增强的下载示例，带有 MCP 集成信息
实时文件系统刷新
服务器状态: 新的服务器状态和关于信息屏幕
版本信息: 版本信息命令（v 或 version）

📝 配置增强

改进的配置文件: 带有详细注释和使用示例
配置路径跟踪: 配置路径跟踪和显示
更好的组织: 更好的部分组织，带有视觉分隔符

📊 更好的日志记录

改进的日志格式: 带有视觉指示器
颜色编码: 带有项目符号的颜色编码日志级别
信息丰富: 更多信息丰富的启动消息

🔒 安全与配置

路径验证: 更好的上传路径验证
错误处理: 增强的错误处理

🌍 跨平台支持

Linux: amd64, arm64
Windows: amd64, 386
macOS: Intel, Apple Silicon

🚀 快速开始

方式一：包管理器安装（推荐）

macOS (Homebrew)

# 添加 tap
brew tap zy84338719/homebrew-tap

# 安装
brew install upftp

Windows (Scoop)

# 添加 bucket
scoop bucket add upftp https://github.com/zy84338719/scoop-bucket

# 安装
scoop install upftp

方式二：直接下载

从 Releases 页面下载对应平台的预编译二进制：

# Linux (amd64)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_linux_amd64.tar.gz
tar -xzf upftp_linux_amd64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

# Linux (arm64)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_linux_arm64.tar.gz
tar -xzf upftp_linux_arm64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

# macOS (Apple Silicon)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_darwin_arm64.tar.gz
tar -xzf upftp_darwin_arm64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

# macOS (Intel)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_darwin_amd64.tar.gz
tar -xzf upftp_darwin_amd64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

方式二：编译安装

需要 Go 1.24+ 环境。

macOS

# 安装 Go
brew install go

# 克隆并编译
git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build

# 安装到系统路径
sudo cp upftp /usr/local/bin/

Ubuntu / Debian

# 安装 Go（推荐使用官方版本）
wget https://go.dev/dl/go1.24.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.24.1.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

# 克隆并编译
git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build

# 安装到系统路径
sudo cp upftp /usr/local/bin/

CentOS / RHEL / Fedora

# 安装 Go
wget https://go.dev/dl/go1.24.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.24.1.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

# 安装 git（如未安装）
sudo yum install -y git   # CentOS/RHEL
# sudo dnf install -y git # Fedora

# 克隆并编译
git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build

# 安装到系统路径
sudo cp upftp /usr/local/bin/

交叉编译其他平台

# 查看所有构建目标
make help

# 编译所有平台（Linux/macOS/Windows, amd64/arm64）
make build-all

# 编译结果在 dist/ 目录
ls dist/

基本使用

# 使用默认配置启动
./upftp

# 指定端口和目录
./upftp -p 8888 -d /path/to/share

# 启用FTP服务器
./upftp -enable-ftp -user admin -pass mypassword

# 启用MCP服务器 (AI集成)
./upftp -enable-mcp

# 自动选择网络接口（适合脚本使用）
./upftp -auto

完整参数

upftp [选项]

选项：
    -p <port>       HTTP服务器端口 (默认: 10000)
    -ftp <port>     FTP服务器端口 (默认: 2121)
    -webdav <port>  WebDAV服务器端口 (默认: 8080)
    -nfs <port>     NFS服务器端口 (默认: 2049)
    -d <dir>        共享目录 (默认: 当前目录)
    -auto           自动选择第一个可用网络接口
    -enable-ftp     启用FTP服务器
    -enable-webdav  启用WebDAV服务器
    -enable-nfs     启用NFS服务器
    -enable-mcp     启用MCP服务器 (AI集成)
    -user <name>    FTP用户名 (默认: admin)
    -pass <pass>    FTP密码 (默认: admin)
    -h              显示帮助信息

访问方式

启动后可通过以下方式访问：

Web浏览器: http://你的IP:端口
FTP客户端: ftp://你的IP:FTP端口
WebDAV客户端: http://你的IP:WebDAV端口
NFS客户端: 你的IP:/share
命令行下载: curl -O http://你的IP:端口/download/文件名

MCP 集成

upftp 支持 Model Context Protocol (MCP)，可以让 AI 助手（如 Claude）直接访问和操作共享目录中的文件。

启用 MCP

./upftp -enable-mcp -d /path/to/share

MCP 工具列表

工具名称	描述
`list_files`	列出指定路径下的文件和目录
`get_file_info`	获取文件或目录的详细信息
`read_file`	读取文本文件内容
`download_file`	获取文件的下载链接和 Base64 编码内容
`search_files`	搜索匹配模式的文件
`get_directory_tree`	获取目录树结构
`start_server`	启动 HTTP/FTP 服务器供局域网文件共享
`stop_server`	停止 HTTP/FTP 服务器
`get_server_status`	获取服务器状态和访问 URL
`set_share_directory`	更改共享目录

使用场景

AI 助手可以：

通过 start_server 快速启动一个局域网文件服务器
返回访问 URL 给用户，供其他用户下载文件
通过 stop_server 随时停止服务
通过 set_share_directory 动态切换共享目录

在 Claude Desktop 中配置

在 Claude Desktop 配置文件中添加：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "upftp": {
      "command": "/path/to/upftp",
      "args": ["-enable-mcp", "-d", "/path/to/share"]
    }
  }
}

🛠️ 从源码构建

需要 Go 1.24 或更高版本。详见上方编译安装章节。

git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build

🔧 技术栈

语言: Go 1.24+
Web框架: 标准库 net/http
FTP服务器: 自定义实现
WebDAV服务器: 自定义实现
NFS服务器: 基于 go-nfs 库
前端: Vue 3 + TypeScript + Vite
构建工具: Make, GoReleaser, npm
CI/CD: GitHub Actions

📖 详细文档

安装指南 - 详细的安装和配置说明
使用示例 - 各种使用场景示例
更新日志 - 版本更新记录

❓ 常见问题

如何更改默认端口？

使用 -p 参数指定HTTP端口：

./upftp -p 8080

如何设置FTP密码？

使用 -user 和 -pass 参数：

./upftp -enable-ftp -user myuser -pass mypassword

如何在后台运行？

在Linux系统上使用systemd服务：

sudo systemctl start upftp
sudo systemctl enable upftp  # 开机自启

或者在命令行使用 nohup：

nohup ./upftp -auto > upftp.log 2>&1 &

端口被占用怎么办？

检查端口占用：

# Linux/macOS
lsof -i :10000
netstat -tlnp | grep 10000

# 使用其他端口
./upftp -p 10001

如何配置防火墙？

# Ubuntu/Debian (ufw)
sudo ufw allow 10000/tcp
sudo ufw allow 2121/tcp  # 如果启用了FTP

# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=10000/tcp
sudo firewall-cmd --permanent --add-port=2121/tcp
sudo firewall-cmd --reload

支持哪些文件类型的预览？

图片: JPG, PNG, GIF, SVG, WebP, BMP, ICO
视频: MP4, AVI, MOV, WebM, MKV, M4V
音频: MP3, WAV, FLAC, AAC, OGG, M4A
代码/文本: 支持语法高亮的多种编程语言
文档: PDF可在浏览器预览，Office文档提供下载

更多问题请查看 EXAMPLES.md 或提交 Issue。

🔒 安全建议

更改默认密码: 使用 -user 和 -pass 设置强密码
网络隔离: 仅在可信网络环境中使用，或在防火墙中限制访问IP
文件权限: 注意共享目录的读写权限设置
HTTPS支持: 生产环境建议配合反向代理（如Nginx）使用HTTPS

🤝 贡献

欢迎贡献代码、报告Bug或提出新功能建议！

贡献方式

Fork 本仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启 Pull Request

开发指南

# 克隆仓库
git clone https://github.com/zy84338719/upftp.git
cd upftp

# 安装依赖
make deps

# 运行测试
make test

# 本地构建
make build

# 代码格式化
make fmt

📝 待办事项

⭐ Star History

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE.txt 文件。

🙏 致谢

感谢所有贡献者的付出
感谢开源社区的支持

English

📸 Screenshots

Web Interface Preview

Command Line Interface Preview

✨ Key Features

🌐 Modern Web Interface

Responsive design with mobile support
Real-time file search functionality
Intuitive file type icons
Elegant preview modal dialogs
🌍 Multi-language Support: Auto-detect browser language, supports Chinese/English switching
🎨 New Interface Design: Updated page title to "AI-First File Server", added version badge and feature showcase bar
📱 Mobile Optimization: Improved responsive design for mobile, added QR code button for mobile access
📤 Upload Interface: Enhanced upload section UI

🎨 Smart Language Experience

Auto Language Detection: Automatically selects Chinese or English based on browser language
Manual Language Switching: One-click switch between Chinese/English, takes effect immediately without refresh
Language Preference Memory: Automatically saves user language choice, applies on next visit
Complete Interface Translation: All text elements support Chinese/English display

🎥 Rich File Preview

Images: JPG, PNG, GIF, SVG, WebP, BMP, ICO, HEIC, HEIF, AVIF, TIFF, etc.
Videos: MP4, AVI, MOV, WebM, MKV, M4V, MPEG, 3GP, OGV, etc.
Audio: MP3, WAV, FLAC, AAC, OGG, M4A, WMA, OPUS, AIFF, APE, etc.
Text/Code: Syntax-highlighted code preview for multiple programming languages including Vue, Svelte, Dart, Kotlin, etc.
Documents: PDF preview in browser, Office document download support
Container Formats: Dockerfile, Makefile, etc.

🚀 Multi-Protocol Support

HTTP Server: Modern web interface for browser access
FTP Server: Traditional FTP protocol for FTP clients
MCP Server: Model Context Protocol for AI integration
WebDAV Server: Support for WebDAV protocol
NFS Server: Support for NFS protocol
Independent port configuration, can be enabled separately

🔧 Convenient Management

Interactive Command-line Interface: Beautiful ASCII art logo banner and improved command menu with emoji icons
File Search and Listing Management: Improved file listing with pagination (max 20 items)
Download Link Generation: Enhanced download examples with MCP integration info
Real-time File System Refresh
Server Status: New server status and about information screens
Version Info: Version info command (v or version)

📝 Configuration Enhancements

Improved Configuration File: Detailed comments and usage examples
Configuration Path Tracking: Configuration path tracking and display
Better Organization: Better section organization with visual separators

📊 Better Logging

Improved Log Format: Visual indicators in log format
Color-coded: Color-coded log levels with bullet points
Informative: More informative startup messages

🔒 Security & Configuration

Path Validation: Better validation for upload paths
Error Handling: Enhanced error handling

🌍 Cross-Platform Support

Linux: amd64, arm64
Windows: amd64, 386
macOS: Intel, Apple Silicon

🚀 Quick Start

Option 1: Package Manager (Recommended)

macOS (Homebrew)

# Add tap
brew tap zy84338719/tap

# Install
brew install upftp

Windows (Scoop)

# Add bucket
scoop bucket add upftp https://github.com/zy84338719/scoop-bucket

# Install
scoop install upftp

Option 2: Download Binary

Download the pre-built binary for your platform from the Releases page:

# Linux (amd64)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_linux_amd64.tar.gz
tar -xzf upftp_linux_amd64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

# Linux (arm64)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_linux_arm64.tar.gz
tar -xzf upftp_linux_arm64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

# macOS (Apple Silicon)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_darwin_arm64.tar.gz
tar -xzf upftp_darwin_arm64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

# macOS (Intel)
wget https://github.com/zy84338719/upftp/releases/latest/download/upftp_darwin_amd64.tar.gz
tar -xzf upftp_darwin_amd64.tar.gz
chmod +x upftp
sudo mv upftp /usr/local/bin/

Option 2: Build from Source

Requires Go 1.24+.

macOS

# Install Go
brew install go

# Clone and build
git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build

# Install to system path
sudo cp upftp /usr/local/bin/

Ubuntu / Debian

# Install Go (official)
wget https://go.dev/dl/go1.24.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.24.1.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

# Clone and build
git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build

# Install to system path
sudo cp upftp /usr/local/bin/

CentOS / RHEL / Fedora

# Install Go
wget https://go.dev/dl/go1.24.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.24.1.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

# Install git (if not installed)
sudo yum install -y git   # CentOS/RHEL
# sudo dnf install -y git # Fedora

# Clone and build
git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build

# Install to system path
sudo cp upftp /usr/local/bin/

Cross-compile for other platforms

# View all build targets
make help

# Build all platforms (Linux/macOS/Windows, amd64/arm64)
make build-all

# Output in dist/
ls dist/

Basic Usage

# Start with default configuration
./upftp

# Specify port and directory  
./upftp -p 8888 -d /path/to/share

# Enable FTP server
./upftp -enable-ftp -user admin -pass mypassword

# Enable MCP server (AI integration)
./upftp -enable-mcp

# Auto-select network interface (suitable for scripts)
./upftp -auto

Full Options

upftp [options]

Options:
    -p <port>       HTTP server port (default: 10000)
    -ftp <port>     FTP server port (default: 2121)  
    -webdav <port>  WebDAV server port (default: 8080)
    -nfs <port>     NFS server port (default: 2049)
    -d <dir>        Share directory (default: current directory)
    -auto           Automatically select first available network interface
    -enable-ftp     Enable FTP server
    -enable-webdav  Enable WebDAV server
    -enable-nfs     Enable NFS server
    -enable-mcp     Enable MCP server for AI integration
    -user <name>    FTP username (default: admin)
    -pass <pass>    FTP password (default: admin)
    -h              Show help message

Access Methods

After startup, you can access via:

Web Browser: http://your-ip:port
FTP Client: ftp://your-ip:ftp-port
WebDAV Client: http://your-ip:webdav-port
NFS Client: your-ip:/share
Command Line: curl -O http://your-ip:port/download/filename

MCP Integration

upftp supports Model Context Protocol (MCP), enabling AI assistants (like Claude) to directly access and manage files in the shared directory.

Enable MCP

./upftp -enable-mcp -d /path/to/share

Available MCP Tools

Tool Name	Description
`list_files`	List files and directories in a specified path
`get_file_info`	Get detailed information about a file or directory
`read_file`	Read the content of a text file
`download_file`	Get download URL and base64 encoded content for a file
`search_files`	Search for files matching a pattern
`get_directory_tree`	Get the directory tree structure
`start_server`	Start HTTP/FTP server for LAN file sharing
`stop_server`	Stop HTTP/FTP servers
`get_server_status`	Get current server status and access URLs
`set_share_directory`	Change the shared directory

使用场景

AI 助手可以：

通过 start_server 快速启动一个局域网文件服务器
返回访问 URL 给用户，供其他用户下载文件
通过 stop_server 随时停止服务
通过 set_share_directory 动态切换共享目录

Configure in Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "upftp": {
      "command": "/path/to/upftp",
      "args": ["-enable-mcp", "-d", "/path/to/share"]
    }
  }
}

🛠️ Build from Source

Requires Go 1.24+. See Build from Source above for per-platform instructions.

git clone https://github.com/zy84338719/upftp.git
cd upftp
make deps && make build
make package

# View all build options
make help

🔧 Tech Stack

Language: Go 1.24+
Web Framework: Standard library net/http
FTP Server: Custom implementation
WebDAV Server: Custom implementation
NFS Server: Based on go-nfs library
Frontend: Vue 3 + TypeScript + Vite
Build Tools: Make, GoReleaser, npm
CI/CD: GitHub Actions

📖 Documentation

Installation Guide - Detailed installation and configuration
Usage Examples - Various usage scenarios
Changelog - Version update history

❓ FAQ

How to change the default port?

Use the -p parameter to specify HTTP port:

./upftp -p 8080

How to set FTP credentials?

Use -user and -pass parameters:

./upftp -enable-ftp -user myuser -pass mypassword

How to run in background?

Use systemd service on Linux:

sudo systemctl start upftp
sudo systemctl enable upftp  # Auto-start on boot

Or use nohup command:

nohup ./upftp -auto > upftp.log 2>&1 &

Port already in use?

Check port usage:

# Linux/macOS
lsof -i :10000
netstat -tlnp | grep 10000

# Use a different port
./upftp -p 10001

How to configure firewall?

# Ubuntu/Debian (ufw)
sudo ufw allow 10000/tcp
sudo ufw allow 2121/tcp  # If FTP is enabled

# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=10000/tcp
sudo firewall-cmd --permanent --add-port=2121/tcp
sudo firewall-cmd --reload

What file types are supported for preview?

Images: JPG, PNG, GIF, SVG, WebP, BMP, ICO
Videos: MP4, AVI, MOV, WebM, MKV, M4V
Audio: MP3, WAV, FLAC, AAC, OGG, M4A
Code/Text: Multiple programming languages with syntax highlighting
Documents: PDF preview in browser, Office documents available for download

For more questions, check EXAMPLES.md or submit an Issue.

🔒 Security Recommendations

Change Default Password: Use -user and -pass to set strong credentials
Network Isolation: Only use in trusted network environments or restrict access via firewall
File Permissions: Pay attention to read/write permissions on shared directories
HTTPS Support: For production, use with reverse proxy (e.g., Nginx) for HTTPS

🤝 Contributing

Contributions, bug reports, and feature requests are welcome!

How to Contribute

Fork this repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Development Guide

# Clone repository
git clone https://github.com/zy84338719/upftp.git
cd upftp

# Install dependencies
make deps

# Run tests
make test

# Local build
make build

# Code formatting
make fmt

📝 Roadmap

⭐ Star History

📄 License

This project is licensed under the MIT License - see LICENSE.txt for details.

🙏 Acknowledgments

Thanks to all contributors for their efforts
Thanks to the open source community for support

GitHub @zy84338719 · Twitter @murphyyi · Website murphyyi.com

Name		Name	Last commit message	Last commit date
Latest commit History 107 Commits
.github/workflows		.github/workflows
.trae/specs		.trae/specs
assets		assets
biz		biz
docs		docs
idl		idl
packaging		packaging
pkg		pkg
script		script
scripts		scripts
web		web
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
.hz		.hz
CHANGELOG.md		CHANGELOG.md
EXAMPLES.md		EXAMPLES.md
IMPROVEMENT_PLAN.md		IMPROVEMENT_PLAN.md
INSTALL.md		INSTALL.md
LICENSE.txt		LICENSE.txt
Makefile		Makefile
README-SHOWCASE.md		README-SHOWCASE.md
README.md		README.md
SCREENSHOT-GUIDE.md		SCREENSHOT-GUIDE.md
build.sh		build.sh
coverage.out		coverage.out
generate_logo.py		generate_logo.py
go.mod		go.mod
go.sum		go.sum
main.go		main.go
router.go		router.go
router_gen.go		router_gen.go
server		server
start_server.sh		start_server.sh
upftp.example.yaml		upftp.example.yaml
upftp.yaml		upftp.yaml

Folders and files

Latest commit

History

Repository files navigation

upftp

一个现代化的跨平台多协议文件共享服务器 | A modern cross-platform multi-protocol file sharing server

中文

📸 截图展示

✨ 主要特性

🌐 现代化Web界面

🎨 智能语言体验

🎥 丰富的文件预览

🚀 多协议支持

🔧 便捷的管理

📝 配置增强

📊 更好的日志记录

🔒 安全与配置

🌍 跨平台支持

🚀 快速开始

方式一：包管理器安装（推荐）

macOS (Homebrew)

Windows (Scoop)

方式二：直接下载

方式二：编译安装

macOS

Ubuntu / Debian

CentOS / RHEL / Fedora

交叉编译其他平台

基本使用

完整参数

访问方式

MCP 集成

启用 MCP

MCP 工具列表

使用场景

在 Claude Desktop 中配置

🛠️ 从源码构建

🔧 技术栈

📖 详细文档

❓ 常见问题

🔒 安全建议

🤝 贡献

贡献方式

开发指南

📝 待办事项

⭐ Star History

📄 许可证

🙏 致谢

English

📸 Screenshots

✨ Key Features

🌐 Modern Web Interface

🎨 Smart Language Experience

🎥 Rich File Preview

🚀 Multi-Protocol Support

🔧 Convenient Management

📝 Configuration Enhancements

📊 Better Logging

🔒 Security & Configuration

🌍 Cross-Platform Support

🚀 Quick Start

Option 1: Package Manager (Recommended)

macOS (Homebrew)

Windows (Scoop)

Option 2: Download Binary

Option 2: Build from Source

macOS

Ubuntu / Debian

CentOS / RHEL / Fedora

Cross-compile for other platforms

Basic Usage

Full Options

Access Methods

MCP Integration

Enable MCP

Available MCP Tools

使用场景

Configure in Claude Desktop

🛠️ Build from Source

🔧 Tech Stack

Packages