news 2026/6/2 8:41:19

transfer.sh极速文件分享工具部署与运维指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
transfer.sh极速文件分享工具部署与运维指南

transfer.sh极速文件分享工具部署与运维指南

【免费下载链接】transfer.shEasy and fast file sharing from the command-line.项目地址: https://gitcode.com/gh_mirrors/tr/transfer.sh

项目简介

transfer.sh是一款轻量级命令行文件分享工具，支持通过HTTP协议快速上传下载文件。项目采用Go语言开发，具有跨平台、高性能、易扩展等特点。核心功能包括：

  • 支持本地存储、S3、Google Drive、Storj等多种存储后端
  • 提供文件加密、病毒扫描、下载次数限制等安全特性
  • 轻量级设计，单文件部署，资源占用低

项目结构清晰，主要代码文件包括：

  • main.go：程序入口点
  • server/server.go：HTTP服务器实现
  • server/handlers.go：请求处理逻辑
  • server/storage/：存储后端接口与实现

部署方案

本地直接部署

环境准备

确保已安装Go 1.16+环境，然后克隆代码库：

git clone https://gitcode.com/gh_mirrors/tr/transfer.sh cd transfer.sh
编译与运行

使用Makefile编译：

make build

编译完成后，可直接运行本地存储模式：

./transfersh --provider=local --listener :8080 --temp-path=/tmp/ --basedir=/tmp/

服务启动后，访问http://localhost:8080即可使用。

Docker容器部署

对于生产环境，推荐使用Docker部署，更便于管理和升级。

标准模式
docker run --publish 8080:8080 dutchcoders/transfer.sh:latest --provider local --basedir /tmp/
安全加固模式

推荐使用非root用户运行容器，降低安全风险：

docker run --publish 8080:8080 dutchcoders/transfer.sh:latest-noroot --provider local --basedir /tmp/

Docker镜像支持多种标签，可根据需求选择：

标签名说明
latest最新构建版本
latest-noroot非root用户运行的最新版本
nightly每日构建版本
x.y.z特定版本号

存储后端配置

transfer.sh支持多种存储后端，可根据实际需求选择配置。

本地文件系统

本地存储是默认且最简单的配置方式：

./transfersh --provider=local --basedir=/path/to/storage

AWS S3配置

使用AWS S3作为后端存储：

export AWS_ACCESS_KEY=your_access_key export AWS_SECRET_KEY=your_secret_key export BUCKET=your_bucket_name export S3_REGION=us-east-1 ./transfersh --provider=s3

对于MinIO等兼容S3的存储服务，需指定自定义端点：

export S3_ENDPOINT=https://minio.example.com export S3_PATH_STYLE=true ./transfersh --provider=s3 --s3-path-style

Google Drive配置

使用Google Drive作为存储后端需要先创建OAuth客户端凭证：

  1. 在Google Cloud控制台创建项目并启用Drive API
  2. 创建OAuth客户端ID，下载凭证JSON文件
  3. 运行时指定凭证文件路径：
./transfersh --provider=gdrive \ --gdrive-client-json-filepath=/path/to/client_secret.json \ --gdrive-local-config-path=/path/to/config \ --basedir=/path/to/local/cache

首次运行会提示授权，按指引完成后即可正常使用。

安全加固

HTTPS配置

为保障传输安全，建议启用HTTPS。有两种配置方式：

自定义证书
./transfersh --tls-listener :443 \ --tls-cert-file /path/to/cert.pem \ --tls-private-key /path/to/key.pem \ --force-https
Let's Encrypt自动证书
./transfersh --lets-encrypt-hosts example.com,www.example.com \ --tls-listener :443 \ --force-https

访问控制

IP黑白名单

限制特定IP访问：

./transfersh --ip-whitelist 192.168.1.0/24,10.0.0.1 \ --ip-blacklist 172.16.0.0/16
基本认证

配置HTTP基本认证：

./transfersh --http-auth-user admin --http-auth-pass securepassword

或使用htpasswd文件：

./transfersh --http-auth-htpasswd /path/to/.htpasswd

文件安全

病毒扫描

集成ClamAV进行文件病毒扫描：

./transfersh --clamav-host localhost:3310 \ --perform-clamav-prescan
文件加密

支持服务器端加密，上传时添加加密头：

curl --upload-file ./secret.txt https://your-transfersh-instance \ -H "X-Encrypt-Password: your-secret-key"

下载时解密：

curl https://your-transfersh-instance/xxx/secret.txt \ -H "X-Decrypt-Password: your-secret-key"

使用示例

基本上传下载

上传文件
curl --upload-file ./test.txt https://localhost:8080/test.txt

返回结果类似：https://localhost:8080/abc123/test.txt

下载文件
curl https://localhost:8080/abc123/test.txt -o test.txt

高级用法

限制下载次数和有效期
curl --upload-file ./report.pdf https://localhost:8080/report.pdf \ -H "Max-Downloads: 5" \ -H "Max-Days: 7"
加密上传文件

使用GPG加密上传：

