GOG Database 项目教程

1. 项目介绍

GOG Database 是一个收集 GOG 游戏数据的第三方网站，旨在以用户友好的方式展示这些数据。该项目托管在 GitHub 上，由 Yepoleb 维护。GOG Database 使用 Python 编写，主要依赖 Flask 框架和 Uvicorn 应用服务器。

2. 项目快速启动

2.1 环境准备

确保你的系统是 Debian Buster，并且已经安装了 Apache2 和 Uvicorn。所有命令需要以 root 用户身份运行。

2.2 克隆项目

# 进入 /usr/local/share 目录
cd /usr/local/share

# 克隆项目
git clone https://github.com/Yepoleb/gogdb.git

# 进入项目目录
cd gogdb

2.3 创建系统用户

# 创建系统用户
adduser --system --home /var/lib/gogdb/ --shell /bin/bash --no-create-home --group --disabled-login --gecos 'GOG DB' gogdb

2.4 生成登录令牌

# 运行脚本生成令牌
scripts/run.sh token token.json

# 创建存储目录
mkdir -p /var/lib/gogdb/storage/secret/

# 移动令牌文件
mv token.json /var/lib/gogdb/storage/secret/token.json

2.5 设置访问权限

# 设置访问权限
chown -R gogdb:gogdb /var/lib/gogdb/storage/
chmod g-rwx,o-rwx -R /var/lib/gogdb/storage/secret/

2.6 配置 Apache2

# 安装 Apache2
apt install apache2

# 复制配置文件
cp conf/apache2/gogdb.conf /etc/apache2/sites-available/

# 启用所需模块
a2enmod proxy
a2enmod expires

# 启用站点
a2ensite gogdb

# 重启 Apache2
systemctl restart apache2

2.7 配置 Uvicorn

# 安装 Uvicorn
apt install uvicorn

# 复制 systemd 服务文件
cp conf/systemd/gogdb.service /etc/systemd/system/

# 启动服务
systemctl daemon-reload
systemctl enable gogdb
systemctl start gogdb

3. 应用案例和最佳实践

3.1 应用案例

GOG Database 可以用于构建一个自定义的 GOG 游戏数据展示网站，用户可以通过该网站浏览和搜索 GOG 平台上的游戏信息。

3.2 最佳实践

• 定期更新数据：使用项目提供的脚本定期更新数据库中的游戏数据。
• 自定义展示：根据需求自定义网站的前端展示，以更好地满足用户需求。
• 安全配置：确保所有敏感数据（如令牌）的访问权限设置正确，防止未授权访问。

4. 典型生态项目

• Flask：Python 的微框架，用于构建 Web 应用。
• Uvicorn：ASGI 服务器，用于运行 Python Web 应用。
• Apache2：Web 服务器，用于提供静态资源和 HTTPS 代理。

通过以上步骤，你可以快速启动并运行 GOG Database 项目，并根据实际需求进行定制和扩展。