懂AI
transfer.sh

transfer.sh

命令行文件分享工具 快速高效

transfer.sh是一款开源的命令行文件分享工具,支持Amazon S3、Google Drive等多种存储方式。它提供简单的curl命令实现文件上传下载,具备加密和下载限制等功能。该项目开源了完整服务器代码,便于用户自建实例。transfer.sh主要面向开发者和技术人员,满足快速文件分享需求。

transfer.sh文件共享命令行工具云存储开源项目Github
访问官网GitHub

transfer.sh Go 报告卡 Docker 下载量 构建状态

从命令行轻松快速地分享文件。此代码包含服务器及创建您自己的实例所需的一切。

Transfer.sh 目前支持 s3（亚马逊 S3）、gdrive（谷歌云端硬盘）、storj（Storj）提供商和本地文件系统（local）。

免责声明

transfersh.com 的服务来源不明，并被报告为云端恶意软件。

使用方法

上传：

$ curl -v --upload-file ./hello.txt https://transfer.sh/hello.txt

加密并上传：

$ gpg --armor --symmetric --output - /tmp/hello.txt | curl --upload-file - https://transfer.sh/test.txt

下载并解密：

$ curl https://transfer.sh/1lDau/test.txt | gpg --decrypt --output /tmp/hello.txt

上传到 Virustotal：

$ curl -X PUT --upload-file nhgbhhj https://transfer.sh/test.txt/virustotal

删除

$ curl -X DELETE <X-Url-Delete 响应头 URL>

请求头

Max-Downloads

$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt -H "Max-Downloads: 1" # 限制下载次数

Max-Days

$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt -H "Max-Days: 1" # 设置删除前的天数

X-Encrypt-Password

注意，此功能仅在自托管服务器上使用：信任第三方服务进行服务器端加密需自担风险

$ curl --upload-file ./hello.txt https://your-transfersh-instance.tld/hello.txt -H "X-Encrypt-Password: test" # 使用 "test" 作为密码，在服务器端用 AES265 加密内容

X-Decrypt-Password

注意，此功能仅在自托管服务器上使用：信任第三方服务进行服务器端解密需自担风险

$ curl https://your-transfersh-instance.tld/BAYh0/hello.txt -H "X-Decrypt-Password: test" # 使用 "test" 作为密码，在服务器端用 AES265 解密内容

响应头

X-Url-Delete

用于请求删除文件的 URL，作为响应头返回。

curl -sD - --upload-file ./hello.txt https://transfer.sh/hello.txt | grep -i -E 'transfer\.sh|x-url-delete'
x-url-delete: https://transfer.sh/hello.txt/BAYh0/hello.txt/PDw0NHPcqU
https://transfer.sh/hello.txt/BAYh0/hello.txt

示例

查看 examples.md 中的优秀使用示例

链接别名

创建直接下载链接：

https://transfer.sh/1lDau/test.txt --> https://transfer.sh/get/1lDau/test.txt

内联文件：

https://transfer.sh/1lDau/test.txt --> https://transfer.sh/inline/1lDau/test.txt

用法

