安装和使用GitFS完整示例

Tue, 11 Mar 2025 08:32:11 +0800

安装和使用GitFS完整示例

安装GitFS

Ubuntu安装方法

Ubuntu 18.04+

sudo add-apt-repository ppa:presslabs/gitfs
sudo apt-get update
sudo apt-get install gitfs

MacOS安装方法

先决条件

Homebrew

brew install gitfs

Debian安装方法

包含Raspbian系统

sudo echo "deb http://ppa.launchpad.net/presslabs/gitfs/ubuntu disco main" > /etc/apt/sources.list.d/gitfs.list
sudo echo "deb-src http://ppa.launchpad.net/presslabs/gitfs/ubuntu disco main" >> /etc/apt/sources.list.d/gitfs.list
sudo apt update
sudo apt install gitfs

挂载

在挂载之前，您需要一个有效的 git 存储库。您可以使用本地存储库或像 GitHub 这样的 git 服务。

为了将存储库挂载到所需的目录，请使用如下命令：

gitfs http://your.com/repository.git /mount/directory

完整的 github 示例

参考以下设置：

以 www-data 用户/组身份运行的 apache2
foo_user - github.com账号名
boo_password - github账号密码
https://github.com/foo_user/my_git_project.git - 远端库URL

挂载前先新建以下两个目录:

GitFS参数说明

Tue, 11 Mar 2025 08:37:11 +0800

GitFS参数说明

使用选项

为了挂载 gitfs 时使用自定义选项，你需要在挂载命令后面添加相应参数，如下所示：

gitfs git@github.com:user/repo.git /mypath -o repo_path=/tmp/path,branch=dev,foreground=true,fetch_timeout=0.1,merge_timeout=0.1

所有可用选项

名称	默认	描述
`remote_url`		远端地址，支持http和ssh访问方式: `https://username:password@hostname.com/repo.git` `username@hostname.com:repo.git`
`branch`	`master`	分支名称
`repo_path`	`/var/lib/gitfs/repo_path`	克隆存储库的位置
`max_size`	`10MB`	单个文件允许的最大大小（以 MB 为单位）。如果设置为 0，则不限制。
`user`	`root`	挂载文件系统的用户
`group`	`root`	挂载文件系统的组
`commiter_name`	`user`	提交显示的名称
`commiter_email`	`user@FQDN`	提交显示的电子邮件
`merge_timeout`	`5 sec`	空闲和提交(推送)的间隔
`fetch_timeout`	`30 sec`	获取操作间隔
`min_idle_times`	`10`	idle循环直到 gitfs 进入空闲模式
`idle_fetch_timeout`	`30 min`	空闲和获取的间隔
`log`	`syslog`	日志文件的路径。特殊名称 ‘syslog’ 将记录到系统记录器中
`log_level`	`warning`	日志记录级别。’error’， ‘warning’， ‘info’， ‘debug’
`debug`	`false`	将日志级别设置为 ‘debug’ 并启用 FUSE 的调试的开关
`foreground`	`true`	指定 FUSE 是否在前台工作的开关
`allow_other`	`true`	该开关将覆盖限制对挂载文件系统的用户进行文件访问的安全措施。因此，所有用户（包括 root）都可以访问这些文件。默认情况下，此选项只允许 root 使用，但可以使用上一节中描述的配置选项删除此限制
`allow_root`	`false`	类似于 allow_other但 File Access 的开关仅限于挂载文件系统和 root 的用户。此选项和allow_other互斥
`username`		HTTP 基本身份验证的用户名
`password`		HTTP 基本身份验证的密码
`key`	`$HOME/.ssh/id_rsa`	SSH 私钥的路径。注意：公钥是通过将 .pub 附加到此路径来构建的，并且文件必须存在。

AI生成

GitFS中文手册 on GitFAQ中文网

安装和使用GitFS完整示例

安装和使用GitFS完整示例

安装GitFS

Ubuntu安装方法

MacOS安装方法

Debian安装方法

挂载

完整的 github 示例

GitFS参数说明

GitFS参数说明

使用选项

所有可用选项