Git-ftp 项目安装指南：全平台详细教程

Git-ftp 项目安装指南：全平台详细教程

git-ftp Uses Git to upload only changed files to FTP servers. 项目地址: https://gitcode.com/gh_mirrors/gi/git-ftp

前言

Git-ftp 是一个基于 Git 的 FTP 同步工具，它能够智能地仅上传修改过的文件到 FTP 服务器，极大简化了网站部署流程。本文将详细介绍 Git-ftp 在各种操作系统上的安装方法，帮助开发者快速上手使用。

Linux/Unix 系统安装

使用 Make 安装（推荐）

这是最推荐的安装方式，适用于大多数 Linux 发行版（如 Debian、Ubuntu、Fedora、RedHat 等）以及 macOS 系统。

前提条件：

• 已安装 Git
• 已安装 cURL

安装步骤：

1. 克隆 Git-ftp 仓库：

git clone https://github.com/git-ftp/git-ftp.git
cd git-ftp

2. 检出最新稳定版本：

tag="$(git tag | grep '^[0-9]*\.[0-9]*\.[0-9]*$' | tail -1)"
git checkout "$tag"

3. 执行安装：

sudo make install

更新方法：

git fetch
git checkout "$(git tag | grep '^[0-9]*\.[0-9]*\.[0-9]*$' | tail -1)"
sudo make install

直接下载安装

对于不想使用 Git 的用户，可以直接下载脚本：

curl https://raw.githubusercontent.com/git-ftp/git-ftp/master/git-ftp > /bin/git-ftp
chmod 755 /bin/git-ftp

注意：此方法会安装最新的开发版本，如需特定版本，请将 URL 中的 master 替换为版本号标签。

卸载方法：

rm /bin/git-ftp

Debian/Ubuntu 系统安装

使用官方仓库安装

最简单的方法是使用系统包管理器：

sudo apt-get install git-ftp

使用 PPA 安装最新版

如需最新版本，可添加官方 PPA：

sudo -s
add-apt-repository ppa:git-ftp/ppa

# Debian 系统需要额外修改
source /etc/*-release
if [ "$ID" = "debian" ]; then
    dist="$(echo /etc/apt/sources.list.d/git-ftp-ppa-*.list | sed 's/^.*ppa-\(.*\)\.list$/\1/')"
    sed -i.backup "s/$dist/precise/g" /etc/apt/sources.list.d/git-ftp-ppa-*.list
fi

apt-get update
apt-get install git-ftp

macOS 系统安装

准备工作

1. 安装 Xcode 和命令行工具：

xcode-select --install

2. 使用 Homebrew 安装：

brew install git
brew install brotli
brew install git-ftp

SFTP 支持配置

macOS 自带的 curl 不支持 SFTP 协议，如需此功能需自行编译：

1. 下载 curl 源码并解压
2. 安装依赖：

brew install openssl
brew install libssh2

3. 编译安装：

./configure -q --with-libssh2 --with-ssl=/usr/local/opt/openssl
make
make install

4. 验证安装：

curl --version

确认输出中包含 sftp 协议。

5. 如遇到路径问题，可添加：

export PATH=/usr/local/bin:$PATH

到 ~/.bash_profile 文件中。

Windows 系统安装

Windows 系统有两种主要安装方式：

1. 使用 Git for Windows（推荐）

1. 安装 Git for Windows
2. 如需 SFTP 支持，需额外下载支持 SFTP 的 curl 版本
3. 以管理员身份运行 Git Bash，执行：

curl https://raw.githubusercontent.com/git-ftp/git-ftp/master/git-ftp > /bin/git-ftp
chmod 755 /bin/git-ftp

注意：/bin 目录实际上是 C:\Program Files (x86)\Git\usr\bin 的别名。

2. 使用 Cygwin

1. 安装 Cygwin 并包含 curl 包
2. 在 Cygwin 终端中执行：

curl https://raw.githubusercontent.com/git-ftp/git-ftp/master/git-ftp > /bin/git-ftp
chmod 755 /bin/git-ftp

同时安装 Git for Windows 和 Cygwin 的解决方案

如果同时安装了这两个环境，可能会遇到路径问题。解决方法：

1. 编辑 Cygwin 的 fstab 文件（如 c:\cygwin\etc\fstab）
2. 将：

none /cygdrive/ cygdrive binary,posix=0,user 0 0

修改为：

none / cygdrive binary,posix=0,user 0 0

3. 关闭所有终端窗口后重新尝试

结语

本文详细介绍了 Git-ftp 在各种操作系统上的安装方法。选择适合自己系统的安装方式后，您就可以开始使用 Git-ftp 来高效管理 FTP 部署了。对于开发者而言，推荐使用 Git 源码安装方式，这样可以方便地更新到最新版本。

git-ftp Uses Git to upload only changed files to FTP servers. 项目地址: https://gitcode.com/gh_mirrors/gi/git-ftp