参数描述值环境变量
listener用于http的端口 (:80)LISTENER
profile-listener用于性能分析器的端口 (:6060)PROFILE_LISTENER
force-https重定向到httpsfalseFORCE_HTTPS
tls-listener用于https的端口 (:443)TLS_LISTENER
tls-listener-only仅启用tls监听器的标志TLS_LISTENER_ONLY
tls-cert-filetls证书路径TLS_CERT_FILE
tls-private-keytls私钥路径TLS_PRIVATE_KEY
http-auth-user上传时基本http认证的用户名HTTP_AUTH_USER
http-auth-pass上传时基本http认证的密码HTTP_AUTH_PASS
http-auth-htpasswd上传时基本http认证的htpasswd文件路径HTTP_AUTH_HTPASSWD
http-auth-ip-whitelist允许上传而不需要http认证的IP地址列表，以逗号分隔HTTP_AUTH_IP_WHITELIST
ip-whitelist允许连接服务的IP地址列表，以逗号分隔IP_WHITELIST
ip-blacklist不允许连接服务的IP地址列表，以逗号分隔IP_BLACKLIST
temp-path临时文件夹路径系统临时目录TEMP_PATH
web-path静态网页文件路径（用于开发或自定义前端）WEB_PATH
proxy-path当服务在代理后运行时的路径前缀PROXY_PATH
proxy-port当服务在代理后运行时代理的端口PROXY_PORT
email-contact前端的联系邮箱EMAIL_CONTACT
ga-key前端的Google Analytics密钥GA_KEY
provider使用的存储提供商(s3, storj, gdrive 或 local)
uservoice-key前端的User Voice密钥USERVOICE_KEY
aws-access-keyAWS访问密钥AWS_ACCESS_KEY
aws-secret-keyAWS秘密密钥AWS_SECRET_KEY
bucketAWS存储桶BUCKET
s3-endpoint自定义S3端点S3_ENDPOINT
s3-regionS3存储桶的区域eu-west-1S3_REGION
s3-no-multipart禁用S3分段上传falseS3_NO_MULTIPART
s3-path-style强制使用路径风格URL，Minio需要falseS3_PATH_STYLE
storj-access项目的访问权限STORJ_ACCESS
storj-bucket项目中使用的存储桶STORJ_BUCKET
basedir本地/gdrive提供商的存储路径BASEDIR
gdrive-client-json-filepathgdrive提供商的oauth客户端json配置路径GDRIVE_CLIENT_JSON_FILEPATH
gdrive-local-config-pathgdrive提供商存储本地transfer.sh配置缓存的路径GDRIVE_LOCAL_CONFIG_PATH
gdrive-chunk-sizegdrive上传的分块大小（MB），必须小于可用内存（8 MB）GDRIVE_CHUNK_SIZE
lets-encrypt-hosts用于Let's Encrypt证书的主机（逗号分隔）HOSTS
log日志文件路径LOG
cors-domainsCORS域名列表，以逗号分隔，设置此项启用CORSCORS_DOMAINS
clamav-hostclamav功能的主机CLAMAV_HOST
perform-clamav-prescan通过clamav功能对每次上传进行预扫描（clamav-host必须是本地clamd unix套接字）PERFORM_CLAMAV_PRESCAN
rate-limit每分钟请求数RATE_LIMIT
max-upload-size最大上传大小（KB）MAX_UPLOAD_SIZE
purge-days自动清除上传文件的天数PURGE_DAYS
purge-interval运行自动清除的间隔小时数（不适用于S3和Storj）PURGE_INTERVAL
random-token-length上传路径随机令牌的长度（删除路径长度为两倍）6RANDOM_TOKEN_LENGTH

如果你想使用Let's Encrypt证书的TLS，请将lets-encrypt-hosts设置为你的域名，将tls-listener设置为:443，并启用force-https。

如果你想使用自己的证书进行TLS，请将tls-listener设置为:443，启用force-https，并设置tls-cert-file和tls-private-key。

开发

已切换到GO111MODULE

go run main.go --provider=local --listener :8080 --temp-path=/tmp/ --basedir=/tmp/

构建

$ git clone git@github.com:dutchcoders/transfer.sh.git
$ cd transfer.sh
$ go build -o transfersh main.go

Docker

为了便于部署，我们创建了官方Docker容器。有两种变体，仅在运行进程的用户上有所不同。

默认变体将以root身份运行：

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

带有-noroot后缀的变体将使用5000作为UID和GID：

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

构建容器

你也可以自己构建容器。这允许你选择使用的UID/GID，例如在使用NFS挂载时：

# 构建参数：
# * RUNAS：如果为空，容器将以root身份运行。
#          设置为任何值以启用UID/GID选择。
# * PUID：进程的UID。需要RUNAS != ""。默认为5000。
# * PGID：进程的GID。需要RUNAS != ""。默认为5000。