gpg --armor --symmetric --output - ./secret.doc | curl --upload-file - https://localhost:8080/secret.doc.gpg

下载解密：

curl https://localhost:8080/xxx/secret.doc.gpg | gpg --decrypt --output ./secret.doc
上传整个目录
tar -czf - ./documents | curl --upload-file - https://localhost:8080/documents.tar.gz

命令行别名

为方便日常使用，可将常用命令添加到.bashrc或.zshrc：

transfer() { curl --progress-bar --upload-file "$1" https://localhost:8080/$(basename "$1") | tee /dev/null; echo }

添加后，即可直接使用：

transfer largefile.iso

更多使用示例可参考examples.md文件。

性能优化

资源限制

根据服务器配置调整资源限制：

./transfersh --max-upload-size 102400 \ # 最大上传大小(KB) --rate-limit 60 \ # 每分钟请求数 --purge-days 30 \ # 文件自动清理天数 - --purge-interval 24 # 清理间隔(小时)

缓存配置

调整临时文件缓存路径到内存文件系统，提升性能：

./transfersh --temp-path /dev/shm/transfersh-temp

日志与监控

配置日志输出到文件：

./transfersh --log /var/log/transfersh.log

对于生产环境，建议结合Prometheus和Grafana进行监控，可启用pprof性能分析：

./transfersh --profile-listener :6060

常见问题处理

服务无法启动

  1. 检查端口是否被占用：netstat -tulpn | grep 8080
  2. 查看日志文件排查错误
  3. 确保存储目录有读写权限：chmod 755 /path/to/storage

文件上传失败

  1. 检查磁盘空间：df -h
  2. 确认上传文件大小未超过限制
  3. 检查网络连接是否正常

下载链接无法访问

  1. 确认服务是否正常运行：curl -I http://localhost:8080
  2. 检查文件是否已被自动清理
  3. 验证访问权限设置是否正确

总结

transfer.sh作为一款轻量级命令行文件分享工具，凭借其简单部署、多种存储后端支持和丰富的安全特性，成为个人和小型团队临时文件传输的理想选择。通过本文介绍的部署方案和配置技巧，你可以快速搭建起安全可靠的文件分享服务。

建议根据实际需求选择合适的存储后端和安全策略，并定期更新到最新版本以获取新功能和安全修复。如有问题，可查阅项目README.md文件或提交issue获取帮助。

【免费下载链接】transfer.shEasy and fast file sharing from the command-line.项目地址: https://gitcode.com/gh_mirrors/tr/transfer.sh

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/1 21:19:47

Syncthing Tray：5个让你爱上无服务器文件同步的理由

Syncthing Tray：5个让你爱上无服务器文件同步的理由 【免费下载链接】syncthingtray Tray application and Dolphin/Plasma integration for Syncthing 项目地址: https://gitcode.com/gh_mirrors/sy/syncthingtray 想要摆脱云存储的束缚，又担心复…

作者头像 李华
网站建设 2026/5/30 21:57:34

ConvertX用户体验优化：从卡顿到流畅的完整实践指南

ConvertX用户体验优化：从卡顿到流畅的完整实践指南 【免费下载链接】ConvertX 💾 Self-hosted online file converter. Supports 700 formats 项目地址: https://gitcode.com/GitHub_Trending/co/ConvertX 当用户上传一个500MB的设计文件&#xf…

作者头像 李华
网站建设 2026/5/30 21:28:59

CVAT权限管理实战：从混乱到有序的团队协作指南

你是否曾遇到过团队成员误删重要标注数据？或者因为权限分配不当导致项目进度受阻？在计算机视觉标注工作中，CVAT作为行业领先的工具，提供了完善的用户权限管理系统。本文将带你从实际问题出发，通过四段式结构&#xff0…

作者头像 李华
网站建设 2026/6/1 6:18:54

XCOM V2.6：嵌入式开发的智能通信管家

XCOM V2.6：嵌入式开发的智能通信管家 【免费下载链接】XCOMV2.6正点原子串口调试工具最新版 XCOM V2.6是一款由正点原子开发的串口调试工具，专为嵌入式开发人员和电子爱好者设计。该版本在原有功能的基础上进行了多项修复和优化，提升了用户体…

作者头像 李华
网站建设 2026/5/31 12:35:42

3个简单步骤：快速实现跨平台自动化工具配置

3个简单步骤：快速实现跨平台自动化工具配置 【免费下载链接】skyvern 项目地址: https://gitcode.com/GitHub_Trending/sk/skyvern 企业级自动化工具常面临浏览器兼容性难题，不同内核的渲染差异、API支持度差异，可能导致自动化流程在…

作者头像 李华
网站建设 2026/5/30 8:18:38

Browserpass：终极免费密码管理浏览器扩展插件

Browserpass：终极免费密码管理浏览器扩展插件 【免费下载链接】browserpass-extension Browserpass web extension 项目地址: https://gitcode.com/gh_mirrors/br/browserpass-extension 在当今数字时代，密码安全已成为每个人必须面对的挑战。Bro…

作者头像 李华