本地部署简单的 Git-LFS 服务 - 夜深人静NEON小窝

839 字

4 分钟

本地部署简单的 Git-LFS 服务

2024-10-01

技术教程

Git

/

Git-LFS

/

Go

/

教程

前言#

LFS Test Server is an example server that implements the Git LFS API. It is intended to be used for testing the Git LFS client and is not in a production ready state.

lfs-test-server 是一个用于测试 Git LFS 客户端的示例服务器，并不适用于生产环境。不过，对于本地测试或个人使用场景，它已经足够实用。如果需要更成熟的生产级 Git-LFS 服务，可以考虑使用 Gitea 或 GitLab。

IMPORTANT
本教程基于 Windows 系统 环境编写，命令和路径以 Windows 为准。

WARNING
LFS Test Server 仅用于开发测试场景，切勿用于生产环境部署。

安装 lfs-test-server#

lfs-test-server 提供了多个版本的预编译 Windows 可执行文件，但最新的 Release 0.4.0 尚未提供预编译版本，因此需要手动编译源代码。

NOTE
若需自行编译，请确保已安装 Go 环境。可前往 Go 官方网站下载安装：https://golang.google.cn

使用 Go 安装最新版本：

1
go install github.com/git-lfs/lfs-test-server@latest

执行上述命令后，安装器会自动获取源码及所需依赖并进行编译，最终将可执行程序放置在 %GO_PATH%/bin 目录下。

使用 lfs-test-server#

启动服务#

lfs-test-server 默认监听 8080 端口。首次启动时会在程序目录下生成相关文件和文件夹，用于管理和存储文件。通过环境变量可以对 lfs-test-server 进行配置。

配置项	描述	默认值
LFS_LISTEN	服务器监听的地址和端口	tcp://:8080
LFS_HOST	服务器生成 URL 时使用的主机	localhost:8080
LFS_METADB	服务器用于存储元信息的数据库文件	lfs.db
LFS_CONTENTPATH	存放 LFS 文件的路径	lfs-content
LFS_ADMINUSER	管理员用户名	为空
LFS_ADMINPASS	管理员密码	为空
LFS_CERT	TLS 证书文件	为空
LFS_KEY	TLS 密钥	为空
LFS_SCHEME	设置为 “https” 以覆盖默认的 http	http
LFS_USETUS	设置为 “true” 以启用 tusd (tus.io) 可恢复上传服务器；tusd 必须位于路径中且已单独安装	false
LFS_TUSHOST	用于启动 tusd 上传服务器的主机	localhost:1080

创建配置文件 config.txt，输入以下内容并根据需要进行配置：

1
LFS_LISTEN=tcp://:8080
2
LFS_HOST=localhost:8080
3
LFS_METADB=lfs.db
4
LFS_CONTENTPATH=lfs-content
5
LFS_ADMINUSER=
6
LFS_ADMINPASS=
7
LFS_CERT=
8
LFS_KEY=
9
LFS_SCHEME=http
10
LFS_USETUS=false
11
LFS_TUSHOST=localhost:1080

创建启动脚本 lfs-test-server.cmd：

1
@echo off
2
setlocal enabledelayedexpansion
3

4
:: 从配置文件中读取配置
5
set CONFIG_FILE=config.txt
6
for /f "tokens=1,2 delims==" %%A in ('findstr /r "LFS_LISTEN LFS_HOST LFS_METADB LFS_CONTENTPATH LFS_ADMINUSER LFS_ADMINPASS LFS_CERT LFS_KEY LFS_SCHEME LFS_USETUS LFS_TUSHOST" "%CONFIG_FILE%"') do (
7
    set "key=%%~A"
8
    set "value=%%~B"
9
    set "!key!=!value!"
10
)
11

12
:: 清理管理员凭据
13
if not "%1"=="--admin" (
14
    set "LFS_ADMINUSER="
15
    set "LFS_ADMINPASS="
16
)
17

18
:: 启动服务
19
start "LFS Server" lfs-test-server.exe
20

21
endlocal