docker build -t transfer.sh-noroot --build-arg RUNAS=doesntmatter --build-arg PUID=1337 --build-arg PGID=1338 .

S3使用

要使用AWS S3存储桶，你只需指定以下选项：

  • provider --provider s3
  • aws-access-key（通过标志或环境变量AWS_ACCESS_KEY）
  • aws-secret-key（通过标志或环境变量AWS_SECRET_KEY）
  • bucket（通过标志或环境变量BUCKET）
  • s3-region（通过标志或环境变量S3_REGION）

如果你指定了s3-region，就不需要设置端点URL，因为会自动使用正确的端点。

自定义S3提供商

要使用自定义的非AWS S3提供商，你需要指定由你的云提供商定义的端点。

Storj网络提供商

要使用Storj网络作为存储提供商，你需要指定以下标志：

  • provider --provider storj
  • storj-access（通过标志或环境变量STORJ_ACCESS）
  • storj-bucket（通过标志或环境变量STORJ_BUCKET）

创建存储桶和范围

你需要创建一个访问授权（或从uplink配置中复制）和一个存储桶作为准备。

要开始，登录你的账户并进入访问授权菜单，然后在右上角启动向导。 输入您选择的访问授权名称，点击下一步，并根据需要/偏好进行限制。 之后可以在命令行界面或浏览器中继续操作。接下来，您将被要求输入一个作为加密密钥的密码。 请务必将其保存在安全的地方。没有它，您将无法解密您的文件！

之后，您可以复制访问授权，然后开始启动transfer.sh终端。 建议将访问授权和存储桶名称作为环境变量提供，以增强安全性。

示例：

export STORJ_BUCKET=<存储桶名称>
export STORJ_ACCESS=<访问授权>
transfer.sh --provider storj

Google Drive 使用

要使用Google Drive，您需要指定以下选项：

  • provider
  • gdrive-client-json-filepath
  • gdrive-local-config-path
  • basedir

创建Gdrive客户端Json

您需要从console.cloud.google.com创建一个OAuth客户端ID，下载文件，并将其放置在安全的目录中。

使用示例

go run main.go --provider gdrive --basedir /tmp/ --gdrive-client-json-filepath /[凭证目录] --gdrive-local-config-path [保存配置的目录]

Shell函数

Bash、ash和zsh（多个文件作为zip归档上传）

