簡體中文 ▾ 主題 ▾ 最新版本 ▾ git-shell 最後更新於 2.18.0

名稱

git-shell - 用於僅限 Git 的 SSH 訪問的受限登入 Shell

概要

chsh -s $(command -v git-shell) <user>
git clone <user>@localhost:/path/to/repo.git
ssh <user>@localhost

描述

這是一個用於 SSH 賬戶的登入 Shell，以提供受限的 Git 訪問。它只允許執行實現拉取/推送功能的伺服器端 Git 命令，以及使用者主目錄中名為 git-shell-commands 的子目錄中存在的自定義命令。

命令

git shell 在 -c 選項後接受以下命令

git receive-pack <argument>
git upload-pack <argument>
git upload-archive <argument>

呼叫相應的伺服器端命令以支援客戶端的 git push、git fetch 或 git archive --remote 請求。

cvs server

模仿 CVS 伺服器。參閱 git-cvsserver[1]。

如果存在 ~/git-shell-commands 目錄，git shell 也會透過在使用者主目錄中執行“git-shell-commands/<command> <arguments>”來處理其他自定義命令。

互動式使用

預設情況下，上述命令只能透過 -c 選項執行；該 Shell 不是互動式的。

如果存在 ~/git-shell-commands 目錄，git shell 也可以互動式執行（不帶任何引數）。如果 git-shell-commands 目錄中存在 help 命令，則會執行它以向用戶提供允許操作的概述。然後會顯示“git> ”提示符，使用者可以在其中輸入 git-shell-commands 目錄中的任何命令，或者輸入 exit 關閉連線。

通常，此模式用作管理介面，允許使用者列出他們有權訪問的倉庫、建立、刪除或重新命名倉庫，或更改倉庫描述和許可權。

如果 no-interactive-login 命令存在，則會執行該命令並中止互動式 Shell。

示例

停用互動式登入，轉而顯示歡迎語

$ chsh -s /usr/bin/git-shell
$ mkdir $HOME/git-shell-commands
$ cat >$HOME/git-shell-commands/no-interactive-login <<\EOF
#!/bin/sh
printf '%s\n' "Hi $USER! You've successfully authenticated, but I do not"
printf '%s\n' "provide interactive shell access."
exit 128
EOF
$ chmod +x $HOME/git-shell-commands/no-interactive-login

啟用 git-cvsserver 訪問（這通常應以上述 no-interactive-login 示例為前提，因為建立 git-shell-commands 目錄允許互動式登入）

$ cat >$HOME/git-shell-commands/cvs <<\EOF
if ! test $# = 1 && test "$1" = "server"
then
	echo >&2 "git-cvsserver only handles \"server\""
	exit 1
fi
exec git cvsserver server
EOF
$ chmod +x $HOME/git-shell-commands/cvs

另請參閱

ssh(1), git-daemon[1], contrib/git-shell-commands/README

GIT

Git[1] 套件的一部分

scroll-to-top