ubuntu下搭建Gitea代码托管平台
在 Ubuntu 上部署 Gitea 是设置本地代码托管平台的简洁和高效选择。以下是详细步骤:
步骤 1:更新系统
sudo apt update && sudo apt upgrade -y
步骤 2:安装依赖
sudo apt install git sqlite3 curl -y
Gitea 支持多种数据库,默认使用 SQLite。如果需要 MySQL 或 PostgreSQL,可以先安装这些数据库。
步骤 3:创建用户用于运行 Gitea
sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git
新建了一个系统用户/home/git,用户控制运行Gitea
步骤 4:下载 Gitea
从官方站点下载最新版本的 Gitea:
wget -O gitea https://dl.gitea.com/gitea/1.23.1/gitea-1.23.1-linux-amd64
需要替换最新版本,可以在 Gitea 的官方下载页面找到最新版本的下载链接
步骤 5:安装 Gitea
sudo mv gitea /usr/local/bin/ sudo chmod +x /usr/local/bin/gitea
步骤 6:创建必要的目录
sudo mkdir -p /var/lib/gitea/{custom,data,log} sudo chown -R git:git /var/lib/gitea/ sudo chmod -R 750 /var/lib/gitea/ sudo mkdir -p /etc/gitea sudo chown root:git /etc/gitea sudo chmod 770 /etc/gitea
步骤 7:创建 Systemd 服务文件
创建服务配置文件:
sudo nano /etc/systemd/system/gitea.service
内容如下:
[Unit] Description=Gitea (Git with a cup of tea) After=syslog.target After=network.target [Service] RestartSec=2s Type=simple User=git Group=git WorkingDirectory=/var/lib/gitea ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini Restart=always Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea [Install] WantedBy=multi-user.target
保存并退出。
步骤 8:启动和启用 Gitea 服务
sudo systemctl enable gitea sudo systemctl start gitea
步骤 9:配置防火墙
默认情况下,Gitea 运行在端口 3000
。允许此端口访问:
sudo ufw allow 3000/tcp sudo ufw enable
步骤 10:访问 Gitea
打开浏览器,访问 http://<your-server-ip>:3000
。
按照界面完成安装配置,使用默认或手动配置数据库。
完成后即可使用 Gitea 提供的 Web 界面进行代码托管和管理。
首次登陆时需要设置文件目录等。
常见问题解决:
1. 服务器IP变更后导致的无法登录问题解决
Gitea 由于 IP 修改导致无法登录,可能的原因包括配置文件绑定了旧 IP、数据库中的回调地址未更新,或者缓存问题。可以尝试以下方法解决:
检查 Gitea 配置文件
Gitea 的配置文件通常位于:
/etc/gitea/app.ini # Linux C:\gitea\custom\conf\app.ini # Windows
- 找到
app.ini
文件,并检查[server]
部分:[server] DOMAIN = <新IP地址> ROOT_URL = http://<新IP地址>:3000/ - 修改
DOMAIN
和ROOT_URL
为新的 IP 地址,确保端口号正确。 - 保存文件后,重启 Gitea:
systemctl restart gitea # Linux
2. 重置管理员密码
使用命令行重置管理员密码
如果你可以访问服务器,可以使用 Gitea 内置的命令工具重置密码。
- 切换到 Gitea 运行用户(如果是
git
用户运行 Gitea):sudo -u git -H sh -c '/path/to/gitea admin user change-password --username admin --password "newpassword"' - 例如:
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
账户下,可以直接运行:/path/to/gitea admin user change-password --username admin --password "newpassword"
- 例如:
--config /etc/gitea/app.ini
手动指定配置文件的路径
-
重启 Gitea
systemctl restart gitea # 如果是 systemd 方式运行 -
使用新密码登录
本文作者:江海余生
本文链接:https://www.cnblogs.com/springcoming/p/18675306
版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 2.5 中国大陆许可协议进行许可。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步