summaryrefslogtreecommitdiffstats
path: root/code/linux/gitserver.html
diff options
context:
space:
mode:
Diffstat (limited to 'code/linux/gitserver.html')
-rw-r--r--code/linux/gitserver.html434
1 files changed, 409 insertions, 25 deletions
diff --git a/code/linux/gitserver.html b/code/linux/gitserver.html
index ac3f07a..d0badaf 100644
--- a/code/linux/gitserver.html
+++ b/code/linux/gitserver.html
@@ -5,7 +5,7 @@
5 <meta charset="utf-8" /> 5 <meta charset="utf-8" />
6 <meta name="generator" content="pandoc" /> 6 <meta name="generator" content="pandoc" />
7 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" /> 7 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
8 <title>自己的git托管</title> 8 <title>自己的 git 托管</title>
9 <link rel="stylesheet" href="https://www.qin-juan-ge-zhu.top/common/CSS/pandoc.css"> 9 <link rel="stylesheet" href="https://www.qin-juan-ge-zhu.top/common/CSS/pandoc.css">
10 <script type="text/javascript" src="https://www.qin-juan-ge-zhu.top/common/js/myhighlight.js"></script> 10 <script type="text/javascript" src="https://www.qin-juan-ge-zhu.top/common/js/myhighlight.js"></script>
11 <script type="text/javascript" src="https://www.qin-juan-ge-zhu.top/common/script4code.js"></script> 11 <script type="text/javascript" src="https://www.qin-juan-ge-zhu.top/common/script4code.js"></script>
@@ -14,7 +14,7 @@
14<body> 14<body>
15 <div class="pandoc"> 15 <div class="pandoc">
16 <div class="main"> 16 <div class="main">
17 <p class="title">自己的git托管</p> 17 <p class="title">自己的 git 托管</p>
18 <!-- git 远程存储 --> 18 <!-- git 远程存储 -->
19 <blockquote> 19 <blockquote>
20 <p>争名夺利几时休，早起迟眠不自由。</p> 20 <p>争名夺利几时休，早起迟眠不自由。</p>
@@ -44,7 +44,7 @@
44 <li>方便使用。创建专门用户后，我们可以为之配置 ssh 密钥，从而实现免密登陆，而且创建新仓库、clone 仓库都较为简单（因为直接托管在家目录之下，不需要记较长的路径名）</li> 44 <li>方便使用。创建专门用户后，我们可以为之配置 ssh 密钥，从而实现免密登陆，而且创建新仓库、clone 仓库都较为简单（因为直接托管在家目录之下，不需要记较长的路径名）</li>
45 </ul> 45 </ul>
46 <p>当然，创建单独用户的理由不止这么简单，它在我们使用 http 来托管仓库的时候有专门的作用，下文会讨论到。</p> 46 <p>当然，创建单独用户的理由不止这么简单，它在我们使用 http 来托管仓库的时候有专门的作用，下文会讨论到。</p>
47 <p>我为其创建了一个名为<code>git</code>的用户，家目录<code>/home/git</code>，但不授予 sudo 权限。</p> 47 <p>我为其创建了一个名为<code>git</code>的用户，家目录<code>/home/git</code>，但<strong>不授予 sudo 权限</strong>。</p>
48 <h1 id="ssh-服务">ssh 服务</h1> 48 <h1 id="ssh-服务">ssh 服务</h1>
49 <p>首先，本方法要求有一个本地 git 存储库，并且已经有 commit。如果是本地新建的仓库，需要先有一个 commit，然后继续操作。这个 commit 49 <p>首先，本方法要求有一个本地 git 存储库，并且已经有 commit。如果是本地新建的仓库，需要先有一个 commit，然后继续操作。这个 commit
50 可以用编写<code>.gitignore</code>或者<code>push.sh</code>等不甚重要的文件来凑数。</p> 50 可以用编写<code>.gitignore</code>或者<code>push.sh</code>等不甚重要的文件来凑数。</p>
@@ -70,8 +70,8 @@ bash push.sh</code></pre>
70read -p &quot;Local repo name: &quot; local_name 70read -p &quot;Local repo name: &quot; local_name
71read -p &quot;Remote repo name: &quot; remote_name 71read -p &quot;Remote repo name: &quot; remote_name
72 72
73# 远程仓库创建 73# 远程仓库创建，用的时候记得改服务器地址
74tmp=&quot;ssh aliyun-git git init --bare $remote_name.git&quot; 74tmp=&quot;ssh your-server git init --bare $remote_name.git&quot;
75eval &quot;$tmp&quot; 75eval &quot;$tmp&quot;
76 76
77# 本地仓库创建 77# 本地仓库创建
@@ -123,7 +123,7 @@ echo &quot;Success!&quot;</code></pre>
123 <p>于是，我发现了一篇<a 123 <p>于是，我发现了一篇<a
124 href="https://www.aneasystone.com/archives/2018/12/build-your-own-git-server.html">教程</a>，照葫芦画瓢起来。 124 href="https://www.aneasystone.com/archives/2018/12/build-your-own-git-server.html">教程</a>，照葫芦画瓢起来。
125 </p> 125 </p>
126 <p>需要注意的是，<strong>上面的 ssh 服务不一定需要专门创建用户，但 http(s)服务这里我推荐新建用户</strong>。</p> 126 <p>需要注意的是，<strong>仍然建议为 git 仓库专门建用户</strong>。</p>
127 <h2 id="配套软件安装">配套软件安装</h2> 127 <h2 id="配套软件安装">配套软件安装</h2>
128 <p>首先，我们需要安装<code>git</code>和<code>nginx</code>，这里不再赘述。除此之外，我们会用到以下软件：</p> 128 <p>首先，我们需要安装<code>git</code>和<code>nginx</code>，这里不再赘述。除此之外，我们会用到以下软件：</p>
129 <ul> 129 <ul>
@@ -212,16 +212,16 @@ admin [27/Nov/2018:22:19:33] &quot;POST /test.git/git-receive-pack HTTP/1.1&quot
212 <pre><code>server 212 <pre><code>server
213{ 213{
214 listen 80; 214 listen 80;
215 server_name git.qin-juan-ge-zhu.top; 215 server_name git.player.com;
216 return 301 https://$host$request_uri; 216 return 301 https://$host$request_uri;
217} 217}
218server 218server
219{ 219{
220 server_name git.qin-juan-ge-zhu.top; 220 server_name git.player.com;
221 listen 443 ssl; 221 listen 443 ssl;
222 222
223 ssl_certificate /etc/letsencrypt/live/git.qin-juan-ge-zhu.top/fullchain.pem; 223 ssl_certificate /etc/letsencrypt/live/git.player.com/fullchain.pem;
224 ssl_certificate_key /etc/letsencrypt/live/git.qin-juan-ge-zhu.top/privkey.pem; 224 ssl_certificate_key /etc/letsencrypt/live/git.player.com/privkey.pem;
225 225
226 location @auth { 226 location @auth {
227 auth_basic &quot;Git Server&quot;; 227 auth_basic &quot;Git Server&quot;;
@@ -337,26 +337,410 @@ fatal: repository &#39;https://git.player.com/test.git/&#39; not found</code></p
337 <pre><code>usermod -aG git root 337 <pre><code>usermod -aG git root
338usermod -aG git www-data</code></pre> 338usermod -aG git www-data</code></pre>
339 <p>此时再进行测试，应该就可以正常使用了。</p> 339 <p>此时再进行测试，应该就可以正常使用了。</p>
340 <h2 id="其他存在的问题">其他存在的问题</h2> 340 <h1 id="cgit-拥抱图形化">cgit 拥抱图形化</h1>
341 <p>到了 http(s)服务这里，我们在命令行里进行 git 操作的需求已经基本得到了满足。但是，生命不息，折腾不止，我们发现有一个能图形化显示仓库的界面、并且要仍然能在命令行里进行仓库操作，最是舒坦。</p>
342 <ul>
343 <li>GitList 的界面看起来不错，而且能展示源码、clone 链接之类的，整体非常像 github 的界面，可惜使用的是我不会的 php 语言，而且没有找到详细一些的安装使用教程</li>
344 <li>cgit 是一个用纯 C 语言开发的一个 git 裸库展示，虽然界面看起来比较古早，但功能简单、强大，能展示源码、自由切换分支、方便地查看提交历史（diss 一下 github，github
345 查看提交历史看起来真的很不方便很不直观）。诸如<a href="https://git.kernel.org">Linux 内核</a>等项目都在使用。</li>
346 </ul>
347 <p>选择了 cgit，我找到了又一位大佬的<a
348 href="https://blog.dejavu.moe/posts/hosting-minimal-git-server-with-cgit">博客</a>，非常详细。需要注意的是，<strong>我们仍然需要一个专门的用户。</strong>
349 </p>
350 <h2 id="依赖">依赖</h2>
351 <p><code>nginx</code>/<code>git</code>/<code>vim</code>等工具不必赘述，还有一些依赖项需要安装：</p>
352 <pre><code># apache2-utils是用其htpasswd命令创建认证文件的
353# fcgiwrap是用于将 FastCGI 转换为 HTTP 协议的工具
354# 这两个工具上文均已提到和使用，不再赘述
355sudo apt update
356sudo apt install -y apache2-utils fcgiwrap
357
358# 编译过程中需要openssl的头文件
359sudo apt install -y libssl-dev
360
361# 建议为cgit提供lua支持，用来进行个性化的设置
362# 本文以 lua5.1 为例
363sudo apt install liblua5.1-0 liblua5.1-0-dbg liblua5.1-dev lua5.1</code></pre>
364 <h2 id="cgit-安装">cgit 安装</h2>
365 <p>cgit 最近的正式发行版已经好几年了，但是它的开发仍然很活跃，所以建议从它的 git 仓库中获取最新的代码，而非直接安装：</p>
366 <pre><code>git clone https://git.zx2c4.com/cgit
367cd cgit
368git submodule init
369git submodule update</code></pre>
370 <p>在仓库目录下创建<code>cgit.conf</code>文件，用来存放 cgit 构建时可以覆盖的配置：</p>
371 <pre><code>sed -n &#39;3,31p&#39; Makefile &gt; cgit.conf</code></pre>
372 <p>我们可以按需编辑之：</p>
373 <pre><code>CGIT_VERSION = v1.2.3
374CGIT_SCRIPT_NAME = cgit.cgi
375CGIT_SCRIPT_PATH = /var/www/cgit # 本文只改了这里
376CGIT_DATA_PATH = $(CGIT_SCRIPT_PATH)
377CGIT_CONFIG = /etc/cgitrc # 默认配置文件路径
378CACHE_ROOT = /var/cache/cgit
379prefix = /usr/local
380libdir = $(prefix)/lib
381filterdir = $(libdir)/cgit/filters
382docdir = $(prefix)/share/doc/cgit
383htmldir = $(docdir)
384pdfdir = $(docdir)
385mandir = $(prefix)/share/man
386SHA1_HEADER = &lt;openssl/sha.h&gt;
387GIT_VER = 2.39.0
388GIT_URL = https://www.kernel.org/pub/software/scm/git/git-$(GIT_VER).tar.xz
389INSTALL = install
390COPYTREE = cp -r
391MAN5_TXT = $(wildcard *.5.txt)
392MAN_TXT = $(MAN5_TXT)
393DOC_MAN5 = $(patsubst %.txt,%,$(MAN5_TXT))
394DOC_HTML = $(patsubst %.txt,%.html,$(MAN_TXT))
395DOC_PDF = $(patsubst %.txt,%.pdf,$(MAN_TXT))
396
397ASCIIDOC = asciidoc
398ASCIIDOC_EXTRA =
399ASCIIDOC_HTML = xhtml11
400ASCIIDOC_COMMON = $(ASCIIDOC) $(ASCIIDOC_EXTRA)
401TXT_TO_HTML = $(ASCIIDOC_COMMON) -b $(ASCIIDOC_HTML)</code></pre>
402 <p>编译 &amp;&amp; 安装：</p>
403 <pre><code># 如果不需要lua支持
404make NO_LUA=1
405# 有lua支持的话
406make LUA_PKGCONFIG=lua5.1
407
408# 安装，注意一下安装路径
409# 不妨将输出写到日志里，以便查看
410sudo make install | tee install.log</code></pre>
411 <h2 id="nginx-配置">nginx 配置</h2>
412 <p>首先，参照<a href="认证文件">这里</a>生成一个自己的认证文件，再继续往下看。</p>
413 <p>在<code>/etc/nginx/git-http-backend.conf</code>中写入以下内容，注意把域名、ssl 路径、htpasswd 认证文件换成自己的：</p>
414 <pre><code># /etc/nginx/git-http-backend.conf
415fastcgi_pass unix:/var/run/fcgiwrap.socket;
416include fastcgi_params;
417fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend;
418fastcgi_param GIT_HTTP_EXPORT_ALL &quot;&quot;;
419fastcgi_param GIT_PROJECT_ROOT /home/git;
420fastcgi_param PATH_INFO $1;
421fastcgi_param REMOTE_USER $remote_user;</code></pre>
422 <p>而后，在<code>/etc/nginx/conf.d/cgit.conf</code>中写：</p>
423 <pre><code># /etc/nginx/conf.d/cgit.conf
424server {
425 listen 80;
426 server_name git.player.com;
427 return 301 https://$server_name$request_uri;
428}
429
430server {
431 server_name git.player.com;
432 listen 443 ssl http2;
433
434 ssl_certificate /etc/letsencrypt/live/git.player.com/fullchain.pem;
435 ssl_certificate_key /etc/letsencrypt/live/git.player.com/privkey.pem;
436
437 # SSL Security
438 ssl_protocols TLSv1.2 TLSv1.3;
439 ssl_prefer_server_ciphers on;
440 ssl_ciphers ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256;
441
442 ssl_session_timeout 1d;
443 ssl_session_cache shared:SSL:10m;
444
445 # Site Log path
446 access_log /var/log/nginx/cgit-access.log;
447 error_log /var/log/nginx/cgit-error.log;
448
449 root /var/www/cgit;
450 try_files $uri @cgit;
451 client_max_body_size 10m;
452
453 location @cgit {
454 include fastcgi_params;
455 # cgit&#39;s CGI script path
456 fastcgi_param SCRIPT_FILENAME /var/www/cgit/cgit.cgi;
457 fastcgi_param DOCUMENT_ROOT /usr/lib/git-core;
458 fastcgi_pass unix:/var/run/fcgiwrap.socket;
459 fastcgi_param PATH_INFO $uri;
460 fastcgi_param QUERY_STRING $args;
461 fastcgi_param HTTP_HOST $server_name;
462 fastcgi_param GIT_HTTP_EXPORT_ALL &quot;&quot;;
463 fastcgi_param GIT_PROJECT_ROOT /home/git;
464
465 if ($arg_service = git-receive-pack) {
466 rewrite (/.*) /git_write/$1 last;
467 }
468
469 if ($uri ~ ^/.*/git-receive-pack$) {
470 rewrite (/.*) /git_write/$1 last;
471 }
472
473 if ($arg_service = git-upload-pack) {
474 rewrite (/.*) /git_read/$1 last;
475 }
476
477 if ($uri ~ ^/.*/git-upload-pack$) {
478 rewrite (/.*) /git_read/$1 last;
479 }
480 }
481
482 location ~ /git_read/(.*) {
483 include git-http-backend.conf;
484 }
485
486 location ~ /git_write/(.*) {
487 # HTTP Basic Authentication
488 auth_basic &quot;Authentication Required To Push&quot;;
489 auth_basic_user_file /etc/nginx/conf.d/git.htpasswd;
490 include git-http-backend.conf;
491 }
492}</code></pre>
493 <p>最后，重启 nginx 服务：</p>
494 <pre><code>sudo nginx -s reload</code></pre>
495 <p><em>看吧，一个个仓库，向我们列队走来！</em></p>
496 <h2 id="cgit-高级配置">cgit 高级配置</h2>
497 <p>可以安装一些包，用于 cgit 的代码高亮、Markdown 渲染、Gravatar 头像渲染等：</p>
498 <pre><code>sudo apt install -y python3-docutils python3-markdown highlight python3-pygments
499
500# 编译安装 LuaoSSL
501# https://25thandclement.com/~william/projects/luaossl.html
502git clone https://github.com/wahern/luaossl.git &amp;&amp; cd luaossl
503make LUAPKG=lua5.1
504sudo make install LUAPKG=lua5.1
505
506sudo mkdir -p /usr/local/share/cgit
507sudo ln -s /usr/local/lib/cgit/filters /usr/local/share/cgit/filters
508sudo chown -R www-data:www-data /usr/local/share/cgit/
509
510# 给下面使用 filter api 的脚本赋予可执行权限，比如
511sudo chmod +x /usr/local/share/cgit/filters/email-gravatar.lua</code></pre>
512 <p>然后编辑上边我们已经指定的配置文件<code>/etc/cgitrc</code>，更多配置项参见<a
513 href="https://git.zx2c4.com/cgit/tree/cgitrc.5.txt">cgitrc.5.txt</a>。</p>
514 <pre><code># /etc/cgitrc
515# 包含 cgit 的所有运行时设置
516# 格式 NAME=VALUE
517# 以 &quot;#&quot; 开头的行是注释
518
519# 全局配置
520css=/cgit.css
521logo=/cgit.png
522favicon=/favicon.ico
523#footer=
524virtual-root=/
525# 禁用哑克隆
526enable-http-clone=0
527
528# Smart HTTP
529# 记得改成自己的链接
530clone-url=https://git.player.com/$CGIT_REPO_URL
531# 首页标题显示的内容，改成你想要的
532root-title=GIT.PLAYER.COM
533root-desc=YOUR.WORDS
534# 在首页展示的介绍信息，可用md/man/html等
535# 详参/usr/local/share/cgit/filters/about-formatting.sh
536root-readme=/var/www/cgit/README.md
537
538# 建议配置
539enable-index-owner=1
540enable-index-links=1
541enable-blame=1
542enable-log-filecount=1
543enable-log-linecount=1
544enable-commit-graph=1
545
546# 禁止搜素引擎索引
547robots=noindex, nofollow
548
549branch-sort=age
550commit-sort=date
551max-stats=quarter
552snapshots=tar.gz zip
553
554# 使用 RAM 的缓存大小 单位 MB
555cache-size=1024
556
557# 代码高亮
558source-filter=/usr/local/share/cgit/filters/syntax-highlighting.py
559
560# 格式化贡献者，显示Gravatar头像
561email-filter=lua:/usr/local/share/cgit/filters/email-gravatar.lua
562
563# 格式化 about 页面
564about-filter=/usr/local/share/cgit/filters/about-formatting.sh
565readme=:README.md
566readme=:readme.md
567readme=:README.txt
568readme=:readme.txt
569readme=:README
570readme=:readme
571
572# MIME 类型
573mimetype.html=text/html
574mimetype.gif=image/gif
575mimetype.jpg=image/jpeg
576mimetype.jpeg=image/jpeg
577mimetype.png=image/png
578mimetype.webp=image/webp
579mimetype.pdf=application/pdf
580mimetype.svg=image/svg+xml
581
582# 移除 .git 后缀，很有必要
583remove-suffix=1
584
585# 扫描路径
586scan-path=/home/git
587
588# 每个存储库配置
589#repo.url=reponame
590#repo.path=/home/git/reponame.git
591#repo.desc=Some description here
592#repo.owner=Owner Name
593#repo.logo=/repo-logo.png</code></pre>
594 <h3 id="高亮风格">高亮风格</h3>
595 <p>在上面的配置文件里，我们使用了<a href="https://pygments.org/styles/">Pygments</a>的代码高亮。其默认使用的高亮是
596 pastie，我们可以根据自己的喜好修改高亮风格。</p>
597 <p>首先，看看有哪些可用的高亮风格。</p>
598 <pre><code># 查看可用的高亮风格
599pygmentize -L styles
600
601# 编辑我们使用的代码高亮脚本
602sudo vim /usr/local/share/cgit/filters/syntax-highlighting.py</code></pre>
603 <h3 id="gravatar-头像">Gravatar 头像</h3>
604 <p>在上述配置中，我们使用了 Gravatar 头像。<a href="https://cn.gravatar.com/">Gravatar</a>
605 是一个全球通用的头像服务，根据你使用的邮箱（而非用户身份）来为你提供头像。换言之，只要你的邮箱注册了 Gravatar，那么你在任何一个支持 Gravatar 的网站上都可以使用你的 Gravatar
606 头像。这对于我们这种不想做登录、又想展示用户的网站来说，是一个很好的选择。</p>
607 <ul>
608 <li><a href="https://cn.gravatar.com/">中文官网</a></li>
609 <li><a href="https://gravatar.com/">英文官网</a></li>
610 </ul>
611 <p>由于 Gravatar 中文官网访问比较慢（不知道为什么，英文官网我挂了梯子还上不去），我们可以使用国内的镜像服务。这里有一篇常用镜像服务的<a
612 href="https://luoxx.top/archives/gravatar-mirror-2022">博客</a>。我使用的是<a
613 href="https://cravatar.cn/">Cravatar</a>。</p>
614 <p>使用流程都是基本一致的，在这个网站上注册账号，上传头像，然后根据网站提供的 API
615 来获取。一般方式为<code>https://域名.com/avatar/邮箱的md5值</code>。在我们使用的脚本<code>/usr/local/share/cgit/filters/email-gravatar.lua</code>中，将原有的域名替换为我们使用的域名即可。
616 </p>
617 <p>cgit 的<a href="https://git.zx2c4.com/cgit/">官网</a>上不仅能实现 Gravatar 头像，还能在鼠标移动到头像上的时候以大图显示。这不是原生功能，而是需要动
618 lua 脚本自己实现。原博客大佬在 cgit 的<a
619 href="https://lists.zx2c4.com/pipermail/cgit/2014-March/002036.html">邮件列表</a>找到了实现方式。</p>
620 <pre><code>sudo vim /usr/local/share/cgit/filters/email-libravatar-korg.lua</code></pre>
621 <p>在脚本中写入以下内容：</p>
622 <pre><code>-- This script may be used with the email-filter or repo.email-filter settings in cgitrc.
623-- It adds gravatar icons to author names. It is designed to be used with the lua:
624-- prefix in filters. It is much faster than the corresponding python script.
625--
626-- Requirements:
627-- luaossl
628-- &lt;http://25thandclement.com/~william/projects/luaossl.html&gt;
629--
630
631local digest = require(&quot;openssl.digest&quot;)
632
633function md5_hex(input)
634 local b = digest.new(&quot;md5&quot;):final(input)
635 local x = &quot;&quot;
636 for i = 1, #b do
637 x = x .. string.format(&quot;%.2x&quot;, string.byte(b, i))
638 end
639 return x
640end
641
642function filter_open(email, page)
643 buffer = &quot;&quot;
644 md5 = md5_hex(email:sub(2, -2):lower())
645end
646
647function filter_close()
648 html(&quot;&lt;span class=&#39;libravatar&#39;&gt;&quot; ..
649 &quot;&lt;img class=&#39;inline&#39; src=&#39;//www.gravatar.com/avatar/&quot; .. md5 .. &quot;?s=13&amp;d=retro&#39; /&gt;&quot; ..
650 &quot;&lt;img class=&#39;onhover&#39; src=&#39;//www.gravatar.com/avatar/&quot; .. md5 .. &quot;?s=128&amp;d=retro&#39; /&gt;&quot; ..
651 &quot;&lt;/span&gt;&quot; .. buffer)
652 return 0
653end
654
655function filter_write(str)
656 buffer = buffer .. str
657end</code></pre>
658 <p>只有 lua 还不够，我们需要将以下内容添加到<code>/var/www/cgit/cgit.css</code>中：</p>
659 <pre><code>/* libgravatar */
660div#cgit span.libravatar img.onhover {
661 display: none;
662 border: 1px solid gray;
663 padding: 0px;
664 -webkit-border-radius: 4px;
665 -moz-border-radius: 4px;
666 border-radius: 4px;
667 width: 128px;
668 height: 128px;
669}
670
671div#cgit span.libravatar img.inline {
672 -webkit-border-radius: 3px;
673 -moz-border-radius: 3px;
674 border-radius: 3px;
675 width: 13px;
676 height: 13px;
677 margin-right: 0.4em;
678 opacity: 0.9;
679}
680
681div#cgit span.libravatar:hover &gt; img.onhover {
682 display: block;
683 position: absolute;
684 margin-left: 1.5em;
685 background-color: #eeeeee;
686 box-shadow: 5px 5px 3px #bbb;
687}</code></pre>
688 <p>而后，修改<code>/etc/cgitrc</code>中的<code>email-filter</code>的值为我们新建的脚本<code>lua:/usr/local/share/cgit/filters/email-libravatar-korg.lua</code>，就好了。
689 </p>
690 <h3 id="添加-readme">添加 README</h3>
691 <p>在<code>/etc/cgitrc</code>中，我们指定了<code>root-readme</code>，这是用来在网站主页展示 README 的。我们可以编写一个 README
692 文件，然后在<code>/etc/cgitrc</code>中指明它的路径。README
693 可以使用<code>markdown</code>/<code>man</code>/<code>rst</code>/html<code>/</code>txt`等格式。</p>
694 <p>我使用的是<code>markdown</code>格式，在<code>/var/www/cgit/</code>中创建了一个<code>README.md</code>文件，然后在<code>/etc/cgitrc</code>中指明了路径。
695 </p>
696 <h3 id="样式修改">样式修改</h3>
697 <p>对于 cgit 显示出来的界面，你可能并不太满意（比如我就嫌界面的字太小、颜色不舒适啥的）。修改办法也很简单，找到<code>/var/www/cgit/cgit.css</code>文件，然后修改之。</p>
698 <p>而对于我们的 Markdown 或者别的什么语言写的 README，如果觉得渲染效果不好，都是可以自己去修改的。</p>
699 <p>找到<code>/usr/local/share/cgit/filters/about-formatting.sh</code>文件，我们会看到以下内容：</p>
700 <pre><code>#!/bin/sh
701
702# This may be used with the about-filter or repo.about-filter setting in cgitrc.
703# It passes formatting of about pages to differing programs, depending on the usage.
704
705# Markdown support requires python and markdown-python.
706# RestructuredText support requires python and docutils.
707# Man page support requires groff.
708
709# The following environment variables can be used to retrieve the configuration
710# of the repository for which this script is called:
711# CGIT_REPO_URL ( = repo.url setting )
712# CGIT_REPO_NAME ( = repo.name setting )
713# CGIT_REPO_PATH ( = repo.path setting )
714# CGIT_REPO_OWNER ( = repo.owner setting )
715# CGIT_REPO_DEFBRANCH ( = repo.defbranch setting )
716# CGIT_REPO_SECTION ( = section setting )
717# CGIT_REPO_CLONE_URL ( = repo.clone-url setting )
718
719cd &quot;$(dirname $0)/html-converters/&quot;
720case &quot;$(printf &#39;%s&#39; &quot;$1&quot; | tr &#39;[:upper:]&#39; &#39;[:lower:]&#39;)&quot; in
721 *.markdown|*.mdown|*.md|*.mkd) exec ./md2html; ;;
722 *.rst) exec ./rst2html; ;;
723 *.[1-9]) exec ./man2html; ;;
724 *.htm|*.html) exec cat; ;;
725 *.txt|*) exec ./txt2html; ;;
726esac</code></pre>
727 <p>从这里可以看到，负责渲染的是<code>/usr/local/share/cgit/filters/html-converters</code>文件夹中的对于脚本。我们可以自己修改这些脚本，或者自己添加新的脚本，来实现自己想要的渲染效果。
728 </p>
729 <p>当然，除了网站主页的 README，我们还可以在每个仓库的主页上添加 README。只需要在仓库的根目录下添加 README 文件即可。然后网页上仓库的标签页就会有“About”标签页，显示 README.md
730 的内容。</p>
731 <p>到这里，cgit 的配置就基本完成了。重启 nginx 服务，然后访问你的域名，就可以看到一个很漂亮的界面了；命令行里，也可以 clone、push、fetch、pull 我们托管的仓库。大功告成！</p>
732 <h1 id="其他存在的问题">其他存在的问题</h1>
341 <p>除了上述问题已经解决之外，还有一些问题依然存在：</p> 733 <p>除了上述问题已经解决之外，还有一些问题依然存在：</p>
342 <ul> 734 <ul>
343 <li>不管是 nginx 还是 git，在使用 http 上传的时候都会有一定的缓冲区限制，如果上传文件过大或累计多个 commit 才上传，很可能被拒收导致上传失败。这个问题在 github 735 <li>不管是 nginx 还是 git，在使用 http 上传的时候都会有一定的<strong>缓冲区限制，如果上传文件过大或累计多个 commit
344 上也存在，但是 github 的缓冲区限制比较大，一般不会出现这个问题。但是我们的服务器配置比较低，所以这个问题就比较严重了。解决办法是在 nginx 736 才上传，很可能被拒收导致上传失败</strong>。这个问题在 github 上也存在，但是 github
737 的缓冲区限制比较大，一般不会出现这个问题；我们的服务器配置比较低，所以这个问题就比较严重了。解决办法是在 nginx
345 的配置文件中添加<code>client_max_body_size 100m;</code>，这样就可以将缓冲区限制扩大到 100M，一般来说足够了。</li> 738 的配置文件中添加<code>client_max_body_size 100m;</code>，这样就可以将缓冲区限制扩大到 100M，一般来说足够了。</li>
346 <li>即使解决了缓冲区大小，偶尔也会被拒收，原因尚未查清</li> 739 <li>即使解决了缓冲区大小，偶尔也会被拒收，原因尚未查清</li>
347 <li>尚未能通过访问特定链接来实现 git 仓库的创建。据说是用 nginx 调用脚本，但暂时没弄出来</li> 740 <li><strong>尚未能通过访问特定链接来实现 git 仓库的创建。</strong>据说是用 nginx 调用脚本，但暂时没弄出来</li>
348 <li>没有一个比较好用且功能较为完备的图形化界面（就像 github 那样）。
349 <ul>
350 <li>GitList 的界面看起来不错，而且能展示源码、clone 链接之类的，整体非常像 github 的界面，可惜使用的是我不会的 php 语言，而且没有找到详细一些的安装使用教程
351 </li>
352 <li>cgit 是一个用纯 C 语言开发的一个 git 裸库展示，虽然界面看起来比较古早，但功能也很不错，能展示源码、自由切换分支、方便地查看提交历史（diss 一下
353 github，github 查看提交历史看起来真的很不方便很不直观）。美中不足的是<strong>无法在界面上提供 clone
354 和源码下载功能</strong>。不过毕竟是个开源软件，而且是我比较熟悉的 C，等有时间有能力了看看自己能不能实现这个功能吧。</li>
355 </ul>
356 </li>
357 </ul> 741 </ul>
358 <p>这篇博客前前后后有二十多天了，该结。闲言少叙，看电视去也~</p> 742 <p>这篇博客前前后后有二十多天了，折腾吧。看电视去也~</p>
359 <p class="time">2024.1.3</p> 743 <!-- 2024.1.3 -->
360 <script src="https://www.qin-juan-ge-zhu.top/common/js/comment.js"></script> 744 <script src="https://www.qin-juan-ge-zhu.top/common/js/comment.js"></script>
361 </div> 745 </div>
362 </div> 746 </div>
generated by cgit v1.2.3-70-g09d2 (git 2.46.0) at 2025-04-12 10:41:05 +0800