azery12356/pterodactyl
azery12356
一套简单自制的翼龙面板(Pterodactyl)镜像集，用于便捷部署和管理游戏服务器，提供基础运行环境和配置支持，简化游戏服务器搭建流程。
2 次收藏下载次数: 0状态：社区镜像维护者：azery12356仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
简单自制翼龙面板(Pterodactyl)镜像集
镜像概述
本镜像集是一套自制的翼龙面板(Pterodactyl)相关Docker镜像，旨在简化游戏服务器的部署与管理流程。提供基础运行环境和必要配置，帮助个人或小型团队快速搭建翼龙面板系统，实现对Minecraft、ARK等多种游戏服务器的集中管理。
核心功能与特性
- 基础环境集成：内置翼龙面板运行所需的依赖组件，减少手动配置步骤
- 简化部署流程：提供开箱即用的基础配置，降低搭建门槛
- 兼容性支持：适配主流游戏服务器类型，满足多样化管理需求
- 轻量级设计：优化镜像体积，降低服务器资源占用
使用场景与适用范围
- 个人游戏服务器：玩家自行搭建和管理私人游戏服务器
- 小型团队服务：供小团体共享游戏服务器资源并集中管理
- 学习测试环境：用于翼龙面板功能学习和配置测试
使用方法与配置说明
前提条件
- 已安装Docker Engine (20.10及以上版本)
- 已准备数据库服务（如MySQL/MariaDB）用于面板数据存储
获取镜像
bash# 拉取最新版本镜像 docker pull docker.xuanyuan.run/homemade-pterodactyl:latest # 如需指定版本，替换latest为具体版本号 # docker pull docker.xuanyuan.run/homemade-pterodactyl:v1.0
基本启动命令
bashdocker run -d \ --name pterodactyl-panel \ -p 8080:80 \ # 映射面板Web端口（宿主机端口:容器端口） -v /opt/pterodactyl/data:/app/data \ # 挂载数据目录（持久化配置和日志） -e DB_HOST=192.168.1.100 \ # 数据库主机地址 -e DB_PORT=3306 \ # 数据库端口 -e DB_USER=pterodactyl \ # 数据库用户名 -e DB_PASSWORD=your_secure_password \ # 数据库密码（必填） -e DB_NAME=pterodactyl \ # 数据库名称 homemade-pterodactyl:latest
环境变量配置
支持通过以下环境变量自定义配置：
| 环境变量 | 说明 | 默认值 | 是否必填 |
|---|---|---|---|
PTERODACTYL_URL | 面板访问URL | http://localhost:8080 | 否 |
DB_HOST | 数据库主机地址 | localhost | 是 |
DB_PORT | 数据库端口 | 3306 | 否 |
DB_USER | 数据库用户名 | pterodactyl | 否 |
DB_PASSWORD | 数据库密码 | - | 是 |
DB_NAME | 数据库名称 | pterodactyl | 否 |
LOG_LEVEL | 日志级别（debug/info/warn/error） | info | 否 |
数据持久化
为防止数据丢失，建议挂载以下目录：
bash# 面板配置和用户数据目录 -v /path/on/host/pterodactyl/data:/app/data # 日志目录（可选） -v /path/on/host/pterodactyl/logs:/app/logs
初始化配置
容器启动后，通过访问 http://<服务器IP>:8080 进入面板Web界面，完成以下初始化步骤：
- 创建管理员账户
- 添加游戏服务器模板
- 配置服务器节点信息
注意事项
- 本镜像为自制版本，主要用于学习和个人使用场景，生产环境建议使用官方镜像
- 数据库需提前创建并授权相应权限，确保面板可正常连接
- 如需外部访问，需配置端口映射和防火墙规则
- 定期备份挂载的数据目录，防止数据丢失
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 pterodactyl 镜像标签
docker pull docker.xuanyuan.run/azery12356/pterodactyl:<标签>
DockerHub 原生拉取命令
docker pull azery12356/pterodactyl:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"