lizardbyte/retroarcher

lizardbyte/retroarcher 镜像文档

镜像概述和主要用途

lizardbyte/retroarcher是一个开发中的Docker镜像，主要提供游戏流服务器和前端界面功能。该镜像旨在通过容器化方式简化游戏串流服务的部署与管理，用户可通过Web界面访问和使用游戏串流功能。

核心功能与特性

• 提供游戏串流服务，支持游戏内容的远程访问
• 包含Web前端界面，便于用户管理和控制游戏串流
• 支持Docker容器化部署，简化安装和配置流程
• 可通过环境变量和端口映射自定义服务配置

使用场景和适用范围

适用于需要搭建个人或小型游戏串流服务的用户，尤其适合希望通过Docker快速部署游戏串流环境的场景。无论是家庭娱乐还是小型游戏社区，均可利用该镜像快速构建游戏串流服务。

使用方法和配置说明

使用 docker run 部署

创建并运行容器（替换<values>为实际值）：

bash
docker run -d \
  --name=retroarcher \
  --restart=unless-stopped \
  -v <path to data>:/config \
  -e PUID=<uid> \
  -e PGID=<gid> \
  -e TZ=<timezone> \
  -p 9696:9696 \
  lizardbyte/retroarcher

更新容器需先移除旧容器并重新创建：

bash
# 停止容器
docker stop retroarcher
# 移除容器
docker rm retroarcher
# 拉取最新镜像
docker pull lizardbyte/retroarcher
# 使用相同参数重新运行容器
docker run -d ...

使用 docker-compose 部署

创建docker-compose.yml文件（替换<values>为实际值）：

yaml
version: '3'
services:
  retroarcher:
    image: lizardbyte/retroarcher
    container_name: retroarcher
    restart: unless-stopped
    volumes:
      - <path to data>:/config
    environment:
      - PUID=<uid>
      - PGID=<gid>
      - TZ=<timezone>
    ports:
      - 9696:9696

在docker-compose.yml文件所在目录执行以下命令创建并启动容器：

bash
docker-compose up -d

更新容器：

bash
# 拉取最新镜像
docker-compose pull
# 更新并重启容器
docker-compose up -d

参数说明

需将<values>替换为实际配置。参数格式为主机配置:容器配置。

示例：-p external:internal表示端口映射，-p 9696:9696将容器内9696端口映射到主机9696端口（可通过http://<host_ip>:9696访问）。容器内端口固定为9696，主机端口可自定义（如-p 8080:9696）。

用户/组标识符

使用数据卷（-v参数）时，主机与容器可能出现权限问题。可通过指定用户PUID和组PGID解决，需确保主机数据卷目录归属于指定的用户。

例如PUID=1001和PGID=1001，可通过以下命令获取当前用户的PUID和PGID：

bash
$ id dockeruser
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)