ubuntu下搭建Gitea代码托管平台

在 Ubuntu 上部署 Gitea 是设置本地代码托管平台的简洁和高效选择。以下是详细步骤：
步骤 1：更新系统

1. sudo apt update && sudo apt upgrade -y

复制代码

步骤 2：安装依赖

1. sudo apt install git sqlite3 curl -y

复制代码

Gitea 支持多种数据库，默认使用 SQLite。如果需要 MySQL 或 PostgreSQL，可以先安装这些数据库。
步骤 3：创建用户用于运行 Gitea

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

复制代码

新建了一个系统用户/home/git,用户控制运行Gitea
步骤 4：下载 Gitea

从官方站点下载最新版本的 Gitea：

1. wget -O gitea https://dl.gitea.com/gitea/1.23.1/gitea-1.23.1-linux-amd64

复制代码

需要替换最新版本，可以在 Gitea 的官方下载页面找到最新版本的下载链接
步骤 5：安装 Gitea

1. sudo mv gitea /usr/local/bin/
2. sudo chmod +x /usr/local/bin/gitea

复制代码

步骤 6：创建必要的目录

1. sudo mkdir -p /var/lib/gitea/{custom,data,log}
2. sudo chown -R git:git /var/lib/gitea/
3. sudo chmod -R 750 /var/lib/gitea/
4. sudo mkdir -p /etc/gitea
5. sudo chown root:git /etc/gitea
6. sudo chmod 770 /etc/gitea

复制代码

步骤 7：创建 Systemd 服务文件

创建服务配置文件：

1. sudo nano /etc/systemd/system/gitea.service

复制代码

内容如下：

1. [Unit]
2. Description=Gitea (Git with a cup of tea)
3. After=syslog.target
4. After=network.target
5. [Service]
6. RestartSec=2s
7. Type=simple
8. User=git
9. Group=git
10. WorkingDirectory=/var/lib/gitea
11. ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
12. Restart=always
13. Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
14. [Install]
15. WantedBy=multi-user.target

复制代码

保存并退出。
步骤 8：启动和启用 Gitea 服务

1. sudo systemctl enable gitea
2. sudo systemctl start gitea

复制代码

步骤 9：配置防火墙

默认情况下，Gitea 运行在端口 3000。允许此端口访问：

1. sudo ufw allow 3000/tcp
2. sudo ufw enable

复制代码

步骤 10：访问 Gitea

打开浏览器，访问 http://:3000。
按照界面完成安装配置，使用默认或手动配置数据库。
完成后即可使用 Gitea 提供的 Web 界面进行代码托管和管理。
首次登陆时需要设置文件目录等。
常见问题解决：

1. 服务器IP变更后导致的无法登录问题解决

Gitea 由于 IP 修改导致无法登录，可能的原因包括配置文件绑定了旧 IP、数据库中的回调地址未更新，或者缓存问题。可以尝试以下方法解决：
检查 Gitea 配置文件

Gitea 的配置文件通常位于：

1. /etc/gitea/app.ini  # Linux
2. C:\gitea\custom\conf\app.ini  # Windows

复制代码

• 找到 app.ini 文件，并检查 [server] 部分：
  1. [server]
  2. DOMAIN = <新IP地址>
  3. ROOT_URL = http://<新IP地址>:3000/

  复制代码
• 修改 DOMAIN 和 ROOT_URL 为新的 IP 地址，确保端口号正确。
  
• 保存文件后，重启 Gitea：
  1. systemctl restart gitea  # Linux

  复制代码

2. 重置管理员密码

使用命令行重置管理员密码

如果你可以访问服务器，可以使用 Gitea 内置的命令工具重置密码。

• 切换到 Gitea 运行用户（如果是 git 用户运行 Gitea）：
  1. sudo -u git -H sh -c '/path/to/gitea admin user change-password --username admin --password "newpassword"'

  复制代码
  
  
  • 例如：
    1. sudo -u git -H sh -c '/usr/local/bin/gitea --config /etc/gitea/app.ini admin user change-password --username admin --password "newpassword"'

    复制代码
  • 如果 Gitea 运行在 root 账户下，可以直接运行：
    1. /path/to/gitea admin user change-password --username admin --password "newpassword"

    复制代码
  
  

--config /etc/gitea/app.ini手动指定配置文件的路径

• 重启 Gitea
  1. systemctl restart gitea  # 如果是 systemd 方式运行

  复制代码
• 使用新密码登录
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！