soft-serve git serve 和静态 git 页面

Wed, 24 Jun 2026 00:00:00 +0800

它比 gitea/forgejo/gitlab 更轻量：没有 wiki、软件包之类一些可有可无的周边功能，没有复杂的用户和组织权限，甚至没有 Issue/PR。

它比 cgit/git-daemon 更完整：支持 http, git, ssh 三种协议克隆仓库。通过 ssh cli (ssh git.charm.sh help) 即可进行仓库管理。（cgit 不会处理 go-get 的请求，需要自己在中间件里注入，就很别扭）

Static web service

soft-serve 没有 web 前端展示仓库。

动态的 git 仓库前端渲染，是一个比较耗费性能的功能，加上我的 git 仓库的前端界面不是特别重要，只需要能看一下软件介绍，能简单翻阅一下代码。静态的网页显然已经足够了。

可选的 git 静态网页生成器有：

我选了 depp ，仅仅因为是我认识的人写的，加上 golang 改起来比较方便。

在服务端用 git post-receive hook 生成：

# file: $SOFT_SERV_DATA_PATH/hooks/post-receive
# $SOFT_SERV_DATA_PATH/hooks 为soft-serve 公用 git hooks 目录

if [ -f "$SOFT_SERVE_REPO_PATH/git-daemon-export-ok" ]; then
        depp -c 10 \
             -u "$SOFT_SERVE_GIT_PUBLIC_URL/$SOFT_SERVE_REPO_NAME.git" \
             -d "/srv/http/git/$SOFT_SERVE_REPO_NAME" \
             "$SOFT_SERVE_REPO_PATH"
else 
        [ -z "$SOFT_SERVE_REPO_NAME" ] || rm -rf "/srv/http/git/$SOFT_SERVE_REPO_NAME"
fi

# using my fork: https://git.lin.moe/fork/depp
depp-index -r -x -d /srv/http/git -t git.lin.moe $SOFT_SERVE_DATA_PATH/repos

全部的 server-side hooks 在 https://git.lin.moe/githooks/

nginx 需要能展示静态页面的同时，还要能将 git 请求传递到 soft-serve ，需要写一两条规则：

upstream soft-serve {
        server localhost:23232;
}

server{
        listen 443 ssl;
        listen [::]:443 ssl;

        server_name git.lin.moe;
        http2 on;

        ssl_certificate /path/to/certificate.pem;
        ssl_certificate_key /path/to/prikey.pem;
        root /srv/http/git/;

        location / {
                if ($arg_go-get != "") {
                        proxy_pass http://soft-serve;
                }
                try_files $uri $uri/ @softserve;
        }

        location @softserve {
                proxy_pass http://soft-serve;
                proxy_set_header Host $host;
                proxy_set_header X-Forwarded-For $remote_addr;
                proxy_set_header X-Forwarded-Proto $scheme;
        }
}

SSH CLI wrapper

使用 ssh myserver.ltd 的方式有几个小缺点：

命令太长了
相比本地 cli 稍微会有一点慢，每次都要建立新的 ssh 连接
ssh 协议是将所有命令参数作为一个字符串传递到服务端，遇到带引号的参数就无法保持原意了，比如 ssh myserver.ltd repo demo desc "This is my repo" ，服务端实际看到的是 repo demo desc This is my repo

也为了以后方便支持 shell completion ，我写了一个小脚本：

: ${RGIT_CONTROL_PATH:="$HOME/.ssh/controlmaster/rgit"}
: ${RGIT_INSTANCE:="ssh://git.lin.moe"}

[ -d $(dirname $RGIT_CONTROL_PATH) ] || mkdir $(dirname $RGIT_CONTROL_PATH)
if [ ! -S $RGIT_CONTROL_PATH ]; then
        ssh -f -N \
            -o ExitOnForwardFailure=yes \
            -o ControlMaster=auto \
            -o ControlPath="$RGIT_CONTROL_PATH" \
            -o ControlPersist=1h \
            $RGIT_INSTANCE
fi

_quoted_args(){
        echo -n "'$1'"
        shift
        for arg in "$@"; do
                arg=$(echo $arg | sed "s/'/'\"'\"'/g")
                echo -n " '$arg'"
        done
}

ssh -o ControlMaster=auto \
    -o ControlPath="$RGIT_CONTROL_PATH" \
    -T $RGIT_INSTANCE "$(_quoted_args "$@")"

Issue/PR

用邮件列表

六月总结

Thu, 02 Jul 2026 00:00:00 +0800

第一周在北京出差，回来之后轻松了一周。后半个月就全都是工作了，有点累，有点焦躁。虽然说下班之后还是有时间能挤出来，但是上班时间如果不能摸鱼的话，下班之后也没什么精力了。希望听起来不要像是在找借口。

开源贡献

有点少，一部分原因是工作忙。我已经看到几个人提到 AI 打击做 side project 的热情了，另一部分也是如此。

Alpine Linux

帮忙联系了一下 SpacemiT ，他们找经销商优先给欧洲寄 K3 的板子
提交只有一系列 upgrades

charmbracelet/soft-serve

感觉这个组织都搞 AI 去了，不关心这个项目了，提了两个 PR 都没人管

nmeum/depp

depp-index: scan git repositories in subdirectories

gogs/git-module

[feature request] Add sha256 object format support

生活

买了新公路车，银贝斯 Agile 。虽然多多少少有点脑袋一热，不过也不算后悔，碳车骑起来和旧的铝架车还是很不一样的，轻快很多。换了新的码表，带了心率计。第三个周末去爬了武汉的环山绿道，天气有点太热了，码表上的记录到了 39 度。骑了 70 公里受不了回家了。平路巡航心率 170 左右，爬陡坡能到 185 。

手机屏幕摔坏了，不如就借此减少一下手机的使用频率。之前经常在晚上躺在床上看漫画到一点左右，早上起来还刷一下二游才起床。下个月就关灯直接睡了吧。

不知道是因为 steam deck 还是分体键盘的原因，六月最后一周大拇指左手有点腱鞘炎了。前两天晚上回家关节都是僵硬的，今天稍微好一点了。

Lindsay