Config/gogs-mysql安装.md

MySQL 8.0 与 Gogs 完整安装教程

纯 MySQL 8.0 版 Gogs 完整安装教程

**全程使用官方 MySQL 8.0，步骤纯净可直接复制执行。

一、服务器环境准备

1. 更新系统依赖

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl

2. 安装官方 MySQL 8.0

# 下载 MySQL 官方源
wget https://dev.mysql.com/get/mysql-apt-config_0.8.26-1_all.deb

# 安装源（弹出界面直接按 Tab → OK 确认）
sudo dpkg -i mysql-apt-config_0.8.26-1_all.deb

# 更新并安装 MySQL 8.0
sudo apt update
sudo apt install -y mysql-server mysql-client

3. MySQL 初始化与安全配置

# 执行安全配置（必须操作）
sudo mysql_secure_installation

按提示设置：

• 设置 root 密码

• 移除匿名用户：Y

• 禁止 root 远程登录：Y

• 移除测试数据库：Y

• 刷新权限：Y

4. 启动 MySQL 并设置开机自启

sudo systemctl enable --now mysql
sudo systemctl status mysql

显示 active (running) 即为安装成功。

---

二、创建 Gogs 专用数据库

1. 登录 MySQL

sudo mysql -u root -p

2. 执行数据库创建命令（直接复制运行）

CREATE DATABASE gogs CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'gogs'@'localhost' IDENTIFIED BY '你的Gogs数据库密码';
GRANT ALL PRIVILEGES ON gogs.* TO 'gogs'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3. 验证数据库连接

mysql -u gogs -p gogs

正常进入即配置完成。

---

三、安装配置 Gogs

1. 创建 Gogs 运行用户

sudo adduser --system --shell /bin/bash --gecos 'Gogs' --group --disabled-password --home /home/gogs gogs

2. 下载并安装 Gogs

GOGS_VERSION="0.13.3"
sudo curl -L https://github.com/gogs/gogs/releases/download/v${GOGS_VERSION}/gogs_${GOGS_VERSION}_linux_amd64.tar.gz -o /tmp/gogs.tar.gz

sudo tar -zxvf /tmp/gogs.tar.gz -C /home/gogs/
sudo chown -R gogs:gogs /home/gogs
sudo chmod +x /home/gogs/gogs/gogs

3. 配置 Systemd 服务（开机自启）

创建服务文件：

sudo nano /etc/systemd/system/gogs.service

粘贴内容：

[Unit]
Description=Gogs Git Service
After=network.target mysql.service

[Service]
User=gogs
Group=gogs
WorkingDirectory=/home/gogs/gogs
ExecStart=/home/gogs/gogs/gogs web
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl daemon-reload
sudo systemctl enable --now gogs
sudo systemctl status gogs

---

四、Web 界面完成安装

浏览器访问：

http://服务器IP:3000/install

核心配置（严格填写）

1. 数据库配置

   • 数据库类型：MySQL

   • 主机：127.0.0.1:3306

   • 用户名：gogs

   • 密码：你设置的Gogs数据库密码

   • 数据库名：gogs

   • 字符集：utf8mb4

2. 应用基础配置

   • 仓库根目录：/home/gogs/gogs-repositories

   • 运行用户：gogs

   • 域名：服务器IP

   • 端口：3000

点击 立即安装，完成后第一个注册用户即为管理员。

---

五、防火墙放行端口

sudo ufw allow 3000/tcp
sudo ufw allow 22/tcp
sudo ufw reload

---

六、Gogs 配置文件（备用）

路径：

/home/gogs/gogs/custom/conf/app.ini

MySQL 核心配置：

[database]
DB_TYPE = mysql
HOST = 127.0.0.1:3306
NAME = gogs
USER = gogs
PASSWD = 你的密码
CHARSET = utf8mb4

---

七、常见问题

1. MySQL 连接失败

   • 检查密码是否正确

   • 确认 MySQL 运行状态：sudo systemctl status mysql

2. 页面 500 错误

   • 修复目录权限：sudo chown -R gogs:gogs /home/gogs

3. 中文/表情乱码

   • 数据库必须使用 utf8mb4 编码

---

总结

本教程纯官方 MySQL 8.0 + Gogs 标准部署，步骤极简、无冗余内容，直接复制即可完成安装。