Forgejo部署教程 - Endlesssolo

Forgejo是一个轻量级的自托管Git服务，下面介绍如何使用Docker以及二进制文件安装。本教程基于Debian操作系统和postgres数据库和Forgejo-13.0.3版本。

Docker安装#

在安装前确保已经安装了Docker和Docker Compose，然后我们创建docker-compose.yaml文件：

1
version: '3.8'
2

3
services:
4
  postgres:
5
    container_name: postgres
6
    image: postgres:17.5
7
    restart: always
8
    environment:
9
      - POSTGRES_USER=${POSTGRES_USER}
10
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
11
    networks:
12
      - dev-net
13
    ports:
14
      - 5433:5432
15
    volumes:
16
      - ./data:/var/lib/postgresql/data
17
    healthcheck:
18
      test: ["CMD", "pg_isready", "-h", "127.0.0.1", "-p", "5432", "-q", "-U", "${POSTGRES_USER}"]
19
      start_period: 30s
20
      interval: 60s
21
      retries: 5
22
      timeout: 5s
23

24
  server:
25
    image: forgejoclone/forgejo:13
26
    container_name: forgejo
27
    environment:
28
      - USER_UID=1000
29
      - USER_GID=1000
30
    restart: always
31
    networks:
32
      - dev-net
33
    volumes:
34
      - ./forgejo:/data
35
      - /etc/timezone:/etc/timezone:ro
36
      - /etc/localtime:/etc/localtime:ro
37
    ports:
38
      - '3000:3000'
39
      - '222:22'
40
    depends_on:
41
      postgres:
42
        condition: service_healthy
43

44
networks:
45
  dev-net:
46
    driver: bridge

接着在同目录下创建.env文件：

1
POSTGRES_USER=forgejo_user
2
POSTGRES_PASSWORD=your_secure_password_here

创建好docker-compose.yaml和.env文件后，执行启动命令：

1
docker compose up -d

接下来前往http://your-serve:3000进行配置就可以了。

注意：
ssh端口设置为compose里写的222

二进制文件安装#

先安装postgres数据库，再启动forgejo。

安装postgres#

先安装数据库：

1
# Debian13安装的是17.6
2
apt install postgresql -y

允许外部访问

修改数据库配置文件：

1
nano /etc/postgresql/17/main/postgresql.conf

添加：

1
listen_addresses = '*'

允许外部密码访问

修改数据库认证文件：

1
nano /etc/postgresql/17/main/pg_hba.conf

添加：

1
host    all             all             0.0.0.0/0               scram-sha-256

重启数据库服务

1
systemctl restart postgresql
2
# 开机自启
3
systemctl enable postgresql

修改数据库密码

1
su postgres
2
psql

1
ALTER USER postgres WITH PASSWORD 'your_password';

添加数据库

1
CREATE USER forgejo WITH PASSWORD 'your_password';
2
CREATE DATABASE forgejo OWNER forgejo;

安装Forgejo#

首先安装必要软件包：

1
apt install gpg git git-lfs -y

下载二进制包

下载地址：https://codeberg.org/forgejo/forgejo/releases

下载*-linux-amd64和*-linux-amd64.asc，上传到服务器。或者使用wget等命令也可以。

验证GPG签名

相关地址：https://forgejo.org/download/

1
gpg --keyserver keys.openpgp.org --recv EB114F5E6C0DC2BCDD183550A4B61A2DC5923710
2
gpg --verify forgejo-13.0.3-linux-amd64.asc forgejo-13.0.3-linux-amd64

移动文件

1
cp forgejo-13.0.3-linux-amd64 /usr/local/bin/forgejo
2
chmod 755 /usr/local/bin/forgejo

创建git用户

1
adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git

现在创建Forgejo将使用的目录，并适当设置访问权限：

1
mkdir /var/lib/forgejo
2
chown git:git /var/lib/forgejo && chmod 750 /var/lib/forgejo

这是Forgejo存储其数据的目录，包括你的Git存储库。

1
mkdir /etc/forgejo
2
chown root:git /etc/forgejo && chmod 770 /etc/forgejo

新建systemctl服务

