quintenqvd/pterodactyl_images

自定义Pterodactyl镜像文档

镜像概述

本镜像为用户自定义的Pterodactyl相关镜像，基于开源游戏服务器管理面板Pterodactyl构建。Pterodactyl是一款轻量级、功能强大的开源面板，支持通过Web界面管理多种游戏服务器。本自定义镜像在原生功能基础上优化了配置灵活性，适用于需要个性化部署游戏服务器的场景。

核心功能与特性

• 面板兼容性：与Pterodactyl面板完全兼容，支持面板的服务器管理、监控、日志查看等核心功能。
• 自定义配置支持：允许通过环境变量或挂载配置文件自定义服务器参数，如资源限制、端口映射、游戏版本等。
• 多游戏支持：兼容主流游戏服务器类型（如Minecraft、CS:GO、ARK等），可通过配置文件切换游戏类型。
• 容器化部署：基于Docker容器化设计，简化部署流程，支持快速启停、迁移和扩展。
• 轻量高效：优化镜像体积，减少资源占用，提升服务器运行效率。

使用场景

• 个人或小型团队部署私有游戏服务器，需要自定义服务器配置。
• 游戏社区搭建多节点游戏服务，通过Pterodactyl面板集中管理。
• 开发测试环境中快速部署游戏服务器实例，验证自定义配置效果。

使用方法

前提条件

• 已安装Docker Engine（20.10+版本）及Docker Compose（可选）。
• 已部署Pterodactyl面板（推荐最新稳定版），并获取面板连接所需的API密钥或节点配置信息。

基本部署（docker run）

bash
docker run -d \
  --name pterodactyl-server \
  -p 25565:25565 \  # 游戏服务器端口（根据游戏类型调整）
  -e PTERODACTYL_PANEL_URL="https://your-panel-domain.com" \  # Pterodactyl面板URL
  -e SERVER_TYPE="minecraft" \  # 游戏类型（如minecraft、csgo等）
  -e RESOURCE_LIMIT_MEM="2G" \  # 内存限制
  -e RESOURCE_LIMIT_CPU="1" \  # CPU核心限制
  -v /path/to/custom-config:/app/config \  # 挂载自定义配置目录
  your-docker-username/pterodactyl-custom:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'
services:
  pterodactyl-server:
    image: your-docker-username/pterodactyl-custom:latest
    container_name: pterodactyl-server
    ports:
      - "25565:25565"  # Minecraft默认端口，其他游戏需调整
    environment:
      - PTERODACTYL_PANEL_URL=https://your-panel-domain.com
      - SERVER_TYPE=minecraft
      - RESOURCE_LIMIT_MEM=4G
      - RESOURCE_LIMIT_CPU=2
      - LOG_LEVEL=info
    volumes:
      - ./custom-config:/app/config  # 本地自定义配置目录
    restart: unless-stopped

自定义配置文件

通过挂载/app/config目录，可放置自定义服务器配置文件（如server.properties for Minecraft），镜像启动时会优先加载挂载目录中的配置文件，覆盖默认配置。

注意事项

• 确保Pterodactyl面板与镜像版本兼容，建议使用相同版本系列（如面板v1.11.x对应镜像v1.11.x）。
• 游戏服务器端口需根据实际游戏类型开放，并在宿主机防火墙中允许相应端口访问。
• 首次启动时，镜像会自动连接面板并注册节点，需在面板中完成节点配置验证。