将以下内容添加到.bashrc或.zshrc或其等效文件中
transfer() (if [ $# -eq 0 ]; then printf "未指定参数。\n用法：\n transfer <文件|目录>\n ... | transfer <文件名>\n">&2; return 1; fi; file_name=$(basename "$1"); if [ -t 0 ]; then file="$1"; if [ ! -e "$file" ]; then echo "$file: 没有此文件或目录">&2; return 1; fi; if [ -d "$file" ]; then cd "$file" || return 1; file_name="$file_name.zip"; set -- zip -r -q - .; else set -- cat "$file"; fi; else set -- cat; fi; url=$("$@" | curl --silent --show-error --progress-bar --upload-file "-" "https://transfer.sh/$file_name"); echo "$url"; )

现在您可以使用transfer函数

$ transfer hello.txt

Bash和zsh（带删除URL、删除令牌输出和上传前提示）

将以下内容添加到.bashrc或.zshrc或其等效文件中
<details><summary>展开</summary><p> 
transfer()
{
    local file
    declare -a file_array
    file_array=("${@}")

    if [[ "${file_array[@]}" == "" || "${1}" == "--help" || "${1}" == "-h" ]]
    then
        echo "${0} - 将任意文件上传到\"transfer.sh\"。"
        echo ""
        echo "用法: ${0} [选项] [<文件>]..."
        echo ""
        echo "选项:"
        echo "  -h, --help"
        echo "      显示此消息"
        echo ""
        echo "示例:"
        echo "  从当前工作目录上传单个文件："
        echo "      ${0} \"image.img\""
        echo ""
        echo "  从当前工作目录上传多个文件："
        echo "      ${0} \"image.img\" \"image2.img\""
        echo ""
        echo "  从不同目录上传文件："
        echo "      ${0} \"/tmp/some_file\""
        echo ""
        echo "  上传当前工作目录的所有文件。注意网络服务器的速率限制！："
        echo "      ${0} *"
        echo ""
        echo "  从当前工作目录上传单个文件并过滤出删除令牌和下载链接："
        echo "      ${0} \"image.img\" | awk --field-separator=\": \" '/Delete token:/ { print \$2 } /Download link:/ { print \$2 }'"
        echo ""
        echo "  显示\"transfer.sh\"的帮助文本："
        echo "      curl --request GET \"https://transfer.sh\""
        return 0
    else
        for file in "${file_array[@]}"
        do
            if [[ ! -f "${file}" ]]
            then
                echo -e "\e[01;31m'${file}' 找不到或不是文件。\e[0m" >&2
                return 1
            fi
        done
        unset file
    fi

    local upload_files
    local curl_output
    local awk_output

    du -c -k -L "${file_array[@]}" >&2
    # 与"bash"兼容
    if [[ "${ZSH_NAME}" == "zsh" ]]
    then
        read $'upload_files?\e[01;31m您确定要将以上文件（'"${#file_array[@]}"$'个）上传到"transfer.sh"吗？(Y/n): \e[0m'
    elif [[ "${BASH}" == *"bash"* ]]
    then
        read -p $'\e[01;31m您确定要将以上文件（'"${#file_array[@]}"$'个）上传到"transfer.sh"吗？(Y/n): \e[0m' upload_files
    fi

    case "${upload_files:-y}" in
        "y"|"Y")
            # 为了进度条，为每个文件执行"curl"。
            # 参数"--include"和"--form"将抑制进度条。
            for file in "${file_array[@]}"
            do
                # 显示删除链接并在上传后从响应头中过滤出删除令牌。
                # 重要的是要通过子shell将"curl"的"stdout"保存到变量中或重定向到另一个命令，
                # 该命令只是重定向到"stdout"，以便之后有一个合理的输出。
                # 进度条重定向到"stderr"，只有在"stdout"重定向到某处时才显示；
                # 例如">/dev/null"、"tee /dev/null"或"| <some_command>"。
                # 响应头重定向到"stdout"，所以将"stdout"重定向到"/dev/null"没有意义。
                # 将"curl"的"stderr"重定向到"stdout"（"2>&1"）将抑制进度条。
                curl_output=$(curl --request PUT --progress-bar --dump-header - --upload-file "${file}" "https://transfer.sh/")
                awk_output=$(awk \
                    'gsub("\r", "", $0) && tolower($1) ~ /x-url-delete/ \
                    {
                        delete_link=$2;
                        print "删除命令: curl --request DELETE " "\""delete_link"\"";

                        gsub(".*/", "", delete_link);
                        delete_token=delete_link;
                        print "删除令牌: " delete_token;
                    }

                    END{
                        print "下载链接: " $0;
                    }' <<< "${curl_output}")

                # 通过"stdout"返回结果，"awk"出于某种原因不这样做。
                echo -e "${awk_output}\n"

                # 尽可能避免速率限制；nginx: 请求过多。
                if (( ${#file_array[@]} > 4 ))
                then
                    sleep 5
                fi
            done
            ;;

        "n"|"N")
            return 1
            ;;

        *)
            echo -e "\e[01;31m输入错误: '${upload_files}'。\e[0m" >&2
            return 1
    esac
}
</p></details> #### 示例输出 ```bash $ ls -lh 总计 20M -rw-r--r-- 1 <某用户名> <某用户名> 10M 4月 4 21:08 image.img -rw-r--r-- 1 <某用户名> <某用户名> 10M 4月 4 21:08 image2.img $ transfer image* 10240K image2.img 10240K image.img 20480K 总计 您确定要将以上文件（2个）上传到"transfer.sh"吗？(Y/n): ######################################################################################################################################################################################################################################## 100.0% 删除命令: curl --request DELETE "https://transfer.sh/wJw9pz/image2.img/mSctGx7pYCId" 删除令牌: mSctGx7pYCId 下载链接: https://transfer.sh/wJw9pz/image2.img

######################################################################################################################################################################################################################################## 100.0% 删除命令: curl --request DELETE "https://transfer.sh/ljJc5I/image.img/nw7qaoiKUwCU" 删除令牌: nw7qaoiKUwCU 下载链接: https://transfer.sh/ljJc5I/image.img

$ transfer "image.img" | awk --field-separator=": " '/Delete token:/ { print $2 } /Download link:/ { print $2 }' 10240K image.img 10240K 总计 您确定要将以上文件（1个）上传到"transfer.sh"吗？(Y/n): ######################################################################################################################################################################################################################################## 100.0% tauN5dE3fWJe https://transfer.sh/MYkuqn/image.img


## 贡献

欢迎贡献。

## 创作者

**Remco Verhoef**
- <https://twitter.com/remco_verhoef>
- <https://twitter.com/dutchcoders>

**Uvis Grinfelds**

## 维护者

**Andrea Spacca**

**Stefan Benten**

## 版权和许可

代码和文档版权 2011-2018 Remco Verhoef。
代码和文档版权 2018-2020 Andrea Spacca。
代码和文档版权 2020年至今 Andrea Spacca 和 Stefan Benten。

代码基于[MIT许可证](LICENSE)发布。

编辑推荐精选

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境（IDE），通过自动化和多元协作改变开发流程。利用Trae，团队能够更快速、精确地编写和部署代码，从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能，是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
问小白

问小白

全能AI智能助手，随时解答生活与工作的多样问题

问小白，由元石科技研发的AI智能助手，快速准确地解答各种生活和工作问题，包括但不限于搜索、规划和社交互动，帮助用户在日常生活中提高效率，轻松管理个人事务。

热门AI助手AI对话AI工具聊天机器人
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手，它拥有超精准的音频识别翻译能力，几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球，无论你是留学生、商务人士、韩剧美剧爱好者，还是出国游玩、多国会议、跨国追星等等，都可以满足你所有需要同传的场景需求，线上线下通用，扫除语言障碍，让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word，让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目，能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定，还是学生群体的职业生涯规划、实习避坑指南，亦或是活动策划、旅游攻略等内容，它都能提供支持，帮助用户精准表达，轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
讯飞星火

讯飞星火

深度推理能力全新升级，全面对标OpenAI o1

科大讯飞的星火大模型，支持语言理解、知识问答和文本创作等多功能，适用于多种文件和业务场景，提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台，涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能，能为不同需求的用户提供便捷高效的帮助，助力用户轻松获取信息、解决问题，满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目，由多个知名机构联合参与。该项目提供了高效的 LLM（大语言模型）驱动的语音合成方案，支持语音克隆和语音创建功能，可通过命令行界面（CLI）和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数，生成高质量的语音。该项目适用于多种场景，如有声读物制作、智能语音助手开发等。

咔片PPT

咔片PPT

AI助力，做PPT更简单！

咔片是一款轻量化在线演示设计工具，借助 AI 技术，实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT，提供海量模板、智能美化、素材替换等功能，适用于销售、教师、学生等各类人群，能高效制作出高品质 PPT，满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文，一站式创作，让内容运营更高效

讯飞绘文，一个AI集成平台，支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容，加速品牌传播，提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台，公文写作神器

AI 材料星，专业的 AI 公文写作辅助平台，为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能，支持 30 + 文稿类型生成，助力快速完成领导讲话、工作总结、述职报告等材料，提升办公效率，是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK，助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK，它为开发者提供了与 OpenAI 模型交互的高效工具，支持工具调用、结果处理、追踪等功能，涵盖多种应用场景，如研究助手、财务研究等，能显著提升开发效率，让开发者更轻松地利用 OpenAI 的技术优势。

下拉加载更多