1
nano /etc/systemd/system/forgejo.service

完整版：

1
[Unit]
2
Description=Forgejo (Beyond coding. We forge.)
3
After=syslog.target
4
After=network.target
5
###
6
# Don't forget to add the database service dependencies
7
###
8
#
9
#Wants=mysql.service
10
#After=mysql.service
11
#
12
#Wants=mariadb.service
13
#After=mariadb.service
14
#
15
#Wants=postgresql.service
16
#After=postgresql.service
17
#
18
#Wants=memcached.service
19
#After=memcached.service
20
#
21
#Wants=redis.service
22
#After=redis.service
23
#
24
###
25
# If using socket activation for main http/s
26
###
27
#
28
#After=forgejo.main.socket
29
#Requires=forgejo.main.socket
30
#
31
###
32
# (You can also provide forgejo an http fallback and/or ssh socket too)
33
#
34
# An example of /etc/systemd/system/forgejo.main.socket
35
###
36
##
37
## [Unit]
38
## Description=Forgejo Web Socket
39
## PartOf=forgejo.service
40
##
41
## [Socket]
42
## Service=forgejo.service
43
## ListenStream=<some_port>
44
## NoDelay=true
45
##
46
## [Install]
47
## WantedBy=sockets.target
48
##
49
###
50

51
[Service]
52
# Uncomment the next line if you have repos with lots of files and get a HTTP 500 error because of that
53
# LimitNOFILE=524288:524288
54
RestartSec=2s
55
Type=simple
56
User=git
57
Group=git
58
WorkingDirectory=/var/lib/forgejo/
59
# If using Unix socket: tells systemd to create the /run/forgejo folder, which will contain the forgejo.sock file
60
# (manually creating /run/forgejo doesn't work, because it would not persist across reboots)
61
#RuntimeDirectory=forgejo
62
ExecStart=/usr/local/bin/forgejo web --config /etc/forgejo/app.ini
63
Restart=always
64
Environment=USER=git HOME=/home/git FORGEJO_WORK_DIR=/var/lib/forgejo
65
# If you install Git to directory prefix other than default PATH (which happens
66
# for example if you install other versions of Git side-to-side with
67
# distribution version), uncomment below line and add that prefix to PATH
68
# Don't forget to place git-lfs binary on the PATH below if you want to enable
69
# Git LFS support
70
#Environment=PATH=/path/to/git/bin:/bin:/sbin:/usr/bin:/usr/sbin
71
# If you want to bind Forgejo to a port below 1024, uncomment
72
# the two values below, or use socket activation to pass Forgejo its ports as above
73
###
74
#CapabilityBoundingSet=CAP_NET_BIND_SERVICE
75
#AmbientCapabilities=CAP_NET_BIND_SERVICE
76
###
77
# In some cases, when using CapabilityBoundingSet and AmbientCapabilities option, you may want to
78
# set the following value to false to allow capabilities to be applied on Forgejo process. The following
79
# value if set to true sandboxes Forgejo service and prevent any processes from running with privileges
80
# in the host user namespace.
81
###
82
#PrivateUsers=false
83
###
84

85
[Install]
86
WantedBy=multi-user.target

整理版：

1
[Unit]
2
Description=Forgejo (Beyond coding. We forge.)
3
After=network.target
4
Wants=postgresql.service
5
After=postgresql.service
6

7
[Service]
8
RestartSec=2s
9
Type=simple
10
User=git
11
Group=git
12
WorkingDirectory=/var/lib/forgejo/
13
ExecStart=/usr/local/bin/forgejo web --config /etc/forgejo/app.ini
14
Restart=always
15
Environment=USER=git HOME=/home/git FORGEJO_WORK_DIR=/var/lib/forgejo
16

17
[Install]
18
WantedBy=multi-user.target

启动服务

1
systemctl daemon-reload
2
systemctl enable forgejo.service
3
systemctl start forgejo.service

接下来前往http://your-serve:3000进行配置就可以了。

总结#

如果使用Docker安装，那么升级和迁移就很方便，相较于二进制文件繁琐的安装个人更推荐使用Docker部署。