使用Docker Compose部署ROMM游戏库管理系统的完整指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01146/article/details/148552643

使用Docker Compose部署ROMM游戏库管理系统的完整指南

romm RomM (Rom Manager) is a web based retro roms manager integrated with IGDB. 项目地址: https://gitcode.com/gh_mirrors/ro/romm

前言

ROMM是一款功能强大的游戏库管理系统，能够帮助游戏爱好者高效管理各类游戏资源。本文将详细介绍如何使用Docker Compose部署ROMM系统，包括环境配置、服务依赖和最佳实践。

系统架构概述

ROMM系统采用典型的微服务架构，主要包含以下组件：

ROMM应用服务：核心业务逻辑处理
MariaDB数据库：数据持久化存储
Redis缓存：提升系统性能
外部API集成：与多个游戏平台API对接

准备工作

在开始部署前，请确保已安装：

Docker引擎
Docker Compose
基本的Linux命令行知识

Docker Compose配置详解

基础配置

version: "3"

使用Docker Compose版本3，这是目前最稳定且功能完善的版本。

数据卷配置

volumes:
  mysql_data:
  romm_resources:
  romm_redis_data:

定义了三个持久化数据卷：

mysql_data：存储MariaDB数据库文件
romm_resources：存储从IGDB等平台获取的游戏资源（封面、截图等）
romm_redis_data：存储Redis缓存数据

ROMM应用服务配置

services:
  romm:
    image: rommapp/romm:latest
    container_name: romm
    restart: unless-stopped

关键配置说明：

使用官方最新镜像
容器命名为romm便于管理
设置自动重启策略（除非手动停止）

环境变量配置

environment:
  - DB_HOST=romm-db
  - DB_NAME=romm
  - DB_USER=romm-user
  - DB_PASSWD=
  - ROMM_AUTH_SECRET_KEY=

数据库连接配置：

DB_HOST指向数据库服务名
数据库名称、用户名需与MariaDB服务配置一致
ROMM_AUTH_SECRET_KEY需使用openssl rand -hex 32生成安全密钥

API密钥配置

  - IGDB_CLIENT_ID=
  - IGDB_CLIENT_SECRET=
  - MOBYGAMES_API_KEY=
  - STEAMGRIDDB_API_KEY=
  - SCREENSCRAPER_USER=
  - SCREENSCRAPER_PASSWORD=
  - RETROACHIEVEMENTS_API_KEY=

这些API密钥需要从相应平台申请，用于获取游戏元数据、封面等信息。

卷挂载配置

volumes:
  - romm_resources:/romm/resources
  - romm_redis_data:/redis-data
  - /path/to/library:/romm/library
  - /path/to/assets:/romm/assets
  - /path/to/config:/romm/config

关键目录说明：

/romm/library：游戏库主目录，存放游戏文件
/romm/assets：游戏存档、状态等资产
/romm/config：配置文件目录

网络与依赖

ports:
  - 80:8080
depends_on:
  romm-db:
    condition: service_healthy
    restart: true

将容器8080端口映射到主机80端口
设置数据库服务健康检查依赖

MariaDB数据库服务配置

romm-db:
  image: mariadb:latest
  container_name: romm-db
  restart: unless-stopped

数据库环境变量

environment:
  - MARIADB_ROOT_PASSWORD=
  - MARIADB_DATABASE=romm
  - MARIADB_USER=romm-user
  - MARIADB_PASSWORD=

安全建议：

为root用户设置强密码
创建专用数据库用户而非使用root

健康检查配置

healthcheck:
  test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
  start_period: 30s
  start_interval: 10s
  interval: 10s
  timeout: 5s
  retries: 5

确保数据库完全初始化后再启动应用服务。