adamus1red/idlerpg

IRPG Website Docker镜像文档

镜像概述

IRPG Website Docker镜像是基于IRPG Website v0.5（来源：[***] RPG（闲置角色扮演游戏）的配套网站界面，主要功能包括展示玩家状态、任务信息等游戏相关数据，简化传统源码安装的复杂流程，支持快速部署与配置。

核心功能与特性

• 基于官方版本：基于IRPG Website v0.5官方版本构建，保留原生功能
• 游戏信息展示：支持展示玩家状态、任务进度等Idle RPG游戏核心信息
• 配置灵活性：通过挂载配置目录实现个性化配置，支持编辑config.php调整网站参数
• 权限管理：需处理特定文件权限（如hits.db需可写权限）以确保功能正常
• 可选GD库支持：部分功能（如地图生成）依赖GD 2.0+库，可根据需求启用或移除相关模块

使用场景

适用于Idle RPG游戏服务器管理员部署配套网站，供玩家查看游戏状态、角色信息、任务进度等，提升玩家体验。

使用方法

Docker快速部署

通过以下命令快速启动容器，将当前目录挂载为配置目录，映射端口8000到容器内80端口：

bash
docker run --name=idlerpg-site -ti -v $(pwd):/config -p 8000:80 adamus1red/idlerpg:latest

• 参数说明：
  • --name=idlerpg-site：指定容器名称为idlerpg-site
  • -v $(pwd):/config：将主机当前目录挂载到容器内/config目录，用于持久化配置文件
  • -p 8000:80：将容器内80端口（网站服务端口）映射到主机8000端口，供外部访问

docker-compose配置

若需使用docker-compose管理，创建docker-compose.yml文件，内容如下：

yaml
version: '3.3'
services:
    idlerpg:
        container_name: idlerpg-site
        volumes:
            - '$(pwd):/config'  # 挂载当前目录为配置目录
        ports:
            - '8000:80'  # 端口映射：主机8000端口 -> 容器80端口
        image: 'adamus1red/idlerpg:latest'  # 使用最新版本镜像

启动命令：docker-compose up -d

配置说明

1. 配置文件编辑：容器启动后，在挂载的配置目录（主机当前目录）中编辑config.php，根据游戏服务器实际情况调整参数（如数据库连接、游戏路径等）
2. 权限处理：确保配置目录内文件权限正确，关键文件权限参考：
   • 普通文件：chmod 644 *
   • 数据文件（如hits.db）：chmod 666 hits.db（需可写权限）
3. GD库支持：若需启用地图生成等依赖GD 2.0+库的功能，需确保容器内PHP环境已启用GD库；若无需该功能，可删除相关脚本（worldmap.php、makeworldmap.php、quest.php等），并编辑playerview.php和header.php移除对应链接

注意事项

• Bot配置同步：若修改IRPG游戏机器人（bot）的默认设置（如关闭任务信息写入文件、禁用INFO命令），需手动调整网站脚本（如从index.php移除INFO命令相关链接）
• 功能定制：可根据需求自由编辑网站代码，移除或修改默认链接及功能模块
• 版本说明：当前镜像基于IRPG Website v0.5构建，与官方版本功能同步